Ad Fuz

Description

AdFuz is a powerful WordPress ad management plugin built for publishers, developers, and site owners who demand full control over their advertising inventory — no third-party networks, no lock-in, no compromise.

Full Control. Unmatched. Zero-Compromise. Manage your ads like a boss.

AdFuz gives you a structured, developer-grade workflow to create ads, schedule campaigns with precise date ranges, and serve them through defined ad spaces — all from your WordPress dashboard.

🎯 Ads

Build and manage every ad in your inventory with precision.

• Multiple ad types: image, Video, HTML, and script/embed-based ads
• Upload media via the WordPress Media Library or use an external media URL
• Configurable call-to-action (CTA) with custom label, type, and position (left/right)
• Link behaviour control: open in same tab, new tab, or custom
• Ad status lifecycle: Draft → Pending → Active → Paused
• Hide or show ad title independently per ad

📅 Campaigns

Schedule your campaigns and let AdFuz handle the rest.

• Group multiple ads into a single campaign
• Set a start date and end date to control exactly when a campaign runs
• Assign campaigns across multiple ad spaces simultaneously
• Campaign status lifecycle: Pending → Active → Expired
• Set a fallback ad that displays when no campaign is scheduled

📐 Ad Spaces

Define your placement zones once — serve ads anywhere.

• Create named ad spaces with custom width, height, and ad format
• Control display sequence and availability per space
• Assign a fallback ad per space for guaranteed fill
• Embed ad spaces anywhere using a shortcode or PHP template function
• Manage all your placement zones from a single screen

🟦 Gutenberg Block

AdFuz ships with a native Gutenberg block for placing ad spaces directly in the WordPress block editor.

1. Open any post, page, or block-based template in the editor
2. Click the + icon to add a new block and search for AdFuz Ad Space
3. Insert the AdFuz Ad Space block into your content
4. In the block’s Ad Space Settings panel on the right, select the ad space you want to display
5. Save or publish — the selected ad space will render with its active campaign ads

No shortcodes or PHP required. The block respects all ad space settings including fallback ads and display sequence.

Shortcode

[ad-fuz ad_space_id="AD_SPACE_ID"]

Template Function

<?php adfuz_adspace( 'AD_SPACE_ID' ); ?>

Source Code & Build Tools

The JavaScript and CSS source code for AdFuz is bundled using Vite. The source code is available in the following locations:

• JavaScript Source: assets/js/ directory in the source repository
• CSS Source: assets/css/ directory in the source repository

Build Instructions

To modify the source code and regenerate the production files:

1. Ensure you have Node.js (v18+) and npm installed.
2. Download the source code from WordPress Repository.
3. Install dependencies: npm install
4. Run the build: npm run build (for admin assets) or npm run build:frontend (for frontend assets)
5. The built files will be generated in assets/public/ directory.

For development with hot-reload: npm run dev

Source Code

This plugin’s JavaScript and CSS are compiled using Vite and npm.
The uncompiled source files are included in the plugin under assets/js/ and assets/css/.
Build configuration files (vite.config.js, package.json, vite.config.frontend.js, tailwind.config.js) are also included in the plugin root.

To build from source:
1. npm install
2. npm run build-admin # builds admin JS/CSS
3. npm run build-frontend # builds frontend JS/CSS
— or —
npm run build # builds both