Gantry 5 Particles - Documentation

Gantry 5 Particle - Ajax Mailchimp Documentation

MailChimp is an email service offered through the URL www.mailchimp.com website that allows you to create, send, and manage email newsletters. Millions of people and businesses around the world use MailChimp for email marketing.

Ajax Mailchimp particle supports subscribing to your Mailchimp newsletter from your website through an Ajax request without page reload and translatable error or success messages.

Installation:

Note: Check your theme's existing particles first. If you already have this particle there, then skip this installation unless you need to update to a latest version.

  1. Download Ajax Mailchimp particle from particles download area of RcaTheme.com
  2. Unzip/Extract the particle zip file on your PC and open the folder
  3. Copy particles folders to-
    1.  On Joomla: ROOT/templates/DEFAULT_TEMPLATE/ using an FTP client like FileZilla or using your cPanel File manager
    2.  On WordPress: ROOT/wp-content/themes/DEFAULT_THEME/
    3.  On Grav CMS:  ROOT/user/data/gantry5/themes/DEFAULT_THEME/
  4. Now it will copy/create required directories and files for this particle. If you're updating this particle to a latest version you need to confirm on the replace warning notification.
     

Usage:

Read how to add particles to your website here.

 

Mailchimp particle

  1. Form Action URL: go to https://kb.mailchimp.com/lists/signup-forms/host-your-own-signup-forms and follow their instructions. After creating your sign up form, copy form action URL(red text) here, example: (as shown on the docs) 
    <form action="https://mailchimp.us8.list-manage.com/subscribe/post" method="POST">
  2. User Id: Copy user id(red text) from the sign up form. Example:  
    <input type="hidden" name="u" value="a123cd45678ef90g7h1j7k9lm" />
  3. List Id: Copy list id(red text) from the sign up form. Example:  
    <input type="hidden" name="id" value="ab2c468d10" />
  4. Headline: You can add a headline and it will show before the sign up form.
  5. Description: You and a description and it will show after the Headline.
  6. Email Field Name: Copy email field name from your Mailchimp sign up form to here.
  7. Email Field Placeholder: Customize the placeholder text as you want.
  8. Show First Name: Enable/Disable First name field.
  9. First Name Field Name: Copy First Name/fname field name from your Mailchimp sign up form.
  10. First Name Field Placeholder: Customize the placeholder text as you want.
  11. Show Last Name: Enable/Disable First name field.
  12. Last Name Field Name: Copy Last Name/lname field name from your Mailchimp sign up form.
  13. Last Name Field Placeholder: Customize the placeholder text as you want.
  14. Button Text: Customize subscribe button text.
  15. Button Class: Add CSS class for subscribe button.
  16. Email Error: Customize error message for invalid email addresses.
  17. Unable to Subscribe: Customize unable to subscribe message.
  18. Already Subscribed: Customize already subscribed message.
  19. Thank You Message: Customize thank you message after a successful subscription.