=== AdFusion ===

Contributors: brelandr
Tags: ads, ad management, monetization, ad groups, shortcode
Requires at least: 5.9
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced ad management and monetization core foundation. Create, organize, and display ads with image, custom code, or text formats.

== Description ==

AdFusion provides a solid foundation for managing advertisements on your WordPress site. Create ad units, organize them into groups for rotation, and display them anywhere using a simple shortcode.

= Features =

* **Custom Post Type** – Manage ads as a dedicated content type with full WordPress integration
* **Ad Groups** – Organize ads into hierarchical groups (e.g., sidebar, header, footer) for easy rotation
* **Multiple Ad Types** – Support for Image ads (featured image), Custom Code/HTML/AdSense, and Plain Text
* **Scheduling** – Optional start and end dates for time-limited campaigns
* **Shortcode** – Display ads by ID or group: `[adfusion id="123"]` or `[adfusion group="sidebar-ads"]`
* **REST API** – Ads and groups exposed for future integrations (e.g., mobile apps)
* **Extensible** – Hooks and filters for Premium extensions to build upon

= Shortcode Usage =

Display a specific ad by ID:
`[adfusion id="123"]`

Display a random ad from a group (rotates on each page load):
`[adfusion group="sidebar-ads"]`

= Ad Types =

* **Image Ad** – Uses the post's featured image. Set a destination URL for click-through.
* **Custom Code / HTML / AdSense** – Paste third-party ad code (e.g., Google AdSense) for direct embedding.
* **Plain Text** – Simple text ads with optional link.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/adfusion-ad-manager-and-monetization/`, or install the ZIP through **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **AdFusion** in the admin menu to create ads and ad groups (requires an administrator account; see FAQ).
4. Use the shortcode `[adfusion id="X"]` or `[adfusion group="your-group-slug"]` in posts, pages, or widgets.

== Frequently Asked Questions ==

= Who can create and edit ads? =

Saving ad details requires permission to **edit that ad** (`edit_post` for the ad). Users without access to the ad editor screen cannot save meta from the meta box.

= How do I create an ad group? =

Go to **AdFusion → Ads**, then use **Ad Groups** in the submenu. Add new groups (e.g., "sidebar-ads", "header-banner") and assign ads to them when editing an ad.

= Can I use Google AdSense? =

Yes. Create an ad, select **Custom Code / HTML / AdSense** as the ad type, and paste your AdSense code in the Ad Code field. Saving raw HTML/scripts typically requires the **unfiltered_html** capability (usually administrators).

= Do ads have their own URLs? =

No. Ads are set so they do not have individual public frontend pages. They are displayed via the shortcode.

= Does this plugin send data to external servers? =

The core plugin does not connect to external APIs. If you embed third-party ad scripts (e.g., AdSense), those providers may load resources from their own domains when the ad is shown—see **External Services**.

== External Services ==

This plugin’s **core code** does not call remote APIs or send site data to third parties.

* **Optional third-party ad code** – When you paste code from providers such as Google AdSense, those scripts run on your site’s frontend and may contact the provider’s servers to load ads or measure performance. That relationship is between you and the provider. Review their terms and privacy policy, for example: https://support.google.com/adsense/answer/48182 and https://policies.google.com/privacy

== Screenshots ==

1. Ad list and Ad Groups in the admin
2. Ad Details & Configuration meta box
3. Shortcode output example

== Changelog ==

= 1.0.0 =
* Initial release
* Custom Post Type for ads
* Ad Groups taxonomy
* Image, Code, and Text ad types
* Start/End date scheduling
* [adfusion] shortcode with id and group attributes
* REST API support for ads and groups

== Upgrade Notice ==

= 1.0.0 =
Initial release of AdFusion.