Description
ContentGecko Connector exposes a secure REST API that the ContentGecko platform can use to synchronise posts, pages, product data, and translations with WordPress and WooCommerce. Access is protected by a shared API key, optional IP allow-listing, and tight capability checks inside wp-admin. The plugin stores minimal data, leans on WordPress core APIs, and keeps logging opt-in so your site remains lightweight.
Key features:
- Publish or update posts and pages through
/wp-json/contentgecko/v1while sanitising content and metadata through WordPress core helpers. - Map multilingual content to WPML or Polylang, automatically linking translations and respecting the site’s default language.
- Provide product, category, and catalog feeds when WooCommerce is active (gracefully failing when it is not).
- Sideload remote featured images using WordPress core upload handlers (mime restricted) and reuse existing attachments when possible.
- Optional debug log that persists the last 50 REST calls and mirrors high-level telemetry inside the wp-admin settings screen.
The admin settings page lives under Settings ContentGecko Connector where administrators can generate API keys, toggle logging, view recent requests, and confirm the /health endpoint matches the WordPress environment.
Short Description
ContentGecko Connector exposes a secure REST API that the allows ContentGecko to automatically write and publish content for your webstore.
Installation
- Upload the
contentgecko-connectorfolder to the/wp-content/plugins/directory or install the ZIP via Plugins Add New Upload Plugin. - Activate the plugin through the Plugins menu.
- Navigate to Settings ContentGecko Connector and click Generate API Key. The plain key is displayed once; copy it into the ContentGecko app immediately.
- (Optional) Enable request logging to store the last 50 API interactions for troubleshooting.
FAQ
-
How is the API secured?
-
Every request must include the
X-ContentGecko-Keyheader. The stored key is hashed usinghash_hmac()withAUTH_SALT, and an allow list filter (contentgecko_allowed_ips) lets you restrict inbound requests by IP if desired. -
Does the plugin phone home or track usage?
-
No. The plugin only processes requests that hit your site’s REST API and never sends telemetry back to ContentGecko automatically. Logging is disabled by default and, when enabled, is limited to recent request metadata stored in a WordPress transient.
-
Which third-party libraries are bundled?
-
The plugin ships with Parsedown (MIT license) to convert Markdown payloads to HTML when needed. Its licence is included in
licenses/parsedown.txt.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ContentGecko Connector” is open source software. The following people have contributed to this plugin.
Contributors
Translate “ContentGecko Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.4
- API responses now return the final permalink and featured image ID immediately after post creation, making downstream publishing flows more reliable.
1.1.3
- Enhanced cache clearing to match WordPress UI save behavior – content now appears immediately on frontend after API sync.
- Added comprehensive object cache, term cache, and permalink cache clearing.
- Trigger edit_post and post_updated actions after all metadata is set to ensure cache plugins work correctly.
1.1.2
- The plugin now runs cache purges now run after every post sync.
1.1.1
- Added WordPress.org ready metadata, text domain loader, and documentation updates for plugin review submission.
- Hardened REST permission callbacks to return structured errors before route callbacks run.
- Included GPL-2.0-or-later licence text and third-party attribution for Parsedown.