=== WPRaiz Content API Tool ===
Contributors: zeicaro
Donate link: https://ai.wpraiz.com.br
Tags: REST API, Content, Post Creation, SEO, Image Upload
Requires at least: 5.0
Tested up to: 6.6
Stable tag: 1.3
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Create WordPress posts via a REST API with custom SEO fields, image uploads, and primary category assignment.

== Description ==

The WPRaiz Content API Tool is a plugin that allows you to create WordPress posts via a REST API. This plugin supports custom SEO fields, image uploads, and primary category assignment, making it ideal for automated content workflows.

Features:

- Create posts programmatically via a custom REST API endpoint.
- Upload images via URL and set as post featured image.
- Set custom SEO titles and descriptions for each post.
- Automatically create or assign a primary category to the post.

The plugin is useful for developers looking to automate content creation workflows and for websites that need content integration from external systems.

== Installation ==

1. Download the plugin zip file.
2. In your WordPress dashboard, go to **Plugins > Add New**.
3. Click on **Upload Plugin** and choose the zip file you downloaded.
4. Click **Install Now** and activate the plugin.
5. Use the REST API endpoint `/wp-json/api-post-creator/v1/create-post` to start creating posts programmatically.

== Frequently Asked Questions ==

= What is the REST API endpoint to create posts? =
The endpoint to create posts is /wp-json/api-post-creator/v1/create-post. You need to make a POST request to this URL with the required parameters.

= What parameters are required to create a post? =
The following parameters are required:

- title: The title of the post.
- content: The content of the post.

Optional parameters include:

- status: The status of the post (default is draft).
- primary_category: The category name to assign to the post.
- seopress_title: Custom SEO title.
- seopress_desc: Custom SEO description.
- image_url: URL of the image to set as the featured image.

= How do I authenticate API requests? =
You need to use an application password to authenticate requests. This can be generated from your user profile in the WordPress admin dashboard.

= What formats are supported for image uploads? =
You can upload images by providing a direct URL. Supported formats are JPG, PNG, GIF, and JPEG.

= Can I add categories programmatically? =
Yes, the plugin automatically checks if the provided category exists. If it doesn't, it will create it automatically.

== Screenshots ==

1. **Settings page in the WordPress dashboard:** Customize API-related settings easily.
2. **API request example:** Demonstrates how to send a JSON payload to create a new post.

== Changelog ==

= 1.3 =
* Improved compatibility with WordPress 6.6.
* Added proper enqueuing of admin JavaScript and CSS files.
* Updated logo references to use local assets.
* Added support for category creation.
* Improved image upload functionality.

= 1.2 =
* Added support for SEO metadata (SEOPress compatibility).
* Fixed issues with image upload and category assignment.
* Added more detailed error messages for failed post creation.

= 1.1 =
* Added image upload via URL and Base64.
* Initial public release.

== Upgrade Notice ==

= 1.3 =
* Critical update for category management and enhanced image handling. Please update to ensure proper functionality.

== License ==
This plugin is licensed under the GPLv3. For more details, visit [GNU's official site](https://www.gnu.org/licenses/gpl-3.0.html).

== Support ==
If you have any questions or issues with the plugin, please visit WPRaiz Support.