PHPackages ralkage/flarum-ext-ad-management - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. ralkage/flarum-ext-ad-management ActiveFlarum-extension[Utility & Helpers](/categories/utility) ralkage/flarum-ext-ad-management ================================ Comprehensive ad management system for Flarum with zones, analytics, and ad owner self-service. 1.2.0(3mo ago)0242[1 issues](https://github.com/Ralkage/flarum-ext-ad-management/issues)MITJavaScript Since Mar 25Pushed 2mo agoCompare [ Source](https://github.com/Ralkage/flarum-ext-ad-management)[ Packagist](https://packagist.org/packages/ralkage/flarum-ext-ad-management)[ RSS](/packages/ralkage-flarum-ext-ad-management/feed)WikiDiscussions 1.x Synced 3w ago READMEChangelog (10)Dependencies (2)Versions (12)Used By (0) Ad Management — Flarum Extension ================================ [](#ad-management--flarum-extension) A comprehensive ad management system for [Flarum](https://flarum.org) forums. Supports image banners, HTML/JS ads, and Google AdSense with zones, analytics, an approval workflow, and a user self-service portal. Features -------- [](#features) - **Ad Zones** — Named positions (`header`, `below_header`, `between_posts`, `sidebar`, `above_footer`, `footer`, `custom`) with optional dimension constraints - **Ad Types** — Image banners, raw HTML/JS, and Google AdSense units - **Rotation** — One random ad per zone per page load (randomized each visit) - **Analytics** — Per-ad impression and click tracking with daily breakdowns and CTR - **Approval Workflow** — User-submitted ads queue for admin review before going live; optional approval for image changes - **Email Notifications** — Expiration reminders and performance reports via cron, with customizable templates - **Admin Notifications** — Instant email alert when a user submits an ad for review - **Rate Limiting** — Anti-fraud protection on click and impression tracking endpoints - **Group Visibility** — Show ads only to specific member groups; hide ads for premium groups - **Post Shortcodes** — Embed any zone inline in discussion posts: `{myadvertisements[zone_name]}` - **Image Processing** — Automatic resizing to zone dimensions; optional compression via PHP GD or reSmush.it API - **GDPR Compliance** — Purge old click records with the built-in console command Requirements ------------ [](#requirements) - Flarum `^1.8` - PHP `^8.0` with GD extension (for image resizing/compression) - PHP `curl` extension (optional, for reSmush.it API compression) Links ----- [](#links) - [Ralkage](https://ralkage.com) - [Github](https://github.com/Ralkage/flarum-ext-ad-management) - [Packagist](https://packagist.org/packages/ralkage/flarum-ext-ad-management) Installation ------------ [](#installation) ``` composer require ralkage/flarum-ext-ad-management ``` Then enable it in your Flarum admin panel under **Extensions**. Quick Start ----------- [](#quick-start) 1. Go to **Admin → Ad Management → Zones** and create a zone (or use a built-in default zone). 2. Go to **Advertisements** and create your first ad. 3. Set up the cron job for email notifications: ``` 0 8 * * * php /var/www/flarum ad-management:send-notifications >> /dev/null 2>&1 ``` 4. (Optional) Grant the **Submit Advertisements** permission to allow forum members to submit ads for review. Console Commands ---------------- [](#console-commands) CommandDescription`php flarum ad-management:send-notifications`Send expiration reminders and performance reports`php flarum ad-management:purge-clicks [days]`Delete click records older than N days (default: 90) for GDPR complianceDocumentation ------------- [](#documentation) See [ADMIN\_GUIDE.md](ADMIN_GUIDE.md) for full configuration and usage documentation. License ------- [](#license) MIT — see [LICENSE](LICENSE). ### Health Score 38 — LowBetter than 83% of packages Maintenance83 Actively maintained with recent releases Popularity15 Limited adoption so far Community2 Small or concentrated contributor base Maturity40 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 12 Last Release 88d ago Major Versions 1.x-dev → 2.x-dev2026-03-30 ### Community Maintainers ![](https://www.gravatar.com/avatar/4415106be37759e15d2f1304df343a37e478dad0f832b6f35860631ffc9b6afb?d=identicon)[Ralkage](/maintainers/Ralkage) --- Tags adsextensionadsenseAdvertisingflarumad management ### Embed Badge ![Health badge](/badges/ralkage-flarum-ext-ad-management/health.svg) ``` [![Health](https://phpackages.com/badges/ralkage-flarum-ext-ad-management/health.svg)](https://phpackages.com/packages/ralkage-flarum-ext-ad-management) ``` ### Alternatives [flarum-lang/russian Russian language pack for Flarum. 12127.5k](/packages/flarum-lang-russian)[fof/sitemap Generate a sitemap 1796.4k2](/packages/fof-sitemap)[davwheat/flarum-ext-ads Ads support for your Flarum forum. 1311.0k](/packages/davwheat-flarum-ext-ads)[flarum-lang/french French language pack to localize the Flarum forum software plus its official and third-party extensions. 1936.5k](/packages/flarum-lang-french)[fof/masquerade User profile builder extension for your Flarum forum. 2024.6k4](/packages/fof-masquerade)[flarum/gdpr Features for GDPR, PII management 1433.4k20](/packages/flarum-gdpr) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)