Download the PHP package wc4b/sib-contact-form-integration without Composer
On this page you can find all versions of the php package wc4b/sib-contact-form-integration. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wc4b/sib-contact-form-integration
More information about wc4b/sib-contact-form-integration
Files in wc4b/sib-contact-form-integration
Package sib-contact-form-integration
Short Description A contact form integration for the Send in Blue API
License MIT
Informations about the package sib-contact-form-integration
sib contact form integration plugin for Craft CMS 3.x
A contact form integration for the Send in Blue API
Requirements
This plugin requires Craft CMS 3.0.0-beta.23 or later.
Installation
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project
-
Then tell Composer to load the plugin:
composer require sib-contact-form-integration/sib-contact-form-integration
- In the Control Panel, go to Settings → Plugins and click the “Install” button for sib-contact-form-integration.
craft sib contact form Overview
This plugin is a fork of the craftcms/contact-form and uses its base contact form logic in to send emails via the users SMPT email settings. In adition to this this plugin has additional settings and logic to handle talking to the Send In Blue API. This plugin lets you add contacts to your SendInBlue contact lists and add those contacts to mailing lists.
Configuring sib-contact-form-integration
CMS Settings
Within the craft CMS, go to the settings page and click on the sib-contact-form-integration
settings.
From here you can add your Send In Blue API Key as SIB API Key
and the newsletter list ID's comma separated within the SIB Lists
textbox.
Custom Logic
To add custom logic the plugin has extended the afterValidate
and beforeSend
event hooks from original craftcms/contact-form.
To use the following event hooks add them to a sib-contact-form-integration.php
file in your projects /config
directory.
e.g. my-project/config/sib-contact-form-integration.php
afterValidate
The plugin has the original afterValidate
but uses the plugins namespacing.
This is where you can add custom validation for your form elements.
For example.
beforeSend & afterSend
The plugin has the original beforeSend
but uses the plugins namespacing.
The plugins has also added and extra afterSend
event hook to use.
This is where you can add custom validation for your form elements.
For example.
beforeSignup & afterSignup
In addition to the above the plugin also has event hooks when signing up users to the Send In Blue mailing lists.
For example.
Using sib-contact-form-integration
You can use the contact form via a page submission as indictated in the craftcms/contact-form docs.
That being said it is recomended to use a Ajax
request to handle the form submission for increased user experience.
and example module might look like this
With the following template
sib-contact-form-integration Roadmap
Some things to do, and ideas for potential features:
- Option to make terms and conditions check mandatory
Brought to you by WillCodeForBeer