Installation and requirements

WP Ad Inserter is an ordinary WordPress plugin. Installation takes a minute.

Requirements

  • WordPress 6.0 or newer.
  • PHP 7.4 or newer.
  • The PHP zlib extension to download and update the GeoIP database (most hosts have it).
  • WP-Cron, or a real cron job that calls it, for the weekly GeoIP update.

Install

  1. Download wpadinserter.zip.
  2. In WordPress open Plugins → Add New → Upload Plugin, choose the ZIP and click Install Now. Or unpack it and upload the wpadinserter folder to /wp-content/plugins/.
  3. Click Activate.
  4. Open WP Ad Inserter → Ad campaigns.

The plugin includes a country GeoIP database, so country targeting works right after activation.

Updates

The plugin asks www.cyberseo.net whether a newer version exists. When it does, WordPress shows it on the Plugins and Updates pages and you update with one click, as with any plugin.

Where the data is stored

WhatWhere
CampaignsThe option wpai_campaigns.
Plugin settingsThe option wpai_options.
Impression and click countersOptions per campaign and per ad, wpai_hits_, wpai_clicks_, wpai_vh_ and wpai_vc_ followed by the campaign ID. They are not loaded on page views.
Downloaded GeoIP databasesThe folder wp-content/uploads/wpai-geoip/, so a plugin update does not remove them.
Backup after the 1.2 upgradeThe option wpai_campaigns_backup_v1 keeps the campaigns exactly as they were before the first run of version 1.2.

Upgrading from version 1.1

Campaigns are kept. On the first run of version 1.2 the plugin renames the old show_in_categoris field to show_in_categories and stores a copy of the original data in wpai_campaigns_backup_v1. All former Pro rules (city names, weekdays, showtime ranges) are available in every installation.

City names, weekdays and showtime ranges need the city-level GeoIP database. It is off by default because it is a large download. Switch it on on the Settings page. See GeoIP and visitor IP.

Install statistics

When the plugin is installed (the first activation on a site), activated, deactivated or uninstalled, it sends one request to www.cyberseo.net with the site address, the plugin version, the name of the event and the WordPress and PHP versions. Nothing else is sent. See the Privacy Policy. Developers can turn it off with the constant WPAI_DISABLE_NOTIFICATIONS or the filter wpai_send_notifications.

Uninstall

Deactivate and delete the plugin on the Plugins page. By default the data stays in the database, so you can reinstall without losing campaigns. To remove everything, switch on Delete plugin data on uninstall on the Settings page first. Then campaigns, settings, impression counters and the downloaded GeoIP files are deleted together with the plugin.