Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/krafty-sprouts-media-llc/ad-placr/archive/refs/heads/main.zipUpdates itself. It ships its own updater, so new versions appear under Dashboard → Updates.
WordPress ad manager by Krafty Sprouts Media LLC.
Each Ad contains everything needed to display it: location, status, display rules, one or more weighted code versions, optional mobile code, and statistics.
Requirements
- WordPress 6.0+
- PHP 8.0+
Features
- One-screen Ad editor with clear Active and Paused status
- Main and optional mobile ad code, plus weighted code versions
- Display rules for page context, content type, visitors, schedules, URL paths, categories, and tags
- Automatic locations including sticky footer, in-content paragraphs, header/footer, side rails, and front-page, blog, and archive positions
- Manual display with
[ad_placr ad="123"]or the Ad Placr sidebar widget - Optional first-party impression and click statistics with 90-day retention
- GitHub updates via bundled Plugin Update Checker
Admin
- Open Ads → Add New.
- Choose where the Ad should appear.
- Paste the ad code and choose any display rules.
- Save it as Paused while preparing it, or Active when it is ready.
- Optionally open Ads → Settings to enable first-party statistics.
Docs in this repo
| File | Purpose |
|---|---|
AGENTS.md |
Conventions for contributors / AI agents |
docs/superpowers/specs/2026-07-23-ad-placr-unified-ad-model-design.md |
Approved unified Ad design |
development.md |
Local layout & coding notes |
roadmap.md |
Backlog beyond v1 |
changelog.md |
Release history |
readme.txt |
WordPress.org-style readme |
Development
composer install
composer test
composer exec phpcs -- --standard=WordPress includes/ ad-placr.php
composer exec phpstan -- analyse --memory-limit=2G
Composer is dev-only — activation never depends on vendor/.
License
GPL-2.0-or-later
Releases
1 release.
Tag
Published
v2.9.0
latest
Sep 8, 2026 1mo ago
These releases are tags only. The author does not attach a packaged zip, so there are no download counts to report.