"Newsletter Susbscription" is a small extension to save registered emails in database.
Use it by simply placing the following in your template, for example, inside a script tag at the bottom of the page, and make whatever use you need with returning values:
{{ checknewsletter() }}
The extension will first email users with a link so thay can verify themselves. Once verified, the status of the database record will be "Published".
You are free to create the subscription form. Just take into account to set "POST" as form method and, obviously, include the field name set in config.yml as an input form control.
The default form field is "newsletter_email". You can customize it by editing the config.yml file.
newsletter_field: another_name
You can also customize the subject field of the email sent and a small sentence in the email's body.
Be sure to setup email smtp settings in your Bolt config file, so the extension can send verifying emails.
Right now you need to manually create the content type for this extension. As an example:
subscribers:
name: Subscribers
singular_name: Subscriber
fields:
email:
label: Email
type: text
group: Content
token:
label: Token
type: text
readonly: true
class: narrow
viewless: true
default_status: held
searchable: false
show_on_dashboard: false
Returned values:
When inserting a new subscriber
0: Verifying email sent. All OK
1: Error sending verifying email
2: Error saving subscriber email in DB
3: Subscriber email already registered
99: Subscriber email not valid
When verifying an email
10: Subscriber email verified
11: Error saving verified email info to DB
12: Error in subscriber email or token sent for verifying
This extension does not force any form style or similar.
It lets you create the email subscription form freely. You just need to include the field set in config.yml.
Additionally, it just inform you about the status of the action using raw numeric strings (returned values), so you later can do whatever you want with them (for example, compare them and make use of modals to inform the user, but you are free to make whatever you want).
For example: Inserting a script tag in the bottom of the page (jQuery ready version)...
<script>
var res = '{{ checknewsletter() }}';
$(document).ready(function(){
switch(res){
case '0':
alert('Verification email sent.');
break;
case '1':
alert('Error sending verification email.');
break;
case '2':
alert('Error saving subscriber to database.');
break;
case '3':
alert('Subscriber email already registered.');
break;
case '99':
alert('Subscriber email not valid.');
break;
case '10':
alert('Subscriber email verified.');
break;
case '11':
alert('Error saving verified subscriber to database.');
break;
case '12':
alert('Error in subscriber email or token sent for verifying.');
break;
}
});
</script>