Banner Rotator

The Banner Rotator extension, as its name implies, enables rotating banners on pages. Banners can be enabled and disabled for specific pages via the page-edit admin interface. One banner can be assigned to any number of pages. Banners are randomly selected based on weights you assign, between 1 and 10 – 1 being least likely, 10 most likely to appear. Banner rotation is enabled for a page in the “meta” drawer on the page-edit screen. When not directly associated with a page with banner rotator enabled, banners are inherited from the nearest ancestor page. Banners work by specifying a background image, with optional foreground image and link.

This extension does not support file uploads, and therefore should be used in concert with an asset management extension if direct file upload access is not available.

History

  • 2011-04-06 – add help doc, expand README, move banner list out of drawer, add pagination to index, other UI tweaks, gemify 1.0.0 release
  • 2010-12-30 – 0.9 compatibility, blade UI, i18n
  • 2010-11-17 – enabled admin ability to protect certain banners from deletion, by adding comma-delimited banner names to Radiant::Config[‘admin.protected_banners’]
  • 2009-06-22 – Deactivate banner functionality removes a banner from all pages
  • 2009-02-07 – 0.7 compatible
  • 2008-10-01 – First release

Installation

From the Radiant Extension Registry

  1. From your RAILS_ROOT run: 
    script/extension install banner_rotator
  2. Restart your app NOTE: In some earlier versions of Radiant, the migrations may not run, and the assets may not be copied and you may therefore need to run: 
    rake radiant:extensions:banner_rotator:migrate
rake radiant:extensions:banner_rotator:update
    

From Github

  1. From your RAILS_ROOT run: 
    cd vendor/extensions
git clone git://github.com/avonderluft/radiant-banner_rotator-extension.git ./banner_rotator
cd ../../
rake radiant:extensions:banner_rotator:migrate
rake radiant:extensions:banner_rotator:update
  2. Restart your app

Using the gem

  1. Install the gem 
    gem install radiant-banner_rotator-extension
  2. Update your Radiant config: add to environment.rb with other gem.configs 
    config.gem ‘radiant-banner_rotator-extension’, :lib => false
  3. Run database migrations 
    rake db:migrate:extensions
  4. Copy assets 
    rake radiant:extensions:update_all
  5. Restart your app

Usage

See HELP doc

To do

  • Extend pagination to other index views
  • javascript image popup in index view
  • Make banners and banner placements draftable via the concurrent_draft extension

Contributors

  • Sean Cribbs
  • Andrew vonderLuft
  • Jeffrey Jones

Acknowledgments

Thanks to Con-way for funding the initial development of this extension.