Skip to content

chriswgerber/dfp-ads

Repository files navigation

DFP Ad Manager

Build Status Code Climate Test CoverageCoverage Status

Table of Contents

Description

Contributors: chriswgerber Requires at least: 3.0.0
Tested up to: 4.2.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Tags: dfp, doubleclick, ads, ad trafficking, ad ops

Simpler management of DFP (DoubleClick for Publishers) ad positions

Installation

Install plugin

  1. Download Zip File
  2. Navigate to your website's admin page: example.com/wp-admin/
  3. Go to Plugins, "Add New"
  4. At the top of the page, choose "Upload Plugin"
  5. Upload zip file and install now
  6. Activate plugin

Set Up Ad Network

  1. Visit https://www.google.com/dfp/ and get your Account ID
    1. To find your Account ID, go to Settings. On the left sidebar, choose "Network Settings" and "All Network Settings".
    2. Copy your "Network Code". It should be an 8-digit integer for identifying your ad network.
  2. Visit the Ad Positions "Settings" in the WordPress Admin page.
  3. Add the DFP Network Code for Identifying the ad network for ad positions.

About

Purpose

Tired of dealing with creating and fixing the ad positions after each change, I decided to create a plugin that would make it easier to manage individual ad positions and add targeting for each of those positions.

Goals

The goal is to create a core set of functions that power a set of ad positions defined in DoubleClick. These ad positions will take custom targeting and display information passed through page level and individual tags.

Managing the tags will be made simple through an import function that works directly with the DFP export tools.

Roadmap

Below are a list of items that need to be completed before the plugin is ready for release.

  • Filter taxonomy names and values into page-level targeting for positions.
  • More precise validation of input values in custom metaboxes for ad positions.
  • Improve documentation on plugin.

Other priorities

  • Full Test Suite for current code and all new features.

Frequently Asked Questions

Submit your questions at www.chriswgerber.com/contact/

Changelog

0.3.2

  • 🆕 Adds DFP_CONCAT_SCRIPTS constant. Set as false to force the plugin to use un-minified scripts
  • 🐛🔫 Fixes array issue in javascript that would cause ads to not appear.
  • 🆒 Improves build scripts
  • 🆕 Adds Composer.lock file to force support for PHP 5.3 on all composer install
  • 💯 Various code quality improvements.

0.3.1

  • 🐛🔫 Fixes widget not displaying ad position correctly.
  • 💯 Various code quality improvements.

0.3.0

  • 🆕 Adds option to turn off asynchronous loading.
  • 🆒 Adds class dfp_ad_pos to ad tags.
  • 🐛 Fixes shortcode issue where content would always appear at the top of the content area.

0.2.5

  • Bug Fix - Ad CPT was overriding page meta. Fix implemented resets post data after use of WP_Query.

0.2.4

  • Fixes build

0.2.3

  • Bug fix

0.2.2

  • Fixed issue where settings were not being called.

0.2.1

  • Bug Fix: Added extra check to make sure plugin didn't attempt to add other CPTs as ad positions.
  • Enhancement: Added linting and uglifying to JS. Now serving minified JS.
  • Enhancement: Updated directory structure
  • Enhancement: Updated Readme to include screenshots and more information.

0.2.0

  • Added functionality for importing DFP Ads
  • Added Travis CI Integration.
  • Added Composer
  • Begin Unit Testing
  • Added Code Coverage Reporting
  • Updated JS to make extensions easier
  • Added Asynchronous ad loading
  • Made plugin compatible with PHP 5.3

0.1.0

  • Initial pre-release