Bun venit! Acest tutorial îți arată cum să conectezi magazinul tău GOMAG la Mixbox folosind un script PHP simplu. Este cea mai ușoară metodă dintre toate - doar încarcă un fișier și configurează-l!
🚀 Ce poți face cu integrarea GOMAG?
Conectare directă la API-ul GOMAG
Script PHP simplu și rapid
Suport pentru toate produsele din catalog
Cache integrat pentru performanță
Mod debug pentru testare detaliată
Gestionare automată a erorilor
Logare completă pentru depanare
Suport pentru diferite URL-uri API
📋 Cerințe minime
Ce ai nevoie pentru a instala script-ul:
- PHP: Versiunea 7.0 sau mai nouă
- cURL: Extensia cURL activată (recomandată)
- Hosting: Orice hosting cu PHP
- Acces FTP: Pentru încărcarea fișierului
- API GOMAG: Acces la API-ul sau export-urile GOMAG
🔑 Informații despre API-ul GOMAG
URL-uri API disponibile:
- API REST principal:
https://api.gomag.ro/v1/products
- API specific magazin:
https://api.gomag.ro/v1/{id-magazin}/products
- URL-uri de export: Diverse endpoint-uri de export disponibile
Important: Contactează suportul GOMAG pentru a obține cheia API și URL-ul exact pentru magazinul tău.
⚙️ Instalare - Pas cu pas
Apasă butonul de mai jos pentru a descărca script-ul PHP simplu pentru GOMAG:
Sfat: Salvează fișierul pe calculatorul tău. O să-l încarci pe server în pasul următor.
Încarcă fișierul pe serverul tău web:
- Conectează-te la serverul tău prin FTP (FileZilla, WinSCP, etc.)
- Mergi în rădăcina site-ului tău (de obicei
public_html sau www)
- Încarcă fișierul
gomag-mixbox-feed.php
- Asigură-te că are permisiuni de citire și execuție (chmod 644)
Important! Dacă serverul tău are restricții de securitate, poate fi nevoie să ceri administratorului să permită execuția fișierelor PHP în directorul respectiv.
Înainte să configurezi script-ul, ai nevoie de informații de la GOMAG:
Pasul 1: Contactează suportul GOMAG
- Contactează echipa de suport GOMAG
- Cere acces la API-ul pentru produse
- Specifică că ai nevoie de date pentru integrare cu Mixbox
Ce vei primi de la GOMAG:
- URL API: Endpoint-ul exact pentru magazinul tău
- Cheie API: Token-ul de autentificare
- Informații suplimentare: Parametri specifici pentru integrare
Notă: Fiecare magazin GOMAG are URL-uri și chei API diferite. Nu folosi exemplele din tutorial - trebuie să obții datele reale de la GOMAG.
Editează fișierul PHP pentru a adăuga credențialele GOMAG:
- Deschide fișierul
gomag-mixbox-feed.php cu un editor de text
- Caută secțiunea
$config (începe cu $config = [)
- Completează cu datele primite de la GOMAG:
$config = [
'gomag_api_url' => 'https://api.gomag.ro/v1/products', // URL-ul tău real de la GOMAG
'gomag_api_key' => 'cheia-ta-api-gomag-aici', // Cheia API primită de la GOMAG
'limit' => isset($_GET['limit']) ? intval($_GET['limit']) : 100,
'cache_time' => 1800,
'debug' => isset($_GET['debug']) && $_GET['debug'] == '1'
];
Important! Înlocuiește valorile cu cele reale primite de la GOMAG. Dacă nu știi care e care, întreabă echipa de suport GOMAG.
Pro tip: Dacă GOMAG îți dă mai multe URL-uri API, poți testa fiecare adăugând ?debug=1 la sfârșitul URL-ului feed-ului.
Să verificăm dacă totul funcționează:
- Salvează fișierul modificat pe server
- Deschide în browser:
https://site-ul-tau.com/gomag-mixbox-feed.php
- Ar trebui să vezi date JSON cu produsele tale
- Pentru testare detaliată, adaugă
?debug=1 la URL
# URL-ul feed-ului tău:
https://site-ul-tau.com/gomag-mixbox-feed.php
# Pentru testare cu debug:
https://site-ul-tau.com/gomag-mixbox-feed.php?debug=1
# Pentru limitare produse:
https://site-ul-tau.com/gomag-mixbox-feed.php?limit=50
Felicitări! Dacă vezi produsele în format JSON, înseamnă că integrarea funcționează. 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 GOMAG",
"qty": "25",
"price": 49.99,
"sale_price": null,
"last_update_date": "2025-08-08 16:30:00",
"description": "Descrierea completă din GOMAG...",
"weight": "1.2",
"images": [
{"src": "https://gomag.ro/images/products/image.jpg"}
],
"permalink": "https://magazinul-tau.gomag.ro/product/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": "Nume Brand",
"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/gomag-mixbox-feed.php?limit=50
# Dezactivare cache (pentru modificări imediate):
https://site-ul-tau.com/gomag-mixbox-feed.php?cache=0
# Mod debug pentru testare:
https://site-ul-tau.com/gomag-mixbox-feed.php?debug=1
🔍 Modul de depanare (Debug)
Modul debug te ajută să:
- Vezi răspunsul brut al API-ului GOMAG
- Identifici erori de conexiune
- Testezi diferite URL-uri API
- Verifici configurația
Cum activezi: Adaugă ?debug=1 la URL-ul feed-ului
Exemplu: https://site-ul-tau.com/gomag-mixbox-feed.php?debug=1
🛠️ Probleme comune și soluții
Problemă: "Conexiunea API a eșuat"
Soluție: Verifică URL-ul API și cheia de autentificare. Folosește modul debug pentru a vedea eroarea exactă.
Problemă: "Răspuns JSON invalid"
Soluție: Activează modul debug (?debug=1) pentru a vedea răspunsul brut al API-ului și identifica problema.
Problemă: "Acces interzis la directorul cache"
Soluție: Asigură-te că directorul unde este script-ul are permisiuni de scriere. Directorul cache se creează automat.
Problemă: "Nu apar produse în feed"
Soluție: Verifică că API-ul GOMAG returnează produse și că nu ai erori de autentificare. Testează cu debug activat.
⚡ Cache și performanță
Cum funcționează cache-ul:
- Rezultatele se stochează pentru 30 de minute
- Se salvează în folderul cache/
- Îmbunătățește performanța și reduce încărcarea API-ului GOMAG
- Poți șterge cache-ul manual dacă e nevoie
Ștergere cache: Șterge fișierul cache/gomag_feed_cache.json
🔒 Securitate
Recomandări de securitate:
- Feed-ul este accesibil public (nu necesită autentificare)
- Consideră adăugarea unei autentificări simple dacă e nevoie
- Nu expune cheia API în alte locuri
- Monitorizează accesările pentru a detecta abuzuri
- Cache-ul ajută la prevenirea supraîncărcării
📞 Suport și ajutor
Ai nevoie de ajutor?
Pentru integrarea GOMAG, contactează:
1. Echipa de suport GOMAG - pentru API și chei de acces
2. Echipa Mixbox - pentru probleme cu formatul JSON
Documentație GOMAG: Verifică portalul pentru dezvoltatori GOMAG pentru informații detaliate despre API.
🎉 Gata! Descarcă din nou dacă ai nevoie
Script-ul GOMAG este acum instalat și configurat. Dacă ai nevoie să-l instalezi din nou, poți descărca fișierul oricând.
📄 Descarcă din nou gomag-mixbox-feed.php
