Plugin: jEvents

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.

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

Here is an example of a simple event inserted in a newsletter:

Plugin

Single Event

Single Event

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

Each event can be selected one by one.

• Display: Select if you want to display ONLY the title or the entire event

• Read More: Add a "read more" link at the end of the item (so linked to your online version)

• Truncate the text after...: It will truncate the item's description, keep "0" or empty if you do not want to truncate it

• Display pictures: You can decide to display or not the pictures of the item (the description's pictures)

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

• Additional parameters:

  • Custom fields: If you installed the custom fields plugin of JEvents, an option to select individually the custom fields will be shown below the "Display" option

  • Language: If you have JoomFish or FaLang installed, an option to translate your events in the right language will be available next to the "Display" option

  • Files: If you installed the File plugin of JEvents, an option will be available below the "Display pictures" option to set if you want to add a link to these files

  • itemid: It will add the specified itemid in the links

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 between the from and to date/delay you specified.

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

• 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.

• Columns: The events will be inserted in 1, 2 or more columns, so X event per line.

• From: AcyMailing will only include events when their starting date is over than the date specified, or X hours/days/months after the sending date if you access this plugin for an auto-newsletter.

• To: AcyMailing will only include events when their starting date is less than the date specified, or X hours/days/months after the sending date if you access this plugin for an auto-newsletter.

• Additional parameters:

  • priority: You can insert a list of priorities, separated by a comma to filter your events, for example: {autojevents:15-26| clickable...| priority:1,3,4}

  • addcurrent: Adding this parameter will make the plugin to also insert already started events. {autojevents:15-26| clickable...| addcurent}

  • todaysevent: With this parameter, you can tell the plugin to insert only events starting within the sending date. {autojevents:15-26| cli...| todaysevent}

  • access: If you are using this plugin on a Joomla 2.5 or a Joomla 3.X site, you can filter the events by attached access. {autojevents:15-26| clic...| access:1}

Filter

With this plugin, you can also filter the users that booked one of your events if you installed the RSVP plugin:

Params

Parameters

Params

• 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 (only visible on a Joomla 1.5 site).

• Default max picture height/width: If you selected "resized" for the pictures option, if you kept empty the resize values the plugin will take a look at this default value.

• Itemid: You can specify here the itemid used in the links added to the inserted events

• Front-end Access: With this option you can restrict the access of this plugin on the Front-end

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 it.

Create a file in the the folder media / com_acymailing / plugins (if the folder does not exist, 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 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: {summary}

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

• your event date: {date}

• Event Location: {location}

• Event Contact: {contact}

• Event category: {category}

• the url of your event: {link}

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

• {street}

• {postcode}

• {city}

• {state}

• {country}

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

By default AcyMailing uses:

<div class="acymailing_content">
    <a style="text-decoration:none;" name="event-{rp_id}" target="_blank" href="{link}">
        <h2 class="acymailing_title">{summary}</h2>
    </a>
    <span class="eventdate">{date}</span><br />
    {description}<br />
    <span class="eventlocation">{location}</span><br />
    <span class="eventcontact">{contact}</span><br />
    <span class="eventextra">{extra_info}</span><br />
    {readmore}
</div>