📚 Tutorial Magento 2

Ghid complet de instalare și configurare pentru Magento 2

← Înapoi la Tutoriale

🛒 Tutorial Magento 2 - Generator Feed JSON Mixbox

Ghid complet pentru instalarea extensiei Magento 2 pentru generarea feed-urilor JSON compatibile cu Mixbox

Bun venit! Acest tutorial îți arată pas cu pas cum să instalezi extensia Magento 2 pentru a genera feed-uri JSON pentru Mixbox. Magento 2 are un proces de instalare mai complex, dar te ghidez eu prin fiecare pas!

🚀 Ce poți face cu această extensie?

Generează feed JSON public automat
Integrare completă cu catalogul Magento 2
Suport pentru toate tipurile de produse
Configurare din panoul admin Magento
Cache integrat pentru performanță
Ierarhie completă de categorii
Suport pentru imagini și galerii
Gestionare automată a producătorilor

📋 Cerințe minime

Ce ai nevoie pentru a instala extensia:

  • Magento: Versiunea 2.3 sau mai nouă
  • PHP: Versiunea 7.3 sau mai nouă
  • Composer: Pentru managementul dependențelor
  • Acces SSH/FTP: Pentru încărcarea fișierelor
  • Acces terminal: Pentru rularea comenzilor CLI
  • Permisiuni scriere: Pentru folderele var/ și generated/

⚙️ Instalare - Pas cu pas

📥 Descarcă extensia

Apasă butonul de mai jos pentru a descărca extensia Magento 2:

⬇️ Descarcă Extensie Magento 2

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

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

Dezarchivează fișierul ZIP și pregătește structura pentru Magento:

  1. Dezarchivează fișierul Mixbox_JsonFeed.zip
  2. Vei vedea folderul Mixbox_JsonFeed cu toate fișierele extensiei
  3. Păstrează această structură - nu modifica nimic înăuntru

Structura extensiei după dezarhivare:

📁 Mixbox_JsonFeed/
├── 📁 Controller/
│   └── 📁 Feed/
├── 📁 etc/
│   ├── 📁 acl/
│   ├── 📁 adminhtml/
│   ├── 📁 frontend/
│   └── 📄 module.xml
├── 📄 registration.php
└── 📄 README.md
                    
Important! Nu modifica structura fișierelor din extensie. Magento 2 are reguli stricte pentru organizarea modulelor.
📤 Încarcă fișierele pe server

Încarcă folderul extensiei în structura Magento 2:

  1. Conectează-te la serverul tău prin FTP/SFTP sau SSH
  2. Mergi în rădăcina instalării Magento 2
  3. Creează folderul pentru extensie: app/code/Mixbox/
  4. Încarcă ÎNTREGUL folder Mixbox_JsonFeed în app/code/Mixbox/

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

📁 Rădăcina Magento 2/
├── 📁 app/
│   └── 📁 code/
│       └── 📁 Mixbox/
│           └── 📁 JsonFeed/
│               ├── 📁 Controller/
│               ├── 📁 etc/
│               ├── 📄 registration.php
│               └── 📄 README.md
└── 📄 index.php
                    
Super important! Calea exactă trebuie să fie app/code/Mixbox/JsonFeed/. Dacă pui fișierele în altă locație, extensia NU va funcționa!
Verificare: După încărcare, ar trebui să ai fișierul app/code/Mixbox/JsonFeed/registration.php pe server.
💻 Activează extensia prin CLI

Acum trebuie să activezi extensia folosind comenzile Magento CLI:

  1. Conectează-te la server prin SSH (sau deschide terminal dacă ai acces local)
  2. Mergi în rădăcina Magento 2: cd /calea/catre/magento2
  3. Rulează următoarele comenzi una câte una:

Comenzi de rulat în terminal:

# 1. Activează modulul
php bin/magento module:enable Mixbox_JsonFeed

# 2. Actualizează baza de date
php bin/magento setup:upgrade

# 3. Compilează dependency injection
php bin/magento setup:di:compile

# 4. Curăță cache-ul
php bin/magento cache:clean

# 5. (Opțional) Curăță cache complet
php bin/magento cache:flush
                    
Sfat: Dacă ai erori la vreuna din comenzi, nu continua cu următoarea. Rezolvă eroarea mai întâi și apoi reia de la început.
Important! Aceste comenzi pot dura câteva minute, mai ales setup:di:compile. Nu întrerupe procesul!
⚙️ Configurează extensia

După activare, trebuie să configurezi extensia în admin-ul Magento:

  1. Intră în admin-ul Magento: https://site-ul-tau.com/admin
  2. Din meniul din stânga, dă click pe "Stores"
  3. Apoi dă click pe "Configuration"
  4. Din panoul din stânga, dă click pe "MIXBOX" (dacă nu vezi, derulează jos)
  5. Dă click pe "Mixbox JSON Feed"

Setări disponibile:

  • Enable Feed: Setează la "Yes" pentru a activa feed-ul
  • Product Limit: Numărul maxim de produse (implicit: 100)
  • Cache Time: Durata cache-ului în secunde
Important! După ce faci modificări, dă click pe butonul "Save Config" din dreapta sus. Magento va arăta un mesaj verde de succes.
Notă: Dacă nu vezi secțiunea "MIXBOX" în Configuration, înseamnă că extensia nu s-a activat corect. Verifică pașii anteriori.
🧪 Testează feed-ul

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

  1. După salvare configurației, copiază URL-ul de mai jos:
# URL-ul feed-ului tău va arăta așa:
https://site-ul-tau.com/mixbox-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/mixbox-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 Magento",
    "qty": "15",
    "price": 29.99,
    "sale_price": null,
    "last_update_date": "2025-08-08 14:30:00",
    "description": "Descrierea completă din Magento...",
    "weight": "1.5",
    "images": [
      {"src": "https://site-ul-tau.com/media/catalog/product/image.jpg"}
    ],
    "permalink": "https://site-ul-tau.com/nume-produs.html",
    "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/mixbox-feed/?limit=50

# Dezactivare cache (pentru testare):
https://site-ul-tau.com/mixbox-feed/?cache=0

🛠️ Probleme comune și soluții

Problemă: "Comanda php bin/magento dă eroare 'Command not found'"
Soluție: Asigură-te că ești în rădăcina Magento 2 și că PHP este instalat. Folosește calea completă către PHP dacă e necesar.
Problemă: "Nu văd secțiunea MIXBOX în Configuration"
Soluție: Extensia nu s-a activat corect. Verifică că fișierele sunt în app/code/Mixbox/JsonFeed/ și reia comenzile CLI.
Problemă: "Feed-ul arată eroare 404"
Soluție: Verifică că extensia este activată și că ai curățat cache-ul. Poți încerca să regenerezi URL-urile: php bin/magento cache:clean
Problemă: "Nu apar produse în feed"
Soluție: Verifică că produsele sunt vizibile în catalog și au SKU-uri setate. De asemenea, verifică setările de limită.

💻 Comenzi CLI esențiale

Comenzi utile pentru întreținere:

# Curăță cache-ul
php bin/magento cache:clean

# Curăță cache complet
php bin/magento cache:flush

# Reindexează catalogul
php bin/magento indexer:reindex

# Verifică statusul modulului
php bin/magento module:status Mixbox_JsonFeed

# Dezactivează modulul (dacă e nevoie)
php bin/magento module:disable Mixbox_JsonFeed
        

⚡ Optimizare performanță

Cache-ul ajută performanța:
- Feed-ul se generează mai repede după prima accesare
- Cache-ul se salvează în folderul var/cache/
- Poți controla durata cache-ului din configurație
- Pentru modificări imediate, poți dezactiva cache-ul temporar

🔒 Securitate

Feed-ul este sigur:
- Accesibil public (nu necesită autentificare)
- Doar date de citire, nu modifică nimic
- Nu expune informații sensibile
- Respectă permisiunile Magento pentru produse

📞 Suport și ajutor

Ai nevoie de ajutor?
Dacă întâmpini probleme sau ai întrebări despre extensia Magento 2, poți contacta echipa Mixbox. Procesul de instalare Magento 2 este mai complex decât alte platforme, dar tutorialul acesta acoperă toate scenariile comune.

🎉 Gata! Descarcă din nou dacă ai nevoie

Extensia Magento 2 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_JsonFeed.zip