Bun venit! Acest tutorial îți va arăta pas cu pas cum să instalezi și să configurezi modulul PrestaShop 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 modul?
Generează feed JSON public automat
Integrare completă cu PrestaShop
Suport pentru toate tipurile de produse
Configurare din panoul admin PrestaShop
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 modulul:
- PrestaShop: Versiunea 1.7.0 sau mai nouă
- PHP: Versiunea 7.1 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 modulul PrestaShop:
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 modulul:
- Intră în panoul de administrare PrestaShop (de obicei
site-ul-tau.com/admin)
- Din meniul din stânga, dă click pe "Module" > "Module Manager"
- În partea de sus, dă click pe butonul "Încarcă un modul"
- Dă click pe "Selectează fișier" și selectează fișierul ZIP pe care l-ai descărcat
- Dă click pe "Încarcă modulul"
- Așteaptă să se termine încărcarea (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 încărcat, trebuie să instalezi și să activezi modulul:
- După încărcare, vei vedea modulul în lista de module
- Caută "Mixbox JSON Feed Generator" în listă
- Dă click pe butonul "Instalează"
- Așteaptă să se termine instalarea
- După instalare, dă click pe "Configurează" pentru a intra în setări
Felicitări! Modulul este acum instalat și activ. Ar trebui să vezi un nou element în meniul "Module" sau în bara laterală.
Acum să configurăm modulul pentru nevoile tale:
- În pagina de configurare a modulului, vei vedea 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 inactive: Include produsele dezactivate în feed
- Include produse fără stoc: Include produsele fără stoc în feed
# Exemplu URL feed după configurare:
https://site-ul-tau.com/modules/mixboxfeed/feed.php
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 configurare, 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/modules/mixboxfeed/feed.php
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ă referință:
{
"REF12345": {
"reference": "REF12345",
"name": "Numele produsului",
"quantity": "10",
"price": 150.50,
"price_reduced": 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/img/p/1/2/3/4/12345.jpg"},
{"src": "https://site-ul-vostru.com/img/p/1/2/3/4/12345-1.jpg"}
],
"link": "https://site-ul-vostru.com/ro/produse/numele-produsului.html",
"categories_tree": [
{
"id": 25,
"name": "Categoria Principală",
"parent": 0,
"image": "https://site-ul-vostru.com/img/c/25.jpg",
"subcategories": [
{
"id": 26,
"name": "Subcategorie",
"parent": 25,
"image": null,
"subcategories": []
}
]
}
],
"breadcrumbs": [
"Categoria Principală > Subcategoria"
],
"manufacturer": {
"name": "NUMELE PRODUCATORULUI",
"image": "https://site-ul-vostru.com/img/m/1.jpg"
}
}
}
🔧 Parametri suplimentari
Poți personaliza feed-ul folosind parametri URL:
# Limitare număr produse:
https://site-ul-tau.com/modules/mixboxfeed/feed.php?limit=50
# Dezactivare cache (pentru testare):
https://site-ul-tau.com/modules/mixboxfeed/feed.php?cache=0
# Include produse inactive:
https://site-ul-tau.com/modules/mixboxfeed/feed.php?inactive=1
🛠️ Probleme comune și soluții
Problemă: "Feed-ul nu se încarcă sau arată erori"
Soluție: Verifică dacă modulul 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 PrestaShop.
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.
