WP AdPosts by Kader Bouyakoub

WP AdPosts plugin allows you to create ads using codes or images and provides views and clicks counters, as well as locations management. You can even use the provided shortcode to insert ads into posts and pages.

Manage Ads

You have two ways of creating ads:

• By uploading featured images only and provided ads links.
• By pasting ads codes (JavaScript) or full HTML.

Note: If you use full HTML, it is better to enter your ads links into the “Ad Link” field.

In order to display an ad on your front-end, you can use the provided php function on your theme’s files like so:

Location here stands for the created location’s slug. So if you created a Header location, it may have the header slug, so you do:

WP AdPosts enabled shortcodes on text widgets, so you can as well use a text widget in which you can use this provided shortcode like so:
[wp-adposts location=”header”]

Using the location, as an argument for the function or an attribute for the shortcode, will display a single randomly picked ad to which it was assigned.

As of version 1.3.0, it is possible to display a specific ad by its ID, passed to the php function in your theme’s files like so:

Or used as shortcode attributes like the example below:
[wp-adposts ad=”123″]

THINGS YOU SHOULD KNOW:

• To display an ad by its ID, make sure to assign a location to it in order to display it with the selected dimensions. Ads with no locations assigned will not be displayed.
• Priority is to ad ID. So if you use both attributes in the shortcode, the ad will be used. If the ad is not found, even if the location exists and has ads assign to it, nothing will be displayed.

Manage Locations

They are much more like “sizes” limitations. A location can have a specified ads sizes so that ads will be contained in them. For instance, if a location has 728 pixles by 90 pixels (728×90), anything that is beyond that is simply hidden.

Views and Clicks Counters

You will see on ads management page views and clicks counters. These are useful to keep an eye on your ads.

1. Upload the plugin files to the /wp-content/plugins/wp-adposts directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the ‘Plugins’ screen in WordPress.
3. Use the Settings->WP AdPosts screen to configure the plugin.
4. Add as many locations as you want, but please do not forget to select ads sizes because it is important.
5. Add you ads by uploading featured images or pasting code into the editor and don’t forget to add the ads links in order to track clicks.

Installation Instructions

1. Upload the plugin files to the /wp-content/plugins/wp-adposts directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the ‘Plugins’ screen in WordPress.
3. Use the Settings->WP AdPosts screen to configure the plugin.
4. Add as many locations as you want, but please do not forget to select ads sizes because it is important.
5. Add you ads by uploading featured images or pasting code into the editor and don’t forget to add the ads links in order to track clicks.

1. 

   After activation, you will see the plugin menu item on your dashboard.

2. 

   On your settings page, make sure to select only desired ads sizes to avoid creating multiple useless thumbnails for uploaded ads images.

3. 

   This is where you can manage your ads locations, or as some like to call them "sizes limitations".

4. 

   Creating ads is as easy as creating WordPress posts or pages.

5. 

   On the ads management page, you can track your ads views (displays) and clicks.

6. 

   An example of displayed automatic ads or using shortcodes (within the blog post).

1.3.0

• It is now possible to display ads within posts content.
• The php function or shortcode accept now the ad ID in order to display a specific ad.
• Settings page enhanced.

1.2.0

• The default location meta box was replaced with a custom one.

1.0.1

• Some input and output sanitizing were added.

1.0.0

• First plugin commit.