Placewell

Description

Placewell is an ad spot manager for publishers who sell sponsorships directly: local news sites, newsletters, podcasts, community and nonprofit sites.

Spots

  • Standard IAB sizes (leaderboard, medium rectangle, skyscraper, half page, billboard, mobile banner…) or custom sizes
  • A different size per device, or hidden on a device
  • Space is reserved before the page loads, so content never jumps
  • Place spots with a block, a shortcode, a widget, a template tag, or automatic insertion (before/after content, after paragraph N, between posts on blog, category, tag and search pages, sticky mobile bar)
  • Optional fallback HTML (“Your business here”) when nothing is booked

Campaigns and creatives

  • Image, GIF, video and HTML creatives with click-through links (HTML creatives are plain markup: no scripts or frames)
  • Upload a version per size; each device gets the best fit, with coverage warnings in the admin
  • Weighted rotation, never the same creative twice on one page
  • Start and end dates, per-creative and per-placement expiration, expiry reminder emails
  • Device, content-type, category and tag targeting, frequency caps
  • Automatic UTM tagging of every click with tokens like {spot} and {size}, plus a UTM Builder

Creative Library

  • Upload creatives with instant checks before anything is stored: file type, weight, dimensions and video length
  • Strict file rules you control: allowed types (JPEG, PNG, WebP, AVIF, GIF, MP4, WebM; never SVG), size limits per format, max dimensions
  • Preview any file inside your real spots on a desktop and phone mock page, plus every slot at actual size
  • See which standard size each file fits (exact, 2× retina, or scaled) and how close it is to its weight limit
  • Start a creative straight from a Library file

Honest analytics

  • Viewable impressions (50% on screen for 1 second, 2 for video) as the headline number
  • Video starts and quartiles, clicks, CTR, daily uniques
  • Signed tokens: views and clicks can’t be faked by posting made-up events
  • Bots, automated browsers and suspicious clicks are filtered and reported separately
  • Reports by day, campaign, creative, spot, device and country, with CSV export and a branded PDF report
  • Optional Google Analytics 4 events

Switch from another ad plugin

  • Import ads, groups and placements from AdRotate, Advanced Ads and WP QUADS in a few clicks, with a preview first
  • The other plugin’s data is only read, never changed, and an import can be undone
  • After you switch the old plugin off, its shortcodes keep working and show your Placewell spots: [adrotate], [the_ad], [the_ad_group], [the_ad_placement] and [quads]. AdRotate’s and Advanced Ads’ theme functions keep working too.

Built for real sites

  • Works behind full-page caches and CDNs
  • No cookies; visitor counting uses a daily-rotating hash, no personal data stored
  • Better Ads guardrails: sticky bars capped at 30% of the screen, muted video only
  • Neutral class names and URLs

External services

Placewell doesn’t connect to any outside service on its own. Ads, stats and reports are served and stored on your site.

Google Analytics 4 (optional, off by default): when “Send views and clicks to Google Analytics 4” is on under Settings and your site already loads Google’s gtag.js, Placewell passes placewell_view and placewell_click events (campaign, creative and spot names) to that tag, which sends them to Google Analytics. Placewell does not load gtag.js itself. Google’s terms: https://marketingplatform.google.com/about/analytics/terms/us/ and privacy policy: https://policies.google.com/privacy

Credits

The admin uses a Latin subset of Lora by The Lora Project Authors, licensed under the SIL Open Font License 1.1 (see assets/fonts/OFL.txt).

Screenshots

Blocks

This plugin provides 1 block.

  • Placewell Spot

Installation

  1. Upload the placewell folder to /wp-content/plugins/, or upload the zip under Plugins Add New.
  2. Activate the plugin.
  3. Go to Placewell Spots and create a spot.
  4. Add an advertiser and a campaign, then add creatives to the campaign.
  5. Put the spot on your site with the Placewell Spot block, [placewell spot="your-slug"], the Placewell Spot widget, or automatic insertion.

FAQ

Can I move my ads from AdRotate, Advanced Ads or WP QUADS?

Yes. Go to Placewell Settings Move from another ad plugin. You’ll see what will come over before anything is imported. Ads become creatives, groups and placements become spots, and the old plugin’s shortcodes show the matching spots once it’s switched off. Stats from the old plugin aren’t copied.

Is there a Pro version?

Placewell Pro is a separate plugin sold at https://placewellads.com/pricing/. It adds emailed PDF reports for advertisers, report branding, a country database so countries are known on any host, and country targeting. Everything in this plugin is free and fully working without it.

Where do country stats come from?

From the visitor’s country that your CDN or host already adds to each request: Cloudflare, Amazon CloudFront, host GeoIP (WP Engine, Kinsta and others) or Google App Engine. Nothing is looked up or sent anywhere. Without one of these, visits are counted as “Unknown” country.

Why don’t my stats update instantly?

Raw events are rolled up into daily totals every hour, and whenever you open the Dashboard or Reports. Use “Refresh stats” on the Reports screen to rebuild any range.

Are WP-Cron jobs required?

The hourly rollup and daily cleanup run on WP-Cron. On low-traffic sites, set up a real cron job that calls wp-cron.php for reliable timing. Expiration is always enforced when serving, so expired creatives never show even if cron is late.

How do HTML creatives count clicks?

Use {click_url} as the link target, for example <a href="{click_url}">. HTML creatives are plain markup (links, images, text and inline styles); scripts, frames and forms are removed when you save. For AdSense and other ad networks, use the network’s own plugin.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Placewell” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Placewell” into your language.

Interested in development?

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

Changelog

0.6.0

  • New automatic position: between posts on list pages, every N posts, up to a set number per page. Each copy shows a different creative. Works with classic themes and with Query Loop blocks in block themes.
  • Spots can be placed on category, tag, blog, search, other term and archive pages. Sticky bars can be limited to chosen list pages too.
  • Category and tag targeting: limit a campaign to chosen categories, tags or custom terms, or keep it off them. Matches the archive pages and posts filed under them, including sub-categories.
  • Report grouping tabs are spaced out.
  • Import from AdRotate, Advanced Ads and WP QUADS, with a preview, re-runs that only bring in new ads, and undo. Their shortcodes and theme functions keep working once those plugins are off. Ads that need scripts or frames, such as AdSense units, are listed and skipped.
  • HTML creatives and fallback HTML are always plain markup: scripts, frames and forms are removed.
  • Spot size rules load with the Placewell stylesheet in the page head.
  • Suggested privacy policy text under Settings Privacy.
  • Translation template in languages/placewell.pot.
  • Reports by country, using the country your CDN or host adds to each request (Cloudflare, CloudFront, host GeoIP, App Engine). Filled from the raw events still on file when you update.
  • Campaign targeting keeps settings from add-ons even while the add-on is switched off, so saving a campaign never drops them.
  • Developer hooks: placewell_normalize_targeting, placewell_page_context, placewell_visitor_country, the placewell.reportGroups admin slot, a page context argument on placewell_targeting_ok and placewell_candidates, and the placewell.campaignTargetingFields admin slot.

0.5.0

  • Every creative now has required start and end dates, set together under Run dates, with quick lengths (1 week, 2 weeks, 30 days, until the campaign ends).
  • The creative type is detected from the file you pick: images and GIFs become image creatives, videos become video creatives. Choose “HTML code” for HTML.
  • Removed the button label field from the creative editor.
  • Each spot has an embed code generator for shortcodes, blocks, theme PHP and widgets, with position, spacing and an extra CSS class.
  • The shortcode, block and placewell_spot() accept align, spacing and class options.
  • New admin design: racing green and brass, a serif for titles and figures, sentence-case labels and a cleaner navigation.
  • Reports can be downloaded as a branded PDF: summary, daily chart, and breakdowns by device, creative, placement and video viewing.
  • Ads now load through the same address as the page, so they keep working behind proxies, CDNs and after domain changes.
  • Developer hooks for add-ons: PHP actions and filters for settings, data fields, ad selection, reports and daily jobs, plus admin screen slots through wp.hooks.

0.4.0

  • Spots open as a full page with a live desktop, tablet and phone preview that follows the chosen placement.
  • Add, upload and preview creatives right from the spot, with a campaign picker (or a new campaign and advertiser inline).
  • Clear device coverage: each creative and spot shows which devices it fills, and which size is missing (e.g. “Phones need a 320×50 version”), with a one-click “Add 320×50 version”.
  • Visual placement picker and a “Where it appears” list of pages, posts and widgets using the spot.

0.3.0

  • Creative Library with drag-and-drop upload, pre-upload checks and previews.
  • File rules: allowed types, size limits per format, max dimensions and video length; strict or warn-only.
  • Preview in spots on desktop and phone mock pages, from the Library and the creative editor.
  • File rules are enforced when a creative is saved; older creatives stay editable.

0.2.0

  • Spots, advertisers, campaigns and creatives with full admin screens.
  • Serving with weighted rotation, per-device sizes, targeting, frequency caps and expiration.
  • Viewability, video quartile and click tracking with invalid-traffic filtering.
  • Reports with CSV export, dashboard, settings, expiry reminders.
  • Block, shortcode, widget, template tag, automatic insertion and sticky bar.
  • UTM Builder and automatic UTM tagging.

0.1.0

  • Plugin scaffold.