An advertising manager mountable engine
Ruby JavaScript
Switch branches/tags
Nothing to show
Failed to load latest commit information.
app add @advertisement.keyword for edit page Sep 11, 2012
config added div back to showAd() function, changed order Aug 21, 2012
test minor cleanup Sep 6, 2012
Gemfile add therubyracer and uglifier gems, define assets for precompilation … Aug 23, 2012
MIT-LICENSE Update MIT-LICENSE Aug 15, 2012 slight refactor Sep 6, 2012
Rakefile Created Ad Manager Engine Aug 8, 2012
ad_man-0.0.13.gem update the gem to version 13 Nov 27, 2012
ad_man.gemspec modified ad_select to accept 'all' keyword, returning all ads Aug 21, 2012


Build Status Code Climate

Ad_man is an advertising manager mountable engine. It allows the user to upload and manage advertising banners, and provides an easy to use helper for inserting the banners on your website. Also counts the number of times an ad has shown, and the number of times an advertisement has been clicked on. The user must set a keyword for each ad.

Currently supports two image sizes for advertising: Leaderboard 728 x 90 and Banner 468 x 60. TODO: Will implement 9 different sizes as mentioned by google's adwords requirements.

Requires Paperclip 3.1, and requires ImageMagick be running on the server.

Getting started

Ad_man works with Rails 3.2 onwards. You can add it to your Gemfile with:

gem 'ad_man'

After you install Ad_man and add it to your Gemfile, you need to run the generator:

rails generate ad_man:install

This will install the migrations and a few controller files, then just rake the database:

rake db:migrate

See where Ad_man is located by running:

rake routes

In our case, we needed to move the line generated by the install in the routes file to our admin space. Then add any before_filters to the controllers that were generated.

Make sure to change references to the application using the main_app helper:

<%= link_to "Home", main_app.root_path %>
<%= link_to "Advertising", main_app.ad_man_path %>

Changing default values

If you need to change the default values set by ad_man, you will need to create an ad_man.rb initializer in your config/initializers folder.

# AdMan Default Values
AdMan.leaderboard_size = "728x90"
AdMan.banner_size = "468x60"
AdMan.mobile_leaderboard_size = "320X50"
AdMan.square_size = "250X250"
AdMan.small_square_size = "200X200"
AdMan.large_rectangle_size = "336X280"
AdMan.inline_rectangle_size = "300X250"
AdMan.skyscraper_size = "120X600"
AdMan.wide_skyscraper_size = "160X600"

AdMan.max_image_size = 50 # 50Kb maximum image size

# These are configurable dimensions (currently leaderboard default)
AdMan.image_dimensions_width = 728
AdMan.image_dimensions_height = 90

# Configurable content type for advertising
AdMan.content_type = ["image/jpg", "image/bmp", "image/png", "image/gif", "image/jpeg"]

# Configurable max advertising for keyword
AdMan.max_count = 6

Putting an advertisement in the view

To put your advertisement in the view just add:

<%= link_to_ad %>

Currently there are three parameters that can control which ads get shown on your page. :keyword, :size, and :display_on_all_pages.

<%= link_to_ad :keyword => "Your Keyword", :size => "leaderboard", :display_on_all_pages => false %>

Ad_man and Javascript

Ad_man supports inserting an advertisement using jQuery. It also uses jQuery in the backend when creating new ads. To use this functionality, include this line in the view:

<%= javascript_include_tag "ad_man/advertisements.js" %>

You can pass a <DIV> id element, the keyword name, and size to show an advertisement using the showAd(); function. Currently supported sizes are: leaderboard and banner.

AdMan.showAd('div_id', 'keyword', 'size');

Then make sure you have a <DIV> element with the div_id you gave to the showAd function.

<div id="banner_ad"></div>


Written by David Strand and Tyler Hu


Matenia Rossides

Copyright & Licensing

This project is maintained by an intern team of developers and is freely available for commercial use under the terms of the MIT License.