Installation

Visit your WordPress admin, Plugins => add new, search for Holler Box. Install and activate this plugin. You can also download it here.

Visit the Holler Box menu item, and add a new box. Give it a title (not displayed on the front end), and add your content.

Content can be pretty much anything, but keep your message short.

Display

  • Activate: Choose to activate this item on publish.
  • Position: the notification position, or banner
  • Choose your colors
  • Show email opt-in: default sends to your email address, or choose a provider or custom HTML form. Details below.
  • Default: sends to the email address you enter in the settings.
  • – MailChimp integration: add your API key in the settings, then your list ID (Get your list ID in your MailChimp account under Lists => Settings => List name and defaults => List ID on right side of screen)
  • Convertkit: visit Holler Box => Settings, enter your API key. Choose Convertkit when creating your new Holler Box, then enter your form ID. Find your form ID by visiting your signup form, then copy the numbers in the url (or in the embed code).
  • Show chat: show the (fake) live chat

Advanced Settings

  • Pages: choose all pages, or select certain pages and begin typing a page title. It will automatically populate a drop down list, simply click the page title or enter page titles comma separated like this: Home, Features, Pricing
  • New or returning: show to only new visitors (since you activated the plugin), or returning visitors. Tracked with the hwp_visit cookie.
  • When should we show: after the page loads, show immediately, with a delay, or based on user scroll.
  • When should it disappear: if you want the notification to show briefly and then disappear automatically, enter a delay here.
  • How often show we show it: a visitor will be shown your message, then you can choose to continue showing it, or hide it based on number of days or user interaction. Interaction is either submitting an email, or clicking a link with a class of hwp-interaction.
  • Hide the button: the button appears when the notification is hidden, you can choose to not display the button. If the notification is hidden, the user will not be able to reopen it.
  • Gravatar email: enter an email associated with a Gravatar account, or leave blank to hide the avatar.

Frequently Asked Questions

Does it use the wp_mail() function to send mail?

Yes, if you have an SMTP plugin like Postman, Mailgun, or other mail plugin it will automatically use that to send mail.

How do I setup MailChimp?

First, add your API key under Holler Box => Settings.

You can find your API key in your MailChimp account under Account => Extras => API Keys. Generate a new one if it doesn’t exist.

Save your API key.

Next, in your Holler Box, choose Mailchimp as the opt-in provider. Add your list ID. You can find this under Lists => Your List => Settings => List name and defaults. Look on the right side of the screen for List ID.

Copy/paste that into the MailChimp list ID field and save.

How do I find my Convertkit form ID and API key?

Your API key is on your account page.

To get your form ID, visit Forms => your form. Look in the browser address bar, it should be something like this:

https://app.convertkit.com/landing_pages/445667/edit

That number is the form ID, in this case it’s 445667. Enter that number as the Convertkit form ID.

Troubleshooting

  • Emails are not sending – The wp_mail() function is unreliable on many hosts. Install Postman or another SMTP plugin to use a more reliable mail service.
  • Email signups are not working – Make sure your email form does not have a required field that is not displayed. For example, if you required first and last name, it will not work. Change your form to only require email, the rest of the fields optional. If you need extra fields, use the custom HTML form option.