=== PhoenixForge On Special ===
Contributors: ryanpurvisphoenixforge
Tags: restaurant, social media, specials, scheduling, hospitality
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your bar or restaurant's daily specials into scheduled social posts across all platforms.

== Description ==

PhoenixForge On Special turns your daily specials into consistent social media posts — without you having to think about it. Create a special, set the time, and it posts automatically.

**The problem:** The bar that posts consistently is the one with the early Friday crowd. But independent operators don't have time to create social posts every day, and generic scheduling tools don't understand food and drink specials.

**The solution:** PhoenixForge On Special is built specifically for bars, restaurants, and cafes. Create your specials as a custom post type, set the schedule (one-off or recurring), and the plugin generates captions and posts them to your connected social accounts at the right time.

= Free Features =

* Specials custom post type with prices, times, and categories
* Manual social post generation with one-click caption creation
* Basic scheduling — set a post time for each special
* Facebook integration (one platform)
* 5 posts per week
* Demo data to see the plugin in action

= Pro Features =

* Multi-platform posting — Instagram, Facebook, TikTok, and Google Business Profile
* AI-powered caption generation using your saved brand voice
* Weather-aware posting — trigger or adjust posts based on local weather
* Recurring specials — auto-repeat on specific days of the week
* POS correlation — upload sales data to see which posts drove revenue
* Post analytics — track engagement per special
* Unlimited posts
* Zapier / webhook integrations

== Installation ==

1. Upload `wp-on-special` to the `/wp-content/plugins/` directory
2. Activate the plugin through the Plugins menu
3. Navigate to On Special in the admin menu
4. Configure your venue name and settings
5. Connect your social accounts
6. Create your first special

== Screenshots ==

1. Dashboard showing today's specials and quick-add form
2. Special editor with pricing, scheduling, and platform selection
3. Social accounts connection page
4. Post queue showing upcoming scheduled posts
5. Recurring specials calendar view

== Frequently Asked Questions ==

= What social platforms are supported? =

Free: Facebook. Pro: Facebook, Instagram, TikTok, and Google Business Profile.

= How does weather-aware posting work? =

Pro users can set weather conditions on specials. For example, post your soup special only when rain is forecast, or promote your patio happy hour when it's sunny. The plugin checks local weather before posting.

= Can I set recurring specials? =

Yes (Pro). Set a special to repeat on specific days — e.g., Wings Wednesday every week. The plugin auto-generates and posts each occurrence.

= Does it work with my POS system? =

Pro includes CSV upload for POS data correlation. API integrations with Square and Clover are planned for a future release.

== Changelog ==

= 1.0.0 =
* Initial release
* Specials custom post type with categories and tags
* Dashboard with today's specials and quick-add form
* Social platform connection management
* Post queue and scheduling
* Metabox editor for special details
* Demo data generation

== Third-Party Services ==

This plugin connects to external services for social media posting and weather data:

= PhoenixForge License Server =
* URL: https://phoenixforge-licenses.phoenixforge.workers.dev
* Purpose: License validation for Pro features
* Privacy Policy: https://phoenixforge.io/privacy-policy/

= PhoenixForge Update Server =
* URL: https://phoenixforge-updates.phoenixforge.workers.dev
* Purpose: Plugin update checks
* Privacy Policy: https://phoenixforge.io/privacy-policy/

= Social Media APIs (Pro) =
* Facebook/Instagram Graph API, TikTok API, Google Business Profile API
* Purpose: Publishing specials to connected social accounts
* Data sent: Post captions, images, and scheduling data
* Only activated when you connect accounts via OAuth

= Weather API (Pro) =
* OpenWeatherMap API
* Purpose: Weather-conditional posting triggers
* Data sent: Location coordinates for weather lookup
* Only activated when weather features are enabled
