Ad-minister quick-start

This page describes how to get up and running using Ad-minister by means of example. It only touches the surface of some of the features, which are documented in more details on this page

1. Adding ads in the widget sidebar

1.1 What we want to do

We want to add the following ad as a widget in the sidebar of our WordPress blog.

<a href="http://www.tearitdown.org" target="_blank" >
  <img src="http://www.tearitdown.org/english/
banners/125x125_english.gif" border="0" />
</a>

which looks like:

1.2 How it’s done

  1. After you have activated the ad-minister plugin on the Plugins page go to ‘Manage->Ad-minister’
  2. Now we need to add a widget position in the ‘Position/Widgets’ tab within which the ad can appear. Click ‘Add new widget position’.
  3. Fill out a name for the position, e.g. ‘Widget 1′. You can add an optional description if you want. You can also add code that appears before and after the ad that is placed withing the position. Click ‘Save position’ to store the information.
  4. The widget position now exists and needs to be moved onto the sidebar of your theme. This is done under Design->Widgets. The position we just created is seen as ‘Ad: Widget 1′, click add and then save you changes. The widget is now positioned onto your sidebar, but since we haven’t added anything to it yet, nothing shows up when you load your blog. Let’s go ahead and add some content.
  5. In Manage->Ad-minister under the ‘Create Content’ tab, you can add the advert. Pick a title for the ad, e.g. ‘Amnesty Insernational’.
  6. Paste the html code of the ad into the editor. If we want to track how many people that click on the banner, add ‘%tracker%’ before the http:// of the link. This means that the html of the ad will look like:
    <a href="%tracker%http://www.tearitdown.org" target="_blank" >
      <img src="http://www.tearitdown.org/english/
    banners/125x125_english.gif" border="0" />
    </a>
    
  7. Ignor the other options for now, and click ‘Save’.
  8. You are done!

If you add more content to that position, Ad-minister will rotate both ads so that each of them are shown 50% of the time. You can also go ahead and create how many widget positions as you wish. I find it’s a convenient way to add stuff to the sidebar without having to go into the templates and edit code.

49 Comments to “Ad-minister quick-start”

  1. gofree Says:

    Very very useful indeed.
    How about adding a widget attached with stylesheet to allow ads to to display together? Let’s say we instead of displaying one ad, we can group the ads in four.

    I guess you have seen this on other website.

    Thx

  2. Magpies Zone Says:

    Hello there, I have download this plugin but what if I want to use the tracking for the ads that is not in the widget sidebar? I have a banner ad on my blog now and when I try to just copy and paste the content code with %tracker%, it is being linked to my own site.

    Thx

  3. Henrik Melin Says:

    Magpies Zone: Do you mean a banner ad that lies outside the Ad-minister system? In general Ad-minister generates an internal url that counts the click, then forwards the user to the advertisers website.

  4. Spudman Says:

    Hi – Great plugin works fine except if I use %tracker% on a static page the hyperlink does not work. Any ideas?

  5. HotForWords Says:

    Are impressions accurate if I am using a caching program?

    Thanks!

    Marina

  6. dkmom Says:

    I can not get the ad widget to appear on the widgets sidebar. I’ve added the widget position and I see that it’s saved, but it doesn’t appear as an available widget. I’m looking in Design> Widgets>Available Widgets.
    I have the most recent version of WP.
    Thanks!
    Amber

  7. Girish Says:

    Hi,
    I have installed Ad-minister. How to show my advertisement. I gone through your process but its not working Can you plz help me…

  8. Ben Says:

    I am also having the same problem as Amber. I can create the widget position fine, but it doesn’t appear in the list of widgets. Also running WP 2.5.1

  9. lbordea Says:

    I have the same problem – the widget is not available to be added in WP 2.6.

  10. Chris Says:

    I also have the problem where the widget does not appear in the widgets list. Any update on a fix?

  11. Fernando Lopes Says:

    I translated the plugin, I put the language (ad-minister-pt_BR.mo) file in the directory ad-minister, but it didn’t work. How to solve?

  12. Peter Braswell Says:

    Really cool plug-in! Couldn’t figure out how to make this work by hacking the template files and you really provided a great little solution!!!

    -Peter

  13. Thanks Says:

    Thanks Works perfectly and capable of handling all our needs. Two thumbs up!

  14. mrheaven Says:

    This plugin is incredible!, I would like to know if you can now or in future versions include this banners in specifics Pages & post, if they can have random banners, and an area of statistics of visits,
    I very much appreciate the plug, can also help to translate into Spanish

    I appreciate the fabulous plugin

    regards

  15. Michael Says:

    This is a very powerful plugin. I would like to ask for one more capability though… it would be very helpful and useful to have the ability to specify that an ad only show in a specific archive category… if you could implement somehow a basic functionality of the “Who Sees Ads” plugin, that would make this a total solution.

  16. Peter Says:

    Hi,
    I can’t get it to work. Can’t even do step 2, which is to position the widgets.
    When I go to the management page I get:

    “Warning: array_keys() [function.array-keys]: The first argument should be an array in /home/sites/londonhuayu.co.uk/public_html/wp-content/plugins/ad-minister/ad-minister-functions.php on line 600″

    Any idea what is wrong?

    Peter

  17. Psychonaught Says:

    i just made this all work! so grateful for you creating this plugin! cheers and all the best!

  18. Psychonaught Says:

    works like charm! thanks!

  19. Terri J. Garofalo Says:

    I’ve activated the Ad-minister plug-in and I received this error code.

    I use Comic Press Plug-in. What I see when I click on setup or any of the buttons is “page not found”.

    This is the error that shows up.

    “Warning: array_keys() [function.array-keys]: The first argument should be an array in /mnt/local/home/tjgarofalo/entities-r-us.com/wp-content/plugins/ad-minister/ad-minister-functions.php on line 600

    Warning: Invalid argument supplied for foreach() in /mnt/local/home/tjgarofalo/entities-r-us.com/wp-content/plugins/ad-minister/ad-minister-functions.php on line 600

    No data available.”

    I’m not web code friendly, so if you have an answer, make it simple.

    Thanks alot!

    Tj

  20. Kal Ström Says:

    Terri: Please look for support in the forum instead.

  21. Deryk Wenaus Says:

    hi,

    I got your plugin to work in WPMU (the 2.6.5 version) . I simply did a search for tools.php and replaced it with edit.php. Also for some reason the default post (administer_post_id) was not being created so I added it in manually. Did the trick and now at least positions work in WPMU just fine.

    thanks for a great plugin. ps. you might want to add more descriptive tags to your widget on the wordpress website, it is hard to find. (ie. ads, ad, advertisements, ad rotator, advertising).

  22. Deryk Wenaus Says:

    interestingly, I also had the errors above, so that is why I added the administer_post_id manually, perhaps there is some logic error in your code there. seems a lot of people have that issue.

  23. Suzanne Says:

    Excellent plug-in that adds nice functionality to WP – thank you! But I’m curious as to why it’s counting one page load as 2, or sometimes 3, impressions. I set up a test, one position (template not widget) running to ads. The rotate beautifully, but for every page load, the impressions go up by two, sometimes by 3. There’s nothing fancy about my theme. The ad position is in the sidebar.

    Any guess as to why that’s happening?

  24. Tom Says:

    Hi, I have a problem with mo file. I translated po file and rename it ad-minister-pl_PL but i did’t work. Did I do somothing wrong?

    Thanks for your reply
    Regards Tom

  25. Rusted Says:

    2 Tom:
    change domain id ‘p2m-ad-manager’ to ‘ad-minister’ in function administer_translate in file ad-minister-functions.php.

    function administer_translate(){
    // Load a language
    load_plugin_textdomain(‘ad-minister’, PLUGINDIR . ‘/’ . dirname(plugin_basename (__FILE__)) );
    }

    Or simply rename your files p2m-ad-manager_pl_PL.*.

  26. kelley Says:

    I’m using a two column theme, activated ad-minister and positions widget. It showed up in right column, but took the place of my category and archive panels. I’ve deactivated the plugin for now, but is there a way to position the widget or ads below my archives, etc.?

  27. reza Says:

    i have showing my ads on my sidebar widget..yeah…
    first, i just the same like every body else, cant find the ad-minister widget once i saved the widget positioning….

    and here the solution…(works for me)

    go to ad-minister page,on “settings” tab, tick the option “make themes widget”, then click “update settings”. Done. i found my ad-minister widget on available widget.

    Note: i use wp 2.7

    hope this useful

  28. ricland Says:

    Multiple template positions.

    How do you do it.

    Everything else works fine

  29. Raveendran Says:

    Really cool work…

    But i want to put add(or widget) some other places except the right side. is it possible ?

  30. Dingo Says:

    I’m encountering the same problem as Magpies Zone. Entering %tracker%http://www.website.com tracks the clilck, but doesn’t redirect to the advertisers web site. Instead it re-directs back to my web site. I’ve tried this using widgets as well as in a template position.

    My current version of WordPress: 2.7.1

  31. Martin Majling Says:

    Hello , i have lite problem with rotating ads. in WP 2.7, , i have include the code into template and i have 2 banners addes and i will retate this in one position, , all get ok, Scheduele, impresion, clicks akk setting get 100% ok but the banners can not rotating . thanks for help.

  32. hari karki Says:

    hello!
    I’m not able to grab widget with newspro theme, how can I integrate manually,

    Will someone post me manual php code to integrate.

    thanks

  33. Kal Ström Says:

    @ricland, @raveendran: What you need to do is set up another sidebar in functions.php. Instructions: http://automattic.com/code/widgets/themes/

  34. masterp Says:

    masterp
    Member

    Hello,

    I need your help to resolve a bug with ad-minister.
    I upgrade WP 2.7 with the new 2.8.
    I have got 5 positions/widgets in ad-minister.
    When i want to integrate widget in the sidebar, i just allowed to integrate one of them. The others are not displayed…
    Before it was displayed as many widgets than i had in ad-minister.

    Thx for your help

  35. Mark Says:

    Love the plug-in! Is there a chance you could allow for two columns of ads in the sidebar? WP125 does this, but I am already using Ad-minister and like it a lot. Thank you for giving this some thought; it would be a great feature to have (1 or 2 columns, configurable from the menu)!

    All the best!
    Mark

  36. Kal Ström Says:

    This comment thread is not used for support at all.

    Try getting support from other users in the forum: http://labs.dagensskiva.com/forum/forum.php?id=2

  37. Luke Douglas Says:

    I followed the instruction #4 from above and I created 4 Widget Positions but I only have the first position showing on the Appearance / Widgets (WordPress 2.8.2). It works fine but how can I get the other 3 to be recognized. I checked the forums and other people are having this same problem but it seems there is very little activity on the forums.

    If anyone has a clue, fill me in!

    Luke

  38. Luke Douglas Says:

    Kal, the only reason I put my last comment here is that there seems to be no current activity on the forums and with no ability to view other Widget Positions, other than the 1st one I created, I have no way to have multiple ads unless I put more than 1 in each content item but then that defeats the purpose of having a counter for views and clicks. Honestly, I’m not sure ‘why’ it doesn’t add the other widget positions to the sidebar in Appearance/Widgets as it did the first one. Is there a limitation on positions?

  39. Gina Says:

    Hello,

    Is there a way to code positions by category? I would like to run different ads on the homepage and each of the category pages — i.e. business, distribution, power, etc.

    Thank you,
    Gina

  40. Ed Says:

    In my site, the ads show only in one instance, when I have 4 of them. I tried adding weight, but not sure that you explain exactly what you put for weight, numbers, letters?

    I’d like to show 4 ads at the same time instead of 1 and not sure how to make that happen since right now it only shows 1 random ad.

    Thanks,
    Ed

  41. thorsten Says:

    Hi,
    First of all, Great Plugin! i love it.
    I am seeing an error thought, which is that all the counts for the clicks are 0.
    is there a bug or anything specific i have to do in order to turn on the counting of clicks?

    thanks,
    thorsten

  42. ric ricland Says:

    Hey, you received all those donations including mine so you would update this fucking plugin and thousands of people who’ve been using it will be able to upgrade to wordpress to 2.8, thus making their websites far more secure.

    So, what exactly is your problem?

    Update this fucking plugin for 2.8, you lazy jackoff.

  43. Butch Hannan Says:

    I am on WordPress 2.8.6. My website has about 20 pages.I am running Google Adsense which is working well for me. I want to add afilliate adds below the Adsense ads. I have installed Ad Minister. Will it allow me to place adds on specified pages. At the moment if I place one add using the other widgets the same add appears on all 20 pages.
    Why is your widget not automatically displayed on the Dashboard column.

    Regards
    Butch Hannan

  44. Kamal Rauniar Says:

    Nice plugin, thanks

  45. Over 50 Says:

    Great Plugin

  46. mike Says:

    Does not work with v. 2.8.6 of WP. I can´t even make a widget position : /

  47. Clayton Says:

    Thank you! I was somewhat lost until I found this page! This is a very powerful program and I will send some moola your way as soon as I get my first paying advertisers!

  48. Clayton Says:

    It is Jan 2010 and I run the latest version of WP – this plugin works great.

  49. Kal Ström Says:

    That’s great. We’ve been having some widget problems. Not you?

Leave a Reply