Plugin: jEvents

• Description
• Plugin
  • Single Event
  • Upcoming Events
• Parameters
• Customize your event template

Description

This plugin enables you to insert events (one by one or by a selection on one or several categories) from jEvents in your Newsletter.

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.

Plugin

Single Event

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

Each event can be selected one by one.

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 an Auto-Newsletter.
  AcyMailing will only generates your auto-Newsletter if the minimum number of events found is reached.

Parameters

• Hide Past Events : This option enables you to display or not the past events in the Event selection.
• Content Access : This option enables you to determine what kind of event access AcyMailing should include when you include events using the upcoming events feature.

Customize your event template

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 jevents 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 tagjevents.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 jevents_vevdetail and jevents_repetition tables).

You can display:

• the name of your event: $event->summary
• the description of your event: $event->datdescription
• your event date: $date
• Event Location: $event->location
• Event Contact: $event->contact
• Event category: $event->category
• the url of your event: $link

On top of that, if you use the locations addon for jEvents, you can use:

• $event->street
• $event->postcode
• $event->city
• $event->state
• $event->country

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

By default AcyMailing uses:

Show / hide php code

<?php $result = '<div class="acymailing_content"><a style="text-decoration:none;" name="event-'.$event->rp_id.'" target="_blank" href="'.$link.'">';
$result .= '<h2 class="acymailing_title">'.$event->summary.'</h2></a>';
$result .= '<span class="eventdate">'.$date.'</span>';
$result .= '<br />'.$event->description;
if(!empty($event->location)) $result .= '<br /><span class="eventlocation">'.$event->location.'</span>';
if(!empty($event->contact)) $result .= '<br /><span class="eventcontact">'.$event->contact.'</span>';
if(!empty($event->extra_info)) $result .= '<br /><span class="eventextra">'.$event->extra_info.'</span>';
$result .= '</div>';
echo $result; ?>