📚 Tutorial OpenCart 3

Ghid complet de instalare și configurare pentru OpenCart 3

← Înapoi la Tutoriale

🛒 Tutorial OpenCart 3.x - Generator Feed JSON Mixbox

Ghid complet pentru instalarea extensiei OpenCart 3.x pentru generarea feed-urilor JSON compatibile cu Mixbox

Bun venit! Acest tutorial îți arată pas cu pas cum să instalezi extensia OpenCart 3.x pentru a genera feed-uri JSON pentru Mixbox. Totul este explicat detaliat și clar - nu ai nevoie de cunoștințe avansate!

🚀 Ce poți face cu această extensie?

Generează feed JSON public automat
Integrare completă cu catalogul OpenCart
Suport pentru toate tipurile de produse
Interfață admin simplă pentru configurare
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 3.0 sau mai nouă
  • PHP: Versiunea 7.0 sau mai nouă
  • MySQL: Versiunea 5.6 sau mai nouă
  • Acces FTP/admin: Pentru încărcarea fișierelor
  • Permisiuni scriere: Pentru folderul cache

⚙️ Instalare - Pas cu pas

📥 Descarcă extensia

Apasă butonul de mai jos pentru a descărca extensia OpenCart 3.x:

⬇️ Descarcă Extensie OpenCart 3.x

Fișierul ZIP conține tot ce ai nevoie pentru instalare

📦 Descarcă mixbox-json-feed-oc3.zip
Sfat: Salvează fișierul ZIP într-un loc sigur pe calculatorul tău. O să-l dezarchivezi în pasul următor.
📂 Dezarchivează fișierele

Dezarchivează fișierul ZIP descărcat:

  1. Găsește fișierul mixbox-json-feed-oc3.zip pe calculatorul tău
  2. Dă click dreapta și selectează "Extract All" sau "Dezarhivează aici"
  3. Ar trebui să vezi un folder numit upload
  4. În folderul upload vei găsi alte două foldere: admin și catalog

Structura fișierelor după dezarhivare:

📁 mixbox-json-feed-oc3/
└── 📁 upload/
    ├── 📁 admin/
    │   ├── 📁 controller/
    │   └── 📁 view/
    └── 📁 catalog/
        └── 📁 controller/
                    
Important! Ai nevoie doar de conținutul folderului upload. Restul fișierelor sunt pentru tutorial.
📤 Încarcă fișierele pe server

Încarcă conținutul folderului upload în rădăcina site-ului tău OpenCart:

  1. Conectează-te la serverul tău prin FTP (FileZilla, WinSCP, etc.)
  2. Mergi în rădăcina instalării OpenCart (de obicei folderul principal)
  3. Încarcă ÎNTREG conținutul folderului upload în rădăcină
  4. Nu încărca folderul upload în sine, doar conținutul lui!
  5. Așteaptă să se termine încărcarea (poate dura câteva minute)
Super important! Dacă încarci folderul upload în loc de conținutul lui, extensia NU va funcționa! Trebuie să fie direct în rădăcina OpenCart.

Cum trebuie să arate după încărcare:

📁 Rădăcina OpenCart/
├── 📁 admin/ (există deja)
│   └── 📁 controller/ (există deja)
│       └── 📄 mixbox_json_feed.php ← NOU (din extensie)
├── 📁 catalog/ (există deja)
│   └── 📁 controller/ (există deja)
│       └── 📄 mixbox_json_feed.php ← NOU (din extensie)
└── 📄 index.php (există deja)
                    
🔧 Instalează extensia în admin

Acum trebuie să activezi extensia în panoul de administrare:

  1. Intră în admin-ul OpenCart: https://site-ul-tau.com/admin
  2. Introdu utilizatorul și parola de admin
  3. Din meniul din stânga, dă click pe "Extensions"
  4. Apoi dă click pe "Extensions" (submeniu)
  5. Din dropdown-ul "Choose Extension Type", selectează "Feeds"
  6. Caută în listă: "Mixbox JSON Feed"
  7. Dă click pe butonul verde "Install" din dreptul lui
  8. Așteaptă să apară mesajul de succes
Sfat: Dacă nu găsești extensia în listă, înseamnă că fișierele nu au fost încărcate corect. Verifică pasul anterior.
⚙️ Configurează setările

După instalare, trebuie să configurezi extensia:

  1. În aceeași pagină (Extensions > Extensions > Feeds), găsește "Mixbox JSON Feed"
  2. Dă click pe butonul albastru "Edit" din dreptul lui
  3. În pagina de setări, 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)
Recomandare: Pentru început, lasă setările implicite. Poți oricând să te întorci și să le modifici mai târziu.
Important! Nu uita să dai click pe butonul "Save" (floppy disk) din dreapta sus pentru a salva setările!
🧪 Testează feed-ul

Să verificăm dacă totul funcționează:

  1. 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/feed/mixbox_json_feed
  1. Deschide URL-ul într-un browser nou
  2. Ar trebui să vezi date JSON cu produsele tale
  3. 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/feed/mixbox_json_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",
    "qty": "15",
    "price": 29.99,
    "sale_price": null,
    "last_update_date": "2025-08-08 14:30:00",
    "description": "Descrierea completă din OpenCart...",
    "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&product_id=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/feed/mixbox_json_feed&limit=50

# Dezactivare cache (pentru testare):
https://site-ul-tau.com/index.php?route=extension/feed/mixbox_json_feed&cache=0

🛠️ Probleme comune și soluții

Problemă: "Extensia nu apare în listă după încărcarea fișierelor"
Soluție: Verifică că ai încărcat conținutul folderului upload, nu folderul în sine. Fișierele trebuie să fie direct în rădăcina OpenCart.
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.
Problemă: "Nu apar imagini în feed"
Soluție: Asigură-te că produsele au imagini principale setate în OpenCart ș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
- Poți șterge cache-ul manual dacă e nevoie
- Cache-ul se salvează în folderul system/cache/

🔒 Securitate

Feed-ul este sigur:
- Accesibil public (nu necesită autentificare)
- Doar date de citire, nu modifică nimic
- Nu expune informații sensibile
- Cache-ul previne supraîncărcarea serverului

📞 Suport și ajutor

Ai nevoie de ajutor?
Dacă întâmpini probleme sau ai întrebări despre extensia OpenCart, poți contacta echipa Mixbox. Tutorialul acesta acoperă cele mai comune scenarii, dar fiecare instalare OpenCart poate avea particularități.

🎉 Gata! Descarcă din nou dacă ai nevoie

Extensia 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-oc3.zip