Back to LATEST versionOur siteForumBlog

plugin: AcyMailing toolbox

Description

This plugin enables you to include tags in your Joomla website which will be replaced by content loaded from the AcyMailing tables.

This plugin also enables you to insert an AcyMailing newsletter inside a Joomla! article by using a simple tag.

You can download this plugin on our plugins section then install and publish it like a standard Joomla plugin.

Display the number of users on your mailing list

To display the number of users you have in all your mailing lists, you should insert the tag: {acymailing:count}

Additional parameters:

  • listid: This parameter enables you to specify the ID of the list so the tag will count only users subscribed to the specified list. For example, you can add display the number of users subscribed to the mailing list ID 3 by using the tag: {acymailing:count|listid:3}

  • where: You can filter the users based on their custom fields values. Write the field namekey, then the operator (=, !=, LIKE, <, >, <= or >=) then the value, separated by a coma. If you want to insert several conditions, separate them by a semicolon. For example:

    • {acymailing:count|where:subid,>,500;city,LIKE,York}

Display a list of users (with their name, email...)

To display a list of subscribers on your website, you can insert the tag: {acymailing:users} This tag will display the name of your last 50 users inserted in AcyMailing.

Additional parameters:

  • fields : This parameter enables you to display the fields you want. By default this parameter is set to the user name but if you want to display the user name and email, you should use the tag: {acymailing:users|fields:name,email}

  • limit : This parameter enables you to specify the number of users you want to show. By default this parameter is set to 50 so only the last 50 users will be displayed by you can modify it to display more or less users. For example the tag {acymailing:users|limit:10} will display the name of your last 10 users.

  • order : This parameter enables you to specify the ordering. By default the plugin will display the latest inserted users but you can modify it to select the oldest users or based on an alphabetical ordering. For example the tag {acymailing:users|order:name ASC} will display the first 50 user's name in alphabetical order.

  • confirmed : You can add this parameter to only display confirmed users. For example : {acymailing:users|confirmed}

  • listid : This parameter enables you to display only users subscribed to the specified list. For example : {acymailing:users|listid:3} will display the last 50 users subscribed to your list ID 3.

  • header : This parameter will enable you to show a table header with the name of each field For example {acymailing:users|header} will display the name of the last 50 users inserted in AcyMailing with the header "name" on top of the column.

  • width : This parameter enables you to set the width of each column. For example {acymailing:users|width:70} will force the columns to be 70px width.

  • width_FIELDNAME : If you have a special column you want to resize, you can use this parameter to set the width of a specific column based on its field name. For example {acymailing:users|width:70|width_email:90|fields:name,email} will display a list of users (its name and email), the name column will be 70px width and the email column will be 90px width.

  • label_FIELDNAME : If you display the table header, you may not want Acy to use the column name in the header so you can specify your own text using this option. For example {acymailing:users|label_name:Your beautiful Name!|header} will display a list of 50 user's name with the text "Your beautiful Name!" on top of the name column.

  • where: You can filter the users based on their custom fields values. Write the field namekey, then the operator (=, !=, LIKE, <, >, <= or >=) then the value, separated by a coma. If you want to insert several conditions, separate them by a semicolon. For example:

    • {acymailing:users|where:subid,>,500;city,LIKE,York}

Example : This tag will display the name and email address of the last 20 users with a custom header name and size: {acymailing:users|fields:name,email|limit:20|header|width:150|width_email:300|label_name:Name|label_email:Email Address}

Display users on your Joomla articles

Display a field from the currently logged in user (its name, email...)

If you have a page with a restricted access to Joomla logged in users only, you can use this plugin to display AcyMailing user profile information about this user.

You can insert the tag {acymailing:userinfo|field:name} to display the name of the current logged in user in your content.

Additional parameters:

  • field : The field parameter enables you to select the field you want to display. For example {acymailing:userinfo|field:email} will display the email address of the currently logged in user.

Insert newsletters in your Joomla articles

Specific newsletter

If you want to insert a specific newsletter, you'll have to first get its ID. You can find it in Components => AcyMailing => Newsletters (or Smart-Newsletters) :

Then when editing a Joomla article, insert the tag {acy:NEWSLETTER_ID}, for example:

Latest newsletter

You can choose to insert the latest sent newsletter using "0" instead of the newsletter ID, so this tag: {acy:0}. Note that it will only take a published and visible newsletter.

You can also add a filter so that it will take the latest newsletter sent to a specific list. You can get the list ID in the page Components => AcyMailing => Lists :

For example with the list "Newsletters", your tag will be {acy:0|list:1}

Last updated