Presencefactor Product Sync with OLX.bg for WooCommerce

Description

Presencefactor Product Sync with OLX.bg for WooCommerce helps WooCommerce store administrators prepare and manually publish product data to OLX.bg through the OLX.bg Partner API v2.

The plugin uses the unique Presencefactor name first, and uses OLX.bg and WooCommerce only to describe the external service and platform it connects. This plugin is independent and is not affiliated with, endorsed by, or sponsored by OLX Group, OLX.bg, WooCommerce, Automattic, or WordPress.org.

The free plugin is built for controlled manual workflows. Administrators configure their OLX.bg Partner API credentials, complete OAuth authorization, map WooCommerce categories to OLX.bg category IDs, add condition/state and extra attributes, then start product synchronization manually from the WooCommerce product edit screen or Products list.

Features:

• OAuth 2.0 authorization-code connection flow with bearer token API requests.
• OLX.bg Partner API v2 endpoint support for Bulgaria.
• WooCommerce dependency declared through the Requires Plugins header.
• Client ID and Client Secret settings stored in WordPress options.
• WooCommerce category to OLX.bg category ID mapping.
• Category notes/path field for administrators.
• Category-level condition/state mapping.
• Extra attribute mapping using simple key=value lines.
• Live OLX.bg category suggestions when OAuth is connected.
• Manual product sync from the WooCommerce product edit screen.
• Bulk manual sync action from the WooCommerce Products list.
• Update existing OLX.bg adverts when an advert ID is already saved.
• Local/private image URL filtering to avoid sending non-public image URLs.
• Developer hooks for custom payload attributes, validation and logging.

External Services

This plugin connects to the OLX.bg Partner API. The service is used to authorize the store owner’s OLX.bg account, retrieve OLX.bg category suggestions in the WordPress admin area, and create or update OLX.bg adverts when an authorized administrator starts a manual sync.

Data sent during OAuth connection:

• The configured OAuth Client ID.
• The OAuth redirect URI for this WordPress site.
• The authorization code returned by OLX.bg during the OAuth flow.

Data sent when category suggestions are requested:

• An OAuth bearer token for the connected OLX.bg account.
• A request to https://www.olx.bg/api/partner/categories?limit=1000.

Data sent when an administrator manually syncs a product or uses the bulk sync action:

• Product title and description.
• Product price and currency.
• Category mapping and extra attributes configured by the administrator.
• Contact name, contact phone, city and district identifiers configured by the administrator.
• Public product image URLs when available.
• Existing OLX.bg advert ID when updating a previously synced advert.

No product data is sent automatically by this free version. Product data is sent only when an authorized store administrator starts a manual product sync or bulk sync action.

Service provider: OLX Group
API endpoint used by this plugin: https://www.olx.bg/api/partner
OAuth authorize URL used by this plugin: https://www.olx.bg/oauth/authorize
OAuth token URL used by this plugin: https://www.olx.bg/api/open/oauth/token
API documentation: https://developer.olx.bg/api/doc
OLX Group privacy statement: https://www.olxgroup.com/privacy-statement/
OLX Group terms of use: https://www.olxgroup.com/terms-of-use-2/

Privacy

OAuth tokens are stored in WordPress options and are used only for OLX.bg API requests. The plugin does not send product data automatically. Local, private, localhost and development-only image URLs are skipped before sync because the external service cannot fetch them from the public internet.