Version 5
Back to LATEST version Our site Forum Blog

Plugin: EasySocial

Description

This plugin enables you to insert users created with EasySocial in your Newsletters. You can also insert your different available profiles in order to promote your site if you just created it.

You can insert photo albums and events created by your users in your newsletters and auto-newsletters.

You can also insert user fields in the newsletters to personalize it.

If you purchased one of the paid version of AcyMailing, you can download the EasySocial plugin on our plugins section then install and publish it like a standard Joomla plugin.

Here is an example of inserted album:

Plugin

Users

You can use this interface to insert any EasySocial users in your Newsletter.

  • Max. Number of items: The inserted tag will be replaced by a maximum of X users.

  • Min. Number of items: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of users found is reached.

  • Columns: display the users in one, two or more columns

  • Filter: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created users are added to your Newsletter.

  • Order by: order the users by ID, name, etc...

  • Profile: With this option you can filter the inserted users by their EasySocial profile type

  • Clickable Title: Make the name clickable (so linked to your online version) or not.

  • Read More: Add a read more button at the end of the user's listing

  • Fields: Select the fields you want to show in the user's listing. Note that if you selected some fields that the user didn't fill in or field that do not belong to the user's profile type, it will not insert it for this user

Profiles

You can insert with this tab one or several EasySocial profile types so that the receivers can register to your site using EasySocial

  • Max. Number of items: The inserted tag will be replaced by a maximum of X profiles.

  • Min. Number of items: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of profiles found is reached.

  • Columns: display the profiles in one, two or more columns

  • Filter: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created profiles are added to your Newsletter.

  • Order by: order the profiles by ID, title, etc...

  • Truncate the text after...: Truncate the profile's description or not, keep this option empty if you don't want to truncate it.

  • Clickable Title: Make the title clickable (so linked to your online version) or not.

Albums

You can insert with this tab one or several albums in your newsletters or auto-newsletters

  • Max. Number of items: The inserted tag will be replaced by a maximum of X albums.

  • Min. Number of items: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of albums found is reached.

  • Columns: display the albums in one, two or more columns

  • Filter: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created albums are added to your Newsletter.

  • Order by: order the profiles by ID, title, etc...

  • Display: Select the information you want to add in the album's listing

  • Clickable Title: Make the title clickable (so linked to your online version) or not.

  • Read More: Add a read more button at the end of the album's listing

  • Display pictures: Choose if you want to display some images of the album and if you want to resize them in the newsletter. If you want to display some images, set how many images maximum you want to insert.

  • Truncate the text after...: Truncate the album's description or not, keep this option empty if you don't want to truncate it.

Events

You can insert with this tab one or several events in your newsletters or auto-newsletters

  • Max. Number of items: The inserted tag will be replaced by a maximum of X albums.

  • Columns: display the albums in one, two or more columns

  • From / To: With these options, you can tell the plugin to insert events starting between two specified dates. If you access this plugin for an auto-newsletter, you can specify two delays: in this example only events starting between 1 week and 5 months after the sending date will be inserted

  • Min. Number of items: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of events found is reached.

  • Order by: order the profiles by ID, title, etc...

  • Truncate the text after...: Truncate the event's description or not, keep this option empty if you don't want to truncate it.

  • Display: Select the information you want to add in the event's listing

  • Clickable Title: Make the title clickable (so linked to your online version) or not.

  • Read More: Add a read more button at the end of the event's listing

User Fields

You can insert with this tab some user fields taken from EasySocial, it allows you to create customized newsletters for each receivers only by adding one simple tag. Simply select the profile type where the field you want to insert is stored and then click on the field you want to insert.

Filters

With this plugin, you can filter your subscribers based on their EasySocial fields: select the EasySocial profile type, then the field you want to filter with, the operator and finally the value. If there are less than 100 different possible values, there will be some propositions like in this example.

Filter your subscribers by their EasySocial profile type and by when they registered.

Filter the subscribers by the groups they belong to. You can specify only the group category like in this example or directly the group itself (in this case the category dropdown will not be used). when clicking on the date fields, an area will appear to help you insert the dates, specific or relative.

Parameters

  • Front-end Access: You can choose to hide the EasySocial tab on the Front-end with this option

Customize your elements using some CSS

You can change the styles used for the title and the content area by editing your AcyMailing template.

Edit the AcyMailing template used for your Newsletter and then set some styles:

  • Style for the content area will be used to encompass your element

  • Style for the content title will be applied to your element's title

  • Style for the read more link will be applied to your read more link (if you have one)

  • You can also set the style of all your links using the Link a field

Set styles template

Create your own template

You can also modify the way your EasySocial elements are displayed by creating your own templates which will be used to render the elements. Please follow those instructions, we don't recommend you to modify the EasySocial plugin directly otherwise your changes will be overwritten when you update the plugin. Create your files in the the folder media / com_acymailing / plugins (if the folder does not exist, please create it first).

The name of the files should be:

  • easysocialuser.php for the users tags replacement

  • easysocialprofile.php for the profiles tags replacement

  • easysocialalbum.php for the albums tags replacement

  • easysocialevent.php for the events tags replacement

If one of these files is available on your server, AcyMailing will use it and won't use the default one.

On these files you can access the element $varFields (which contains all the information you should need) and the element $tag (which contains the information of the current tag used in your Newsletter)

You can insert the elements information using this simple syntax : {title}, {description}, ...

Here are some examples:

  • Users

<div class="acymailing_content easysocial_user"><a href="{link}" name="easysocial-user-{id}" target="_blank" ><h2 class="acymailing_title">{name}</h2></a>E-mail address: {email}<br/> Birthday: {birthday}<br/> EasySocial field: {easysocialfield}<br/> EasySocial field2: {easysocialfield2} </div>

  • Profiles

<div class="acymailing_content easysocial_profile"><a href="{link}" name="easysocial-profile-{id}" target="_blank" ><h2 class="acymailing_title">{title}</h2></a>{imagehtml}<br/>{description}<br/> Groups: {groups} </div>

  • Albums

<div class="acymailing_content easysocial_album"><a href="{link}" name="easysocial-album-{id}" target="_blank" ><h2 class="acymailing_title">{title}</h2></a> Author: {name}<br/> Created on: {created}<br/>{caption}<br/>{images} </div>

  • Events

<div class="acymailing_content easysocial_event"><a href="{link}" name="easysocial-event-{id}" target="_blank" ><h2 class="acymailing_title">{title}</h2></a> Author: {name}<br/>Starting on: {date_start}<br/>Ending on: {date_end}<br/>{description} </div>

Last updated