EXT: Advanced Banner Management¶

What does it do?¶

This extension allows Backend users to add banners to the website.

Features:¶

• Support for Flash files, animated GIFs, images and custom HTML Code
• Show banner on all pages, single pages or groups of pages
• Show context sensitive banners using get-parameter matching

Click tracking for image and Flash banners

• Banners with internal or external links
• Time-controlled publishing of banners
• Display random banners
• Localization & versioning of banners
• Access limits for Frontend usergroups
• Modify appearance by specifying a maximum width and borders
• HTML template for each banner group
• Configurable locations for banners.
• Logging of impressions and clicks
• Banner groups in sysfolders
• Insert as plugin(content element) or directly into the template by TS

Screenshots¶

Screenshot of the banner creation (Image 1)

Installation¶

To use the extension, connect to the Extension Repository through your extension manager and install it by clicking the “plus” Icon (extkey:macina_banners).

Installation Configuration¶

Add Banner Categories¶

To group your banners, or for better maintenance create a sysfolder:Call it “Banner” and create your banner records in there.Note: Bannercategories can be added only to sysfolders.Note: To use the localization feature in the List Module create a translation of the sysfolder.

Click the “Create new record” and select Record Type “Banner Category”.

Edit the following data in the Categoriy Form

Add Banners¶

To group your banners and categories, or for better maintenance create a sysfolder:Call it “Banner” and create your banner records in there.Note: Banners can be added to every page, not only to sysfolders.Note: To use the localization feature in the List Module create a translation of the sysfolder.

Click the “Create new record” and select Record Type “banner”.

Edit the folowing data in the FlexForm (see Image 1)

Add banner module as content element¶

Switch to your Typo3 Backend and point the page module to the page where you want to add the Bannermodule.Click “new content”.Choose Bannermodule from the Plugins section:

Add Clicktracking to Flash banners¶

To add click tracking to your Flash banner, use the 2 Variables “clickTag” and “target” which are passed to the Flash banner via the OBJECT EMBED Tag.

Create a MovieClip with the InstanceName “content” and assign the following handler to the onRelease Event:

ActionScript 2 Code:

if (clickTAG.substr(0, 5) == "http:" || clickTAG.substr(0, 6) == "https:") {
        contentClip.onRelease = function() {
                getURL(clickTAG, target);
        };
}

Or create a Button and put the following script to your Button:

ActionScript 1 Code:

on (release) {
        if (clickTAG.substr(0,5) == "http:"| | clickTAG.substr(0, 6) == "https:") {
                getURL(_root.clickTAG, _root.target);
        }
}

Note: The ActionScript in this Flash banner is verifying that the clickTAG URL begins with “http:” or “https:”. This is an important security measure. If you do not take this precaution, a malicious HTML page could source your SWF and pass a clickTAG URL that begins with “javascript:” or another scripting pseudo-protocol. If your ActionScript code were to call getURL with a maliciously crafted JavaScript URL, it would be possible for the site serving the malicious HTML page to obtain the contents of your HTTP cookies or perform other actions on your site’s behalf.

Add banner module to template¶

As an alternative to the plugin method, you can add the banner module with TypoScript to your template.Note: You can add multiple modules to the page to use different locations like left, right, top and bottom.

temp.bannertop < plugin.tx_macinabanners_pi1
temp.bannertop {
        # show banners with this attribute, default options are: "top, left, bottom, right", all      Descriptions of Banner Categories can be used
        placement = top

        #mode to show banners. Options are: all, random
        mode = all

        # list of page IDs where the banners should be taken from (comma seperated. i.e.: 1,5,7)
        pidList = 18

        # levels of recursion to search for banners
        recursive = 0

        # Limit number of banners
        results_at_a_time = 3
}
marks.bannertop < temp.bannertop

temp.bannertop < plugin.tx_macinabanners_pi1
temp.bannertop {
    image {
             file = GIFBUILDER
           file {
                      XY = 468,60
                         10 = IMAGE
                  10.file = field_image
                  10.file.maxW = 468
                  10.file.minW = 468
                  10.file.maxH = 60
                   10.file.minH = 60
                   10.altText = field_alttext
                     10.align = c,c
              }
   }
}

Excludefields¶

The plugin has 6 Excludefields which can be added to user profiles to prevent Backend users from changing these banner settings:

• hide
• start
• stop
• access
• Impressions
• ClickCount

TypoScript¶

Reference (TypoScript)

HTML Template¶

The template is found in the path of your extension directiory:

typo3conf/ext/macina_banners/pi1/template.htm

To change the layout of your banner module, open the template with your favorite HTML editor, and modify it to suit your needs. To prevent the template from being overwritten when you upgrade the extension in the future, place a copy in an appropriate directory (i.e. /fileadmin/template/) and reference it in TS with the templateFile property.

Ver. 1.5.1¶

Ver. 1.5.0¶

Ver. 1.4.1¶

Ver. 1.4.0¶

Ver. 1.3.1¶

Ver. 1.3.0¶

Ver. 1.2.0¶

Ver. 1.0.0¶

Ver. 0.5.0¶

Ver. 0.4.0¶

Ver. 0.3.0¶

Ver. 0.1.1:¶

Ver. 0.1.0:¶

Ver. 0.0.8:¶

Ver. 0.0.7:¶

Ver. 0.0.6:¶

Ver. 0.0.5:¶

Ver. 0.0.4:¶

Ver. 0.0.3:¶

Ver. 0.0.2:¶

EXT: Advanced Banner Management - 9