=== AwoOutdoor Media — Outdoor Advertising Inventory, Media Planning & A4 Client Proposal Studio ===
Contributors: awoscan
Tags: outdoor-advertising, billboard, media-planning, inventory, proposal
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage Billboards, Megalights, CLP Citylights, Wall Wraps, and Digital LED inventory, build client media plans, and print A4 Media Plan Proposals.

== Description ==

**AwoOutdoor Media 2.2.0** is a self-contained corporate B2B studio for WordPress (`WP Admin -> AwoOutdoor`).

= What AwoOutdoor Media Does =

AwoOutdoor Media centralizes outdoor advertising inventory management (Billboards, Megalights, CLP / Citylights, Building Wall Wraps, Overpass Banners, and Digital OOH LED screens), approach direction & GPS coordinate tracking, availability scheduling, client media plan budgeting, A4 Client Media Plan Proposal generation, and one-click campaign handoff to **AwoProof**.

= How to Configure and Use AwoOutdoor Media =

1. **Open the Studio:** After activating the plugin, click **AwoOutdoor** in the WordPress admin sidebar (requires `manage_options` capability) or embed `[awooutdoor]` on any page.
2. **Configure Agency / Media Owner Profile:** Enter your media agency or media owner company name, media planning director contact, and phone/email.
3. **Add Advertising Inventory Units:** Register each unit with its code (`IST-LVN-01`), location title, city/district, format, approach direction, dimensions, illumination, availability date, GPS coordinates, daily impressions, list/net rate, and site photo.
4. **Build a Client Media Plan:** Check the units you want to include in a client proposal, set campaign dates, currency, and package discount.
5. **Save, Print A4 Proposal PDF, or Send to AwoProof:** Click **Save** to store inventory in WordPress, click **Print A4 Media Plan Proposal**, or click **Send Selected Units to AwoProof** for field proof-of-posting.

= Key Features =

* **Visual OOH Inventory Showcase:** Displays every advertising unit with its photo/schematic banner, unit code, availability badge, approach direction, dimensions, illumination, and GPS link.
* **Client Media Plan Cart & Rate Calculator:** Calculates total list rate, agency/package discount, net media investment, VAT, and estimated total campaign impressions.
* **A4 Client Media Plan Proposal & QR Stickers:** Prints executive A4 client proposals with unit photos and QR map links, plus on-unit QR field stickers (`@media print` ready).
* **Direct Handoff to AwoProof:** Transfers selected campaign locations with coordinates and photos directly to AwoProof (`awo_outdoor_to_proof_transfer_v1` & `.json` export).
* **100% Local WordPress Database Storage:** Stores workspace records safely inside `wp_options` (`awooutdoor_workspace_v1`) via Nonce-verified WordPress AJAX (`manage_options`).

= External Services =

* **100% Local Default Operation:** By default in Free mode, AwoOutdoor Media runs 100% locally inside your WordPress site and makes **zero external HTTP requests**.
* **Optional AWO-Guard / Polar.sh PRO License Verification (`https://awosign.awoscan.com`):** Only when a site administrator explicitly enters an optional PRO license key (`AWO-OUT-...` or `AWO-SUITE-...`) and clicks Activate, the plugin sends an HTTPS POST request to `https://awosign.awoscan.com/api/license/activate` to verify the license.

= Privacy and Data Storage =

AwoOutdoor Media stores all inventory units, media plans, and agency settings locally inside your own WordPress database (`wp_options` under `awooutdoor_workspace_v1`). All stored options are automatically removed when the plugin is uninstalled (`uninstall.php`).

== Installation ==

1. Upload the `awooutdoor` folder to `/wp-content/plugins/` or upload the plugin ZIP file via **Plugins -> Add New -> Upload Plugin** in WordPress.
2. Activate **AwoOutdoor Media** through the **Plugins** menu in WordPress.
3. Click **AwoOutdoor** in the WordPress admin sidebar (`manage_options` capability required).

== Changelog ==

= 2.2.0 =
* Initial release of AwoOutdoor Media v2.2.0 (Outdoor Advertising Inventory, Media Planning & AwoProof Integration Studio).
