How to create a AcyMailing Optin Box

Published in EngageBox
Updated 04 Jan, 2020

There are three distinct methods to create a AcyMailing Optin Box with EngageBox. Each of them provides a different kind of flexibility and ease of use. Let's take a look.


1. Using Native Subcription Form

To use the Native Subscription Form method you should know first the AcyMailing's Subscription base URL which differs depending on the version you're using.

AcyMailing 5
https://www.site.com/index.php?option=com_acymailing&ctrl=sub&task=optin&hiddenlists=1,2,3
AcyMailing 6
https://www.site.com/index.php?option=com_acym&ctrl=frontusers&task=subscribe&hiddenlists=1,2,3

In the base URL you will need to modify the hiddenlists parameter. The hiddenlists parameter is a comma separated list of AcyMailing list IDs you'd like to add the user to. Lastly, don't forget to replace site.com with your site's URL.

To find the list IDs, go to Components -> AcyMailing -> Lists. The List IDs can be found on the last column of the Lists table as you can see in the screenshot below.

how to find the id of an acymailing list

Of course you don't have to use ALL the list IDs. You only have to use at least one.

Now that we know how to find the Submit URL, let's move on to setting up the actual box.

engagebox-acymailing-native-subscription-form

As you can see from the screenshot above, there are 4 things you need to take care of.

  1. Select Email Subscription Form from the Box Type drop-down list
  2. Type your Submit URL (check below on how to find it)
  3. Type user[email] for the Email Field Name input box
  4. Type user[name] for the Field 1 Name input box

Go on and set all the other box options if you need to customize it further and then click "Save"! You are done!

2. Using AcyMailing Module

To follow this method you need to have an AcyMailing module published and configured. Follow Acyba's Guide on how to do that if you are not familiar with it.

Then, as you can see in the screenshot below, create a new box with the type set to "Existing Module" and at the left side choose your AcyMailing module.

engagebox-acymailing-module

You can also write some text in the editor to appear right above the subscription form.

Finally, configure all the other options of your box you might be interested in and then click "Save"! You are done!

3. Using Convert Forms (Best Method)

Our Convert Forms extension makes creating an AcyMailing Opt-In Box an absolute breeze! This method is considered as the best of the three because of its use of AJAX for the form submission. By using AJAX the guest doesn't get disrupted from his current progress and therefore he stays as close as ever to his converting goal.

We have already created detailed documentation for each of the 3 needed steps. Take a look below!