plugin: RSEvents Pro

Description

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

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

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

If you purchased at least one of the commercial versions of AcyMailing, you can download this plugin on our plugins section, then install and publish it like a standard Joomla plugin.

Your events will look like this in your newsletter, but you can of course customize the way it is inserted :

Plugin

Single Event

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

Each event can be selected one by one.

• Displayed fields: Select the way you want to display your event

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

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

• Display pictures: You can decide to display or not the pictures in your event's description.

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

• Additional parameters:

  • itemid: You can specify the Itemid used in the event's links

  • noenddate: If you only want to display the event's starting date

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" date and "To" date 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: Display the events in one, two or more columns

• Order by: Order the inserted events by id, title, starting date, creation date or randomly.

• From/To: AcyMailing will only include events that start between the two dates specified, or between the two delays specified (depending on if you access this page for an auto-newsletter or a simple newsletter).

• Additional parameters:

  • featured: Insert only featured events, for example: {autorseventspro:|option1:value1....| featured....| option2:value2}

  • nofeatured: Prevent the tag to insert featured events.

  • todaysevent: It will take only events starting within the sending day

  • addcurrent: The plugin will also add already started events

  • created: It will insert only newly created events (created between the last sending date and the current sending date)

Parameters

• Hide Past Events: You can choose to hide past events in the popup for event selection

• Category table: Search the event categories in the Joomla table or in the RSEvents Pro's one?

• Max picture width/height: If you selected "resized" for the pictures but kept empty the resizing values, the plugin will take these ones

• Default Itemid: You can specify here the itemid used in all the events links

• Front-end Access: You can choose to hide this plugin's tab on the Front-end's tag popup

Customize your RSEvents Pro events template

Customize your event 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 content

• Style for the content title will be applied to the 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 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 RSEvents Pro plugin directly otherwise your changes will be overwritten when you update the plugin.

Create a file in the folder media / com_acymailing / plugins (if the folder does not exist, please create it first). The name of the file should be rseventspro.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 $varFields (which contains all the event information), the element $tag (which contains the information of the current tag used in your Newsletter) and $link (the event link)

You can insert the event's information using this simple syntax : {name}, {description}, or {link}

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

Here is an example:

<div class="acymailing_content">
    <a href="{link}" target="_blank" >
        <h2 class="acymailing_title">{name}</h2>
    </a>
    {picthtml}<br/>
    {description}<br/>
    From: {start}<br/>
    To: {end}<br/>
    At: {location}
</div>