Frequently Asked Questions
The frequently asked questions page contains several of the most commonly asked questions and our solutions for them. This section will change over time and should be your first stop for a specific problem.
This is often caused by an issue with permalinks.
Go to Settings > Permalinks and re-save the Permalinks page. (Do not make any changes to the settings. Just click the blue button to re-save the current settings.)
Sometimes when new custom post types, such as AdSanity’s ads, are activated on the site, the permalinks do not reset to include the new type. This solution should reset the permalink structure and include AdSanity in the process. This will not affect anything on your site (unless you make changes to you permalink settings, in which that will have obvious implications).
Yes, there are many options - shortcode button in the classic editor, gutenberg blocks, Beaver Builder modules, and PHP template tags.
[adsanity id="put-the-ad-id-here" align="alignnone"]
[adsanity_group num_ads=4 num_columns=2 group_ids=1,2 /]
Template Tag examples
Core Template Tags
AdSanity ads can be placed programmatically. There are two template tags available for users. One to add a single ad and one to show an ad group. You may want to add these tags to specific templates or template parts to display your advertisements.
To show a single ad:
<?php adsanity_show_ad( array( // any valid ad ID will do // (you can get this from the main list of ads) 'post_id' => 1, // (one of the following: // alignleft, aligncenter, alignright or alignnone) 'align' => false, // this will optionally return the output instead of echoing it 'return' => false, )); ?>
To show a group of ads:
<?php adsanity_show_ad_group( array( // an array of valid group ids // (you can get these from the main list of ad groups) 'group_ids' => array(), // number of ads to show total 'num_ads' => 1, // number of ads to show per row 'num_columns' => 1, // this will optionally return the output instead of echoing it 'return' => false, )); ?>
Add-On Template Tags
In addition to our core template tags, certain add-ons provide additional template tags.
To show rotating ads:
<?php adsanity_show_rotating_ads( array( // any valid group id 'group_id' => 0, // (one of the following: alignleft, aligncenter, alignright or alignnone) 'align' => false, // how many seconds to show an ad before rotating 'time' => 30, // setting a max width can help keep ads responsive, // but also no wider than necessary 'max_width' => 0, // this will optionally return the output instead of echoing it 'return' => false, )); ?>
To show ordered ads:
<?php function adsanity_show_ordered_ads( array( // the number of columns to output 'num_columns' => 1, // an array of valid ad ids // (you can get these from the main list of ads) 'ad_ids' => array(), // (one of the following: // alignleft, aligncenter, alignright or alignnone) 'align' => 'alignnone', // this will optionally return the output instead of echoing it 'return' => false, ));
AdSanity will always have the capability to support any non-standard ad-size via an add-on plugin. AdSanity currently supports the following ad sizes by default:
- 1x1 - Responsive
- 1x2 - Responsive
- 1x3 - Responsive
- 1x4 - Responsive
- 2x1 - Responsive
- 3x1 - Responsive
- 4x1 - Responsive
- 6x1 - Responsive
- 8x1 - Responsive
- 10x1 - Responsive
- 88x31 - Micro Bar
- 120x60 - Button 2
- 120x90 - Button 1
- 120x240 - Vertical Banner
- 120x600 - Skyscraper
- 125x125 - Square Button
- 160x600 - Wide Skyscraper
- 180x150 - Rectangle
- 234x60 - Half Banner
- 240x400 - Vertical Rectangle
- 250x250 - Square Pop-Up
- 300x100 - 3:1 Rectangle
- 300x250 - Medium Rectangle
- 300x600 - Half Page Ad
- 336x280 - Large Rectangle
- 468x60 - Full Banner
- 720x300 - Pop-Under
- 728x90 - Leaderboard
These Ad Sizes were derived from IAB Standards. The Responsive ad sizes are to be used for dynamic HTML5 content that meets the new LEAN standards. As of December 2016, the IAB Standards have been updated (see https://www.iab.com/guidelines/iab-display-advertising-guidelines). If you wish to keep the version 1.0 defaults, download, install, and activate the attached AdSanity add-on via the WordPress plugin installer.
adsanity-size-filter.php.zip (2 KB)
If you’re getting an error message when trying to authenticate your plugin, it is likely being caused by one of a few things that you can fix on your own. Follow the steps below to resolve any issues you might be having before sending in a support ticket.
- Use the correct username. Your correct username consists of the first part of your email address you used during your purchase – basically, everything before the @ sign.
- Be sure that the plugin folder name is “adsanity.” Occasionally after updating plugins, WordPress will rename the folder adsanity.tmp or something of that sort. Our authentication system is unable to find the plugin and is therefore unable to authenticate it.
If none of that worked for you, you’ve done your due diligence. Go ahead and submit a support ticket and we’ll make sure there’s nothing else going on on our end that is blocking your authentication.
We recognize that static or animated image files aren't the only type in use on the web. We also support flash ads with a static image fallback. While we work on an updated interface to include Flash ads, we have always had the ability to use the network ad code field to place flash ads.
Upload your flash file to WordPress via the media uploader.
Paste the flash embed code below into the code box under the network ads tab (changing your-flash-file.swf with the URL of your flash file). If you use a clickTAG in your swf file, the attached code will also track clicks.
You can optionally include a static fallback image for devices that don't support flash wrapped in a special link so the clicks get tracked. You'll need to upload the image via the media uploader and replace your-image-file.jpg with the full url to the uploaded image as well. You have to enter the destination URL in the tracking url field and use our special %link% tag in the href.
<object type="application/x-shockwave-flash" data="your-flash-file.swf" width="300" height="250"> <param name="movie" value="your-flash-file.swf" /> <param name="quality" value="high" /> <param name="flashvars" value="clickTAG=%link%"> <!-- STATIC FALLBACK IMAGE--> <a href="%link%"><img src="your-image-file.jpg" width="300" height="250" /></a> <!-- /STATIC FALLBACK IMAGE--> </object>