Περιγραφή
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 through
/wp-json/contentgecko/v1/postsand pages through/wp-json/contentgecko/v1/pageswhile 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.
Εγκατάσταση
- 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.
Συχνές Ερωτήσεις
-
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.
Κριτικές
Συνεισφέροντες & Προγραμματιστές
“ContentGecko Connector” είναι λογισμικό ανοιχτού κώδικα. Οι παρακάτω έχουν συνεισφέρει στη δημιουργία του.
ΣυντελεστέςΜεταφράστε το “ContentGecko Connector” στην γλώσσα σας.
Ενδιαφέρεστε για την ανάπτυξη;
Περιηγηθείτε στον κώδικα, ανατρέξτε στο αποθετήριο SVN ή εγγραφείτε στο αρχείο καταγραφής αλλαγών ανάπτυξης μέσω RSS .
Σύνοψη αλλαγών
1.2.6
- Locked
/postswrite, item, delete, and translation routes to native WordPress posts only. - Added
/pageswrite, item, delete, and translation routes for native WordPress pages. - Fixed post/page updates to preserve existing content and status when those fields are omitted from an update payload.
1.2.5
- Added
metaTitleandmetaDescriptionsupport to blog post writes and WordPress blog category create/update requests. - Blog category, store category, and store product writes now use camelCase SEO fields:
metaTitleandmetaDescription. - Post, page, and blog category responses now include normalized
metaTitleandmetaDescriptionvalues.
1.2.4
- Added POST
/store/categoriesendpoint for creating WooCommerce product categories. - Added PUT
/store/categories/{id}endpoint for updating WooCommerce category name, description, slug,metaTitle, andmetaDescription. - Added PUT
/store/products/{id}endpoint for updating WooCommerce product name, description, slug, category assignment,metaTitle, andmetaDescription. - WooCommerce category and product payloads now include
metaTitleandmetaDescriptionvalues.
1.2.3
- WooCommerce GET
/store/categoriesand/store/productsnow always returndescriptionas a string (empty descriptions returndescription: ""). - Descriptions use the visible WooCommerce category/product description content (not SEO meta descriptions).
- Added
localizedByLanguagefor WooCommerce categories and products so each localized payload includes localizeddescription. - Added
idsfilter support to GET/store/products(accepts array or comma-separated values) to fetch specific products by ID.
1.2.2
- Added authenticated POST
/store/images/resolveendpoint for in-article image URL resolution. - The endpoint now reuses existing media by exact filename match (
fileName) before downloading and sideloading. - Added partial-failure support: successful results are returned in
data.imagesand failures include detailed entries indata.errors. /store/images/resolvenow supports per-imagealtText,preferredMimeType, andpreferredExtension.- Added
fileNameandmimeTypeto each resolve result and applyaltTexton reused/uploaded attachments.
1.2.0
- Added GET
/categoriesendpoint for listing WordPress blog categories with per-language name/id/slug mappings. - Added POST
/categoriesendpoint for creating WordPress blog categories. - Added PUT
/categories/{id}endpoint for updating WordPress blog categories. - Image search now accepts a single term string (legacy terms array still supported) and matches attachment filenames and alt text.
1.1.8
- Fixed WPML language variations not returning all translations for posts, pages, products, and categories.
- Changed WPML integration to use
wpml_object_idfilter withwpml_active_languagesfor more reliable translation detection. - Added proper language context switching via
wpml_switch_languageto generate correct localized permalinks. - All endpoints now consistently return
linksByLanguagewith all available language variations.
1.1.6
- Added
linksByLanguageandlanguagefields to all products in/store/productsendpoint. - Added
linksByLanguageandlanguagefields to all categories in/store/categoriesendpoint. - Language variations are automatically detected when WPML or Polylang is active.
- Added
contentgecko_product_language_linksandcontentgecko_category_language_linksfilter hooks.
1.1.5
- Enhanced
/store/images/searchendpoint to return all WordPress media library images (not just product images). - Added pagination support to images search with
pageandperPageparameters. - Images search now works without terms (returns all images when no search terms provided).
- Expanded image data to include comprehensive metadata: title, caption, description, filename, filesize, dimensions, upload date, MIME type, and thumbnail/medium URLs.
- Added
attachedTofield showing parent post information when images are attached to posts/products. - Added DELETE
/posts/{id}/deleteendpoint to move posts to trash (bin) via REST API.
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.