collective.portlet.adsense 0.5

A portlet for google adsense

A Plone3 style portlet to use Google AdSense in a Plone site.

Features

Portlet AdSense allows to easily insert Google AdSense code in a Plone site using a dedicated portlet.

It also provides configuration options to:

use a pre-built Google AdSense slot code customize Ad colors customize PSA behaviour set test mode on

Requirements

• zope 2.10.x

• plone 3.x

Release notes

Tested on Plone 3.1. It should run on any Plone 3.x

Installing

Installing without buildout

You can install this package in either your system path packages or in the lib/python directory of your Zope instance. You can do this using either easy_install or via the setup.py script.

After installing the package it needs to be registered in your Zope instance. This can be done by putting a collective.portlet.adsense-configure.zcml file in the etc/pakage-includes directory with this content:

<include package="collective.portlet.adsense" />

or, alternatively, you can add that line to the configure.zcml in a package or Product that is already registered.

Installing with buildout

If you are using buildout to manage your instance installing collective.portlet.adsense is even simpler. You can install it by adding it to the eggs line for your instance:

[instance]
eggs = collective.portlet.adsense
zcml = collective.portlet.adsense

The last line tells buildout to generate a zcml snippet that tells Zope to configure collective.portlet.adsense.

If another package depends on the AdSense portlet egg or includes its zcml directly you do not need to specify anything in the buildout configuration: buildout will detect this automatically.

After updating the configuration you need to run the ‘’bin/buildout’’, which will take care of updating your system.

Usage notes

AdSense code and Size are always mandatory. AdSense slot code is optional; if an ad sense slot code is used its size and format should match the one choosen in the Size field.

Custom colors will override other choices

Alternate color and Alternate URL fields can be used to customize the Ad space behaviour in the event that Google is unable to serve targeted ads.

Full information on Google AdSense can be found in the Google AdSense documentation: https://www.google.com/adsense/support

Known bugs

No known bugs

Credits

Portlet AdSense developement by Francesco Merlo - [e-mail] Portlet AdSense contributions by Eleonora Borelli - [e-mail]

License

See docs/LICENSE.txt