SynthSEO Publisher

Description

SynthSEO Publisher is a WordPress plugin that acts as a secure bridge between your WordPress site and the SynthSEO content generation platform. It provides a REST API interface for automated content publishing with full SEO metadata support.

✨ Key Features

• 🔒 Secure REST API – API key authentication for secure content delivery
• 📈 SEO Metadata Support – Full support for meta descriptions, keywords, Open Graph, and Twitter Cards
• 🖼️ Media Handling – Automatic featured image upload and optimization
• 📝 SEO Editor Panels – SynthSEO score, keyword strategy, and search preview right in the post editor
• 🛡️ Rate Limiting – Built-in protection against API abuse
• ⚛️ Modern Admin Interface – React-based settings panel with real-time connection testing
• 🔧 WordPress Integration – Seamless integration with WordPress post types and taxonomies
• 🎯 Debug Mode – Comprehensive debugging tools for troubleshooting

🚀 What’s New in Version 2.0.4

• SEO panel in the block editor sidebar – your article’s SynthSEO score, meta title, description, focus keyword and canonical URL, editable right where you write
• SynthSEO Analysis box – a detailed breakdown under the editor: the platform’s SEO score with six sub-metrics, the hub-and-spoke keyword strategy the article was written around, a Google-style search preview, suggestions, and schema
• Featured images now set automatically on published posts, with alt text on every uploaded image
• Media library safety – removed an over-aggressive cleanup routine that could delete images from the media library
• New REST endpoints for reading posts, SEO data, settings and stats
• Fully translation-ready: text domain aligned with the WordPress.org plugin slug

🔌 API Endpoints

• GET /wp-json/synthseo/v2/status – Check connection and plugin status
• POST /wp-json/synthseo/v2/publish – Publish single article
• PUT /wp-json/synthseo/v2/posts/{id} – Update existing post
• GET /wp-json/synthseo/v2/posts – List published posts
• GET /wp-json/synthseo/v2/posts/{id} – Read a post with its stored content and SEO data
• POST /wp-json/synthseo/v2/media and POST /wp-json/synthseo/v2/media/{id} – Upload media and set alt text
• GET /wp-json/synthseo/v2/schema – Get available fields schema

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• MySQL 5.6 or higher
• HTTPS recommended for API security

Build from Source

The production files in /build/ are compiled from the source files in /src/.

Source Code Structure

• /src/admin/ – React admin interface source code
• /src/editor/ – Post editor enhancements source
• /src/components/ – Reusable React components
• /src/hooks/ – Custom React hooks
• /src/utils/ – Utility functions
• /src/styles/ – CSS source files

Build Instructions

1. Install dependencies: npm install
2. Development build: npm run dev
3. Production build: npm run build

The source code is also available on GitHub:
https://github.com/synthseo/synthseo-publisher

API Documentation

Authentication

All API requests must include the X-API-Key header:

X-API-Key: YOUR_API_KEY_HERE

Example Request

POST /wp-json/synthseo/v2/publish
Content-Type: application/json
X-API-Key: YOUR_API_KEY_HERE

{
  "title": "Article Title",
  "content": "Article content with HTML markup...",
  "excerpt": "Brief article summary",
  "meta_description": "SEO meta description",
  "keywords": ["keyword1", "keyword2"],
  "author": "Author Name",
  "featured_image": "https://example.com/image.jpg",
  "categories": ["Technology", "WordPress"],
  "tags": ["api", "automation"]
}

Response Format

{
  "success": true,
  "data": {
    "id": 123,
    "link": "https://yoursite.com/article-title/",
    "status": "publish"
  }
}

Development

Build from Source

The plugin uses modern JavaScript tooling with React 18 and Webpack 5.

Requirements:
* Node.js 18+
* npm or yarn
* WordPress 5.0+
* PHP 7.4+

Available Scripts:
* npm run start – Development build with watch
* npm run build – Production build
* npm run build:dev – Development build
* npm run clean – Clean build artifacts
* npm run release – Create release package
* npm run lint:js – Run linting
* npm run format – Format code

Project Structure

• /build/ – Compiled assets
• /includes/ – PHP classes
• /src/ – React source files
• /src/components/ – React components
• /src/contexts/ – React contexts
• /src/hooks/ – Custom hooks
• /src/styles/ – CSS/Tailwind styles
• /src/admin.js – Admin interface entry
• /src/editor.js – Post editor entry

Debug Mode

The plugin includes a comprehensive debug mode for development:

To enable the Debug tab:

Add these constants to your wp-config.php:
php
define('WP_DEBUG', true);
define('SYNTHSEO_DEVELOPMENT', true);

Note: The Debug tab is only available in development environments and will not appear in production releases.

When enabled, the Debug tab shows:
* Complete post data structure
* All metadata fields
* Post status breakdown
* API configuration
* WordPress dependencies status

Support

For support, feature requests, or bug reports:

• Documentation: Available in plugin’s Documentation tab
• GitHub: https://github.com/synthseo/synthseo-publisher
• Support: https://www.synthseo.ai/support

Privacy Policy

This plugin does not collect any personal data. It only processes content submitted through the API for publishing on your WordPress site.

Third Party Services

This plugin communicates with the SynthSEO platform (https://www.synthseo.ai) to receive content for publishing. By using this plugin, you agree to SynthSEO’s terms of service and privacy policy.

Data sent to SynthSEO:
* Publishing status and confirmation
* Error messages (for debugging)

Data received from SynthSEO:
* Post content and metadata
* SEO optimization data
* Media files for upload

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Credits

• SynthSEO Development Team
• WordPress Community
• React and WordPress Packages Contributors

For more information, visit SynthSEO.ai

Development

Building from Source

The plugin includes all source files for transparency and contribution.

1. Install dependencies: npm install
2. Development build: npm run dev
3. Production build: npm run build

Contributing

We welcome contributions! Please visit our GitHub repository to submit issues or pull requests.

Support

For support, please visit SynthSEO.ai or create an issue on GitHub.