Bun venit! Acest tutorial îți va arăta pas cu pas cum să instalezi și să configurezi plugin-ul WordPress pentru generarea feed-urilor JSON pentru Mixbox. Nu ai nevoie de cunoștințe avansate - totul este explicat detaliat și ușor de înțeles!
🚀 Ce poți face cu acest plugin?
Generează feed JSON public automat
Integrare completă cu WooCommerce
Suport pentru toate tipurile de produse
Configurare din panoul admin WordPress
Cache integrat pentru performanță
Suport pentru imagini și galerii
Gestionare automată a categoriilor
Branduri și producători
📋 Cerințe minime
Ce ai nevoie pentru a instala plugin-ul:
- WordPress: Versiunea 5.0 sau mai nouă
- WooCommerce: Versiunea 5.0 sau mai nouă
- PHP: Versiunea 7.4 sau mai nouă
- MySQL: Versiunea 5.6 sau mai nouă
- Acces FTP/admin: Pentru încărcarea fișierelor
⚙️ Instalare - Pas cu pas
Apasă butonul de mai jos pentru a descărca plugin-ul WordPress:
Sfat: Salvează fișierul ZIP într-un loc sigur pe calculatorul tău. O să ai nevoie de el în pasul următor.
Urmează acești pași pentru a încărca plugin-ul:
- Intră în panoul de administrare WordPress (de obicei
site-ul-tau.com/wp-admin)
- Din meniul din stânga, dă click pe "Plugin-uri" > "Adaugă nou"
- În partea de sus, dă click pe butonul "Încarcă plugin"
- Dă click pe "Alege fișier" și selectează fișierul ZIP pe care l-ai descărcat
- Dă click pe "Instalează acum"
- Așteaptă să se termine instalarea (de obicei durează câteva secunde)
Important! Dacă primești eroare de "fișier prea mare", contactează administratorul serverului sau hosting-ului tău pentru a mări limita de încărcare.
După ce s-a instalat, trebuie să activezi plugin-ul:
- După instalare, vei vedea un mesaj verde: "Plugin instalat cu succes"
- Dă click pe link-ul "Activează plugin-ul"
- Sau mergi la "Plugin-uri" > "Plugin-uri instalate"
- Caută "Mixbox JSON Feed Generator" în listă
- Dă click pe "Activează" sub numele plugin-ului
Felicitări! Plugin-ul este acum activ și gata de configurare. Ar trebui să vezi un nou element în meniul din stânga: "Mixbox Feed".
Acum să configurăm plugin-ul pentru nevoile tale:
- Din meniul din stânga, dă click pe "Mixbox Feed"
- Veți vedea pagina de setări cu următoarele opțiuni:
Setări disponibile:
- Limită produse: Numărul maxim de produse în feed (implicit: nelimitat)
- Timp cache: Cât timp să păstreze feed-ul în cache (în secunde)
- Include produse epuizate: Dacă să includă produsele fără stoc
- Include produse private: Dacă să includă produsele private
# Exemplu URL feed după configurare:
https://site-ul-tau.com/mixbox-feed/
Sfat: Pentru început, lasă setările implicite. Poți oricând să te întorci și să le modifici mai târziu.
Să verificăm dacă totul funcționează:
- În pagina de setări "Mixbox Feed", dă click pe butonul "Test Feed"
- Ar trebui să vezi un mesaj de succes și o previzualizare a datelor
- Dacă totul e OK, copiază URL-ul feed-ului
- Deschide URL-ul într-un browser nou pentru a vedea feed-ul JSON
# URL-ul feed-ului tău va arăta așa:
https://site-ul-tau.com/mixbox-feed/
Perfect! Dacă vezi date JSON în browser, înseamnă că totul funcționează. Poți acum să folosești acest URL în Mixbox.
📄 Formatul feed-ului JSON
Feed-ul generează un obiect JSON cu toate produsele indexate după SKU:
{
"SKU12345": {
"sku": "SKU12345",
"name": "Numele produsului",
"qty": "10",
"price": 150.50,
"sale_price": 120.00,
"last_update_date": "2025-08-08 10:30:00",
"description": "Descrierea completă a produsului...",
"weight": "2.5",
"images": [
{"src": "https://site-ul-vostru.com/wp-content/uploads/image1.jpg"},
{"src": "https://site-ul-vostru.com/wp-content/uploads/image2.jpg"}
],
"permalink": "https://site-ul-vostru.com/product/numele-produsului/",
"categories_tree": [
{
"id": 25,
"name": "Categoria Principală",
"parent": 0,
"image": "https://site-ul-vostru.com/category-image.jpg",
"subcategories": [
{
"id": 30,
"name": "Subcategoria",
"parent": 25,
"image": "https://site-ul-vostru.com/subcategory-image.jpg",
"subcategories": []
}
]
}
],
"breadcrumbs": [
"Categoria Principală > Subcategoria"
],
"brands": [
{
"name": "NUMELE BRANDULUI",
"image": "https://site-ul-vostru.com/brand-logo.jpg"
}
]
}
}
🔧 Parametri suplimentari
Poți personaliza feed-ul folosind parametri URL:
# Limitare număr produse:
https://site-ul-tau.com/mixbox-feed/?limit=50
# Dezactivare cache (pentru testare):
https://site-ul-tau.com/mixbox-feed/?cache=0
🛠️ Probleme comune și soluții
Problemă: "Feed-ul nu se încarcă sau arată erori"
Soluție: Verifică dacă WooCommerce este activ și dacă ai produse în catalog.
Problemă: "Nu apar imagini în feed"
Soluție: Asigură-te că produsele au imagini principale setate în WooCommerce.
Problemă: "Cache-ul nu se actualizează"
Soluție: Modifică timpul cache în setări sau adaugă ?cache=0 la URL.
📞 Suport și ajutor
Ai nevoie de ajutor?
Dacă întâmpini probleme sau ai întrebări, poți contacta echipa Mixbox. Tutorialul acesta acoperă cele mai comune scenarii, dar fiecare site poate avea particularități.
