{"id":3778,"date":"2025-05-03T16:57:30","date_gmt":"2025-05-03T14:57:30","guid":{"rendered":"https:\/\/cocos.codes\/?p=3778"},"modified":"2026-01-21T16:09:32","modified_gmt":"2026-01-21T15:09:32","slug":"wordpress-olx-integration","status":"publish","type":"post","link":"https:\/\/cocos.codes\/en\/archiwa\/integracja-wordpress-olx\/","title":{"rendered":"WordPress OLX integration 1.0"},"content":{"rendered":"<h6 data-rm-block-id=\"block-1\">Documentation WordPress OLX Integration<\/h6>Comprehensive documentation for a plugin that enables WooCommerce integration with the OLX platform (<a href=\"https:\/\/cocos.codes\/en\/product\/wordpress-olx-integration\/\" title=\"Cc_wordpress_olx_integration\">cc_wordpress_olx_integration<\/a>).<br \/><br \/><p data-rm-block-id=\"block-2\"><strong>Table of contents<\/strong><\/p><ol><li data-rm-block-id=\"block-3\">Introduction<\/li><li data-rm-block-id=\"block-4\">Installation<\/li><li data-rm-block-id=\"block-5\">License activation<\/li><li data-rm-block-id=\"block-6\">Main desktop<\/li><li data-rm-block-id=\"block-7\">Integration with products<\/li><li data-rm-block-id=\"block-8\">Managing the list of announcements<\/li><li data-rm-block-id=\"block-9\">API settings<\/li><li data-rm-block-id=\"block-10\">Location management<\/li><li data-rm-block-id=\"block-11\">Troubleshooting<\/li><li data-rm-block-id=\"block-12\">FAQ<\/li><\/ol><h6 data-rm-block-id=\"block-13\"><br \/>1. introduction<\/h6>CC WordPress OLX Integration is a professional plugin for WordPress that allows you to fully integrate your WooCommerce store with the OLX platform. It allows you to publish, update and manage your ads directly from the WordPress admin panel, without having to log into the OLX panel.<br \/><br \/>The plug-in allows full control over:<ul><li data-rm-block-id=\"block-14\">Create and publish OLX ads based on WooCommerce products<\/li><li data-rm-block-id=\"block-15\">Update announcements after product changes<\/li><li data-rm-block-id=\"block-16\">Managing the status of announcements (activation, deactivation)<\/li><li data-rm-block-id=\"block-17\">Monitoring statistics of announcements<\/li><li data-rm-block-id=\"block-18\">Automatic synchronization of locations (cities, districts)<\/li><\/ul><h6 data-rm-block-id=\"block-19\"><br \/>2 Installation<\/h6><strong>System requirements<\/strong><ul><li data-rm-block-id=\"block-20\">WordPress 5.0 or later<\/li><li data-rm-block-id=\"block-21\">WooCommerce 3.0 or later<\/li><li data-rm-block-id=\"block-22\">PHP 7.0 or later<\/li><\/ul><strong>Installation process<\/strong><ol><li data-rm-block-id=\"block-23\">Download the ZIP file of the plug-in from the official store <a class=\"button\" href=\"https:\/\/cocos.codes\/en\/\" title=\"Cocos.codes\">cocos.codes<\/a><\/li><li data-rm-block-id=\"block-24\">Log in to your WordPress admin panel<\/li><li data-rm-block-id=\"block-25\">Go to: Plugins &gt; Add New &gt; Upload Plugin<\/li><li data-rm-block-id=\"block-26\">Select the downloaded ZIP file and click \"Install Now\".<\/li><li data-rm-block-id=\"block-27\">When the installation is complete, click \"Enable plug-in\"<\/li><\/ol><div class=\"cc-alert cc-alert-info\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-28\">Info<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-29\">The plugin requires an active WooCommerce. If WooCommerce is not installed or activated, the plugin will display a corresponding message.<\/div><\/div><h6 data-rm-block-id=\"block-30\"><br \/>3. license activation<\/h6>It is necessary to activate the license before using the plug-in:<ol><li data-rm-block-id=\"block-31\">After installation, a new item \"OLX Integration\" will appear in the menu.<\/li><li data-rm-block-id=\"block-32\">Go to OLX Integration &gt; License.<\/li><li data-rm-block-id=\"block-33\">Enter the license key you received after purchase<\/li><li data-rm-block-id=\"block-34\">Click \"Activate License\"<\/li><li data-rm-block-id=\"block-35\">After successful activation, you will see a confirmation message and all features of the plugin will be unlocked<\/li><\/ol><div class=\"cc-alert cc-alert-warning\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-36\">Warning<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-37\">Without an active license, the plug-in will work in limited mode, without the ability to publish and manage ads on OLX.<\/div><\/div><h6 data-rm-block-id=\"block-38\"><br \/>4. main desktop<\/h6>The plug-in's main dashboard contains key information and statistics: <strong>Statistics panel<\/strong><ul><li data-rm-block-id=\"block-39\">Number of total announcements<\/li><li data-rm-block-id=\"block-40\">Number of active announcements<\/li><li data-rm-block-id=\"block-41\">Number of pending announcements<\/li><li data-rm-block-id=\"block-42\">Number of inactive announcements<\/li><\/ul><strong>Announcement details<\/strong><ul><li data-rm-block-id=\"block-43\">New announcements<\/li><li data-rm-block-id=\"block-44\">Unpaid ads<\/li><li data-rm-block-id=\"block-45\">Unconfirmed announcements<\/li><\/ul><strong>Fast action<\/strong><ul><li data-rm-block-id=\"block-46\">See all ads - redirect to list of ads<\/li><li data-rm-block-id=\"block-47\">Add new ad - redirect to add WooCommerce products<\/li><\/ul><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-48\">Tip<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-49\">The statistics panel provides a quick overview of the status of announcements. The chart shows the percentage of announcements with different statuses.<\/div><\/div><h6 data-rm-block-id=\"block-50\"><br \/>5. product integration<\/h6>Integration with WooCommerce products is done via an additional panel in the product edition: <strong>Enabling integration for the product<\/strong><ol><li data-rm-block-id=\"block-51\">Go to edit the WooCommerce product (Products &gt; Edit).<\/li><li data-rm-block-id=\"block-52\">Locate the \"Integration with OLX\" section below the product description<\/li><li data-rm-block-id=\"block-53\">Check the option \"Enable OLX integration for this product\".<\/li><li data-rm-block-id=\"block-54\">Fill out the ad data form<\/li><li data-rm-block-id=\"block-55\">Save the product data by clicking the \"Update\" button<\/li><\/ol><strong>Ad configuration<\/strong><ul><li data-rm-block-id=\"block-56\"><strong>Ad title<\/strong> - Default is the same as the product name (requires 16-70 characters)<\/li><li data-rm-block-id=\"block-57\"><strong>Advertisement description<\/strong> - default product description (requires 80-9000 characters)<\/li><li data-rm-block-id=\"block-58\"><strong>OLX category<\/strong> - OLX category selection for the ad<\/li><li data-rm-block-id=\"block-59\"><strong>Category attributes<\/strong> - additional fields specific to the selected category<\/li><li data-rm-block-id=\"block-60\"><strong>Account type<\/strong> - private or company<\/li><li data-rm-block-id=\"block-61\"><strong>Contact information<\/strong> - first name\/company name and phone number<\/li><li data-rm-block-id=\"block-62\"><strong>Location<\/strong> - city and optionally district<\/li><li data-rm-block-id=\"block-63\"><strong>Price<\/strong> - value, currency and \"negotiable\" option<\/li><\/ul><strong>Publication panel in the side menu<\/strong><ul><li data-rm-block-id=\"block-64\">\"Publish on OLX\" button - for new ads<\/li><li data-rm-block-id=\"block-65\">\"Update announcement\" button - for existing announcements<\/li><li data-rm-block-id=\"block-66\">\"Deactivate announcement\" button - for active announcements<\/li><li data-rm-block-id=\"block-67\">\"Activate announcement\" button - for inactive announcements<\/li><li data-rm-block-id=\"block-68\">\"Delete ad\" button - completely remove the ad from OLX<\/li><\/ul><div class=\"cc-alert cc-alert-note\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-69\">Note<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-70\">Photos of the product are automatically used in the OLX ad. The first 8 photos from the product gallery will be sent to OLX.<\/div><\/div><h6 data-rm-block-id=\"block-71\"><br \/>6 Manage the list of announcements<\/h6>The \"Announcement List\" tab allows you to view and manage all announcements: <br \/><br \/><strong>Filtering announcements<\/strong><ul><li data-rm-block-id=\"block-72\">By product category<\/li><li data-rm-block-id=\"block-73\">By announcement status<\/li><li data-rm-block-id=\"block-74\">By date (from-to)<\/li><li data-rm-block-id=\"block-75\">Text Search<\/li><\/ul><strong>Table of announcements<\/strong><ul><li data-rm-block-id=\"block-76\">Product name<\/li><li data-rm-block-id=\"block-77\">Ad ID (with a link to the ad on OLX)<\/li><li data-rm-block-id=\"block-78\">Announcement status<\/li><li data-rm-block-id=\"block-79\">OLX category<\/li><li data-rm-block-id=\"block-80\">Date of creation<\/li><li data-rm-block-id=\"block-81\">Expiration date<\/li><li data-rm-block-id=\"block-82\">Price<\/li><li data-rm-block-id=\"block-83\">Available actions<\/li><\/ul><strong>Actions for announcements<\/strong><ul><li data-rm-block-id=\"block-84\">Deactivation of the ad<\/li><li data-rm-block-id=\"block-85\">Announcement activation<\/li><li data-rm-block-id=\"block-86\">Deletion of notice<\/li><li data-rm-block-id=\"block-87\">Status refresh<\/li><\/ul><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-88\">Tip<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-89\">Ads that expire in the next 3 days are marked with a special warning message.<\/div><\/div><h6 data-rm-block-id=\"block-90\"><br \/>7 API settings<\/h6>In the \"Settings\" tab, you can configure the connection to the OLX API and default values for ads: <strong>OLX API Settings<\/strong><ul><li data-rm-block-id=\"block-91\"><strong>Client ID<\/strong> - customer ID received from OLX<\/li><li data-rm-block-id=\"block-92\"><strong>Client Secret<\/strong> - Secret customer key received from OLX<\/li><li data-rm-block-id=\"block-93\"><strong>Redirection URI<\/strong> - address for authorization (set by default)<\/li><li data-rm-block-id=\"block-94\"><strong>Base API URL<\/strong> - OLX API address (default: https:\/\/www.olx.pl)<\/li><\/ul><strong>Default ad values<\/strong><ul><li data-rm-block-id=\"block-95\"><strong>Default city<\/strong> - location used for new announcements<\/li><li data-rm-block-id=\"block-96\"><strong>Default district<\/strong> - district used for new announcements<\/li><li data-rm-block-id=\"block-97\"><strong>Default phone number<\/strong> - contact number for announcements<\/li><li data-rm-block-id=\"block-98\"><strong>Default name \/ company name<\/strong> - name of contact for announcements<\/li><li data-rm-block-id=\"block-99\"><strong>Default account type<\/strong> - private or company<\/li><li data-rm-block-id=\"block-100\"><strong>Default currency<\/strong> - currency used in advertisements (PLN, EUR, USD)<\/li><li data-rm-block-id=\"block-101\"><strong>Headline of the ad<\/strong> - text added at the beginning of the description<\/li><li data-rm-block-id=\"block-102\"><strong>Advertisement footer<\/strong> - text added at the end of the description<\/li><li data-rm-block-id=\"block-103\"><strong>Enable automatic header\/footer<\/strong> - whether to include these elements in the descriptions<\/li><\/ul><div class=\"cc-alert cc-alert-success\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-104\">Success<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-105\">After successfully connecting to the OLX API, you will see the message \"Connected to OLX API. The access token is valid.\"<\/div><\/div><h6 data-rm-block-id=\"block-106\"><br \/>8. location management<\/h6>The \"Locations\" tab allows you to synchronize your location data with OLX: <strong>Location data<\/strong><ul><li data-rm-block-id=\"block-107\">Regions\/Voivodships<\/li><li data-rm-block-id=\"block-108\">Cities<\/li><li data-rm-block-id=\"block-109\">Districts<\/li><\/ul><strong>Synchronization process<\/strong><ol><li data-rm-block-id=\"block-110\">Synchronization of regions<\/li><li data-rm-block-id=\"block-111\">Synchronization of cities (incremental process)<\/li><li data-rm-block-id=\"block-112\">Synchronization of districts (for each city)<\/li><\/ol><div class=\"cc-alert cc-alert-info\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-113\">Info<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-114\">Location synchronization allows you to store city and neighborhood data in a local database, which greatly speeds up the plug-in.<br \/>By default, the plug-in comes with a pre-installed database, so city synchronization is not necessary.<br \/><br \/><\/div><\/div><h6 data-rm-block-id=\"block-115\"><br \/>9 Troubleshooting<\/h6><strong>The ad is not published on OLX<\/strong><ol><li data-rm-block-id=\"block-116\">Check if the license is active<\/li><li data-rm-block-id=\"block-117\">Make sure that the API data (Client ID and Client Secret) is correct<\/li><li data-rm-block-id=\"block-118\">Check that all required fields in the announcement form are filled in<\/li><li data-rm-block-id=\"block-119\">Check that the title and description meet the length requirements (title: 16-70 characters, description: 80-9000 characters)<\/li><li data-rm-block-id=\"block-120\">Make sure that the selected OLX category is the final category (without subcategories)<\/li><\/ol><strong>Data validation errors<\/strong><ol><li data-rm-block-id=\"block-121\">Check that all required attributes for the selected category have been filled in<\/li><li data-rm-block-id=\"block-122\">Make sure the price is a number greater than zero<\/li><li data-rm-block-id=\"block-123\">Check the correctness of the phone number<\/li><\/ol><strong>Problems with location synchronization<\/strong><ol><li data-rm-block-id=\"block-124\">Check the connection to the OLX API<\/li><li data-rm-block-id=\"block-125\">Make sure the access token is valid<\/li><li data-rm-block-id=\"block-126\">Check database write permissions<\/li><\/ol><div class=\"cc-alert cc-alert-error\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-127\">Error<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-128\">If there are communication errors with the OLX API, make sure that your API parameters are correct and that you have an active account on the OLX platform with API permissions.<\/div><\/div><h6 data-rm-block-id=\"block-129\"><br \/>10. FAQS.<\/h6><strong>Does the plugin work without WooCommerce?<\/strong><br \/>No, the plugin requires an active WooCommerce, as it relies on WooCommerce products as the data source for ads.<br \/><br \/><strong>How many ads can I publish on OLX?<\/strong><br \/>The number of ads depends on your plan on the OLX platform, not the plugin.<br \/><br \/><strong>Can I use the plugin for multiple stores?<\/strong><br \/>Yes, each license allows you to use the plugin on one WordPress installation. For multiple stores you need separate licenses.<br \/><br \/><strong>Does the plugin automatically update the ads when the product changes?<\/strong><br \/>No, you have to manually click \"Update Ad\" after making changes to the product.<br \/><br \/><strong>What happens to the ad when the product is sold out?<\/strong><br \/>The plugin does not automatically deactivate ads. You can configure a function that will check inventory and deactivate ads for sold out products.<br \/><br \/><strong>Can I have different settings for different ads?<\/strong><br \/>Yes, each product can have individual ad settings, independent of the default settings.<br \/><br \/><strong>Does the plugin support product variants?<\/strong><br \/>Yes, for variation products you can create ads containing all available variants.<br \/><br \/><strong>Do I need a special account on OLX to use the plugin?<\/strong><br \/>Yes, you need an account with access to the OLX API. Contact OLX support to get API access credentials through the platform <a href=\"https:\/\/developer.olx.pl\/\" title=\"Https:\/\/developer.olx.pl\/\" target=\"_blank\" rel=\"noopener\">https:\/\/developer.olx.pl\/<\/a><br \/><br \/><br \/><div class=\"cc-alert cc-alert-tip\"><div class=\"cc-alert-title\" data-rm-block-id=\"block-130\">Tip<\/div><div class=\"cc-alert-content\" data-rm-block-id=\"block-131\">If you have problems with the plugin or questions about its operation, visit the support page at <a class=\"button\" href=\"https:\/\/cocos.codes\/en\/support\/\" title=\"Cocos.codes\/support\">cocos.codes\/support<\/a>.<\/div><\/div>","protected":false},"excerpt":{"rendered":"Documentation Word Press OLX IntegrationComplete documentation for the plugin that enables Woo Commerce to integrate with the OLX platform (cc_wordpress_olx_integration). Table of Contents Introduction Installation License activation Main dashboard Integration with products Ad list managementSettings","protected":false},"author":1,"featured_media":3805,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"powered_cache_disable_cache":false,"powered_cache_disable_css_optimization":false,"powered_cache_disable_js_optimization":false,"footnotes":""},"categories":[196],"tags":[197,235,234,144],"class_list":["post-3778","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dokumentacje","tag-dokumentacja","tag-integracja","tag-olx","tag-wordpress"],"_links":{"self":[{"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/posts\/3778","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/comments?post=3778"}],"version-history":[{"count":0,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/posts\/3778\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/media\/3805"}],"wp:attachment":[{"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/media?parent=3778"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/categories?post=3778"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cocos.codes\/en\/wp-json\/wp\/v2\/tags?post=3778"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}