🛍️ Tutorial Shopify - Generator Feed JSON Mixbox

Ghid complet pentru conectarea magazinului Shopify la Mixbox prin feed-uri JSON

        Bun venit! Acest tutorial îți arată cum să conectezi magazinul tău Shopify la Mixbox folosind feed-uri JSON. Ai două opțiuni: un script PHP simplu sau o aplicație Node.js completă. O să explic fiecare pas detaliat și ușor de înțeles!
    

🔧 Ce opțiuni ai?

Script PHP Simplu - Pentru Începători

Când să alegi asta: Dacă vrei cea mai ușoară instalare și nu ai experiență cu Node.js

Avantaje: Instalezi într-un singur fișier, nu ai nevoie de server special

Dezavantaje: Mai puține funcții avansate

Aplicație Node.js Completă - Pentru Profesioniști

Când să alegi asta: Dacă vrei toate funcțiile și performanță maximă

Avantaje: Mai rapidă, mai multe funcții, mai stabilă

Dezavantaje: Necesită instalare mai complexă

🚀 Ce poți face cu integrarea Shopify?

Conectare directă la API-ul Shopify

Suport pentru toate produsele și variante

Imagini și descrieri complete

Categorii și tag-uri din Shopify

Prețuri regular și de vânzare

Stoc și disponibilitate

Cache pentru viteză

Mod debug pentru testare

📋 Cerințe pentru fiecare opțiune

📄 Pentru Script PHP:

PHP: Versiunea 7.0 sau mai nouă
cURL: Extensia cURL activată pe server
Hosting: Orice hosting cu PHP (nu trebuie să fie special)
Acces FTP: Pentru încărcarea fișierului

⚙️ Instalare - Script PHP (Opțiunea Simplă)

📥 Descarcă script-ul PHP

Apasă butonul de mai jos pentru a descărca script-ul PHP simplu:

⬇️ Descarcă Script PHP

Un singur fișier PHP - super simplu!

📄 Descarcă shopify-mixbox-feed.php

                        Sfat: Salvează fișierul pe calculatorul tău. O să-l încarci pe server în pasul următor.
                    

📤 Încarcă pe server

Încarcă fișierul pe serverul tău web:

Conectează-te la serverul tău prin FTP (FileZilla, WinSCP, etc.)
Mergi în folderul public al site-ului tău (de obicei public_html sau www)
Încarcă fișierul shopify-mixbox-feed.php
Asigură-te că are permisiuni de citire (chmod 644)

Important! Dacă nu ai acces FTP, poți încărca fișierul prin panoul de control al hosting-ului tău (cPanel, Plesk, etc.) în secțiunea "File Manager".

🔑 Configurează API-ul Shopify

Acum trebuie să configurezi accesul la API-ul Shopify:

Pasul 1: Creează aplicație privată în Shopify

Intră în admin-ul Shopify: https://magazinul-tau.myshopify.com/admin
Din meniul din stânga, dă click pe "Apps"
Dă click pe "Develop apps" (dacă nu vezi, activează modul developer)
Dă click pe "Create an app"
Pune un nume: "Mixbox Feed Generator"
Dă click pe "Configure Admin API scopes"
Bifează "read_products" (citire produse)
Dă click pe "Save"
Dă click pe "Install app"

Pasul 2: Copiază credențialele

După instalare, copiază:

API key (cheia API)
API secret key (secretul API)
Admin API access token (token-ul de acces)

⚙️ Configurează script-ul

Editează fișierul PHP pentru a adăuga credențialele:

Deschide fișierul shopify-mixbox-feed.php cu un editor de text
Caută secțiunea $config (începe cu $config = [)
Completează următoarele:

$config = [
    'shopify_store_url' => 'magazinul-tau.myshopify.com',
    'shopify_api_key' => 'cheia-ta-api-aici',
    'shopify_password' => 'secretul-api-ului-tau',
    'shopify_access_token' => 'token-ul-tau-de-acces',
    'limit' => 100,
    'cache_time' => 1800,
    'debug' => false,
    'include_metafields' => false,
    'include_variants' => true
];

                        Important! Înlocuiește valorile cu ale tale. Dacă nu știi care e care, uită-te în Shopify admin la "API credentials".
                    

🧪 Testează feed-ul

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

Salvează fișierul modificat pe server
Deschide în browser: https://site-ul-tau.com/shopify-mixbox-feed.php
Ar trebui să vezi date JSON cu produsele tale
Pentru testare, adaugă ?debug=1 la URL

# URL-ul feed-ului tău:
https://site-ul-tau.com/shopify-mixbox-feed.php

# Pentru testare cu debug:
https://site-ul-tau.com/shopify-mixbox-feed.php?debug=1

                        Felicitări! Dacă vezi produsele în format JSON, înseamnă că totul funcționează. Poți folosi acest URL în Mixbox!
                    

⚙️ Instalare - Aplicație Node.js (Opțiunea Avansată)

📥 Descarcă aplicația Node.js

Apasă butonul de mai jos pentru a descărca aplicația completă:

⬇️ Descarcă Aplicație Node.js

Aplicație completă cu toate funcțiile!

📦 Descarcă shopify-app.zip

📂 Dezarchivează și instalează

Pe serverul tău (sau computer local pentru testare):

Dezarchivează fișierul ZIP descărcat
Deschide terminal/command prompt în folderul dezarchivat
Instalează dependențele: npm install
Așteaptă să se termine instalarea (poate dura câteva minute)

Notă: Ai nevoie de Node.js instalat pe server. Dacă nu ai, descarcă de pe nodejs.org

🔧 Configurează variabilele

Creează fișierul de configurare:

În folderul aplicației, copiază .env.example în .env
Deschide .env cu un editor de text
Completează cu datele tale din Shopify:

SHOPIFY_API_KEY=cheia-ta-api-shopify
SHOPIFY_API_SECRET=secretul-api-ului-tau
SHOPIFY_STORE_URL=magazinul-tau.myshopify.com
HOST=localhost
PORT=3000

▶️ Pornește aplicația

În terminal, rulează:

npm start

Ar trebui să vezi mesajul: "Server running on port 3000"

                        Sfat: Pentru producție, poți folosi npm run build și apoi porni cu PM2 sau Docker.
                    

🧪 Testează feed-ul

Verifică dacă aplicația funcționează:

# Verificare sănătate:
http://localhost:3000/health

# Feed produse:
http://localhost:3000/feed

# Info aplicație:
http://localhost:3000/

📄 Formatul feed-ului JSON

Feed-ul generează același format JSON ca Mixbox:

{
  "SKU123": {
    "sku": "SKU123",
    "name": "Nume Produs Shopify",
    "qty": "10",
    "price": 150.50,
    "sale_price": 120.00,
    "last_update_date": "2025-08-08 10:30:00",
    "description": "Descrierea completă din Shopify...",
    "weight": "2.5",
    "images": [
      {"src": "https://cdn.shopify.com/image1.jpg"}
    ],
    "permalink": "https://magazinul-tau.myshopify.com/products/nume-produs",
    "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": "Vendor din Shopify",
        "image": "https://site-ul-vostru.com/brand-logo.jpg"
      }
    ]
  }
}

🛠️ Probleme comune și soluții

Problemă: "API credentials invalid"
Soluție: Verifică că ai copiat corect cheia API și secretul din Shopify admin.

Problemă: "Rate limit exceeded"
Soluție: Shopify permite doar 40 de cereri pe 40 secunde. Adaugă delay între cereri.

Problemă: "Nu apar produse în feed"
Soluție: Verifică că produsele au SKU-uri setate în Shopify.

🔒 Sfaturi de securitate

        Important!

        - Nu publica niciodată credențialele API pe GitHub

        - Folosește HTTPS pentru producție

        - Restrânge accesul la feed doar pentru Mixbox

        - Actualizează periodic token-urile API

📞 Suport și ajutor

Ai nevoie de ajutor?
Dacă întâmpini probleme, verifică mai întâi documentația oficială Shopify: shopify.dev/docs/api
Pentru probleme cu Mixbox, contactează echipa noastră de suport.

🎉 Alege opțiunea potrivită pentru tine

Descarcă versiunea care ți se potrivește cel mai bine:

📄 Script PHP Simplu 📦 Aplicație Node.js Completă

📚 Tutorial Shopify

🛍️ Tutorial Shopify - Generator Feed JSON Mixbox

🔧 Ce opțiuni ai?

Script PHP Simplu - Pentru Începători

Aplicație Node.js Completă - Pentru Profesioniști

🚀 Ce poți face cu integrarea Shopify?

📋 Cerințe pentru fiecare opțiune

📄 Pentru Script PHP:

🚀 Pentru Aplicație Node.js:

⚙️ Instalare - Script PHP (Opțiunea Simplă)

⬇️ Descarcă Script PHP

Pasul 1: Creează aplicație privată în Shopify

Pasul 2: Copiază credențialele

⚙️ Instalare - Aplicație Node.js (Opțiunea Avansată)

⬇️ Descarcă Aplicație Node.js

📄 Formatul feed-ului JSON

🛠️ Probleme comune și soluții

🔒 Sfaturi de securitate

📞 Suport și ajutor

🎉 Alege opțiunea potrivită pentru tine

📚 Tutorial Shopify

🛍️ Tutorial Shopify - Generator Feed JSON Mixbox

🔧 Ce opțiuni ai?

Script PHP Simplu - Pentru Începători

Aplicație Node.js Completă - Pentru Profesioniști

🚀 Ce poți face cu integrarea Shopify?

📋 Cerințe pentru fiecare opțiune

📄 Pentru Script PHP:

🚀 Pentru Aplicație Node.js:

⚙️ Instalare - Script PHP (Opțiunea Simplă)

⬇️ Descarcă Script PHP

Pasul 1: Creează aplicație privată în Shopify

Pasul 2: Copiază credențialele

⚙️ Instalare - Aplicație Node.js (Opțiunea Avansată)

⬇️ Descarcă Aplicație Node.js

📄 Formatul feed-ului JSON

🛠️ Probleme comune și soluții

🔒 Sfaturi de securitate

📞 Suport și ajutor

🎉 Alege opțiunea potrivită pentru tine

🚀 Alte Tutoriale Disponibile

📝 WordPress

🛒 Magento 2

🛒 OpenCart 4

🛒 OpenCart 3

🛒 PrestaShop

🇷🇴 GOMAG

🔧 Laravel

🚀 Node.js

🎸 Django