Feed2WooAI
Plugin 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.

Stack principal
Provocarea
Provocarea a fost sincronizarea repetabilă a unui catalog extern cu WooCommerce fără a crea duplicate, păstrând stocul, prețurile, imaginile, categoriile și metadatele coerente, apoi adăugarea unei etape de rescriere AI care să poată rula incremental fără a transforma o singură cerere web într-un proces lung și fragil.
Soluția
Soluția implementează un plugin WooCommerce cu reconciliere pe SKU, procesare în batch-uri și stare persistentă în WordPress Options API. Interfața admin pornește importurile și urmărește progresul prin AJAX, importatorul actualizează sau creează produse simple și atașează media/categorii, iar un modul OpenAI separat rescrie titlul și descrierea produselor marcate ca nerevizuite. Endpointurile REST și scripturile cron permit automatizare server-side, iar loggerul propriu oferă trasabilitate pentru import, media și apelurile AI.
Complexitate notabilă
Feed2WooAI este un plugin WordPress construit pentru administrarea unui catalog WooCommerce alimentat din feed-uri externe. Suprafața principală este un panou din WordPress Admin în care administratorul poate adăuga sau elimina URL-uri de feed, porni importul pentru un feed, urmări progresul, căuta produsele importate după ID sau SKU și vedea dacă un produs a fost deja rescris cu AI. Separat există pagini pentru configurarea OpenAI și pentru consultarea logurilor operaționale.
Importatorul curent consumă feed-uri JSON și procesează catalogul în batch-uri. Pentru fiecare intrare validă, SKU-ul este cheia de reconciliere cu WooCommerce: un SKU existent este actualizat în loc să fie duplicat, iar un SKU nou creează un WC_Product_Simple publicat. Sunt sincronizate prețul recomandat, stocul, statusul de stoc, categoria, imaginea principală, galeria și câmpurile suplimentare din feed, acestea din urmă fiind persistate ca meta date cu prefix propriu. Categoriile WooCommerce sunt create la nevoie, iar imaginea categoriei poate fi adusă din storage-ul furnizorului atunci când feed-ul include un imageId.
Procesarea este controlată prin cozi persistate în WordPress Options API. Coada de import reține feed-ul curent, offsetul, numărul de produse noi, totalul și starea de finalizare, iar interfața AJAX cere succesiv câte un batch și actualizează bara de progres. Importul folosește și un transient de lock pentru a evita două batch-uri simultane. Acest mecanism nu este o coadă distribuită și are limite importante: intrările fără SKU nu avansează offsetul, un lock poate rămâne activ atunci când coada lipsește, iar inițializarea automată din endpointul REST reutilizează handlerul AJAX care cere nonce, ceea ce face cronul REST dependent de o coadă deja inițializată sau de corectarea acestui flux.
Rescrierea AI este implementată separat prin OpenAI Chat Completions. Administratorul configurează cheia și template-ul de prompt, iar produsul trimite titlul și descrierea curentă către model. Răspunsul este interpretat în format Titlu/Descriere, apoi numele și descrierea WooCommerce sunt actualizate și produsul primește meta flag-ul _f2wai_ai_rewritten. Rescrierea poate fi pornită pentru toate produsele importate care nu au flag-ul sau individual, direct din tabel. Coada AI procesează câte un produs pe iterație, însă nu are lock propriu, retry limitat sau backoff; dacă o rescriere eșuează, offsetul nu avansează și același produs poate bloca progresul.
Imaginile sunt descărcate prin API-urile WordPress Media și atașate produselor. Pentru a reduce costul de procesare, pluginul dezactivează generarea thumbnail-urilor intermediare pe durata sideload-ului și păstrează un cache de URL-uri doar în interiorul batch-ului curent. Codul redenumește fișierele descărcate cu extensia .webp fără conversie efectivă a formatului, deci această zonă trebuie tratată ca o optimizare incompletă, nu ca un pipeline real de conversie media.
Automatizarea este pregătită prin două endpointuri REST — import și AI rewrite — protejate cu o cheie salvată în opțiunile WordPress, plus generatoare de scripturi Bash și PowerShell pentru rulare din cPanel sau alt cron extern. Repository-ul conține scripturi Bash configurate pentru un site real, ceea ce confirmă folosirea practică a fluxului, dar acestea includ o cheie REST în clar și trebuie regenerate cu secretul rotit. Endpointurile folosesc cheia în query string și permission_callback public, astfel că securitatea depinde în prezent de acel secret.
Pluginul nu definește tabele proprii și folosește structurile native WordPress/WooCommerce: opțiuni pentru configurare și cozi, post meta pentru marcajele și câmpurile importate, taxonomia product_cat pentru categorii și Media Library pentru imagini. Administrarea interactivă folosește jQuery și API-ul AJAX WordPress cu nonce și verificare manage_options pentru operațiile principale. Nu există suită de teste, CI/CD sau workflow-uri GitHub în repository-ul analizat, iar istoricul disponibil este un singur commit de backup pentru portofoliu.
Rezultate cheie
- Plugin WordPress/WooCommerce dedicat importului de catalog din feed-uri JSON
- Import incremental în batch-uri cu progres vizibil în WordPress Admin
- Reconciliere după SKU pentru actualizarea produselor existente fără creare intenționată de duplicate
- Crearea produselor WooCommerce simple cu preț, stoc, status de stoc, imagini și categorie
- Import de galerie și imagine principală prin WordPress Media API
- Crearea automată a categoriilor WooCommerce și asocierea unei imagini de categorie atunci când feed-ul furnizează imageId
- Persistarea câmpurilor suplimentare din feed ca meta date cu prefix dedicat
- Listă paginată a produselor importate cu căutare după ID sau SKU și indicator pentru starea rescrierii AI
- Rescriere OpenAI pentru titlu și descriere, disponibilă individual sau în batch
- Prompt OpenAI configurabil din WordPress Admin
- Cozi persistate pentru import și AI rewrite în WordPress Options API
- Lock pe import prin WordPress Transients pentru limitarea execuțiilor concurente
- Endpointuri REST pentru rularea batch-urilor de import și AI rewrite
- Generare de scripturi Bash și PowerShell pentru integrare cu cron extern
- Pagină de loguri operaționale pentru import, imagini și procesarea AI
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.
- 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.
- ZIP Code ManagerPlugin WordPress/WooCommerce care importă în batch un nomenclator de coduri poștale din Excel, normalizează județe, străzi și intervale de numere și poate completa manual codurile poștale de facturare și livrare ale comenzilor.
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.