=== Ad Manager by WD - Advanced Ad Manager plugin === Contributors: webdorado Donate link: https://web-dorado.com/products/wordpress-ad-manager-wd.html Tags: : ad, ads, adsense, advert, advertisement, adverts, banner, banner manager, schedule, schedules, statistics, tracking Requires at least: 3.8 Tested up to: 4.8 Stable tag: 1.0.7 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Ad Manager WD is functional and comprehensive plugin which is created to help you monetize your WordPress website with ads. == Description == Ad Manager WD is functional and comprehensive ad management plugin which is created to help you display advertisements on your WordPress website and take the next step in monetization with ads. Its quick and easy configuration settings will let you create, manage and publish ads on your site and make additional money. Advertizing was never as easy as it is with this ads manager WordPress plugin. [WordPress Ad Manager WD](https://web-dorado.com/products/wordpress-ad-manager-wd.html ) [Ad Manager WD User Manual](https://web-dorado.com/wordpress-gallery-guide-step-1.html) [Ad Manager WD Support Forum](https://web-dorado.com/forum/ad-manager-wd.html) Start creating your ad with an advertisement banner, and you can display it on any page, post, category page or sidebar area with an ad widget. Absolutely no need to get a separate banner manager or affiliate plugin. Ad Manager WD does it all. With its flexible functionality, Ad Manager WD supports almost any type of ad code and lets you manage multiple banners. Whether you’ve got it in an HTML markup, Javascript code or specific advertisement script (e.g. Google AdSense, Chitika, Amazon, BuySellAds,), you can publish it with this WordPress plugin. It is widely used on commercial websites ,in affiliate marketing and other affiliate programs with commission. Organize your ads by adding them into ad groups, and publish ad groups in three modes. Ads can be renewed upon reloading the page with Default mode, as well as be refreshed dynamically with Dynamic. You can also place more than one advert on the same area using Block mode of ad groups.The plugin supports ad rotation. You can adjust the ad rotating settings from the Groups section in the plugin settings.Ad Manager WD WordPress plugin lets you publish your ads with ad inserter functionality by injecting them into posts, pages or categories. Ad injections can be made before or after the page content, or inside it. Select a specific paragraph, and inject the ad next to it. The ads are perfectly displayed on AMP.Furthermore, you can have your ads published based on a certain schedule and advertise saving time and efforts. Set start and end dates for your ad schedule and apply it to your ads. They will be unpublished from your website automatically, when the end date of the schedule is passed. This feature-rich affiliate tool is a great way to manage home page ads,target your niche audience and make some more income.Export functionality of Ad Manager WD allows to download JSON file with created ads. You can then import them into the plugin installed on another website.Th plugin is multisite compatible to help you display adverts on multiple sites and make more revenue. Track the statistics of your ads with Internal Tracker of Ad Manager WD plugin. Configure tracking settings and you will have in-depth information regarding clicks and impressions on your ads.As an administrator of your WordPress site, you act as an advert manager, and receive email notifications from Ad Manager WD plugin. They can be triggered when an ad is saved by any advertiser, or is approved by site moderators.There are many browser extensions, which block ads on websites, and one of them is AdBlock. Ad Manager WD plugin provides AdBlock Detection feature. It lets you catch AdBlock in case it is enabled on visitors’ browsers and notify them about it. You can set a custom text to display as AdBlock detector message. ###IMPORTANT: If you think you found a bug in Ad Manager WD or have any problem/question concerning the plugin, please check out [Ad Manager WD Support Forum](https://web-dorado.com/forum/ad-manager-wd.html) in our website. If you do not find a solution here, do not hesitate to [click here to contact us](https://web-dorado.com/support/contact-us.html). ### Features of Ad Manager WD plugin: * Unlimited ads and ad groups * User-friendly interface * Ad scheduling * 3 display modes for ad groups: * Default * Dynamic * Block * Exporting/importing created ads * AdBlock detection * Clicks and impressions tracker for ads * Email notifications Upgrade to [Ad Manager WD Pro](https://web-dorado.com/products/wordpress-ad-manager-wd.html ) to have access to its advanced functionality: * Device Targeting * Ad and schedule management access levels * Geo Targeting * Pushover notifications * Publishing with multiple schedules * Ad tracking with Google Analytics and Piwik Analytics == Changelog == = 1.0.7 = Added: Notice to install Backup WD plugin = 1.0.6 = Fixed: Updated library to prevent conflict with PHP version 7. = 1.0.5 = Fixed: Notices on submenus = 1.0.4 = Added: Overview page Changed: Deactivation = 1.0.3 = Fixed: Bug on PHP 5.3 = 1.0.2 = Fixed: Bug on Show Advert in posts = 1.0.1 = Fixed: Misspellings = 1.0.0 = Initial version == Frequently Asked Questions == = 1. What can I get with Ad Manager WD plugin? = Ad Manager WD is a user-friendly tool which lets you easily create and manage ads on your WordPress websites. It allows publishing the ads as a single entry or a group, and each of the ads can appear on your website based on a certain schedule. = 2. Can Ad Manager WD plugin be installed via FTP? = Installation through WordPress administrative panel is recommended, however, you can install the plugin with FTP connection. Connect to your website server and navigate to /wp-content/plugins directory. Uncompress the .zip installation file of Ad Manager WD plugin, then upload it to /wp-content/plugins. Afterwards login to WordPress administrative panel of your site, go to Plugins page and activate Ad Manager WD. = 3. How many ads can I add with the plugin? = Ad Manager WD plugin lets you create and publish unlimited numbers of advertisement entries on your WordPress site. = 4. Can I use Google AdSense code? = You can have your Ad Code in HTML/CSS and Javascript code, as well as specific ad script, such as Google AdSense. Important: Ad Code does not accept PHP. Please avoid writing PHP code as the value of Ad Code option, since the site will throw errors and stop functioning properly until the code is removed. = 5. How can I publish my ads on my WordPress site? = Ads can be published on posts, pages and categories, as well as in widget areas. Use Placement options to select entries where your ad will display. You can inject your ads before or after page content, as well as inside it. = 6. Can the ads be published based on a schedule? = You can create schedules from Ad Manager WD Schedules page, and add one schedule to each ad entry. Specify start and end dates, and your ads will appear during the specified time frame. = 7. Is it possible to categorize ads in groups? = Ad Manager WD plugin lets you create groups for your ads, which are WordPress taxonomies. Ad groups allows you to bulk publish more than one ads in pages, posts, categories or widget areas. = 8. Which are the views available for ad groups? = Ad groups can be published with three types of views, Default, Dynamic or Block. Ad groups published with Default mode will refresh displayed ad when the page is reloaded. Whereas Dynamic lets you have them renewed automatically after a specified period of time. Block mode of Ad Manager WD plugin aligns ads of the group in a grid. It lets you display more than one ad on the same area of your WordPress site. = 9. How can I transfer created ads from one website to another? = Ad Manager WD plugin lets you export created ads in a JSON file. Select your ads from All Adverts page choose Export to JSON from Bulk Actions and click Apply. The JSON file with ads will be downloaded automatically. You can then upload this file from Ad Manager WD > Import page. = 10. Is it possible to detect AdBlock and ask visitors to disable it? = With AdBlock Detector of Ad Manager WD plugin you can notify the visitors that AdBlock extension is enabled on their web browser. This option lets you write a custom message to display when Ad Manager WD detects AdBlock. AdBlock detection settings can be found on Ad Manager WD > Settings > General tab. = 11. How can I get notified when an ad is created or approved? = Ad Manager WD can send email notifications to site administrators, when an advertiser saves an ad on your website, and also when a moderator approves an ad. Enable notification options from Ad Manager WD > Settings > General tab, and provide the email addresses of recipients, separated by commas. = 12. Can I track clicks and impressions of my ads? = Internal Tracker of Ad Manager WD plugin lets you have statistics of clicks and impressions of each ad you create. Enable Statistics option when creating an ad, and make sure Internal Tracker is selected on Ad Manager WD > Settings page, Statistics tab. You will be able to display tracking information of each ad from All Adverts page, Statistics column. == Installation == #### Thank you for your interest in Ad Manager WD. ### Minimum requirements. * Wordpress 3.9+ * PHP 5.x * MySQL 5.x ### Perform a new installation After downloading the ZIP file of the Ad Manager WD plugin, 1. Log in to the administrator panel. 2. Go to Plugins Add > New > Upload. 3. Click "Choose file" ("Browse") and select the downloaded zip file of the Ad Manager WD plugin. *For Mac Users* *Go to your Downloads folder and locate the folder with the Ad Manager WD. Right-click on the folder and select Compress. Now you have a newly created .zip file which can be installed as described here.* 4. Click "Install Now" button. 5. Click "Activate Plugin" button for activating the Ad Manager WD. 6. If the installation does not succeed, please contact us at [info@web-dorado.com](mailto:info@web-dorado.com). ==Wordpress Ad Manager WD Step by step guide== = Introduction = Ad Manager WD plugin is a user-friendly tool developed to easily create, publish and manage advertisements on your WordPress sites. Its straightforward, yet extensive functionality lets you have these features: Place any advertisement code to your website, including Google AdSense or just HTML, Create advert groups and organize the ads on your website, Apply schedules to each advertisement, Display published adverts in three different modes, Easily control the placement of adverts and advert groups, Control the weight and visibility of ads throughout your site including adrotate settings, Target users from specific locations all over the globe, Keep track of feedback using plugins tracker, as well as Google Analytics and Piwik Analytics, Manage user roles for adding, editing and deleting adverts, as well as schedules. And this is just a summary of Ad Manager WD features. Now let’s get started on creating adverts, groups, schedules and managing the plugin’s settings. = Creating an advertisement = After installing and activating Ad Manager WD plugin, click on Ad Manager WD menu item from left menu bar of WordPress dashboard. You will be redirected to All Adverts page, where you can see the list of advertisements. Press Add New Advert to start creating a new one. = New Advert = Firstly make sure to provide a Title for your advert entry. Ad Code option holds the code for your advertisement. You can write the following types of code in the scripts manager box as the value of Ad Code option: HTML and CSS, Javascript, Specific advertisement code, such as Google AdSense. Note: You’ll be able to use ad codes from any advertising platform,company and affiliate networks (Adserver ,AdGridwork, Adify, Adpinion, Adroll, CrispAds,Adbrite, shopping ads,Ad Rotator) that use Javascript, HTML and CSS.Important: This option does not accept PHP code. Please avoid adding it to Ad Code setting. Useful tags will let you quickly include the featured image of current advert, or its title. Moreover, it provides some attributes, which will help you with the code, if your are writing HTML. Click on tags once to add them to your advertisement code. As soon as the code for the advertisement is provided, you will be able to see a quick preview of it. Mark Statistics option as checked to enable tracking of clicks and impressions of this advert. = Advanced = Use Show on setting if you wish you wish to disable current advertisement on Desktops, Tablets or Smartphones. Leave all unchecked to display this ad on all devices. In case you do want to have the advert on smartphones and tablets, make sure to enable its Responsiveness. Use Image For Smartphones and Image For Tablets options to choose pictures for mobile display from Media Library. This lets you have your advertisement displayed nicely on any screen size. Weight represents the display frequency of current advert. In other words, if it has larger weight than other ads in the same group, it will appear in your advertisement section more often. Use Sortorder to set ordering of adverts in the same group displayed with Block type as its Mode. Alternatively you can skip this by leaving the option empty or setting it to 0. We will thoroughly cover ad group modes in Groups section of this user guide. = Geo Targeting = Geo Targeting settings of Ad Manager WD plugin let you advertise to users based in specific locations from all around the globe. You can select certain cities, states and countries with the following options. If you wish to use geo targeting, make sure to choose a Geo Service from Ad Manager WD > Settings > Statistics tab. Cities/States allows you to indicate the list of cities (or the Metro ID) and states (or their ISO codes) to choose locations where current ad will display. Make sure to separate the values by commas. Whereas with Countries setting you can mark all countries, which you would like to be geographical targets of this advertisement. = Show In Posts = You can determine the placement of your advertisement with this set of options. Ad Manager WD plugin lets you add your adverts to widget areas, categories, posts and pages. We will discuss publishing of widgets later on in this guide. Let’s go through the rest of its methods now. Placement option can be used to specify the location of current advert in a post, page or category. Correspondingly it can be added in one of the following sections: Before Content After Content Before And After Content Inside The Content There’s also a way to be more specific in the placement of your ad in those entries. You can set the number of paragraph, after which your advert will show up. For instance, if you write 3, the ad will appear below the 3rd paragraph on a post/page. Select corresponding options to inject your advertisement in a post, page or category. In case you select Show advert in category option, the list of post categories you have will appear right below. Make sure to choose the ones where you want your ad to display. Similarly, the list of pages and posts will show up for you to select, when you mark Show advert in posts and Show advert in pages options as checked. = Choose Schedules = After you create schedules for your advertisement, they will be mentioned under this section of advertisement editor page. This lets you set exact start and end date for the advertisement. In case you select one or multiple schedules, your advert will display during the selected period. Leave all schedules unchecked, in case you wish to always display current advert on your website frontend. = Wrapper Code = This option of Ad Manager WD plugin allows you to place additional code before and after the advertisement. It accepts HTML, CSS and Javascript code. Alternatively you can leave it blank, if you don’t need a wrapper around the ad. Let’s say you wish to wrap your advertisement inside a container. You can set
as the value of Before Advert option, and write a corresponding
closing tag in After Advert textarea. = Advertiser = As an administrator you can select the author of current advertisement using Advertiser option. The list of registered users is available with its select box. This helps you identify the creators or owners of the advert. Simply click on the dropdown menu and choose the user account which would be the advertiser of current entry. = Managing All Adverts =When you create a few advertisement entries, they all will be available under Ad Manager WD page. This section also provides a set of useful tools, which will come handy for affiliates managers . Let’s go through each of them and discuss thoroughly. As with regular WordPress posts, you can search your adverts from this page. Enter their title (partially or fully) in corresponding input on top right corner, then click Search. Bulk Actions dropdown of this page comes with the following settings. Choose the one you need to use and hit Apply. Edit lets you make quick modifications on more than one adverts. Move to Trash helps you delete several advertisement entries at once. Duplicate will create copies of all selected adverts. Deactivate allows you to unpublish chosen advertisements from frontend of your site. Reset stats will clear out all clicks and impressions statistics for selected adverts. Export to JSON option will let you export chosen entries as a JSON file and import on another website, where you have Ad Manager WD plugin. Renew lets you re-publish expired adverts for the following periods: For 1 year For 180 days For 30 days For 7 days You can also filter advertisements on All Adverts page using the dropdown menus from the top. They can be filtered by the dates they were published, groups, schedules, as well as their expiration status (active/expired/soon to expire). Choose the necessary values for each select box and click Filter. = Groups = Ad Manager WD plugin lets you organize your adverts and display them in groups with different modes. Let’s start with creating a new group and assigning it to an advertisement. Firstly provide a Name and Slug for your group, and select a Parent group (if any). You can write a few lines of Description for this particular group also. The slug and description text is optional, but the name requires to be filled in. Groups of advertisements can be displayed on site frontend based on three Modes: Default mode will switch adverts of current group only upon page load. Dynamic lets you have the group ads to refresh after a specified time frame, without reloading the page. Block allows you to place a few adverts at once. It creates a grid containing ads of current group. Dynamic and Block have a set of specific options, that will only apply if your group is published in those modes. Block Parameters lets you select the number of rows and columns for your group in Block mode. Advert Size determines the width and height of ads in this group. Auto refresh allows setting the amount of time (in seconds), which will be indicated as the interval for refreshing dynamic ads. Advanced set of options allows you to add margins to your advert block. For example, you can set it to 10px 0px to have margins from top and the bottom only. Furthermore, it lets you select the alignment of this advertisement group, Left, Right or Center. Select Placement of the advertisement group, which can be one of the following: Before Content After Content Before And After Content Inside The Content You can also specify the number of paragraph, after which the advertisement will appear. E.g. if you set 5, the ad group will appear after fifth paragraph. As with individual adverts, groups can be placed in posts, pages or categories. Select where you need the ad group to appear by checking corresponding checkboxes. Make sure to press Save after configuring all necessary options in your group. Now lets add an advert to it. You need to navigate to All Adverts page and edit the one you wish to assign to the group. Click Add New Group from right side of the editor, and select the group from its dropdown menu. = Schedules = With Ad Manager WD Schedules you can apply certain schedules to your adverts, and have them published during a specific time frame. Related ads will automatically appear on the start date, and will expire on the end date of their schedules. Click Add New Schedule button to start configuring your first advertisement schedule. Start with providing a Title for this entry, and afterwards select the start and end dates. Click on From and To inputs to open date pickers. This indicates the period during which related advertisements will appear on your website. With Show only on option the plugin lets you specify weekdays, on which ads connected to this schedule will display. You can also set Daily start at(hh:mm) and Daily End On(hh:mm). These are the timestamps when the ads will start and finish appearing on each weekday. You might need to control the schedule not based on start/end dates, but clicks and impressions. This can be done with Ad Manager WD plugin, by specify the number of Maximum Clicks and Maximum Impressions. Adverts related to this schedule will be disabled from website frontend as soon as clicks and impressions reach these numbers. Alternatively you can leave the values empty or set to 0 to skip this. Apply the schedules to advertisement entries using corresponding checkboxes under Adverts section. = Settings = Ad Manager WD provides various useful settings, which makes the functionality of the adverts more flexible. You can configure alert messages, geo targeting options, administrative roles and much more. Navigate to Ad Manager WD > Settings and let’s go through each section and options one by one. General Ad Block Detection can be enabled to have a message in case Ad blocker extensions are enabled on user’s browser. The message will appear as an overlay on your website frontend. With Show message for setting you can select the interval (in seconds) during which this message will be displayed. Furthermore, set the message content for Adblock detection using Message to show option. Bot Filter option lets you provide list of bots, which will otherwise interact with your adverts. We provide a predefined list, which you can keep for this setting. Send Notification When lets you enable email or Pushover notifications to keep track of changes among your adverts. These alert messages can be sent for the following two cases: Any advertiser saves an advert in your moderation queue. A moderator approved an advert from the moderation queue. Mark Email Message option as checked to configure email notifications. Afterwards provide the list of recipient email addresses, separated by commas. Push Notifications to Your Smartphone option turns on notifications, which you will receive directly to your smartphone. This is done through Pushover application. You can download and install Pushover on your devices from the following links: Android iOS Desktop There’s one last step necessary to complete, if you wish to get notified via Pushover application. Make user to create a new user for yourself, then copy User Key and API Token of your account to corresponding options of Ad Manager WD. Statistics This section lets you configure tracking settings for checking the statistics of your adverts created with Ad Manager WD. Three options of tracking tools are available: Internal Tracker Piwik Analytics Google Analytics Internal Tracker is the tracking tool which runs in Ad Manager WD plugin itself. You can check the statistics of each advertisement from All Adverts page. Click Statistics link to open the details. Alternatively, the plugin can also be integrated with Piwik Analytics and Google Analytics. However, in this case you need to include their tracking code to header.php or footer.php files of your website theme. The following settings are available for configuration of Internal Tracker: Logged in impressions can be enabled to track impressions from logged in users. Logged in clicks lets you track clicks from logged in users. Impression timer is used to specifying timer for impressions. This setting will not track sequential impressions during this period. For example, let’s say you have set it to 5, and an impression is recorded. Impressions for this add will not be counted, if they occur during the next 5 seconds. Click timer sets the timer for tracking clicks. This setting will not track sequential clicks during this period. For example, let’s say you have set it to 5, and a click is recorded. Clicks for this add will not be counted, if they occur during the next 5 seconds. Geo targeting If you wish to have geo targeting functionality on your advertisement entries, you can select one of the two Geo Services from this section. WD Adverts uses the free version of Max Mind geo targeting service. It is precise and will let you target all specified locations correctly. You can alternatively use Max Mind option, which is the paid version of this service. WD Adverts is automatically integrated with Ad Manager WD plugin. Whereas Max Mind requires your account username and password to incorporate its geo service with the plugin. Advertisement and Schedule Roles Ad Manager WD plugin lets you have full control on setting up user roles, which will be able to complete the following actions related to adverts and schedules: Edit their own adverts and schedules, Edit other’s adverts and schedules, Delete their own adverts and schedules, Delete other’s adverts and schedules, Publish adverts and schedules, Assign groups to adverts. Simply mark each user role option, which will have the privileges to perform actions mentioned above. Note, that user accounts with Administrator role have full access to the plugin. = Import = Ad Manager WD plugin lets you export created adverts from one website, and import to another one with its Import feature. Firstly go to Ad Manager WD > All Adverts page to export the entries. Select the necessary items, choose Export JSON option from Bulk Action, then click Export. Afterwards navigate to Ad Manager WD > Import page, where you will find import settings. Click on Choose File button and select the exported JSON file and press Import. Publishing as a Widget Besides injecting advertisements into post, page or category pages, you can also publish them as widgets. Go to Appearance > Widgets to start the setup. Find Ad Manager WD widget and place it to one of the widget areas your website theme provides. Provide a Title for the widget, and select an advert or group. Afterwards save the widget, and the advertisement will appear on your website frontend.