Ad Code Manager

Version: 0.6.0

Manage your ad codes through the WordPress admin in a safe and easy way.

Overall Rating

WordPress Rating

Ad Code Manager gives non-developers an interface in the WordPress admin for configuring your complex set of ad codes. Some code-level configuration may be necessary to setup Ad Code Manager. Ad tags must be added (via do_action()) to your theme’s template files where you’d like ads to appear. Alternatively, you can incorporate ad tags into your website with our widget and our shortcode. Check out the configuration guide for the full details. A common set of parameters must also be defined for your ad provider. This includes the tag IDs used by your template, the default URL for your ad provider, and the default HTML surrounding that URL. Ad Code Manager comes with support for Google Doubleclick For Publishers (and Async), and Google AdSense. All of the logic is abstracted, however, so configuring a different provider is relatively easy. Check providers/doubleclick-for-publishers.php for an idea of how to extend ACM to suit your needs. Once this configuration is in place, the Ad Code Manager admin interface will allow you to add new ad codes, modify the parameters for your script URL, and define conditionals to determine when the ad code appears. Conditionals are core WordPress functions like is_page(), is_category(), or your own custom functions that evaluate certain expression and then return true or false. Fork the plugin on Github and follow...

Want to write review?

Are you an author of this plugin? Want to write a more detailed review?

All right sparky!

The plugin scored great on our tests. Everything looks good!

Tests done by WP Hive test script Results

Minimal impact on memory usage The memory usage of this plugin is less than the average memory usage of other plugins on WordPress.org + 200KB. Check FAQ for more.
Minimal impact on pagespeed The impact of this plugin on PageSpeed is less than the average impact of other plugins on WordPress.org + 1000 milliseconds
No PHP errors, warning, notices WP Hive automated test found no PHP error while activating this plugin on our server
No Javascript issues WP Hive automated test found no JavaScrip error while activating this plugin on our server
Latest PHP 7.4.8 compatible The latest version of the plugin is compatible with the latest PHP version
Latest WordPress 5.9.2 compatible The latest version of the plugin is compatible with the latest PHP version
Optimized database footprint The plugin creates less than 50 database tables
No activation errors WP Hive automated test found no activation error while activating this plugin on our server
No resource errors WP Hive automated test found no resource error/s while trying this plugin on our server
Frequently updated The plugin was updated at least once in the last 90 days

No problems were detected during tests.

All the plugins are tested on the same server with exactly same configuration via test script that automatically activates and logs the data WP Hive shows.

All the scripts run on a VPS with 8 CPU cores and 8 GB of RAM.
The test sites are hosted on Google Cloud VM instances, one site/plugin per instance. The machine type is n1-standard-1. The server is a 8 core CPU with 8GB of RAM.
The test sites are hosted on Apache/2 server and they are tested on PHP 7.4.8 & WordPress 5.9.2.
The database server is MySQL 8.0.21 and the default PHP memory limit is 256M.

24K

Total Downloads

200

Active Installation

10 years

On WordPress

0.0%

Growth Rate

1

Support Thread

0

Ratings on WordPress

00

Downloads This Week

00

Ago Last Updated

Download Plugin Plugin Website

About Ad Code Manager

Description

Ad Code Manager gives non-developers an interface in the WordPress admin for configuring your complex set of ad codes.

Some code-level configuration may be necessary to setup Ad Code Manager. Ad tags must be added (via do_action()) to your theme’s template files where you’d like ads to appear. Alternatively, you can incorporate ad tags into your website with our widget and our shortcode. Check out the configuration guide for the full details.

A common set of parameters must also be defined for your ad provider. This includes the tag IDs used by your template, the default URL for your ad provider, and the default HTML surrounding that URL. Ad Code Manager comes with support for Google Doubleclick For Publishers (and Async), and Google AdSense. All of the logic is abstracted, however, so configuring a different provider is relatively easy. Check providers/doubleclick-for-publishers.php for an idea of how to extend ACM to suit your needs.

Once this configuration is in place, the Ad Code Manager admin interface will allow you to add new ad codes, modify the parameters for your script URL, and define conditionals to determine when the ad code appears. Conditionals are core WordPress functions like is_page(), is_category(), or your own custom functions that evaluate certain expression and then return true or false.

Fork the plugin on Github and follow our development blog.

Configuration Filters

There are some filters which allow you to easily customize the output of the plugin. You should place these filters in your theme’s functions.php file or in another appropriate place.

Check out this gist to see all of the filters in action.

acm_ad_tag_ids

Ad tag ids are used as a parameter when adding tags to your theme (e.g. do_action( ‘acm_tag’, ‘my_top_leaderboard’ )). The url_vars defined as part of each tag here will also be used to replace tokens in your default URL.

Arguments:
* array $tag_ids array of default tag ids

Example usage: Add a new ad tag called ‘my_top_leaderboard’

    add_filter( 'acm_ad_tag_ids', 'my_acm_ad_tag_ids' );
        function my_acm_ad_tag_ids( $tag_ids ) {
            $tag_ids[] = array(
                'tag' => 'my_top_leaderboard', // tag_id
                'url_vars' => array(
                    'sz' => '728x90', // %sz% token
                    'fold' => 'atf', // %fold% token
                    'my_custom_token' => 'something' // %my_custom_token% will be replaced with 'something'
                ),
            );
            return $tag_ids;
        }

acm_default_url

Set the default tokenized URL used when displaying your ad tags. This filter is required.

Arguments:
* string $url The tokenized url of Ad Code

Example usage: Set your default ad code URL

    add_filter( 'acm_default_url', 'my_acm_default_url' );
        function my_acm_default_url( $url ) {
            if ( 0 === strlen( $url )  ) {
                return "http://ad.doubleclick.net/adj/%site_name%/%zone1%;s1=%zone1%;s2=;pid=%permalink%;fold=%fold%;kw=;test=%test%;ltv=ad;pos=%pos%;dcopt=%dcopt%;tile=%tile%;sz=%sz%;";
            }
        }

acm_output_html

The HTML outputted by the do_action( 'acm_tag', 'ad_tag_id' ); call in your theme. Support multiple ad formats ( e.g. Javascript ad tags, or simple HTML tags ) by adjusting the HTML rendered for a given ad tag.

The %url% token used in this HTML will be filled in with the URL defined with acm_default_url.

Arguments:
* string $output_html The original output HTML
* string $tag_id Ad tag currently being accessed

Example usage:

    add_filter( 'acm_output_html', 'my_acm_output_html', 10, 2 );
        function my_acm_output_html( $output_html, $tag_id ) {
            switch ( $tag_id ) {
                case 'my_leaderboard':
                    $output_html = '';
                    break;
                case 'rich_media_leaderboard':
                    $output_html = '';
                    break;
                default:
                    break;
            }
            return $output_html;
        }

acm_register_provider_slug

Ad Code Manager has a built in list of providers that it gathers by scanning the ‘providers’ directory used by the plugin. Additional providers can be added by placing the appropriate files in that directory, or by using the acm_register_provider_slug filter to register those that may be included as part of your theme or another plugin.

When using this plugin, you are defining the provider slug as part of the existing object as well as an array of classes associated with that provider slug.

Arguments:
* object $providers An object containing the current registered providers.

Example usage:

    add_filter( 'acm_register_provider_slug', 'my_acm_register_provider_slug' );
        function my_acm_register_provider_slug( $providers ) {
            $providers->new_provider_slug = array(
                'provider' => 'My_New_Ad_Company_ACM_Provider',
                'table' => 'My_New_Ad_Company_ACM_WP_List_Table'
            );
            return $providers;
        }

acm_whitelisted_script_urls

A security filter to whitelist which ad code script URLs can be added in the admin

Arguments:
* array $whitelisted_urls Existing whitelisted ad code URLs

Example usage: Allow Doubleclick for Publishers ad codes to be used

    add_filter( 'acm_whitelisted_script_urls', 'my_acm_whitelisted_script_urls' );
        function my_acm_whiltelisted_script_urls( $whitelisted_urls ) {
            $whitelisted_urls = array( 'ad.doubleclick.net' );
            return $whitelisted_urls;
        }

acm_output_tokens

Output tokens can be registered depending on the needs of your setup. Tokens defined here will be replaced in the ad tag’s tokenized URL in addition to the tokens already registered with your tag id.

Arguments:
* array $output_tokens Any existing output tokens
* string $tag_id Unique tag id
* array $code_to_display Ad Code that matched conditionals

Example usage: Test to determine whether you’re in test or production by passing ?test=on query argument

    add_filter( 'acm_output_tokens', 'my_acm_output_tokens', 10, 3 );
        function my_acm_output_tokens( $output_tokens, $tag_id, $code_to_display ) {
            $output_tokens['%test%'] = isset( $_GET['test'] ) && $_GET['test'] == 'on' ? 'on' : '';
            return $output_tokens;
        }

acm_whitelisted_conditionals

Extend the list of usable conditional functions with your own awesome ones. We whitelist these so users can’t execute random PHP functions.

Arguments:
* array $conditionals Default conditionals

Example usage: Register a few custom conditional callbacks

    add_filter( 'acm_whitelisted_conditionals', 'my_acm_whitelisted_conditionals' );
        function my_acm_whitelisted_conditionals( $conditionals ) {
            $conditionals[] = 'my_is_post_type';
            $conditionals[] = 'is_post_type_archive';
            $conditionals[] = 'my_page_is_child_of';
            return $conditionals;
        }

acm_conditional_args

For certain conditionals (has_tag, has_category), you might need to pass additional arguments.

Arguments:
* array $cond_args Existing conditional arguments
* string $cond_func Conditional function (is_category, is_page, etc)

Example usage: has_category() and has_tag() use has_term(), which requires the object ID to function properly

    add_filter( 'acm_conditional_args', 'my_acm_conditional_args', 10, 2 );
        function my_acm_conditional_args( $cond_args, $cond_func ) {
            global $wp_query;
            // has_category and has_tag use has_term
            // we should pass queried object id for it to produce correct result
            if ( in_array( $cond_func, array( 'has_category', 'has_tag' ) ) ) {
                if ( $wp_query->is_single == true ) {
                    $cond_args[] = $wp_query->queried_object->ID;
                }
            }
            // my_page_is_child_of is our custom WP conditional tag and we have to pass queried object ID to it
            if ( in_array( $cond_func, array( 'my_page_is_child_of' ) ) && $wp_query->is_page ) {
                $cond_args[] = $cond_args[] = $wp_query->queried_object->ID;
            }

            return $cond_args;
        }

acm_display_ad_codes_without_conditionals

Change the behavior of Ad Code Manager so that ad codes without conditionals display on the frontend. The default behavior is that each ad code requires a conditional to be included in the presentation logic.

Arguments:
* bool $behavior Whether or not to display the ad codes that don’t have conditionals

Example usage:

    add_filter( 'acm_display_ad_codes_without_conditionals', '__return_true' );

acm_provider_slug

By default we use our bundled doubleclick_for_publishers config ( check it in /providers/doubleclick-for-publishers.php ). If you want to add your own flavor of DFP or even implement configuration for some another ad network, you’d have to apply a filter to correct the slug.

Example usage:

    add_filter( 'acm_provider_slug', function() { return 'my-ad-network-slug'; } );

acm_logical_operator

By default logical operator is set to “OR”, that is, ad code will be displayed if at least one conditional returns true.
You can change it to “AND”, so that ad code will be displayed only if ALL of the conditionals match

Example usage:

    add_filter( 'acm_logical_operator', function() { return 'AND'; } );

acm_manage_ads_cap

By default user has to have “manage_options” cap. This filter comes in handy, if you want to relax the requirements.

Example usage:

    add_filter( 'acm_manage_ads_cap', function( $cap ) { return 'edit_others_posts'; } );

acm_allowed_get_posts_args

This filter is only for edge cases. Most likely you won’t have to touch it. Allows to include additional query args for Ad_Code_Manager->get_ad_codes() method.

Example usage:

    add_filter( 'acm_allowed_get_posts_args', function( $args_array ) { return array( 'offset', 'exclude' ); } );

acm_ad_code_count

By default the total number of ad codes to get is 50, which is reasonable for any small to mid site. However, in some certain cases you would want to increase the limit. This will affect Ad_Code_Manager->get_ad_codes() ‘numberposts’ query argument.

Example usage:

    add_filter( 'acm_ad_code_count', function( $total ) { return 100; } );

acm_list_table_columns

This filter can alter table columns that are displayed in ACM UI.

Example usage:

    add_filter( 'acm_list_table_columns', 'my_acm_list_table_columns' );
        function my_acm_list_table_columns( $columns ) {
            $columns = array(
                'id'             => __( 'ID', 'ad-code-manager' ),
                'name'           => __( 'Name', 'ad-code-manager' ),
                'priority'       => __( 'Priority', 'ad-code-manager' ),
                'conditionals'   => __( 'Conditionals', 'ad-code-manager' ),
            );
            return $columns;
        }

acm_ad_code_args

This filter comes in pair with previous one, it should return array of ad network specific parameters. E.g. in acm_list_table_columns example we have
‘id’, ‘name’, ‘priority’, ‘conditionals’. All of them except name are generic for Ad Code Manager. Hence acm_provider_columns should return only “name”. “editable” and “required” indicate whether this field should be editable and required.

Example usage:

    add_filter( 'acm_ad_code_args', 'my_acm_ad_code_args' );
        function my_acm_ad_code_args( $args ) {
            $args = array(
                array(
                    'key'       => 'name',
                    'label'     => __( 'Name', 'ad-code-manager' ),
                    'editable'  => true,
                    'required'  => true,
                ),
            );
            return $args;
        }

Performance

Memory Usage

Average memory usage is 93.48 KB
This is less than 99% plugins

Page Speed

Average page loading time is increased by 0.04 s
This is faster than 99% plugins

Speed Test Benchmark Learn more how we collect the data

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

- 0.04s

/(front page)

- 0.05s

/wp-admin/edit-comments.php

- 0.02s

/wp-admin/edit-tags.php?taxonomy=category

- 0.01s

/wp-admin/edit.php

+ 0.01s

/wp-admin/index.php

+ 0.03s

/wp-admin/media-new.php

- 0.1s

/wp-admin/options-discussion.php

+ 0.05s

/wp-admin/options-writing.php

- 0.2s

/wp-admin/post-new.php

- 0.14s

/wp-admin/post-new.php?post_type=page

+ 0.01s

/wp-admin/upload.php

- 0.03s

MoreLess

Memory Usage Benchmark Learn more how we collect the data

Before plugin activation
After plugin activation

Benchmark

Change

Average Change

+ 93.48KB

/ (front page)

+ 1.22KB

/wp-admin/edit-comments.php

+ 15.6KB

/wp-admin/edit-tags.php?taxonomy=category

+ 15.74KB

/wp-admin/edit.php

+ 7.74KB

/wp-admin/index.php

+ 7.74KB

/wp-admin/media-new.php

+ 16.62KB

/wp-admin/options-discussion.php

+ 16.66KB

/wp-admin/options-writing.php

+ 14.58KB

/wp-admin/post-new.php

+ 8.29KB

/wp-admin/post-new.php?post_type=page

+ 7.74KB

/wp-admin/upload.php

+ 16.6KB

MoreLess

User Rating of Ad Code Manager from WP Hive Users

Overall Quality

Measures the overall quality

Ease of Use

How easy it is to use?

Quality of Support

Satisfied or not?

Value for Money

Is it good bang for the buck?

Features

Is it feature riched?

Rate Now

Stats

Download Statistics

Plugin Version Usage

Database Tables

The plugin has added 0 additional options to your WordPress.

WP-Options

The plugin has added 1 additional options to your WordPress website.

widget_acm_ad_zones

Show Off Your Plugin

PHP 7.4.8

WP 5.9.2

PHP 7.4.8 WP 5.9.2

Love using this plugin?

Why don’t you compare the plugin side by side
with another plugin

Start Comparing

Ratings & Reviews

Overall Quality

Ease of Use

Quality of Support

Value for Money

Features

Like what you see?

Subscribe to get more quality reviews and articles.

Ad Code Manager

Version : 0.6.0

Want to write review?

All right sparky!

24K

200

10 years

0.0%

1

0

00

00

About Ad Code Manager

Description

Configuration Filters

acm_ad_tag_ids

acm_default_url

acm_output_html

acm_register_provider_slug

acm_whitelisted_script_urls

acm_output_tokens

acm_whitelisted_conditionals

acm_conditional_args

acm_display_ad_codes_without_conditionals

acm_provider_slug

acm_logical_operator

acm_manage_ads_cap

acm_allowed_get_posts_args

acm_ad_code_count

acm_list_table_columns

acm_ad_code_args

Performance

Memory Usage

Page Speed

<img decoding="async" width="67" height="67" loading="lazy" src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossy,ret_img,w_67,h_67/https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/speed-test-bm.png" alt=""> Speed Test Benchmark Learn more how we collect the data

Pages

Benchmark

Change

Pages

Benchmark

Change

User Rating of Ad Code Manager from WP Hive Users

Overall Quality

Ease of Use

Quality of Support

Value for Money

Features

<img decoding="async" width="81" height="81" loading="lazy" src="https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/stats-image.svg" alt="Stats"> Stats

Download Statistics

Plugin Version Usage

<img decoding="async" width="53" height="53" loading="lazy" src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossy,ret_img,w_53,h_53/https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/more-icon.png" alt="Stats"> More

Database Tables

WP-Options

Show Off Your Plugin

PHP 7.4.8

WP 5.9.2

<img decoding="async" src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossy,ret_img/https://wphive.com/wp-content/themes/twenty20-child/assets/images/pluginReport/hive-logo-color.png" alt="Logo">

Love using this plugin?

Ratings & Reviews

Like what you see?

Social Reviews and Recommendations Widgets Review Write a Review

Are you an author of this plugin?

Stina Gunnarsdottir

Overall

Easy of Use

Features

Quality of Support

Value for Money

Changelog

Speed Test Benchmark Learn more how we collect the data

Stats

More

Are you an author
of this plugin?