內容簡介
SynthSEO Publisher 是一款 WordPress 外掛，作為 WordPress 網站與 SynthSEO 內容生成平台之間的安全橋樑。它提供 REST API 介面，支援自動內容發布及完整的 SEO 元數據。
【主要功能】
• 安全的 REST API - 使用 API 金鑰進行安全內容傳遞
• SEO 元數據支援 - 完整支援 meta 描述、關鍵字、Open Graph 和 Twitter Cards
• 媒體處理 - 自動上傳及優化特色圖片
• SEO 編輯面板 - 在文章編輯器中顯示 SynthSEO 分數及關鍵字策略
• 速率限制 - 內建防止 API 濫用的保護機制
• 現代化管理介面 - 基於 React 的設定面板，具即時連接測試功能
外掛標籤
開發者團隊
原文外掛簡介
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
Install dependencies: npm install
Development build: npm run dev
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.
Install dependencies: npm install
Development build: npm run dev
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.
