=== AwoProof — Proof of Posting for Outdoor Advertising & Mounting Verification Studio ===
Contributors: awoscan
Tags: outdoor-advertising, proof-of-posting, billboard, media-planning, field-report
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

Record creative designs and posting dates for every location in your outdoor campaign plan, collect mounting photos and timestamps, highlight missing locations, and generate A4 Proof of Posting reports.

== Description ==

**AwoProof 2.2.0** is a self-contained corporate B2B Proof of Posting studio for WordPress (`WP Admin -> AwoProof` or `[awoproof]` shortcode).

= What AwoProof Does =

AwoProof centralizes outdoor advertising proof-of-posting workflows: recording creative artwork and planned flight dates for every billboard, CLP, megalight, and wall wrap, collecting timestamped field mounting photos, highlighting missing locations that still need installation proof, importing booked media plans from AwoOutdoor Media, and generating A4 Client Proof of Posting Reports.

= How to Configure and Use AwoProof =

1. **Open the Studio:** After activating the plugin, click **AwoProof** in the WordPress admin sidebar (requires `manage_options` capability).
2. **Configure Campaign & Advertiser Details:** Enter the campaign name, advertiser (client), media agency, flight start/end dates, and operations director.
3. **Add Locations or Import from AwoOutdoor:** Add planned outdoor units or click **Import from AwoOutdoor Plan** to pull booked billboard/CLP locations.
4. **Collect Mounting Photos & Track Missing Locations:** Upload field mounting photos with automatic Date-Time, Unit Code & GPS watermark stamps, and use the **Show Missing Only** filter to track pending installations.
5. **Save, Print A4 Proof Report, or Export:** Click **Save** to store campaign proof records in WordPress, click **A4 Proof of Posting Report** to print/save as PDF for your client, or export to CSV / JSON.

= Key Features =

* **Campaign Location & Creative Design Tracking:** Track unit code, format (Billboard, Megalight, CLP, Wall Wrap, DOOH), street address, facing direction, creative artwork code, and planned start/end dates.
* **Timestamped Field Photo Proof & Watermark Engine:** Upload photos from phone or computer with client-side resizing and automatic Date-Time, Unit Code, and GPS watermark stamping.
* **Missing Locations Alert & Crew Task Sheet:** Automatically highlights planned locations missing mounting photos or posting timestamps and prints an A4 Missing Locations Task Sheet for installation crews.
* **Seamless AwoOutdoor Media Integration:** Import planned outdoor media units directly from AwoOutdoor Media.
* **100% Local WordPress Database Storage:** Stores workspace records safely inside `wp_options` (`awoproof_workspace_v1`) via Nonce-verified and capability-checked WordPress AJAX (`manage_options`).

= External Services =

* **100% Local Default Operation:** By default in Free mode, AwoProof 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-PRF-...` or `AWO-SUITE-...`) and clicks Activate, the plugin sends an HTTPS POST request to `https://awosign.awoscan.com/api/license/activate` containing the license key, site domain, and company name to verify the license and issue a signed domain lease token.
  * Service Provider: AwoScan / AWO Cloud Portal (`https://awosign.awoscan.com`) & Polar Software, Inc. (`https://polar.sh`)
  * Terms & Privacy Policy: `https://awoscan.com/privacy` and `https://polar.sh/legal/privacy`

= Privacy and Data Storage =

AwoProof stores all campaign records and mounting proof photos locally inside your own WordPress database (`wp_options` under `awoproof_workspace_v1`). No business records or customer data are sent to external servers. All stored options are automatically removed when the plugin is uninstalled (`uninstall.php`).

= Source Code =

All PHP, JavaScript, and CSS files in this plugin are distributed in human-readable, unminified source form directly inside the plugin directory:

* `awoproof.php` - WordPress admin studio, shortcode handler, and AJAX storage.
* `proof-view.php` - Studio HTML template.
* `assets/awoproof.js` - Interactive Proof of Posting, photo watermark, missing location tracker, and A4 print engine.
* `assets/awoproof.css` - Adaptive light/dark theme and A4 print stylesheet.

== Installation ==

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

== Changelog ==

= 2.2.0 =
* Initial release of AwoProof (Proof of Posting for Outdoor Advertising) studio for WordPress, Cloud Web, and Desktop PWA.
