{"id":404419,"date":"2026-11-17T00:22:23","date_gmt":"2026-11-17T00:22:23","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/placewell\/"},"modified":"2026-11-17T00:22:02","modified_gmt":"2026-11-17T00:22:02","slug":"placewell","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/placewell\/","author":23605129,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.6.0","stable_tag":"0.6.0","tested":"7.1.4","requires":"6.6","requires_php":"7.4","requires_plugins":null,"header_name":"Placewell","header_author":"Laws & Codes","header_description":"Sell and manage direct ad spots with honest, viewable-impression analytics. Cache-safe, responsive, and built to work with any theme.","last_updated":"2026-11-17 00:22:02","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/placewellads.com","header_author_uri":"https:\/\/lawscodes.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":43,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.6.0":{"tag":"0.6.0","author":"lawscodes","date":"2026-11-17 00:22:02","revision":3806303}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3806303,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3806303,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3806303,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3806303,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{"blueprint.json":{"filename":"blueprint.json","revision":3806303,"resolution":false,"location":"assets","locale":"","contents":"{\"$schema\":\"https:\\\/\\\/playground.wordpress.net\\\/blueprint-schema.json\",\"meta\":{\"title\":\"Placewell demo\",\"description\":\"Placewell with sample ad spots, two advertisers, example stats and a few posts to show the ads in.\",\"author\":\"lawscodes\",\"categories\":[\"Advertising\"]},\"landingPage\":\"\\\/wp-admin\\\/admin.php?page=placewell\",\"preferredVersions\":{\"php\":\"8.3\",\"wp\":\"latest\"},\"features\":{\"networking\":true},\"login\":true,\"steps\":[{\"step\":\"installPlugin\",\"pluginData\":{\"resource\":\"wordpress.org\\\/plugins\",\"slug\":\"placewell\"},\"options\":{\"activate\":true}},{\"step\":\"setSiteOptions\",\"options\":{\"blogname\":\"Flatbush Weekly (Placewell demo)\",\"permalink_structure\":\"\\\/%postname%\\\/\"}},{\"step\":\"writeFile\",\"path\":\"\\\/wordpress\\\/wp-content\\\/placewell-demo-seed.php\",\"data\":\"<?php\\n\\\/**\\n * Placewell demo content for WordPress Playground: two advertisers, three spots,\\n * HTML creatives that need no image files, a few posts to show them in, and\\n * 30 days of example stats so the reports have something to show.\\n *\\n * Run once on a fresh site with Placewell active.\\n *\\\/\\n\\nuse Placewell\\\\Db;\\nuse Placewell\\\\Frontend;\\nuse Placewell\\\\Resources;\\nuse Placewell\\\\Schema;\\n\\nif ( ! class_exists( Db::class ) ) {\\n\\treturn;\\n}\\nif ( get_option( 'placewell_demo_seeded' ) ) {\\n\\treturn;\\n}\\n\\n$now   = Db::now();\\n$start = gmdate( 'Y-m-d H:i:s', strtotime( '-30 days' ) );\\n$end   = gmdate( 'Y-m-d H:i:s', strtotime( '+60 days' ) );\\n\\n$ad = static function ( string $bg, string $fg, string $accent, string $kicker, string $line, string $cta, string $layout ): string {\\n\\t$base = \\\"box-sizing:border-box;width:100%;height:100%;display:flex;align-items:center;gap:4%;padding:0 4%;background:{$bg};color:{$fg};font-family:Georgia,serif;text-decoration:none;overflow:hidden;\\\";\\n\\t$btn  = \\\"margin-left:auto;padding:.5em 1.1em;border-radius:999px;background:{$accent};color:#fff;font:600 clamp(11px,1.6vw,15px)\\\/1 system-ui,sans-serif;white-space:nowrap;\\\";\\n\\tif ( 'box' === $layout ) {\\n\\t\\t$base = \\\"box-sizing:border-box;width:100%;height:100%;display:flex;flex-direction:column;justify-content:center;gap:12px;padding:8%;background:{$bg};color:{$fg};font-family:Georgia,serif;text-decoration:none;\\\";\\n\\t\\t$btn  = \\\"align-self:flex-start;padding:.6em 1.2em;border-radius:999px;background:{$accent};color:#fff;font:600 14px\\\/1 system-ui,sans-serif;\\\";\\n\\t}\\n\\treturn '<a href=\\\"{click_url}\\\" style=\\\"' . $base . '\\\">'\\n\\t\\t. '<span style=\\\"font:600 12px\\\/1.2 system-ui,sans-serif;color:' . $accent . ';\\\">' . esc_html( $kicker ) . '<\\\/span>'\\n\\t\\t. '<strong style=\\\"font-size:clamp(15px,2.4vw,26px);line-height:1.15;font-weight:600;\\\">' . esc_html( $line ) . '<\\\/strong>'\\n\\t\\t. '<span style=\\\"' . $btn . '\\\">' . esc_html( $cta ) . '<\\\/span><\\\/a>';\\n};\\n\\n$advertisers = array(\\n\\tarray( 'Kettle & Crumb Bakery', 'Fresh sourdough, every morning', '#F4E9DC', '#3A2A1E', '#C2502E', 'Kettle & Crumb', 'Order ahead' ),\\n\\tarray( 'Northside Cycles', 'Spring tune-ups from $49', '#17352D', '#F3F4F0', '#D9A441', 'Northside Cycles', 'Book a tune-up' ),\\n);\\n\\n\\\/\\\/ Spots.\\n$spots = array(\\n\\t'header-banner' => array( 'Header banner', array( 'desktop' => '728x90', 'tablet' => '728x90', 'mobile' => '320x50' ), array( 'mode' => 'before_content' ) ),\\n\\t'in-article'    => array( 'In article', array( 'desktop' => '300x250', 'tablet' => '300x250', 'mobile' => '300x250' ), array( 'mode' => 'after_paragraph', 'paragraph' => 2 ) ),\\n\\t'between-posts' => array( 'Between posts', array( 'desktop' => '728x90', 'tablet' => '728x90', 'mobile' => '320x50' ), array( 'mode' => 'between_posts', 'every' => 2, 'max' => 2 ) ),\\n);\\n$spot_ids = array();\\nforeach ( $spots as $slug => list( $name, $sizes, $insertion ) ) {\\n\\t$spot_ids[ $slug ] = Db::insert(\\n\\t\\t'spots',\\n\\t\\tarray(\\n\\t\\t\\t'slug'          => $slug,\\n\\t\\t\\t'name'          => $name,\\n\\t\\t\\t'sizes'         => wp_json_encode( $sizes ),\\n\\t\\t\\t'formats'       => 'any',\\n\\t\\t\\t'rotation'      => 'weighted',\\n\\t\\t\\t'insertion'     => wp_json_encode( Frontend::normalize_insertion( $insertion ) ),\\n\\t\\t\\t'fallback_html' => '',\\n\\t\\t\\t'status'        => 'active',\\n\\t\\t\\t'created_at'    => $now,\\n\\t\\t\\t'updated_at'    => $now,\\n\\t\\t)\\n\\t);\\n}\\n\\n\\\/\\\/ Advertisers, campaigns and creatives.\\n$creatives = array();\\nforeach ( $advertisers as list( $name, $line, $bg, $fg, $accent, $kicker, $cta ) ) {\\n\\t$adv  = Db::insert( 'advertisers', array( 'name' => $name, 'email' => '', 'created_at' => $now, 'updated_at' => $now ) );\\n\\t$camp = Db::insert(\\n\\t\\t'campaigns',\\n\\t\\tarray(\\n\\t\\t\\t'advertiser_id' => $adv,\\n\\t\\t\\t'name'          => $name . ' \\u2013 autumn',\\n\\t\\t\\t'start_at'      => $start,\\n\\t\\t\\t'end_at'        => $end,\\n\\t\\t\\t'targeting'     => wp_json_encode( Resources::normalize_targeting( array() ) ),\\n\\t\\t\\t'utm'           => wp_json_encode( Resources::default_utm() ),\\n\\t\\t\\t'status'        => 'active',\\n\\t\\t\\t'created_at'    => $now,\\n\\t\\t\\t'updated_at'    => $now,\\n\\t\\t)\\n\\t);\\n\\tforeach ( array( 'banner' => 'row', 'box' => 'box' ) as $label => $layout ) {\\n\\t\\t$creatives[] = array(\\n\\t\\t\\t'campaign' => $camp,\\n\\t\\t\\t'layout'   => $layout,\\n\\t\\t\\t'id'       => Db::insert(\\n\\t\\t\\t\\t'creatives',\\n\\t\\t\\t\\tarray(\\n\\t\\t\\t\\t\\t'campaign_id'       => $camp,\\n\\t\\t\\t\\t\\t'name'              => $kicker . ' ' . $label,\\n\\t\\t\\t\\t\\t'type'              => 'html',\\n\\t\\t\\t\\t\\t'html'              => $ad( $bg, $fg, $accent, $kicker, $line, $cta, $layout ),\\n\\t\\t\\t\\t\\t'alt'               => $line,\\n\\t\\t\\t\\t\\t'starts_at'         => $start,\\n\\t\\t\\t\\t\\t'expires_at'        => $end,\\n\\t\\t\\t\\t\\t'status'            => 'approved',\\n\\t\\t\\t\\t\\t'moderation_status' => 'approved',\\n\\t\\t\\t\\t\\t'created_at'        => $now,\\n\\t\\t\\t\\t\\t'updated_at'        => $now,\\n\\t\\t\\t\\t)\\n\\t\\t\\t),\\n\\t\\t);\\n\\t}\\n}\\n\\n\\\/\\\/ Wide creatives go in the banner spots, boxes in the article.\\nforeach ( $creatives as $c ) {\\n\\t$targets = 'box' === $c['layout'] ? array( 'in-article' ) : array( 'header-banner', 'between-posts' );\\n\\tforeach ( $targets as $slug ) {\\n\\t\\tDb::insert( 'placements', array( 'creative_id' => $c['id'], 'spot_id' => $spot_ids[ $slug ], 'weight' => 10, 'status' => 'active' ) );\\n\\t}\\n}\\n\\n\\\/\\\/ Posts to show the ads in.\\n$paragraphs = '<!-- wp:paragraph --><p>Neighborhood news, events and the people who make this place what it is. This is sample content so you can see where Placewell puts ads.<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:paragraph --><p>The in-article spot appears after this paragraph on desktop, tablet and phone, at its own size on each.<\\\/p><!-- \\\/wp:paragraph -->'\\n\\t. '<!-- wp:paragraph --><p>Open Placewell in the admin to change sizes, positions and creatives, or download a PDF report from the Reports screen.<\\\/p><!-- \\\/wp:paragraph -->';\\n$titles = array( 'Farmers market moves to Saturdays', 'New bike lanes on Cortelyou Road', 'Library extends weekend hours', 'Block party returns in June', 'Local bakery wins citywide award' );\\n$first  = 0;\\nforeach ( $titles as $i => $title ) {\\n\\t$id = wp_insert_post(\\n\\t\\tarray(\\n\\t\\t\\t'post_title'   => $title,\\n\\t\\t\\t'post_content' => $paragraphs,\\n\\t\\t\\t'post_status'  => 'publish',\\n\\t\\t\\t'post_author'  => 1,\\n\\t\\t\\t'post_date'    => gmdate( 'Y-m-d H:i:s', strtotime( '-' . ( $i + 1 ) . ' days' ) ),\\n\\t\\t)\\n\\t);\\n\\t$first = $first ? $first : $id;\\n}\\n\\n\\\/\\\/ 30 days of example stats.\\nglobal $wpdb;\\n$stats   = Schema::table( 'stats_daily' );\\n$devices = array( 'desktop' => 1.0, 'mobile' => 0.85, 'tablet' => 0.15 );\\nmt_srand( 42 );\\nfor ( $d = 29; $d >= 0; $d-- ) {\\n\\t$date    = current_datetime()->modify( \\\"-{$d} days\\\" );\\n\\t$weekend = in_array( (int) $date->format( 'N' ), array( 6, 7 ), true ) ? 0.7 : 1;\\n\\tforeach ( $creatives as $c ) {\\n\\t\\tforeach ( $devices as $device => $f ) {\\n\\t\\t\\t$served = (int) ( mt_rand( 140, 280 ) * $f * $weekend * ( 1 + ( 29 - $d ) \\\/ 70 ) );\\n\\t\\t\\t$view   = (int) ( $served * mt_rand( 60, 78 ) \\\/ 100 );\\n\\t\\t\\t$wpdb->insert( \\\/\\\/ phpcs:ignore WordPress.DB.DirectDatabaseQuery\\n\\t\\t\\t\\t$stats,\\n\\t\\t\\t\\tarray(\\n\\t\\t\\t\\t\\t'day'         => $date->format( 'Y-m-d' ),\\n\\t\\t\\t\\t\\t'campaign_id' => $c['campaign'],\\n\\t\\t\\t\\t\\t'creative_id' => $c['id'],\\n\\t\\t\\t\\t\\t'spot_id'     => 'box' === $c['layout'] ? $spot_ids['in-article'] : $spot_ids['header-banner'],\\n\\t\\t\\t\\t\\t'device'      => $device,\\n\\t\\t\\t\\t\\t'served'      => $served,\\n\\t\\t\\t\\t\\t'viewable'    => $view,\\n\\t\\t\\t\\t\\t'clicks'      => (int) round( $view * mt_rand( 6, 20 ) \\\/ 1000 ),\\n\\t\\t\\t\\t\\t'uniques'     => (int) ( $view * 0.7 ),\\n\\t\\t\\t\\t\\t'invalid'     => mt_rand( 0, 5 ),\\n\\t\\t\\t\\t)\\n\\t\\t\\t);\\n\\t\\t}\\n\\t}\\n}\\n\\\/\\\/ Keep the example numbers: don't rebuild recent days from the (empty) raw log for a while.\\nset_transient( 'placewell_quick_rollup', 1, HOUR_IN_SECONDS );\\nwp_clear_scheduled_hook( 'placewell_rollup' );\\n\\nupdate_option( 'placewell_demo_seeded', time() );\\nupdate_option( 'placewell_demo_post', $first );\\n\"},{\"step\":\"runPHP\",\"code\":\"<?php require '\\\/wordpress\\\/wp-load.php'; require WP_CONTENT_DIR . '\\\/placewell-demo-seed.php';\"}]}"}},"all_blocks":{"placewell\/spot":{"name":"placewell\/spot","title":"Placewell Spot"}},"tagged_versions":["0.6.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3806303,"resolution":"1","location":"assets","locale":"","width":1440,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3806303,"resolution":"2","location":"assets","locale":"","width":1440,"height":900},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3806303,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3806303,"resolution":"4","location":"assets","locale":"","width":1440,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3806303,"resolution":"5","location":"assets","locale":"","width":1440,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3806303,"resolution":"6","location":"assets","locale":"","width":1440,"height":900}},"screenshots":{"1":"The dashboard: viewable impressions, clicks and campaigns ending soon.","2":"A spot: size per device, where it goes on the page, and a live preview with the creatives that fit.","3":"Campaign targeting: devices, content types, categories and tags, and frequency caps.","4":"Reports by day, campaign, creative, spot and device.","5":"The PDF report, ready to send to an advertiser.","6":"Importing ads from AdRotate, Advanced Ads and WP QUADS."}},"plugin_section":[],"plugin_tags":[2533,368,232,2608,2606],"plugin_category":[35,36],"plugin_contributors":[293293],"plugin_business_model":[],"class_list":["post-404419","plugin","type-plugin","status-publish","hentry","plugin_tags-ad-manager","plugin_tags-advertising","plugin_tags-analytics","plugin_tags-banners","plugin_tags-sponsors","plugin_category-advertising","plugin_category-analytics","plugin_contributors-lawscodes","plugin_committers-lawscodes"],"banners":{"banner":"https:\/\/ps.w.org\/placewell\/assets\/banner-772x250.png?rev=3806303","banner_2x":"https:\/\/ps.w.org\/placewell\/assets\/banner-1544x500.png?rev=3806303","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/placewell\/assets\/icon-128x128.png?rev=3806303","icon_2x":"https:\/\/ps.w.org\/placewell\/assets\/icon-256x256.png?rev=3806303","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-1.png?rev=3806303","caption":"The dashboard: viewable impressions, clicks and campaigns ending soon."},{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-2.png?rev=3806303","caption":"A spot: size per device, where it goes on the page, and a live preview with the creatives that fit."},{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-3.png?rev=3806303","caption":"Campaign targeting: devices, content types, categories and tags, and frequency caps."},{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-4.png?rev=3806303","caption":"Reports by day, campaign, creative, spot and device."},{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-5.png?rev=3806303","caption":"The PDF report, ready to send to an advertiser."},{"src":"https:\/\/ps.w.org\/placewell\/assets\/screenshot-6.png?rev=3806303","caption":"Importing ads from AdRotate, Advanced Ads and WP QUADS."}],"raw_content":"<!--section=description-->\n<p>Placewell is an ad spot manager for publishers who sell sponsorships directly: local news sites, newsletters, podcasts, community and nonprofit sites.<\/p>\n\n<h4>Spots<\/h4>\n\n<ul>\n<li>Standard IAB sizes (leaderboard, medium rectangle, skyscraper, half page, billboard, mobile banner\u2026) or custom sizes<\/li>\n<li>A different size per device, or hidden on a device<\/li>\n<li>Space is reserved before the page loads, so content never jumps<\/li>\n<li>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)<\/li>\n<li>Optional fallback HTML (\"Your business here\") when nothing is booked<\/li>\n<\/ul>\n\n<h4>Campaigns and creatives<\/h4>\n\n<ul>\n<li>Image, GIF, video and HTML creatives with click-through links (HTML creatives are plain markup: no scripts or frames)<\/li>\n<li>Upload a version per size; each device gets the best fit, with coverage warnings in the admin<\/li>\n<li>Weighted rotation, never the same creative twice on one page<\/li>\n<li>Start and end dates, per-creative and per-placement expiration, expiry reminder emails<\/li>\n<li>Device, content-type, category and tag targeting, frequency caps<\/li>\n<li>Automatic UTM tagging of every click with tokens like {spot} and {size}, plus a UTM Builder<\/li>\n<\/ul>\n\n<h4>Creative Library<\/h4>\n\n<ul>\n<li>Upload creatives with instant checks before anything is stored: file type, weight, dimensions and video length<\/li>\n<li>Strict file rules you control: allowed types (JPEG, PNG, WebP, AVIF, GIF, MP4, WebM; never SVG), size limits per format, max dimensions<\/li>\n<li>Preview any file inside your real spots on a desktop and phone mock page, plus every slot at actual size<\/li>\n<li>See which standard size each file fits (exact, 2\u00d7 retina, or scaled) and how close it is to its weight limit<\/li>\n<li>Start a creative straight from a Library file<\/li>\n<\/ul>\n\n<h4>Honest analytics<\/h4>\n\n<ul>\n<li>Viewable impressions (50% on screen for 1 second, 2 for video) as the headline number<\/li>\n<li>Video starts and quartiles, clicks, CTR, daily uniques<\/li>\n<li>Signed tokens: views and clicks can't be faked by posting made-up events<\/li>\n<li>Bots, automated browsers and suspicious clicks are filtered and reported separately<\/li>\n<li>Reports by day, campaign, creative, spot, device and country, with CSV export and a branded PDF report<\/li>\n<li>Optional Google Analytics 4 events<\/li>\n<\/ul>\n\n<h4>Switch from another ad plugin<\/h4>\n\n<ul>\n<li>Import ads, groups and placements from AdRotate, Advanced Ads and WP QUADS in a few clicks, with a preview first<\/li>\n<li>The other plugin's data is only read, never changed, and an import can be undone<\/li>\n<li>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.<\/li>\n<\/ul>\n\n<h4>Built for real sites<\/h4>\n\n<ul>\n<li>Works behind full-page caches and CDNs<\/li>\n<li>No cookies; visitor counting uses a daily-rotating hash, no personal data stored<\/li>\n<li>Better Ads guardrails: sticky bars capped at 30% of the screen, muted video only<\/li>\n<li>Neutral class names and URLs<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>Placewell doesn't connect to any outside service on its own. Ads, stats and reports are served and stored on your site.<\/p>\n\n<p>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<\/p>\n\n<h3>Credits<\/h3>\n\n<p>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).<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>placewell<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or upload the zip under Plugins \u2192 Add New.<\/li>\n<li>Activate the plugin.<\/li>\n<li>Go to Placewell \u2192 Spots and create a spot.<\/li>\n<li>Add an advertiser and a campaign, then add creatives to the campaign.<\/li>\n<li>Put the spot on your site with the Placewell Spot block, <code>[placewell spot=\"your-slug\"]<\/code>, the Placewell Spot widget, or automatic insertion.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"can%20i%20move%20my%20ads%20from%20adrotate%2C%20advanced%20ads%20or%20wp%20quads%3F\"><h3>Can I move my ads from AdRotate, Advanced Ads or WP QUADS?<\/h3><\/dt>\n<dd><p>Yes. Go to Placewell \u2192 Settings \u2192 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.<\/p><\/dd>\n<dt id=\"is%20there%20a%20pro%20version%3F\"><h3>Is there a Pro version?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"where%20do%20country%20stats%20come%20from%3F\"><h3>Where do country stats come from?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"why%20don%27t%20my%20stats%20update%20instantly%3F\"><h3>Why don't my stats update instantly?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"are%20wp-cron%20jobs%20required%3F\"><h3>Are WP-Cron jobs required?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20html%20creatives%20count%20clicks%3F\"><h3>How do HTML creatives count clicks?<\/h3><\/dt>\n<dd><p>Use {click_url} as the link target, for example <code>&lt;a href=\"{click_url}\"&gt;<\/code>. 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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.6.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<li>Spots can be placed on category, tag, blog, search, other term and archive pages. Sticky bars can be limited to chosen list pages too.<\/li>\n<li>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.<\/li>\n<li>Report grouping tabs are spaced out.<\/li>\n<li>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.<\/li>\n<li>HTML creatives and fallback HTML are always plain markup: scripts, frames and forms are removed.<\/li>\n<li>Spot size rules load with the Placewell stylesheet in the page head.<\/li>\n<li>Suggested privacy policy text under Settings \u2192 Privacy.<\/li>\n<li>Translation template in languages\/placewell.pot.<\/li>\n<li>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.<\/li>\n<li>Campaign targeting keeps settings from add-ons even while the add-on is switched off, so saving a campaign never drops them.<\/li>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.5.0<\/h4>\n\n<ul>\n<li>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).<\/li>\n<li>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.<\/li>\n<li>Removed the button label field from the creative editor.<\/li>\n<li>Each spot has an embed code generator for shortcodes, blocks, theme PHP and widgets, with position, spacing and an extra CSS class.<\/li>\n<li>The shortcode, block and placewell_spot() accept align, spacing and class options.<\/li>\n<li>New admin design: racing green and brass, a serif for titles and figures, sentence-case labels and a cleaner navigation.<\/li>\n<li>Reports can be downloaded as a branded PDF: summary, daily chart, and breakdowns by device, creative, placement and video viewing.<\/li>\n<li>Ads now load through the same address as the page, so they keep working behind proxies, CDNs and after domain changes.<\/li>\n<li>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.<\/li>\n<\/ul>\n\n<h4>0.4.0<\/h4>\n\n<ul>\n<li>Spots open as a full page with a live desktop, tablet and phone preview that follows the chosen placement.<\/li>\n<li>Add, upload and preview creatives right from the spot, with a campaign picker (or a new campaign and advertiser inline).<\/li>\n<li>Clear device coverage: each creative and spot shows which devices it fills, and which size is missing (e.g. \"Phones need a 320\u00d750 version\"), with a one-click \"Add 320\u00d750 version\".<\/li>\n<li>Visual placement picker and a \"Where it appears\" list of pages, posts and widgets using the spot.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>Creative Library with drag-and-drop upload, pre-upload checks and previews.<\/li>\n<li>File rules: allowed types, size limits per format, max dimensions and video length; strict or warn-only.<\/li>\n<li>Preview in spots on desktop and phone mock pages, from the Library and the creative editor.<\/li>\n<li>File rules are enforced when a creative is saved; older creatives stay editable.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Spots, advertisers, campaigns and creatives with full admin screens.<\/li>\n<li>Serving with weighted rotation, per-device sizes, targeting, frequency caps and expiration.<\/li>\n<li>Viewability, video quartile and click tracking with invalid-traffic filtering.<\/li>\n<li>Reports with CSV export, dashboard, settings, expiry reminders.<\/li>\n<li>Block, shortcode, widget, template tag, automatic insertion and sticky bar.<\/li>\n<li>UTM Builder and automatic UTM tagging.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Plugin scaffold.<\/li>\n<\/ul>","raw_excerpt":"Sell and manage direct ad spots with honest, viewable-impression analytics. Cache-safe, responsive, and built to work with any theme.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/404419","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=404419"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lawscodes"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=404419"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=404419"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=404419"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=404419"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=404419"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=404419"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}