Description
Desperado House Product Sync for PIK is an independent integration for WooCommerce shop owners who already sell on the olx.ba (PIK) marketplace. It is not affiliated with, endorsed by, or an official plugin of PIK d.o.o. / olx.ba. “OLX”, “PIK” and “olx.ba” are trademarks of their respective owners and are used only to describe the integration.
The plugin does exactly two things:
- Manual linking — on each WooCommerce product edit screen you enter the numeric ID of your existing olx.ba listing and link it to the product. You can also break the local link at any time (this never touches the listing on olx.ba).
- Manual sync — with one click (“Ažuriraj na OLX”) the plugin compares the WooCommerce product with the linked listing and updates on olx.ba only what changed: title, description, price and product images.
Notes:
- The listing category, condition/state and olx.ba attributes are never modified by the sync — they stay exactly as you set them on olx.ba.
- For variable WooCommerce products, the listing price is taken from the first variation and all variations with prices are listed in the listing description under “DODATNE OPCIJE I CIJENE”.
- The plugin stores an olx.ba API token that you obtain with your own olx.ba account (Settings page), and a product-list status column shows which products are linked.
- Looking for automation? A separate Premium version with automatic listing creation, automatic synchronization, stock synchronization, mass actions and deletion is available at https://desperadohouse.com (see the “Upgrade to Premium” section below).
Donate
If you find this plugin useful, consider supporting its continued development with a donation.
Languages
The plugin administration interface is available in Bosnian/Serbian/Croatian and English.
Upgrade to Premium
This free plugin is fully functional on its own — manual linking by OLX ID and manual synchronization work completely, with no license key, registration, time limit or feature limits. Nothing in this plugin is locked.
If you want to go further, a separate Premium version is offered by the author (Desperado House) on its own website at https://desperadohouse.com. The Premium version is a separate plugin, hosted and sold outside of WordPress.org, and it adds extra automation features on top of what this free version already does:
- Automatic adding — create new listings on PIK (on olx.ba) directly from your WooCommerce products
- Automatic synchronization — title, description, price and images are updated on olx.ba automatically when a product is saved in WooCommerce
- Stock synchronization — listing availability on PIK (on olx.ba) follows your WooCommerce stock status automatically
- Mass adding — create listings for many WooCommerce products in one batch
- Mass synchronization — synchronize many linked products at once
- Deleting — remove listings on PIK (on olx.ba) directly from your shop
WordPress.org hosts only this free version. The Premium version is not bundled with it and this free plugin never locks, disables or limits any of its own features behind the upgrade.
External services
This plugin connects to the public olx.ba (PIK) API, hosted at https://api.olx.ba, operated by PIK d.o.o. (olx.ba). This connection is required because the plugin’s entire purpose is to update your existing listings on that marketplace; this cannot be done locally without their API.
What the plugin sends and when:
- API authentication — Your olx.ba API token is sent as an Authorization header with every API request. You obtain the token either manually (copy it from your olx.ba account) or by entering your olx.ba username and password on the plugin Settings page and clicking “Prijavi se i dobij token”. In that case your username and password are sent once to the olx.ba API login endpoint (https://api.olx.ba/auth/login) and the returned token is stored in your WordPress database. Your credentials are never sent anywhere else.
- Product data — When you click “Ažuriraj na OLX” on a product (or call the
dhpsync_sync_product()helper), the plugin sends: the product title (max 65 characters), the product description converted to olx.ba text format, the product price, and — if images changed — the product image files, to the olx.ba API for the specific listing ID you linked. The plugin also reads the current listing data (title, price, category, state) from the API to detect changes before updating. - Connection test — The Settings page “Testiraj konekciju” button performs an unauthenticated GET request to the categories endpoint of the olx.ba API.
No customer data, order data or other personal data from your WooCommerce store is sent to olx.ba. Only the data described above, always triggered by an explicit manual action by a logged-in administrator/shop manager.
Links to the service provider’s terms and policies:
- Terms of use: https://www.olx.ba/o-olxu/uslovi-koristenja
- Privacy policy: https://www.olx.ba/o-olxu/privatnost-podataka
Installation
- Upload the plugin files to the
/wp-content/plugins/desperado-house-product-sync-for-pikdirectory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- WooCommerce must be installed and active.
- Open DH Product Sync > Postavke and connect with your olx.ba account (username + password, or paste an API token directly).
- Open a product, enter your existing olx.ba listing ID in the “DH Product Sync” meta box and click “Poveži sa OLX”.
FAQ
-
How do I get an olx.ba API token?
-
Log in on olx.ba, go to your account settings and create a new API token, then paste it on the plugin Settings page. Alternatively, enter your olx.ba username and password in the plugin Settings and click “Prijavi se i dobij token” — the plugin will fetch and store the token for you.
-
Does the plugin create new listings on olx.ba?
-
No. The plugin only links WooCommerce products to listings that already exist on olx.ba and updates their content on demand.
-
Are variable products supported?
-
Yes. The listing price is taken from the first variation and all variations with prices are listed in the listing description under “DODATNE OPCIJE I CIJENE”.
-
What if the sync fails?
-
Check that the product is linked to a valid olx.ba listing ID, that your olx.ba API token is still valid, and read the error message shown in the product meta box.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Desperado House Product Sync for PIK” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Desperado House Product Sync for PIK” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
3.1.0
- Removed the license/trial system — all features are free and fully functional.
- Removed automatic synchronization, stock synchronization, category mapping, auto-matching, mass operations, listing creation and advertisement deletion. The plugin now focuses on manual linking by OLX ID and manual synchronization.
- Renamed the plugin to “Desperado House Product Sync for PIK” with unique
dhpsyncprefixed names. - Meta box scripts are now enqueued with wp_enqueue_script.
- Documented the olx.ba external API service in the readme.
- Added a note about the separate Premium version with automation features (hosted on desperadohouse.com).
3.0.0
- Initial submission version.