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

Create WordPress posts via REST API with custom SEO fields, image uploads, primary category assignment, and integration with major SEO plugins (SEOPress, Yoast SEO, Rank Math).

== Description ==

The WPRaiz Content API Tool is a powerful plugin that enables the creation of WordPress posts programmatically through a REST API. Ideal for developers and websites that need seamless content integration from external systems, this plugin supports:

- **Integration with Major SEO Plugins**: Set custom SEO fields for titles and descriptions, compatible with SEOPress, Yoast SEO, and Rank Math.
- **Flexible Image Uploads**: Accept images via URL, with automatic attachment as the featured image.
- **Automatic Category Management**: Assign an existing category or create a new one based on supplied category names.
- **Installation Check Endpoint**: Verify plugin installation, authentication, and detect the installed SEO plugin.
- **Post Similarity Search**: Find and return the top 10 most similar published posts by title for better content linking and duplication checks.
- **Admin Interface**: Dashboard section with copyable API endpoints for easy testing.

== 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.

== Authentication ==

To authenticate API requests, you must use an application password, which can be generated from your user profile in the WordPress admin dashboard.

1. **Generate Application Password**: Go to **Users > Profile** in the WordPress dashboard and create an application password.
2. **Authorization Header**: Pass the application password in a Base64-encoded `Authorization` header in the format `Basic {base64_encode(username:application_password)}`.

== REST API Endpoints ==

1. **Create Post Endpoint**  
   - **URL**: `/wp-json/api-post-creator/v1/create-post`  
   - **Method**: POST  
   - **Parameters**:
     - `title` (required): Title of the post.  
     - `content` (required): Content of the post.  
     - `status` (optional): Post status (default: draft).  
     - `primary_category` (optional): Primary category name.  
     - `seo_title` (optional): SEO title.  
     - `seo_desc` (optional): SEO description.  
     - `image_url` (optional): URL for the featured image.

2. **Check Installation Endpoint**  
   - **URL**: `/wp-json/api-post-creator/v1/check-status`  
   - **Method**: GET  
   - **Purpose**: Verifies plugin status and active SEO plugin.

3. **List Categories Endpoint**  
   - **URL**: `/wp-json/api-post-creator/v1/get-categories`  
   - **Method**: GET  
   - **Purpose**: Returns all registered post categories.

4. **Similar Titles Search Endpoint**  
   - **URL**: `/wp-json/api-post-creator/v1/search-similar-posts?title=Your+Title+Here`  
   - **Method**: GET  
   - **Purpose**: Returns the top 10 most similar published posts by title.

== Frequently Asked Questions ==

= What is the REST API endpoint to create posts? =
Use `/wp-json/api-post-creator/v1/create-post` with a POST request and appropriate parameters.

= How do I authenticate requests? =
Use application passwords and pass them using the Basic Auth header.

= What SEO plugins are supported? =
SEOPress, Yoast SEO, and Rank Math. The plugin auto-updates the correct meta fields.

= Can I search for similar post titles before publishing? =
Yes! Use the `/search-similar-posts` endpoint to retrieve related posts for internal linking or avoiding duplicates.

== Screenshots ==

1. **Admin Page Interface** – Displays all endpoints with copy buttons.
2. **API Example Payload** – Demonstrates JSON structure to create a post.
3. **Similarity Response** – JSON listing similar titles by relevance.

== Changelog ==

= 1.5 =
* Adicionada interface mais organizada para endpoints na página do admin.
* Novo endpoint `search-similar-posts` para sugerir conteúdos semelhantes com score.
* Otimizações de compatibilidade com WordPress 6.7.2.
* SEO fields agora são gravados diretamente em todos os plugins suportados.

= 1.4 =
* Added SEO metadata integration for SEOPress, Yoast SEO, and Rank Math.
* Introduced `/check-status` endpoint to verify installation and authentication.
* Enhanced error handling and response messages.

= 1.3 =
* Improved compatibility with WordPress 6.6.
* Proper enqueuing of admin JavaScript and CSS files.
* Added support for automatic category creation.
* Enhanced image upload functionality.

= 1.2 =
* Added support for SEO metadata (SEOPress compatibility).
* Fixed image upload issues.

= 1.1 =
* Initial public release with basic post creation via REST API.

== Upgrade Notice ==

= 1.5 =
Recomendado para todos os usuários. Adiciona recursos importantes de verificação de similaridade e melhoria de usabilidade no painel administrativo.

== License ==
Este plugin é licenciado sob a GPLv3. Veja [GNU's official site](https://www.gnu.org/licenses/gpl-3.0.html) para detalhes.

== Support ==
Para dúvidas ou suporte, visite [WPRaiz Support](https://ai.wpraiz.com.br).