This shortcode is used to render a subscription form for any visitor.
It is automatically included on the Newsletter Subscription page that can be generated under Subscription Activation Page in Newsletters > Settings.
Here visitors can input their email address and must confirm their subscription through an activation link that is sent to their email address.
The shortcode offers flexible options that can be set using these attributes:
‘description’ : The text shown in the form that invites to subscribe. Defaults to ‘Subscribe to our newsletters’.
‘description_class’ : CSS class applied to the description. Default: ‘description’.
‘description_style’ : CSS inline style applied to the description. Default: ‘padding-bottom: 1em;’.
‘field_label’ : The label of the email field. Default: ‘Email’.
‘field_class’ : CSS class of the email field. Default: ‘field’.
‘field_style’ : Inline style of the email field. Default: ‘padding-bottom: 1em;’.
‘after_field_label’ : What is printed after the email field label. Default: ‘ ‘.
‘email_placeholder’ : Placeholder text for the email field. Default: ‘Your email address’.
‘captcha_class’ : CSS class applied to captcha. Default: ‘captcha’.
‘captcha_style’ : Inline style applied to captcha. Default: ‘padding-bottom: 1em;’.
‘captcha_filter’ : Function name, render a custom captcha. Default: ”.
‘captcha_validate_filter’ : Function name, custom captcha validator. Default: ”.
‘captcha_description’ : The text that explains the captcha, defaults to ‘Are you human?’.
‘captcha_description_class’ : CSS class for the captcha description. Default: ‘captcha-description’.
‘captcha_description_style’ : Inline style. Default: ‘padding-bottom: 1em;’.
‘recaptcha’ : Set to ‘yes’ to use reCAPTCHA. Defaults to ‘no’.
‘recaptcha_public_key’ : Provide your reCAPTCHA public key, required when using reCAPTCHA.
‘recaptcha_private_key’ : Provide your reCAPTCHA private key, required when using reCAPTCHA.
‘recaptcha_options’ : Content of the RecaptchaOptions array. Defaults to ‘theme:”white”‘. See https://developers.google.com/recaptcha/docs/customization.
‘recaptcha_widget’ : Id of the element used for a custom widget. Defaults to ”.
‘recaptcha_error_message’ : Defaults to ‘Please solve the captcha to proof that you are human.’.
‘captcha_error_message’ : Defaults to ‘Please solve the captcha to proof that you are human.’.
‘errors_style’ : Inline style used to display errors. Default : ‘border: 1px solid #c00; border-radius: 4px; background-color: #fee; padding: 1em;’.
‘confirm_message’ : Message used to ask for subscription confirmation. Default: ‘Thank you. Please check your email to confirm your subscription.’
‘confirm_style’ : Inline style. Default: ‘border: 1px solid #0c0; border-radius: 4px; background-color: #efe; padding: 1em;’.
‘resend_inactive’ : If the activation email should be sent when an inactive email is resubmitted. Defaults to ‘yes’.
‘hide_on_activation’ : Whether the form should be hidden when an incoming activation is recognized. Defaults to ‘yes’.
‘hide_on_cancellation’ : Whether the form should be hidden when an incoming cancellation is recognized. Defaults to ‘yes’.
‘user_subscribe_form’ : For registered users, the alternative direct subscription form is displayed. Defaults to ‘yes’.
‘force_user_login’ : Existing emails require login. Defaults to ‘yes’.