Rankwell Ad Manager

Leírás

Rankwell Ad Manager is a lightweight, enterprise-grade ad management plugin designed for high-traffic sites. Create, schedule, and display advertisements anywhere on your site with precision targeting, caching compatibility, and strict security standards.

Why Rankwell Ad Manager?

Unlike bloated ad plugins that slow down your site or open your database to Cross-Site Scripting (XSS) vulnerabilities via raw script injection, Rankwell Ad Manager is built with a highly secure, performance-first architecture:

  • 100% Secure ID-Based Integration – Never expose your site to arbitrary script injection. Just enter your AdSense, MGID, or Tracking IDs, and the plugin safely hardcodes the required scripts on the frontend.
  • Zero frontend bloat – Only loads what’s needed, when it’s needed.
  • Cache-safe device targeting – CSS-based visibility ensures ads display correctly even with full-page caching.
  • Transient-based queries – Database queries are cached, eliminating repeated meta queries on every page load.
  • CLS prevention – Image ads automatically include width/height attributes to prevent layout shifts.
  • Slot reservation system – Explicit inventory management prevents ad oversaturation per format, device, and placement.

Features

  • Secure Ad Types: Google AdSense, MGID Native Ads, Direct Image Ads.
  • Site-Wide Tracking & Auto Ads: Secure configuration for GA4, Google Tag Manager (GTM), Meta (Facebook) Pixel, AdSense Auto Ads, and MGID Site Scripts.
  • Smart Placement: Before/after content, before specific paragraphs, middle of content.
  • Compliant Ad Labels: Mandatory, non-removable „Advertisement” labels on all ad units.
  • Slot Reservation System: Capacity-based inventory management per ad format with overflow queue.
  • Device Targeting: Desktop-only or mobile-only ads (cache-safe via CSS).
  • Scheduling: Set start and end dates for time-sensitive campaigns.
  • Post Type Filtering: Choose which post types display each ad.
  • Post Exclusion: Exclude specific posts from showing ads.
  • Clone & Quick Toggle: Clone ad units and toggle active status from the list view.
  • Shortcode Support: [rankwell_ad id=”123″] for manual placement.
  • Template Tag: rankwell_display_ad(123) for theme developers.

PRODUCTION-READY ARCHITECTURE

Built by Omajemite Don (author of BotFend Anti-Bot Firewall and Rankwell SEO), this plugin follows WP Coding Standards with:

  • Strict sanitization and ID-only database saving (No unfiltered_html required)
  • PSR-4 autoloading
  • PHP 8.0+ typed properties and return types
  • Nonce verification on all forms
  • Capability checks for admin actions
  • Transient caching for database queries
  • CSS-based device visibility (full-page cache compatible)
  • DOM-safe paragraph insertion (regex-based, never breaks HTML)
  • Vanilla JavaScript — zero jQuery dependency

Usage

  1. Go to Ad Manager Add New Ad
  2. Choose your ad network (Google AdSense, MGID, or Image Ad)
  3. Enter your Publisher ID/Widget ID, or configure your image
  4. Set display rules (position, device, schedule, post types)
  5. Publish and your ad is live!

For site-wide tracking (GA4, GTM, Meta Pixel) and Auto Ads, go to Ad Manager Tracking & Auto Ads.

Shortcode

[rankwell_ad id="123"]

Replace 123 with your ad unit ID.

Template Tag

<?php if ( function_exists( 'rankwell_display_ad' ) ) { rankwell_display_ad( 123 ); } ?>

External Services

This plugin securely integrates with the following third-party services to provide ad management and performance tracking. By using these services, data may be transmitted to their respective platforms as per their policies:

  • Google AdSense: Used for ad serving and monetization.

    • Data transmitted: Ad requests, browser information, and publisher IDs.
    • Terms of Service: https://policies.google.com/terms
    • Privacy Policy: https://policies.google.com/privacy
  • Google Tag Manager (GTM): Used to manage and deploy marketing and analytics tags.

    • Data transmitted: Browser interaction and analytical data.
    • Terms of Service: https://marketingplatform.google.com/about/analytics/terms/us/
    • Privacy Policy: https://policies.google.com/privacy
  • MGID: Used for native ad delivery.

    • Data transmitted: Site ID and interaction metrics.
    • Terms of Service: https://www.mgid.com/terms-and-conditions
    • Privacy Policy: https://www.mgid.com/privacy-policy
  • Meta Pixel (Facebook): Used for conversion tracking and ad performance analysis.

    • Data transmitted: Page view events and pixel identifiers.
    • Terms of Service: https://www.facebook.com/legal/terms
    • Privacy Policy: https://www.facebook.com/privacy/policy/

Telepítés

  1. Upload the rankwell-ad-manager folder to /wp-content/plugins/ or install via the plugin directory
  2. Activate the plugin through the ‘Plugins’ menu in the admin area
  3. Go to Ad Manager Add New Ad to create your first ad
  4. For site-wide scripts, go to Ad Manager Tracking & Auto Ads

GYIK

Does this work with full-page caching?

Yes! Device targeting uses CSS media queries instead of server-side detection, so desktop/mobile ads display correctly even with aggressive page caching (LiteSpeed, WP Rocket, W3TC, etc.).

How does the plugin handle security?

Rankwell Ad Manager is strictly ID-based. Instead of allowing users to paste raw, potentially dangerous <script> tags, you simply provide your numeric/alphanumeric IDs (e.g., your AdSense Publisher ID or MGID Widget ID). The plugin safely generates the verified code on the frontend, completely eliminating XSS vulnerabilities.

Does this support Google AdSense?

Absolutely. You can add individual AdSense units by entering your Publisher ID and Slot ID, or enter your Publisher ID in the Tracking & Auto Ads page for site-wide Auto Ads.

Does this work with MGID, Taboola, or Media.net?

Yes! The plugin natively supports MGID via secure Widget IDs. If you need to deploy Taboola or other networks, you can do so safely using the built-in Google Tag Manager (GTM) integration on the Tracking & Auto Ads page.

Will this slow down my site?

No. The plugin uses transient caching for ad queries, loads minimal CSS only when needed, and uses DOM-safe regex for content insertion. It’s built for high-traffic news sites.

Is it GDPR compliant?

The plugin itself does not set cookies or track users. However, the ad networks you use (AdSense, MGID, etc.) have their own compliance requirements. All ads include mandatory „Advertisement” labels for clear content distinction.

Can I schedule ads?

Yes! Each ad unit has start and end date fields for time-sensitive campaigns.

How does the slot reservation system work?

Each ad format (728×90, 300×250, etc.) has a defined capacity per position and device. When capacity is reached, additional ads go into an overflow queue and automatically activate when a slot opens. This prevents ad oversaturation while maximizing fill rate.

Vélemények

Nincsenek értékelések erről a bővítményről.

Közreműködők és fejlesztők

“Rankwell Ad Manager” egy nyílt forráskódú szoftver. A bővítményhez a következő személyek járultak hozzá:

Közreműködők

“Rankwell Ad Manager” fordítása a saját nyelvünkre.

Érdekeltek vagyunk a fejlesztésben?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Változási napló

1.3.0

  • SECURITY PIVOT: Completely removed all arbitrary script injection vulnerabilities to comply with strict WordPress.org repository guidelines.
  • Added: Native, secure ID-based support for MGID widgets and site scripts.
  • Added: Secure ID-based integrations for Google Tag Manager (GTM) and Meta (Facebook) Pixel.
  • Changed: Replaced raw AdSense code textareas with secure Publisher ID and Slot ID inputs.
  • Changed: Renamed „Advanced Scripts” to „Tracking & Auto Ads”.
  • Changed: Removed legacy raw textareas for header, body, and footer injection.

1.1.0

  • Added: Slot reservation system with capacity-based inventory management per ad format
  • Added: Overflow queue with automatic promotion when slots open
  • Added: Priority-based ad ordering within reserved slots
  • Changed: Ad labels are now mandatory and non-customizable for compliance
  • Changed: „After Paragraph” repositioned to „Before Paragraph” for intuitive placement
  • Changed: Zero jQuery dependency — pure vanilla JavaScript
  • Fixed: Inner content wrapper prevents ad code from breaking page layout

1.0.0

  • Initial release