OLX Import
Plugin WordPress pentru sincronizarea produselor WooCommerce cu OLX: mapping de categorii și atribute, imagini și locații, autentificare OAuth, creare/actualizare anunțuri și curățarea legăturii la ștergere sau duplicare.

Stack principal
Provocarea
Provocarea a fost păstrarea coerentă a unui produs între WooCommerce și OLX fără operare manuală dublă: categorii și atribute diferite între platforme, locații și contacte specifice agenției, imagini și descrieri comerciale, tokenuri OAuth distincte și necesitatea de a actualiza sau elimina anunțul corect pe tot ciclul de viață al produsului.
Soluția
Soluția folosește hooks WooCommerce/WordPress și post meta ca legătură între produs și anunț. La salvare, datele produsului sunt normalizate și mapate către taxonomia OLX, endpointurile de catalog furnizează categoriile, atributele și locațiile necesare, iar OLX Partner API primește operații POST sau PUT în funcție de existența _advert_id. Debifarea, trash/delete și duplicarea au reguli dedicate pentru dezactivare, ștergere sau resetarea metadatelor.
Complexitate notabilă
OLX Import este o integrare WordPress/WooCommerce construită pentru un client real, cu scopul de a transforma produsul administrat în WooCommerce în sursa operațională pentru anunțul OLX. Fluxul nu importă anunțuri OLX în magazin; direcția demonstrată de cod este WooCommerce → OLX Partner API.
Pe pagina de editare a produsului, administratorul primește un meta box «Import to olx». Bifarea și salvarea produsului pregătesc payload-ul din datele WooCommerce și creează anunțul dacă produsul nu are încă un _advert_id. La salvările ulterioare, același ID este folosit pentru update. Pluginul persistă în post meta ID-ul anunțului, URL-ul OLX și flag-ul _imported_to_olx, iar linkul către anunț este afișat direct în meta box.
Transformarea datelor include titlu, descriere, preț, SKU, imagini, categorii, atribute WooCommerce și metadate client-specific pentru magazin și contact. Codul mapează explicit categoriile de Bijuterii și Electronice către taxonomia OLX, selectează subcategorii pentru telefoane, tablete și foto și traduce atribute obligatorii precum starea produsului sau publicul țintă în codurile așteptate de OLX.
Locația anunțului este construită dintr-un cod de agenție stocat pe produs. Pentru locațiile configurate sunt definite date operaționale precum adresa, programul, numărul de telefon, sectorul și denumirea magazinului. Orașul și sectorul sunt apoi rezolvate prin endpointurile OLX pentru cities și districts, iar payload-ul anunțului include city_id, district_id și coordonatele returnate de API.
Integrarea folosește două tipuri de token: client credentials pentru endpointuri de catalog precum categorii, atribute și locații și authorization code/refresh token pentru operațiile asupra anunțurilor. Tokenurile și configurația sunt păstrate în WordPress Options. Pagina proprie «OLX Import» permite configurarea credențialelor și afișează starea conexiunii.
Lifecycle-ul produsului este sincronizat și în sensul eliminării. Debifarea importului, mutarea produsului în coș sau ștergerea lui încearcă mai întâi dezactivarea anunțului atunci când starea OLX o cere, apoi DELETE și curățarea metadatelor locale. La duplicarea unui produs WooCommerce, _advert_id și _advert_url sunt eliminate și flag-ul de import este resetat, astfel încât copia să nu reutilizeze intenționat legătura anunțului original.
Interfața de administrare adaugă în lista de produse o coloană «Imported to OLX», sortare și filtru Da/Nu. Erorile OLX sunt păstrate temporar prin WordPress Transients și prezentate ca admin notices după redirect. Nu există suită de teste, CI/CD, coadă de joburi, batching sau cache pentru metadatele OLX în snapshotul analizat.
Baza pluginului păstrează mult din WordPress Plugin Boilerplate: loader, i18n, clase public/admin și fișiere demonstrative. Personalizarea substanțială se află în clasa de admin, unde sunt implementate integrarea OLX, mapping-ul de business și sincronizarea cu WooCommerce. Repository-ul conține un singur commit de backup, deci istoricul nu permite separarea cronologică a fiecărei contribuții.
Există și un mecanism de refresh zilnic bazat pe WP-Cron în cod, însă plasarea registration hook-urilor în fișierul clasei admin și reinstanțierea clasei în callback fac funcționarea lui neconfirmată și fragilă. În plus, verificarea conexiunii este executată în constructorul admin și poate produce apeluri externe sincrone la încărcarea pluginului, ceea ce este o zonă clară de optimizare înainte de o versiune hardenată.
Rezultate cheie
- Plugin WordPress/WooCommerce dedicat publicării produselor către OLX Partner API
- Creare și actualizare a anunțului pe baza existenței ID-ului OLX persistat în post meta
- Dezactivare și ștergere a anunțului când produsul este debifat, trimis în trash sau șters
- Resetarea metadatelor OLX la duplicarea unui produs WooCommerce
- Mapping explicit WooCommerce → OLX pentru categoriile Bijuterii și Electronice
- Mapping de subcategorii pentru telefoane, tablete și foto și de atribute obligatorii OLX
- Transmiterea titlului, descrierii, prețului, imaginilor, contactului și locației către anunț
- Rezolvarea orașului și sectorului prin endpointurile OLX pentru locații
- OAuth 2.0 cu client credentials, authorization code și refresh token pentru fluxurile API
- Coloană, sortare și filtru OLX în lista de produse din WordPress Admin
- Meta box pe produs cu toggle de sincronizare și link către anunțul OLX
- Afișarea erorilor de validare/API prin transient și admin notice
Proiecte asemănătoare
- Farmadati ImportModul WordPress care preia seturi de date Farmadati prin SOAP, normalizează schema XML și îmbogățește produse WooCommerce cu prețuri, descrieri, producător, metadate farmaceutice și imagini.
- Feed2WooAIPlugin WordPress pentru importul în batch al produselor din feed-uri JSON în WooCommerce, actualizare după SKU, imagini și categorii, rescriere OpenAI, progres în admin și automatizare prin endpointuri REST și scripturi cron.
- Page Content ExtractorTool operațional WordPress pentru găsirea și actualizarea în masă a paginilor localizate, cu suport Elementor/Gutenberg/Classic, rescriere prin Gemini și generare de imagini prin Vertex AI Imagen.
Vrei ceva similar?
Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.