=== Zerply Integration WordPress Plugin ===
Contributors: zerply
Donate link: https://zerply.ai
Tags: zerply, AI, SEO, content, publishing, automation
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress website with Zerply's AI SEO assistant and publish content with one click.

== Description ==

The Zerply Integration WordPress Plugin is designed to make it easy for you to publish AI-generated content from Zerply directly to your WordPress website. Once the plugin is installed and activated, it generates a unique API key. This API key can be entered into your Zerply account settings to link your WordPress website.

With this plugin, you can:
* Publish blog posts and long-form content directly from Zerply chat
* Maintain content control with draft or publish options
* Seamlessly integrate AI-powered SEO content into your WordPress workflow

= Features =

* Automatic API key generation
* Secure Bearer token authentication
* Publish or save as draft
* Connection verification
* Modern, user-friendly interface
* HTML content support
* Media upload and featured image support

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/zerply-integration` directory, or install the plugin through the WordPress plugins screen directly
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Navigate to the 'Zerply' page in the admin menu to view your API key
4. Copy the API key and paste it in your Zerply account settings

= Detailed Setup Steps =

Step 1: Install WordPress Plugin

You can install the plugin in two ways:

Option A: Upload Plugin Files
1. Download the plugin from this directory
2. Create a ZIP file of the plugin directory
3. Log in to your WordPress admin panel
4. Navigate to Plugins → Add New → Upload Plugin
5. Choose the ZIP file and click Install Now
6. Click Activate Plugin

Option B: Manual Installation
1. Copy the plugin directory to /wp-content/plugins/ on your WordPress server
2. Log in to your WordPress admin panel
3. Navigate to Plugins
4. Find "Zerply" in the list and click Activate

Step 2: Get API Key from WordPress

1. In your WordPress admin, go to Zerply in the sidebar
2. You'll see your unique API key displayed
3. Click the copy button to copy the API key
4. Keep this page open as you'll need the API key for the next step

Step 3: Connect WordPress Site to Zerply

1. Log in to your Zerply account at https://zerply.ai
2. Navigate to Settings → Manage Your Website
3. Scroll down to the WordPress Integration section
4. Click Add WordPress Site
5. Enter your WordPress site URL (e.g., https://yoursite.com)
6. Paste the API key you copied from WordPress
7. Click Connect Site

If the connection is successful, you'll see a green "Verified" badge next to your site.

Step 4: Publish Content from Zerply

1. Go to any Zerply chat where the AI has generated content
2. Hover over the AI message you want to publish
3. Click the Publish to WordPress button (document icon)
4. In the dialog:
   * Select your WordPress site
   * Enter a post title
   * Choose status (Draft, Publish, or Pending Review)
5. Click Publish Now or Save as Draft

Your content will be published to your WordPress site!

== Frequently Asked Questions ==

= Where can I find my API key? =

After activating the plugin, you can find your API key on the 'Zerply' page in the sidebar of your WordPress admin panel.

= How do I enter my API key into Zerply? =

1. Copy the API key from the Zerply plugin page in WordPress
2. Go to zerply.ai and log in to your account
3. Navigate to Settings → Integrations → WordPress
4. Enter your WordPress site URL and API key
5. Click "Connect" to verify the connection

= Can I change my API key? =

Currently, the API key is generated once upon activation. If you need to regenerate it, you can deactivate and reactivate the plugin.

= What happens if I deactivate the plugin? =

Your API key will be preserved, but you won't be able to publish from Zerply until you reactivate the plugin.

= Can I publish directly or save as draft? =

Yes! When publishing from Zerply, you can choose to publish immediately or save as a draft for review.

= Is this plugin secure? =

Yes, the plugin uses secure API key authentication and follows WordPress security best practices. All API keys are randomly generated, stored securely, and all requests require Bearer token authentication.

== Screenshots ==

1. Zerply admin page showing API key and connection instructions
2. Copy API key with one click
3. Connection status and site information

== Changelog ==

= 1.2.0 =
* Added API route for media upload and featured image support
* REST API endpoint for uploading media files
* Featured image attachment functionality via API

= 1.1.0 =
* Updated for WordPress 2025 best practices
* Added PHP 7.4+ requirement with type hints and strict types
* Implemented proper namespacing (Zerply\WordPress)
* Enhanced security with hash_equals() for timing-safe API key comparison
* Added timing attack prevention (sleep on failed auth)
* Improved input sanitization and validation
* Better error messages with full internationalization support
* Added REST API argument validation with sanitize/validate callbacks
* Enhanced permission checks before publishing
* Added custom post meta for tracking published content
* Added action hooks for plugin extensibility
* Improved clipboard fallback for older browsers
* Better code documentation with PHPDoc blocks
* Updated to use WP_REST_Server constants

= 1.0.0 =
* Initial release
* API key generation and management
* REST API endpoints for publishing and verification
* Modern admin interface with Tailwind CSS
* Secure authentication system

== Upgrade Notice ==

= 1.2.0 =
* New feature release. Added media upload and featured image support via API. No breaking changes. All existing integrations continue to work.

= 1.1.0 =
* Important security and compatibility update for WordPress 2025. Requires PHP 7.4+. Enhanced security features, better error handling, and improved code quality. Fully backward compatible with existing integrations.

= 1.0.0 =
* Initial release of the Zerply WordPress integration plugin

== API Documentation ==

The plugin provides three REST API endpoints:

All endpoints require Bearer token authentication using your API key in the format:
Authorization: Bearer {api_key}

= Verify Connection =

GET /wp-json/zerply/v1/verify

Verify connection and get site information.

Response:
    {
      "success": true,
      "message": "Connection verified successfully",
      "data": {
        "site_name": "Your Site Name",
        "site_url": "https://yoursite.com",
        "wordpress_version": "6.4",
        "plugin_version": "1.2.0",
        "user_id": 1,
        "user_name": "Admin User"
      }
    }

= Publish Content =

POST /wp-json/zerply/v1/publish

Publish content to WordPress.

Parameters:
* title (required): The post title
* content (required): The post content (HTML supported)
* status (optional): Post status - draft, publish, pending, or private (defaults to draft)

Body:
    {
      "title": "Post Title",
      "content": "<p>HTML content here</p>",
      "status": "draft"
    }

Status Options:
* draft - Save as draft
* publish - Publish immediately
* pending - Pending review
* private - Private post

Response:
    {
      "success": true,
      "post_id": 123,
      "post_url": "https://yoursite.com/post-slug",
      "edit_url": "https://yoursite.com/wp-admin/post.php?post=123&action=edit",
      "status": "draft"
    }

= Upload Media =

POST /wp-json/zerply/v1/media

Upload media files and set featured images.

== Troubleshooting ==

= Connection Failed =

Issue: Cannot verify connection to WordPress site

Solutions:
1. Ensure the Zerply plugin is activated in WordPress
2. Check that the site URL is correct (include https://)
3. Verify the API key is copied correctly
4. Check if your WordPress site is publicly accessible
5. Ensure your server allows outgoing connections

= Publishing Failed =

Issue: Content cannot be published to WordPress

Solutions:
1. Verify the connection status in Settings
2. Check that you have permission to create posts
3. Ensure the API key is still valid
4. Try re-verifying the connection

= Plugin Not Showing in WordPress =

Issue: Zerply plugin not visible in WordPress admin

Solutions:
1. Check that plugin files are in /wp-content/plugins/zerply-integration/
2. Ensure all plugin files were uploaded correctly
3. Check PHP version requirements (7.4+)
4. Look for errors in WordPress debug log

= API Key Not Displaying =

Issue: API key not showing in WordPress plugin page

Solutions:
1. Deactivate and reactivate the plugin
2. Check that you're logged in as an administrator
3. Look for JavaScript errors in browser console

== Security ==

* API keys are 32 characters long and randomly generated
* All requests require Bearer token authentication
* API keys are stored securely in the WordPress database
* Only verified connections can publish content

== Privacy Policy ==

This plugin does not collect or store any personal data. It only stores the API key and user ID locally in your WordPress database.

== Support ==

Need help? Contact us on our website: https://zerply.ai