Plugin: Matukio

Description

This plugin enables you to insert events (one by one or by a selection on one or several categories) from Matukio 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 commercial version 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, of course you can fully customize the way it is rendered:

Plugin

Single Event

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

Each event can be selected one by one.

• Format: Choose the way the event should be displayed (image on left/right, title on top, wrapping description or not...)

• Display pictures: Choose if you want to display or not the images and resize them if needed

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

• Custom Fields: Select the custom fields you also want to insert with the event

• Clickable Title: Choose if you want a link to be added to the title

• Read More: Choose if you want to add a "Read more" button at the end of the event. You should not add it if you selected "Book now button" in the "Display" area.

• Truncate the text after...: You can decide to truncate or not the description

• Additional parameters:

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

  • nbcols: By default, the information is displayed on one column, but you can display it on more columns if you use this parameter (for example |nbcols:2)

Upcoming Events

You can select one or several 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.

• Columns: You can decide to insert the events on one or more columns with this option

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

• Order by: Order the inserted events by id, title...

• From/To: AcyMailing will include events starting between the dates you specify. If you access this plugin for a Smart-Newsletter, you will be able to specify a delay instead of a fixed date. In the above example, Acy will insert events starting between the generating day and 3 weeks after.

• Additional parameters:

  • unpublished: If you use this parameter, Acy will also insert unpublished events

  • hotevent: If you use this parameter, Acy will insert only hot events

  • nohotevent: If you use this parameter, Acy will insert only not hot events

  • topevent: If you use this parameter, Acy will insert only top events

  • notopevent: If you use this parameter, Acy will insert only not top events

  • onlypaid: If you use this parameter, Acy will insert only paid events

  • onlyfree: If you use this parameter, Acy will insert only free events

  • recurring: If you use this parameter, Acy will insert only recurring events

  • norecurring: If you use this parameter, Acy will insert only non-recurring events

  • access: You can filter the events by access, for example |access:2

  • addcurrent: This parameter allows you to also insert already started events

  • todaysevent: With this parameter, Acy will insert only events starting in the sending date

  • start: You can specify a number X so Acy will insert the events starting by the Xth event (for example with |start:20, Acy will ignore the 20 first results)

Filter

You can filter your AcyMailing users based on if they booked one of your events. You can refine this filter with the status, the booking date and if the user paid or not:

Parameters

• Custom template: You can use this button to create a custom template for this plugin

• Display events: Select if you want to display only the published events in the tags popup

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

Customize your Event Booking 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 plugin directly otherwise your changes will be overwritten when you update the plugin.

Create the custom template as explained here, on the created file you can access to the element $varFields that contains all the needed data.

You can insert the event's information using this simple syntax : {title}, {shortdesc}, {description}, {image}, 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">{title}</h2>
    </a>
    <img alt="" src="{image}" /><br/>
    {contentText}<br/>
    From: {startdate}<br/>
    To: {enddate}<br/>
    At: {location}<br/>
    Capacity: {maxpupil}<br/>
    Price: {price}<br/> 
    Cut off date: {bookeddate}<br/> 
    One custom field: {cf|custom_field_alias}<br/> 
    {booknow} / {readmore}
</div>