Plugin : AdsManager

• Description
• Plugin
  • Single Ad
  • Ad categories
• Parameters
• Customize your Adsmanager Ad template
  • Customize your ad using some CSS
  • Create your own template

Description

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

You can also use this plugin to automatically include your newly created (or modified) Adsmanager Ads in an Auto-newsletter or a Newsletter.

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

The Adsmanager plugin has to be installed like a standard Joomla plugin.

Plugin

Single Item

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

Each Ad can be selected one by one.

• Display:
  
  • Title Only: only the title will be inserted
  • Text: only the title,description and images will be inserted
  • Full Text: the element will be inserted using the fields of the ad. This view can be customized (see below)
• Display pictures: You can decide to display or not this picture in your Newsletter (thumbnail or original image).
• Clickable Title: make your title clickable (so linked to your online version) or not.

Categories

You can select one or several Adsmanager categories and AcyMailing will automatically include the AdsManager items belonging to the selected categories.

• Maximum Number of Articles: The inserted tag will be replaced by a maximum of X Adsmanager Ads.
• Minimum Number of Articles: This option will only be displayed if you access this plugin for an Auto-Newsletter.
  AcyMailing will only generate your auto-Newsletter if the minimum number of Adsmanager Ads found is reached.
• Filter: This option will only be displayed if you access this plugin for an Auto-Newsletter.
  You can set a rule so that only newly created or modified Adsmanager ads are added to your Newsletter.

Parameters

• Display articles: This parameter enables you to filter the list of Adsmanager Ads in the tag system
  • All articles: AcyMailing will display all your Adsmanager Ads
  • Only published articles: AcyMailing will only display your published Adsmanager Ads
• Remove javascript: This option enables you to remove any javascript code included in your Adsmanager Ad as the javascript won't work in most of mail clients.

Customize your Adsmanager Ad template

Customize your ad 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 item
• Style for the content title will be applied to your content 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

Example:

Create your own template

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

Create a file in the folder media / com_acymailing / plugins (if the folder does not exists, please create it first).
The name of the file should be adsmanager.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 $article (which is the article object loaded from the content table) and the element $tag (which contains the information of the current tag used in your Newsletter)

By default the file should contain:

<?php

if(!empty($tag->link)){
$title = '<a href="'.$link.'" ';
$title .= 'target="_blank" >'.$styleTitle.$helper->showFieldValue($ad,$fields['ad_headline']).$styleTitleEnd.'</a>';
}else{
$title = $styleTitle.$helper->showFieldValue($ad,$fields['ad_headline']).$styleTitleEnd;
}
echo '<h2 class="acymailing_title">'.$title.'</h2>';
$imgpath = $this->_getimagepath($ad->id,$conf->nb_images,"thumb");
echo '<img src="'.$imgpath.'" style="float:right;margin:5px" />';
echo $helper->showFieldValue($ad,$fields['ad_text']);
foreach($fields as $name => $field) {
if (($name != 'ad_headline')&&($name != 'ad_text'))
echo $helper->showFieldValue($ad,$field);
}