Configuration

Description

This screen enables you to configure AcyMailing.

During the install process, AcyMailing will be automatically configured using your Joomla Configuration but you can modify it at any time.

You will also find a tool to easily publish/unpublish the AcyMailing plugins and add/modify the AcyMailing languages files.

Toolbar

• Custom Fields : This button enables you to access the custom fields interface.
  This feature is only available with AcyMailing Enterprise
• Bounce Handling : This button enables you to test the connection to your mailbox in order to handle bounce messages.
  If you click on this button, AcyMailing will try to connect to your mailbox so that you can make sure the connection is Ok.
  Then you will be able to handle the bounces by clicking on a link if your connection was successful.
  This feature is only available with AcyMailing Enterprise.
• Send a test : Save the configuration page and send a test e-mail to the currently logged in user (you!) using your configuration.
  This button enables you to make sure you can send e-mails using AcyMailing.
• Save : Save the configuration page and return to the AcyMailing Dashboard.
• Apply : Apply the modifications and stay on the same screen.
• Cancel : Return to the AcyMailing Dashboard.
• Help : This button enables you to turn ON/OFF the help section, this screen will appear or disappear.
• CPanel : This button enables you to access the AcyMailing Control Panel

Mail Configuration

Sender Information

• From Name : Default "From Name" used in all your Newsletters.
  You can modify this property for each Newsletter you write.
• From Address : Default E-mail address used as "from" in all your Newsletters.
  You can modify this property for each Newsletter you write.
• Reply-to Name : Default "Reply To Name" used in all your Newsletters.
  You can modify this property for each Newsletter you write.
• Reply-to Address : Default E-mail address used as "reply-to" in all your Newsletters.
  So, if your receivers click on "reply-to" when they read your e-mail, their response will be sent to this e-mail address.
  You can modify this property for each Newsletter you write.
• Bounce Address : All automatic response will be sent to this e-mail address.
  This e-mail address won't be visible for your receivers, it's only useful for server processing and will be used to check your spam score, send you the bounce e-mails (address not found, mailbox not available, mailbox full...).

• Add Names : If this option is turned ON, the sender and receiver name will appear in the sender/receiver information.
  If this option is turned OFF, only the e-mail address will be visible.
  For example: Acy will send the message to "Name " with the option turned ON whereas it will be sent to "email@example.com" with this option turned OFF.
  This option won't alter your Newsletter body/subject.

Mail Configuration

• Mailer Method : Mailer method used to send your e-mails.
  We recommend the PHP Mail Function but in some cases you might want to use an external SMTP Server (you can even use your own GMail account!).
  SMTP will be a little bit slower but you might decrease your spam score by using it.
• Encoding Format : Encoding format used for all your Newsletters. We recommend 8-Bit to reduce the spam score.
• Charset : Charset used for all your Newsletters. We recommend UTF-8 if you send english or international e-mails.
  We recommend to use the charset used in your country if your business is local.
• Word Wrapping : Some servers do not allow you to send e-mails with more than xx characters per line. This parameter enables you to set this limitation.
• Hostname : Sets the hostname to use in Message-Id and Received headers and as default HELO string. Leave this field empty if you don't know what is it.
• Embed Images : Should AcyMailing embed your pictures inside the Newsletter? If so, the send process will take more time but the recipient won't have to download the picture form your website in order to display it. By default, this option is set to NO so the pictures included in your Newsletter will stay on your own website.
• Embed Attachments : Should AcyMailing embed your attachments inside the Newsletter? If not, AcyMailing will add a list of attachments with a link to your website in order to download it.
  If you disable this option, the send process will be much faster as AcyMailing won't send the attachment but a simple link.
• Send Multiple Part : Should AcyMailing send multiple part e-mails? If so, AcyMailing will send the text and the html version in the e-mail so that depending on the recipient server, the appropriate version will be opened.
• DKIM : AcyMailing is able to sign your messages based on the DKIM protocol.

SMTP Configuration

• Server : Address of the SMTP Server. Example : smtp.gmail.com
• Port : Port used to connect to your SMTP Server.
  Leave this field empty if you don't know which port you should use. (GMail does use the port 465 because it's an SSL method)
• Secure Method : Should AcyMailing use an SMTP Secure Connection? For GMail, you should select SSL.
  This option should only be used if your SMTP server uses a secured sending method.
• Keep Alive : Should AcyMailing keep your SMTP Connection opened during the send Process?
  We recommend to turn ON this option. This option should be turned OFF only if you have problems.
  If you turn it OFF, AcyMailing will connect to your SMTP server, then send one e-mail and then close the connection. It will need reopen the connection with your SMTP server to send an other e-mail so it may consume a lot of time whereas if you turn this option ON, AcyMailing will open the connection with the SMTP server once, send the whole batch of e-mails and then close the connection.
• Authentication : If you enter a Username and a Password to connect to your SMTP Server, please turn ON this option.
• Username : Username used to connect to your SMTP Server.
• Password : Password used to connect to your SMTP Server.

Queue Process

Queue process

• Please read this article if you want to know how to configure AcyMailing to stay under your server limitations.
• Queue Processing : If you use the "automatic only" sending method, AcyMailing will always use the automatic process and won't even start the manual send process if you send an e-mail from the backend.
  This option is only available from AcyMailing Essential. If you use our Free version, you won't see this option and the send process can only be triggered manually and run on your own session.
  Please note that the send frequency should match with your cron frequency. This parameter is only there for security so your website can't be triggered too often.
• Automatic send process : Using the automatic send process, AcyMailing will automatically send X e-mails every Y minutes without you having to do anything.
  The send process will run on the background and not on your own session so you can turn off your computer and let Acy do the job.
• Manual send process : Using the manual send process, AcyMailing will send a batch of e-mails, then wait X seconds and send an other batch then wait X seconds and ...
  You can configure the time AcyMailing will wait between two batches.
• Re-queue delay : If AcyMailing cannot send an e-mail, AcyMailing will put it back in the queue and send it later.
  So, even if you reached your server limitations, AcyMailing will be able to continue the send process later.
• Maximum Number of Tries : If AcyMailing cannot send the e-mail after X tries, AcyMailing will delete the e-mail from the queue.
  Most of the time, that means the e-mail address is not correct so AcyMailing can also execute an action on the subscriber to not send him e-mails any more.
  This option is different from the bounce handling as it will be only applied if your server refuses to deliver the e-mail, not if the e-mail is delivered but then bounces because the receiver does not exist.

Cron

The automatic send process, the Newsletter generation, the Newsletter scheduling and the Follow-ups require a cron task.
You can either create a cron task on your own server or use our free service on Acyba.com to create one.
If you don't know how to set up a cron task on your own server or if you cannot make it work on your own server, don't bother with that and simply use our own free service.

• Next Run Time : Next time the Cron task is allowed to run.
  It does not mean that the cron task will run AcyMailing at this exact time. But it means AcyMailing will accept a cron url if it triggers AcyMailing after this time.
• Cron URL : Cron URL to trigger AcyMailing. You should use this URL to create your cron task.
  You can make sure it's a working url by clicking on the link.

• Send a report :When does AcyMailing should send a report?
• Send the report to : You can enter one or several e-mail addresses so that AcyMailing will send the report to those users (separate each e-mail address with a comma).
• Save the report : Which report should AcyMailing save in the log file?
• Save the report to : Location of the log file.

• Last Run Time : Last time AcyMailing executed actions via the cron url.
• Triggered from the IP : AcyMailing has been triggered by the following IP.
• Report : Latest report generated by AcyMailing.

Priority

• Newsletter priority : When AcyMailing queue your e-mails, AcyMailing will order them depending on the send date and the priority.
  So, if you want your Newsletter to be sent immediately, you can set up a lower priority number and it will be sent before the others.
• Follow-up priority : Priority for the Follow-up messages.
  Usually, you want those e-mails to be sent without delay. So they need a lower priority number.

• Priority level 1 is top priority
• Priority level 2 is important
• Priority level 3 is less important

Subscription

• Allow non logged in users : Do you allow simple visitors to subscribe to your Mailing Lists? If not, only logged in users will be able to subscribe.
• Require Confirmation : Should the user click on a confirmation link before being considered as a subscriber?
  If you require a confirmation, you can edit the confirmation e-mail using the button "Edit Confirmation Email".
  US users: You have to turn ON this option to be CAN-SPAM compliant.
• Auto-subscribe on Joomla registration : Using the "select" button, you can select the lists you want the user to be automatically subscribed to during the Joomla registration process (or any other component using the standard Joomla User registration system).
  This option works with the AcyMailing : auto-subscribe plugin so this plugin has to be enabled if you want it to work.
• Allow user data modifications without identification : When your users are not identified by the system, do you allow them to modify their subscription?
  If you select "No", then an identification message will be sent to the user with a link to enable him to modify his subscription.
  If you select "Only his subscription" then his subscription will be updated but not his personal data (name, receive html...).
  If you select "Yes", the subscription and the data will be updated without extra identification.

• When a new user is created, send an e-mail to : Send an e-mail to those e-mail addresses each time a new user is created from the front-end.
  You can edit the notification e-mail by clicking on the button "Edit Notification Email".
• When a user unsusbcribes from a list, send an e-mail to : Send an e-mail to those e-mail addresses if a user unsubscribes from at least one of your lists (from the module or from the unsubscribe link).
• When a user unsubscribes from all Lists, send an e-mail to : Send an e-mail to those e-mail addresses if a user unsubscribes from all your lists (from the unsubscribe link inserted in your Newsletter).
• When a user refuses to receive e-mails, send an e-mail to : Send an e-mail to those e-mail addresses if a user refuses to receive messages from your website.

• Redirection after subscription : Enter the url you want the user to be redirected to after he clicked on the subscribe button from the component view interface (accessible via a menu).
  This redirection does not affect the module subscription. Please edit your module if you want to set a redirection after the module subscription.
• Redirection after subscription modification : Enter the url you want the user to be redirected to after he clicked on the modify your subscription button from the component view interface (accessible via a menu or via the "modify your subscription" link inserted in your Newsletter).
  This redirection does not affect the module subscription. Please edit your module if you want to set a redirection after the module subscription.
• Redirection after Confirmation : Enter the url you want the user to be redirected to after he clicked on the confirmation link in the confirmation e-mail.
• Redirection after Unsubscription : Enter the url you want the user to be redirected to after he unsubscribes.
  This redirection URL does not apply to the Module Unsubscription! Please edit the AcyMailing module for that.

Interfaces

Messages

• Display a message on subscription : Should AcyMailing display a confirmation message when the user subscribes on your website?
• Display a message on confirmation : Should AcyMailing display a confirmation message when the user confirms his subscription?
• Display a message on unsubscription : Should AcyMailing display a confirmation message when the user unsubscribes from your website?
• Display a message when sending the confirmation e-mail : Should AcyMailing display a confirmation message when AcyMailing sends the confirmation e-mails?
• Display a message when sending the welcome e-mail : Should AcyMailing display a confirmation message when AcyMailing sends one or several welcome e-mails?
• Display a message when sending the unsubscribe e-mail : Should AcyMailing display a confirmation message when AcyMailing sends one or several unsubscribe e-mails?

CSS

• Module CSS File : Select the CSS file used for the AcyMailing module.
• Component Front-end CSS File : Select the CSS file used for the AcyMailing component on the front-end.
• Back-end CSS File : Select the CSS file used for the AcyMailing component on the back-end.
• You can edit each CSS file via this interface. Click on the button "Edit" and a popup will load with the existing file.
  AcyMailing won't apply the modifications on the default one but it will create a custom file and select it so that you won't loose your modifications if you update or upgrade AcyMailing.
  You will find all the AcyMailing CSS files in the folder media/com_acymailing/css/.

Features / Menu / Editor

• Enable the Forward capability : On all our commercial version you can add a "forward to a friend" link in your Newsletter.
  This option enables you to turn ON/OFF this feature.
• Use SEF Urls : When sending a Newsletter from the front-end (via the cron task for example), AcyMailing can transform your links to use SEF ones.

• Menu Linked to AcyMailing : Select the Menu you want to link to AcyMailing.
  Users having problems with access levels should select a menu which is opened to non registered users.
  Please always make sure you select a menu WITHOUT access level on it so that all your users will be able to access the unsubscribe page.
• Menu Position
  • Under the title: the AcyMailing back-end menu will be displayed just under the title.
    

    

  • Above the main area: the AcyMailing back-end menu will be displayed above the main content area.
    

    

    
    Most of the time you will keep the option set by default to "under the title" nevertheless in some cases you may want to display it above the main area (depending on your back-end Joomla template)

• Editor : Select the editor you want to use to edit all your AcyMailing E-mails.

Archive section

AcyMailing enables you to display archive Newsletters on your front-end.

Please create a new Joomla Menu, type "AcyMailing" and select one of the two available menus to display an archive section on your website.

• User Comments: If jComments or jomComment is installed on your Joomla website, you should see this option which will enable you to let your users add comments about your Newsletters.
• Display subject : By default your Newsletter subject will be displayed at the top of the Newsletter, you can decide to hide it by turning this option off.
• PDF Icon : You can add a PDF icon on your archive section so your users will be able to export your plain text version of the Newsletter.
• Print Icon : You can add a print icon on your archive section so your users will be able to print your Newsletter.
• Display the list description : AcyMailing will add your list description on your Newsletter listing, you can remove it with this option.
• Display table headings : On the Newsletter listing, AcyMailing will display some headings (subject, send date) that you can remove using this option.
• Display send-date column : Do you want AcyMailing to display your Newsletter's send date?
• Display Filter : Should AcyMailing display a search box so your users can search in your Newsletters?
• Open the archive is a popup : To you want the Newsletter to be opened in a popup instead of inside your Joomla template?
  This option does not affect the "view it online" link. If you want to change the "view it online" link, then you should access the website links plugin parameters.

Front-end edition

AcyMailing Enterprise enables you to manage your Newsletters from the front-end.

When you create a Newsletter via the front-end, the default sender information will be applied to this Newsletter.

Nevertheless you can change some options to apply the currently logged in user information in the Newsletter instead of the default ones.

• Logged-in User as Sender : Do you want the logged-in user to be specified by default as sender of the Newsletter?
• Logged-in User as Reply-to : Do you want the logged-in user to be specified by default as reply-to of the Newsletter?
• Allow modifications : Do you allow a user to edit the Newsletter created by an other user?
• Allow post-sent edit : Do you allow the user to edit the Newsletter after the Newsletter has been sent or scheduled?

Footer

AcyMailing won't add any brand on your Newsletters but you will see a link to our website at the bottom of some pages (not on our module!).
Using any of our versions, you will be able to remove this link.

• Display the brand : Display the AcyMailing footer on each page?
  Since AcyMailing 1.5.2, we decided to give you the freedom to remove this link even if you use our Starter version but please consider keeping this option enabled as it shows your support to our team and our project.

Security

• In all our commercial versions, you can add a captcha to the AcyMailing subscription form

Files

• Allowed Files : List of allowed file extensions for the attachments.
• Upload Folder : Folder in which the attachments will be uploaded to.
  Please make sure this folder is writeable otherwise AcyMailing won't be able to upload your files in it.

Plugins

This screen displays the list of plugins used by AcyMailing.

The first listing, "Plugins for the tag system", is a list of plugins called by AcyMailing before sending each message.

As a developer, you can develop new plugins to integrate anything in your Newsletter.

AcyMailing uses the Joomla Plugin System.

The second listing, "Integrations with AcyMailing", is a list of events called by other components which trigger AcyMailing.
You can edit the plugin AcyMailing : (auto)Subscribe during Joomla registration to display your lists on the Joomla registration page...
Please make sure this plugin is always enabled as it handles the synchronisation with your Joomla users.

You can click on each Enabled button in order to publish or unpublish each plugin.

Some plugins have parameters. You can click on the name of the plugin in order to edit those parameters.

If you click on each plugin, you will also see a "Help" button at the top of each plugin page so that you can know what each plugin does.

Languages

This listing displays the list of languages of your website (Front-End). For each language, you can edit the AcyMailing language file.

Most of languages files are included in the package so during the AcyMailing installation process, the language files are automatically installed so you don't have to do anything on your end.
Nevertheless some of the languages are not included in the package (we could not include them all, it takes too much space).
In that case you should click on the create button and the latest version of this language will be directly loaded from our website.
Then you simply have to save the language to have it on your website.

For any reason, if your language file could not be automatically installed, you can manually download it.

Please don't forget to share your translated language files so that we can include them in our next release.

Related Articles

• Configure your subscription module
• Configure your send process
• Configure your cron task
  
• Custom fields
  
• Captcha
  
• Bounce Handling
  

Available in all our commercial versions (Essential, Business and Enterprise)
Available in AcyMailing Business and Enterprise
Available in AcyMailing Enterprise only