Ad Rotator

Posted by Dmytro Shteflyuk on

Ad Rotator is a simple WordPress widget to display random HTML code from a given group of HTML-chunks separated with <!--more--> on sidebar. Basically it shows different HTML every time you requesting page. There are infinite number of instances of this widget may exist.


  1. Download and unpack plugin files to wp-content/plugins/ad-rotator/ directory.

  2. Enable Ad Rotator plugin on your Plugins page in Site Admin.

  3. Go to the Appearence/Widgets page in Site Admin and drag as many Ad Rotator widgets to your sidebars as you wish. Configure instances separating HTML blocks with <!--more-->. Save changes.

    Ad Rotator widget configuration

    Sidebar with Ad Rotator widgets

  4. Now on Ad Rotator blocks should appear on your sidebars.

Migrating from AdRotator plugin

AdRotator plugin is a simple file-based ad rotation solution. It was developed by Angsuman Chakraborty long time ago, but occasionally we have the same plugin names from WordPress’ point of view. If you are using this plugin, you may click upgrade link from your Plugins page and it being replaced with Ad Rotator widget.

So now you have two ways to solve the problem 'getad()' function is undefined:

  1. You can download AdRotator and ignore upgrade notices, or

  2. You can upgrade your theme to use Ad Rotator Widget.

Here is how to upgrade your theme. Find all occurrences of getad function,
and replace them with something like this:

  'name' => 'ad-area',
  'id' => 'ad-area',
  'before_widget' => '',
  'after_widget' => '',
  'before_title' => '',
  'after_title' => ''

Make sure you’ve replaced ad-area with the name suitable for you. Also
you can specify additional options, like before_title and after_title.

Then open the Appearence/Widgets page in Site Admin and configure Ad Rotator widget instances for your advertisements area. Just take into account, that in files for AdRotator ads are separated with new line character (ie each line means separate ad), but in Ad Rotator widget you should separate you blocks with <!--more--> (so each of them may contain more then one line.)

Anyways, sorry for сonfusion, I did not want to сheat on you.


Plugin requires the WordPress version 2.8.0. Be sure your theme supports sidebar widgets.


Latest version of “Ad Rotator” is 2.0.3, and it can be downloaded here:

version2.0.3DownloadAd Rotator

If you have any propositions, want to send feedback or found bugs, please post comments. It’s very important for me!

Frequently Asked Questions

Q. How to enter several ads to a single text box?
A. Separate your ad blocks with <!--more--> sequence.

Q. How many ads every instance of widget could handle?
A. Number of advertisements in each instance is unlimited.

Q. Can I use Google AdSense code as one of my ads?
A. Of course, you can use any HTML you wish (AdSense, Clicksor, Chitika, and everything else).

Q. WordPress shows `’getad()’ function is undefined` error
A. See explanation in Migrating from AdRotator plugin section.


  • 2.0.3 (July 30, 2009)
    • Fixed problem with backslashes appearing inside HTML (thanks to Maxx Kremer).
  • 2.0.2 (July 29, 2009)
    • Added section Migrating from AdRotator plugin in readme.txt.
  • 2.0.1 (July 29, 2009)
    • Fixed Installation section in readme.txt.
    • Filter out HTML when user has no rights to edit unfiltered HTML.
  • 2.0.0 (July 29, 2009)
    • Completely rewritten using new WordPress 2.8 widgets API.
    • Readme.txt file and couple of screenshots added.
  • 1.0.1 (March 31, 2007)
    • Plugin home page updated.
  • 1.0.0 (May 1, 2006)
    • Initial plugin implementation.

Other plugins

Full list of plugins I have implemented is available here.

95 Responses to this entry

Subscribe to comments with RSS or TrackBack to 'Ad Rotator'.

said on September 12th, 2008 at 07:08 · Permalink · Reply

Please excuse my naivete, but I have installed the widget but I have a question.

I understand that I am supposed to take the “html code” and add it to the widget. My question is where do I get the code from? Do I need to sign up somewhere? When I unzipped the file, there was only a widget.php file. Is there something I missed? I’m using WordPress 2.5.1.

Any ideas?

Thanks in advance for the help!


said on October 14th, 2008 at 23:19 · Permalink · Reply

Just wondering why the code would pull a random Google ad from elsewhere in the page, even though the code is not listed in the ad rotator widget.

said on December 30th, 2008 at 17:34 · Permalink · Reply


Sorry the link doesn’t exist, well i can’t download, i trying but i can’t, somebody can see, what happened please.

said on February 4th, 2009 at 15:50 · Permalink · Reply

i was add something to my adrotator then this is what i’ve got. can somebody please help how should i fix this?

Fatal error: Cannot use string offset as an array in /home/public_html/wp-content/plugins/adrotator.php on line 44
said on February 16th, 2009 at 23:10 · Permalink · Reply

What a fantastic widget! I have been looking high and low for a widget that you could put custom HTML instead of just text, and this is it! You could advertise this as a custom HTML widget as well, cause I know I can’t be the only one looking for it.

said on March 5th, 2009 at 00:18 · Permalink · Reply

hi there can any one tell me how to Random Ad Rotator to evenly Ad Rotator. please i need it in my webpress

said on March 25th, 2009 at 17:54 · Permalink · Reply

I have wordpress 2.7 and there is no “configure” button showing. Can anyone please tell me how to run multiple instances?

said on May 12th, 2009 at 23:33 · Permalink · Reply

Hi. is there soemthing wrong witht he plugin?

After installing it wont let me activate it. is the version still compatible. im using wordpress 2.7.

I made this web site. It’s all about celebrity news and gossip…So I’d appreciate your opinion on web site, this ad widget sounds cool.

said on May 19th, 2009 at 07:28 · Permalink · Reply

I’m getting the same “Fatal error: Cannot use string offset as an array” problem as Mimi above. It happens when I try to go to my “Widgets” page in wp-admin. It used to work fine, now it doesn’t. I tried erasing the data in Mysql but it didn’t work. Suggestions please? It was such a useful plugin.

said on June 18th, 2009 at 07:14 · Permalink · Reply

I did a fresh install of wordpress 2.8 and when I go to add more ad-rotator widgets it won’t add anymore than just one. Any ideas on a quick fix?


said on June 27th, 2009 at 02:03 · Permalink · Reply

Right now I have 3 ad rotator widgets that are all working fairly well however, I want more. I have tried to request more using the “how many do you want” option but no matter how many I choose none appear. What am I doing wrong?

Jason Rogers
said on July 3rd, 2009 at 07:44 · Permalink · Reply

This widget doesn’t work in multi-mode in wp2.8 anymore, as they have changed the way widgets are created and coded from 2.8 and on:

Might want to update it and maybe, just maybe submit it to the WordPress Plugin database so we can find the updated version on there too… it would be a waste if you didn’t and left the widget here to die.

said on July 10th, 2009 at 13:10 · Permalink · Reply

Prior to upgrading to WordPress 2.8, Ad Rotator had the option to select multiple instances of the plugin. Now the selection for multiple instances is still there but no additional Ad Rotators appear after choosing a number of extra copies. Is this something that can be tweaked in the plugin to make it compatible or is this a bug to be pursued at

said on July 19th, 2009 at 17:49 · Permalink · Reply

Hello?? Is this plugin going to be upgraded to work in multi-mode?

said on July 29th, 2009 at 22:22 · Permalink · Reply

Um.. I ran into that WP upgrade error because I am using the real AdRotator. You should change the name so your widget doesn’t do that.

said on July 30th, 2009 at 01:09 · Permalink · Reply

Cole, I’m not sure that this is the best solution. This widget is more than 3 years old, so it has his own users, and I am not ready to stop providing them a good solution for this day-to-day problem.

said on July 30th, 2009 at 01:16 · Permalink · Reply

Hi Dmytro,

Thanks for updating the plugin. This is a great plugin that I would be lost without!

Kudos to you!

said on July 30th, 2009 at 06:31 · Permalink · Reply

I’m having an issue since the upgrade — backslashes are now appearing before all of my double-quotes and apostrophes.

Look in my sidebar under “Rave Reviews” to see what I mean.

said on July 30th, 2009 at 08:31 · Permalink · Reply

Where is 2.0.3? I just downloaded the plugin and it appears to still be 2.0.2 and still the same issue with backslashes.

said on July 30th, 2009 at 16:26 · Permalink · Reply

Thanks Dmytro! Greatly appreciated. Where is your PayPal donation link?

said on July 31st, 2009 at 00:03 · Permalink · Reply


Is there any way to stop the plugin from trying to escape quotes when you add some html? I am trying to add a banner image withing a link and it doesn’t show up because the plugin automatically escapes the quotes.


said on July 31st, 2009 at 04:00 · Permalink · Reply

How do I have the rotating ads show up in my Theme? I did not understand the directions. I created a TXT file with the HTML for images and links, and uploaded it to the wp-content folder. Is this method still used with this new version?

said on August 3rd, 2009 at 06:56 · Permalink · Reply

I just updated and I’ve had a few issues. First, the update essentially deleted all my existing rotators. Luckily I was planning on changing the ads anyway. Now, as I’m starting over, the rotators are showing multiple ads stacked on each other with (!–more–) between them.

said on August 8th, 2009 at 09:52 · Permalink · Reply

Hi Dmytro, I must be pretty thick!!…I have finally been able to get the first image to appear, but the images won’t rotate. Can you please take a look at the code below and tell me what I am doing wrong? Thanks, Steve


said on August 20th, 2009 at 13:31 · Permalink · Reply

Hey Steve,

Could you contact me directly at [email protected]?

said on August 8th, 2009 at 10:03 · Permalink · Reply

I have changed my code since last post as the images were all running in-line down the column…current code looks like this, but still no rotating…Regards, Steve


said on August 15th, 2009 at 05:19 · Permalink · Reply

Can I enter another web site widget code into the rotator? I’d like to enter widgets like weather and stuff and have them rotate. Thanks.

said on August 27th, 2009 at 08:41 · Permalink · Reply

I’m getting this error when I try to activate the plugin:

Fatal error: Class ‘WP_Widget’ not found in /zine/wp-content/plugins/ad-rotator/adrotator.php on line 28

How might I go about fixing it?

said on August 27th, 2009 at 10:26 · Permalink · Reply

Looks like you are using outdated WordPress version. You should update it to at least 2.8.0 to use this plugin. And I think you should do the upgrade, because there are many known security holes in old version, and your blog could be hacked by someone.

said on August 31st, 2009 at 04:44 · Permalink · Reply

I’m using this plugin in all of my websites.. The beauty is this will decrease down the ad blindness and users tends to click more on ads..More over other benifit is I can keep track of CTR and check which ad is performing well and remove the non performer..
My Kudos to this pligin

said on September 23rd, 2009 at 14:46 · Permalink · Reply

I installed this plugin this morning because I was being prompted to upgrade from the old Ad Rotator plugin at
This plugin appears to do exactly what that one had done. The only difference between the two is that this one works in a widget whereas the old one worked with a template tag. I had gotten around the template tag issue when widgets were introduced by writing my own widget for the old plugin so I essentially had the same functionality on my website before I installed this one. And I have not had to update it for different WordPress versions (while this one seems to need updating occasionally). I’ll use this one for a while to see if there’s any real benefit to it but will probably switch back after a while.

And FYI – if you’re running the old version and want to keep it without getting prompted to upgrade to this one simply change the filename of the old one.

said on October 11th, 2009 at 19:33 · Permalink · Reply

Having two plugins with the same name is bad enough, but making one rewriting over the other is very ugly thing in life. Having to redownload and reinstall the old one just because you thing widgets are nice is not appreciated.

said on November 7th, 2009 at 19:40 · Permalink · Reply

[…] you find another theme that doesn’t include adsense, I’d recommend checking out the Ad Rotator. I haven’t tried it out, but it is supposed to be able to include ads into any WordPress […]

said on April 1st, 2010 at 22:31 · Permalink · Reply

I realize this is an old plugin and the last comment here was in November of 2009. But I’m hoping the author is still monitoring comments. I just installed the plugin and have it working well. I’ve put three Ad Rotator widgets in my sidebar, since I want three ads stacked vertically. I populated each widget with the same content (10 images wrapped with the appropriate html and separated by ). My goal is to have each ad appear in any one of the three positions randomly so that over time, each one gets equal exposure in each of the positions. The only problem is that on some page reloads, the same ad appears in two widgets. I know this is just because of the nature of randomization and the relatively small number of ads I have. But is there a way to link each instance of the widget and have each one omit an ad (and pick another) if another widget has already randomly selected it? Even running 10 ads in three spots, I can get the same ad in two spots fairly frequently. That’s what I’m trying to eliminate. Any ideas? Thanks!

said on December 21st, 2011 at 17:03 · Permalink · Reply

Hello, I came across this page looking for exactly what this plugin seems to do – and that is rotate adverts in a sidebar widget.
But, can you please let me know if this plugin is up to date for 2011?
Or does anyone know of a similar plugin, please?

said on March 21st, 2013 at 15:05 · Permalink · Reply

I’m noticing that this plugin/widget does not show up on a lot of browsers – Firefox, Chrome, etc. It’s not that the code doesn’t work, it seems to be getting blocked by some anti-adware. Is there anyway to “sanitize” the code so that doesn’t happen?

said on January 12th, 2011 at 15:14 · Permalink · Reply

I found the problem. The client added a redirect to his website and each Ad Rotator link used an absolute URL. Changed to relative URL’s and now it works again.

More comments: 1 2

Post a comment

You can use simple HTML-formatting tags (like <a>, <strong>, <em>, <ul>, <blockquote>, and other). To format your code sample use [cc lang="php"]$a = "hello";[/cc] (allowed languages are ruby, php, yaml, html, csharp, javascript). Also you can use [cc][/cc] block and its syntax would not be highlighted.

Submit Comment