Repository is archived
No commit activity in last 3 years
No release in over 3 years
Allows addition and independent management of rotating banners on pages.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 0.9.1
 Project Readme

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.