Bun venit! Acest tutorial îți arată pas cu pas cum să instalezi extensia OpenCart 4.x pentru a genera feed-uri JSON pentru Mixbox. Are interfață modernă cu Bootstrap 5 și este optimizată pentru OpenCart 4!
🚀 Ce poți face cu această extensie?
Generează feed JSON public automat
Integrare completă cu catalogul OpenCart 4
Interfață admin modernă cu Bootstrap 5
Suport pentru toate tipurile de produse
Setări configurabile din panoul admin
Cache integrat pentru performanță
Ierarhie completă de categorii
Suport pentru producători și branduri
Gestionare imagini și galerii
📋 Cerințe minime
Ce ai nevoie pentru a instala extensia:
- OpenCart: Versiunea 4.0 sau mai nouă
- PHP: Versiunea 8.0 sau mai nouă
- MySQL/MariaDB: Versiunea 5.7 sau mai nouă
- Acces FTP/admin: Pentru încărcarea fișierelor
- Permisiuni scriere: Pentru folderul storage/cache
⚙️ Instalare - Pas cu pas
Apasă butonul de mai jos pentru a descărca extensia OpenCart 4.x:
Sfat: Salvează fișierul ZIP într-un loc sigur pe calculatorul tău. O să-l dezarchivezi în pasul următor.
Dezarchivează fișierul ZIP și organizează fișierele conform structurii OpenCart 4:
- Dezarchivează fișierul
mixbox-json-feed-oc4.zip
- Vei vedea următoarea structură:
Structura fișierelor după dezarhivare:
📁 mixbox-json-feed-oc4/
├── 📄 mixbox_json_feed.php
└── 📁 admin/
├── 📄 mixbox_feed.twig
└── 📁 language/
└── 📁 en-gb/
└── 📄 mixbox_feed.php
- Creează folderul pentru extensie:
extension/mixbox_json_feed/
- Copiază fișierul
mixbox_json_feed.php în extension/mixbox_json_feed/
- Creează subfolderele pentru admin:
Cum trebuie să organizezi fișierele:
📁 extension/mixbox_json_feed/
├── 📄 mixbox_json_feed.php
├── 📁 admin/
│ ├── 📁 view/
│ │ └── 📁 template/
│ │ └── 📄 mixbox_feed.twig
│ └── 📁 language/
│ └── 📁 en-gb/
│ └── 📄 mixbox_feed.php
└── 📁 catalog/
└── 📁 controller/
└── 📄 mixbox_feed.php (se va crea automat)
Important! Structura folderelor trebuie să fie exactă. OpenCart 4 folosește o organizare diferită față de versiunile anterioare.
Încarcă folderul organizat în rădăcina site-ului tău OpenCart 4:
- Conectează-te la serverul tău prin FTP/SFTP
- Mergi în rădăcina instalării OpenCart 4
- Încarcă ÎNTREGUL folder
extension/mixbox_json_feed/
- Asigură-te că fișierele au permisiuni corecte (644 pentru fișiere, 755 pentru foldere)
Cum trebuie să arate după încărcare:
📁 Rădăcina OpenCart 4/
├── 📁 extension/
│ └── 📁 mixbox_json_feed/
│ ├── 📄 mixbox_json_feed.php
│ └── 📁 admin/
│ ├── 📁 view/template/
│ │ └── 📄 mixbox_feed.twig
│ └── 📁 language/en-gb/
│ └── 📄 mixbox_feed.php
└── 📄 index.php
Sfat: Dacă folosești cPanel sau alt panou de control, poți încărca fișierul ZIP direct și-l dezarchivezi pe server.
Acum trebuie să activezi extensia în panoul de administrare OpenCart 4:
- Intră în admin-ul OpenCart 4:
https://site-ul-tau.com/admin
- Introdu utilizatorul și parola de admin
- Din meniul din stânga, dă click pe "Extensions"
- Apoi dă click pe "Extensions" (submeniu)
- Din dropdown-ul "Choose Extension Type", selectează "Feeds"
- Caută în listă: "Mixbox JSON Feed"
- Dă click pe butonul verde "Install" din dreptul lui
- Așteaptă să apară mesajul de succes (poate dura câteva secunde)
Important! Dacă nu găsești extensia în listă, înseamnă că fișierele nu au fost încărcate în locația corectă. Verifică pasul anterior.
UI Modern: OpenCart 4 are interfață modernă cu Bootstrap 5 - extensia noastră se integrează perfect cu acest design!
După instalare, trebuie să configurezi extensia:
- În aceeași pagină (Extensions > Extensions > Feeds), găsește "Mixbox JSON Feed"
- Dă click pe butonul albastru "Edit" (iconița creion)
- În pagina de setări moderne, vei vedea următoarele opțiuni:
Setări disponibile:
- Status: Setează la "Enabled" pentru a activa feed-ul
- Product Limit: Numărul maxim de produse în feed (implicit: 100)
- Cache Time: Cât timp să păstreze feed-ul în cache (în secunde)
- Include Out of Stock: Dacă să includă produsele epuizate
Interfață Modernă: Setările folosesc design-ul modern OpenCart 4 cu Bootstrap 5 pentru o experiență mai bună!
Important! Nu uita să dai click pe butonul "Save" (iconița floppy disk) din dreapta sus pentru a salva setările!
Să verificăm dacă totul funcționează:
- După salvare, copiază URL-ul de mai jos și înlocuiește cu site-ul tău:
# URL-ul feed-ului tău va arăta așa:
https://site-ul-tau.com/index.php?route=extension/mixbox_json_feed/catalog/mixbox_feed.feed
- Deschide URL-ul într-un browser nou
- Ar trebui să vezi date JSON cu produsele tale
- Pentru testare cu mai puține produse: adaugă
&limit=5 la URL
# Pentru testare cu doar 5 produse:
https://site-ul-tau.com/index.php?route=extension/mixbox_json_feed/catalog/mixbox_feed.feed&limit=5
Felicitări! Dacă vezi produsele în format JSON, înseamnă că extensia funcționează perfect. Poți acum să folosești acest URL în Mixbox!
📄 Formatul feed-ului JSON
Feed-ul generează același format JSON ca Mixbox, cu produsele indexate după SKU:
{
"SKU-123": {
"sku": "SKU-123",
"name": "Nume Produs OpenCart 4",
"qty": "15",
"price": 29.99,
"sale_price": null,
"last_update_date": "2025-08-08 14:30:00",
"description": "Descrierea completă din OpenCart 4...",
"weight": "1.5",
"images": [
{"src": "https://site-ul-tau.com/image/cache/catalog/produs.jpg"}
],
"permalink": "https://site-ul-tau.com/index.php?route=product/product&path=123",
"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": "Samsung",
"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/index.php?route=extension/mixbox_json_feed/catalog/mixbox_feed.feed&limit=50
# Dezactivare cache (pentru testare):
https://site-ul-tau.com/index.php?route=extension/mixbox_json_feed/catalog/mixbox_feed.feed&cache=0
🛠️ Probleme comune și soluții
Problemă: "Extensia nu apare în listă după încărcarea fișierelor"
Soluție: Verifică că ai respectat structura exactă a folderelor pentru OpenCart 4. Fișierele trebuie să fie în extension/mixbox_json_feed/ cu subfolderele corecte.
Problemă: "Feed-ul arată eroare sau este gol"
Soluție: Verifică că extensia este activată (Status: Enabled) și că ai produse în catalog cu SKU-uri setate. De asemenea, verifică permisiunile folderului storage/.
Problemă: "Nu apar imagini în feed"
Soluție: Asigură-te că produsele au imagini principale setate și că folderul image/ are permisiuni de citire.
⚡ Cache și performanță
Cache-ul ajută performanța:
- Feed-ul se generează mai repede după prima accesare
- Se actualizează automat când schimbi setările
- Cache-ul se salvează în folderul storage/cache/
- OpenCart 4 are sistem de cache îmbunătățit
🎨 Interfață Modernă
OpenCart 4 + Bootstrap 5:
- Interfață complet responsive
- Design modern și intuitiv
- Compatibilitate deplină cu tema OpenCart 4
- Experiență de utilizare îmbunătățită
🔒 Securitate
Feed-ul este sigur:
- Accesibil public (nu necesită autentificare)
- Doar date de citire, nu modifică nimic
- Nu expune informații sensibile
- Sistem de rate limiting integrat
📞 Suport și ajutor
Ai nevoie de ajutor?
Dacă întâmpini probleme sau ai întrebări despre extensia OpenCart 4, poți contacta echipa Mixbox. Tutorialul acesta acoperă cele mai comune scenarii, dar fiecare instalare OpenCart 4 poate avea particularități.
🎉 Gata! Descarcă din nou dacă ai nevoie
Extensia OpenCart 4.x cu UI modern este acum instalată și configurată. Dacă ai nevoie să o instalezi din nou, poți descărca fișierul oricând.
📦 Descarcă din nou mixbox-json-feed-oc4.zip
