ContentGecko Connector

چۈشەندۈرۈش

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/v1 while 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.

ئورنىتىش

  1. Upload the contentgecko-connector folder to the /wp-content/plugins/ directory or install the ZIP via Plugins Add New Upload Plugin.
  2. Activate the plugin through the Plugins menu.
  3. Navigate to Settings ContentGecko Connector and click Generate API Key. The plain key is displayed once; copy it into the ContentGecko app immediately.
  4. (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-Key header. The stored key is hashed using hash_hmac() with AUTH_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.

باھالاشلار

2025-يىلى 17-نويابىر
Does exactly what it’s supposed to – nothing more, nothing less. ContentGecko is a great way to automate SEO for a Woocommerce store.
1 باھالاشنىڭ ھەممىنى ئوقۇش

تۆھپىكار ۋە ئىجادكار

«ContentGecko Connector» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.

تۆھپىكار

«ContentGecko Connector» نى تىلىڭىزغا تەرجىمە قىلىڭ

ئىجادىيەتكە قىزىقامسىز؟

كودقا كۆز يۈگۈرتۈپ، SVN خەزىنە تەكشۈرۈپ ياكى RSSئارقىلىق ئىجادىيەت خاتىرىسىگە مۇشتەرى بولغىلى بولىدۇ.

ئۆزگىرىش خاتىرىسى

1.2.0

  • Added GET /categories endpoint for listing WordPress blog categories with per-language name/id/slug mappings.
  • Added POST /categories endpoint 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_id filter with wpml_active_languages for more reliable translation detection.
  • Added proper language context switching via wpml_switch_language to generate correct localized permalinks.
  • All endpoints now consistently return linksByLanguage with all available language variations.

1.1.6

  • Added linksByLanguage and language fields to all products in /store/products endpoint.
  • Added linksByLanguage and language fields to all categories in /store/categories endpoint.
  • Language variations are automatically detected when WPML or Polylang is active.
  • Added contentgecko_product_language_links and contentgecko_category_language_links filter hooks.

1.1.5

  • Enhanced /store/images/search endpoint to return all WordPress media library images (not just product images).
  • Added pagination support to images search with page and perPage parameters.
  • 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 attachedTo field showing parent post information when images are attached to posts/products.
  • Added DELETE /posts/{id}/delete endpoint 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.