Plugin: EventList


You can also use this plugin to automatically include your upcoming events in an Auto-newsletter or a Newsletter.

You can search in all your events and then click on one of the events to include it in your Newsletter.

You can download this plugin from our download area if you purchased at least one of our commercial version.


Single Event

Single Event

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

Each event can be selected one by one.

Upcoming Events

Upcoming Events

You can select one or several event categories and AcyMailing will automatically include the upcoming events from the selected categories when their starting date is inferior to the maximum starting date you specified.

  • Maximum Number of Articles: The inserted tag will be replaced by a maximum of X events.

  • Maximum Starting Date: AcyMailing will only include events when their starting date is less than X days after the current time. You can define this delay using this parameter.

  • Minimum Number of Articles: 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.



  • Hide Past Events : This option enables you to display or not the past events in the Event selection.

Customize your event template

By default, AcyMailing will display your events like the following screenshot:

Event example

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

You can also modify the way your event is displayed by creating your own template which will be used to render the event. Please follow those instructions, we don't recommend you to modify the eventlist plugin directly otherwise your changes will be overwritten when you update AcyMailing.

Create a file in the the folder media / com_acymailing / plugins (if the folder does not exists, please create it first). The name of the file should be tageventlist.php If this file is available on your server, AcyMailing will use it and won't use the default one.

On this file you can access to the element $event (which is the event object loaded from the eventlist_events table).

You can display:

  • the name of your event: $event->title

  • the description of your event: $event->datdescription

  • your event date: $event->dates

  • Event Venue: $event->venue

  • Event City: $event->city

  • Event Country: $event->country

  • Localisation description: $event->locdescription

  • the url of your event: $link

Using all those variables, you can create your own product template.

By default AcyMailing uses:

echo '<div class="acymailing_content">'; 
    echo '<table cellspacing="0" cellpadding="0" border="0"><tr><td>'; 
echo '<a style="text-decoration:none;" name="event-'.$event->id.'" target="_blank" href="'.$link.'"><h2 class="acymailing_title">'.$event->title.'</h2></a>'; 
echo '<span class="eventdate">'.$date.'</span>'; 
echo '<br/>'.$event->datdescription; 
    $imageFile = file_exists(ACYMAILING_ROOT.'images'.DS.'eventlist'.DS.'events'.DS.'small'.DS.$event->datimage) ? ACYMAILING_LIVE.'images/eventlist/events/small/'.$event->datimage : ACYMAILING_LIVE.'images/eventlist/events/'.$event->datimage; 
    echo '</td><td style="padding-right:5px"><a style="text-decoration:none;border:0" target="_blank" href="'.$link.'" ><img src="'.$imageFile.'"/></a></td></tr></table>'; 
echo '</div>';

Last updated