=== Content Handoff Hub ===
Contributors: bdtreder
Tags: client portal, content upload, web design, client files, project handoff
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Author: Ben Treder
Author URI: https://bentreder.com

Help business owners send website content to their web designer — all inside WordPress, organized and private.

== Description ==

**Content Handoff Hub** gives business owners one organized place inside WordPress to upload and send everything their web designer needs.

Instead of scattering content across emails, text messages, Google Drive, random screenshots, and half-written notes, this plugin provides a structured handoff hub where everything is collected, labeled, and ready for the designer to review.

**Business Owner Page**

A friendly, guided upload form where the client can send:

* Page text and copy
* Images and logos
* PDFs and documents
* Ideas and notes
* Reference URLs
* Revision requests

Each item is labeled with a website section (Home, About, Services, etc.), a content type, a priority, and notes for the designer.

**Designer Review Page**

A professional review dashboard where the web designer can:

* See stats at a glance — Total Items, New, Needs More Info, Approved
* Browse all submitted content in a clean table
* View files, sections, types, priorities, and statuses
* Edit individual items
* Export a Project Brief as a downloadable text file

**Privacy**

This plugin stores submitted content and uploaded files locally in the WordPress database and Media Library. It does not send data to external services. No API keys required. No external connections.

**Security**

Nonce verification, capability checks, input sanitization, output escaping, and strict file type validation. Executable file types are always blocked.

**Core Features**

* Business Owner upload form with guided field descriptions
* Designer review dashboard with stat cards
* Status tracking: New → Reviewed → Needs More Info → Approved → Archived
* File uploads via WordPress Media Library with configurable size and type limits
* Export Project Brief as a .txt file
* Settings for designer info, project name, upload limits, and uninstall behavior
* Admin bar indicator showing new item count
* WordPress 7.0+ and PHP 7.4+ compatible

**Content Handoff Hub Premium**

Need more workflow power? Content Handoff Hub Premium is an optional add-on for designers, agencies, and growing client projects. It adds:

* AI content cleanup — automatically polish submitted page copy
* AI designer summary — generate a structured brief from submitted items
* Missing content checklist — see exactly what the client has not yet sent
* Advanced Project Brief — rich, printable, grouped by section
* Email notifications — alert the designer when new content is submitted
* Multiple projects — manage content for many clients at once
* White-label branding — show your agency name and support URL
* Advanced export templates

AI tools in Premium use WordPress AI connectors when configured on your site — no external API keys stored in the plugin.

**Requirements**

* WordPress 7.0 or higher
* PHP 7.4 or higher

== Installation ==

1. Upload the `content-handoff-hub` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Content Hub → Business Owner** to start adding content.
4. Go to **Content Hub → Designer** to review submitted items.
5. Go to **Content Hub → Settings** to configure designer info and upload limits.

== Frequently Asked Questions ==

= Who can access Content Handoff Hub? =

Only users with the `manage_options` capability (WordPress administrators) can access the hub. Content is not publicly visible.

= What file types can be uploaded? =

By default: jpg, jpeg, png, gif, webp, pdf, doc, docx, txt, rtf, csv. You can customize the allowed extensions in Settings. Executable file types (php, js, html, svg, exe, sh, etc.) are always blocked for security.

= What is the maximum upload size? =

The default is 10 MB per file. You can change this in Settings (1–100 MB). The actual limit may also be constrained by your server's PHP configuration.

= Can I export the content? =

Yes. Click **Export Project Brief** on the Designer page to download a .txt file with all content items organized by website section.

= Does this plugin send data to external services? =

No. All data stays in your WordPress database and Media Library. No external API calls, no tracking, no remote assets.

= Is there a Premium version? =

Yes. Content Handoff Hub Premium is an optional add-on plugin that extends this free plugin with AI tools, advanced briefs, email notifications, white-label branding, and more. It does not replace the free plugin.

= What happens when I delete the plugin? =

By default, plugin settings are removed on uninstall but content items are preserved. You can choose to also delete content items and uploaded files in Settings.

== Privacy ==

Content Handoff Hub stores all submitted content and uploaded files locally in your WordPress database and Media Library. It does not send any data to external services. No analytics, no tracking, no remote assets. No API keys are required or stored.

== Screenshots ==

1. Business Owner page for sending website content to a designer.
2. Designer review page with submitted content, statuses, and actions.
3. Content item detail page with notes, files, and status controls.
4. Settings page for project, upload, and data options.
5. Premium preview showing optional advanced workflow tools.
6. Exported project brief view for organized handoff review.

== Changelog ==

= 1.0.0 =
* Initial release as Content Handoff Hub.
* Business Owner upload page with guided helper cards and friendly copy.
* Designer Review dashboard with stat cards and full content table.
* Custom post type: client_content_item with full CRUD via WordPress admin.
* Custom post statuses: New, Reviewed, Needs More Info, Approved, Archived.
* File upload validation with configurable allowed types and size limits.
* Export Project Brief as a .txt file.
* Settings page with project info, upload limits, and uninstall options.
* Premium Features preview card.
* Admin bar indicator showing new item count.
* Full security: nonces, capability checks, sanitization, escaping, file type blocking.
* Hook points for Content Handoff Hub Premium: content_handoff_hub_after_designer_detail, content_handoff_hub_after_designer_table, content_handoff_hub_after_settings_cards.

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps needed.
