Podłączenie shopGold

shopGold nie ma własnego API, dlatego Cornvilla łączy się ze sklepem przez mały plik łącznika, który wgrywasz na serwer sklepu. Plik czyta produkty i zamówienia ze sklepu, a zmienia tylko to, co trzeba: status zamówienia, numer przesyłki i stany magazynowe. Zajmuje to około 15 minut.

Integrację uruchamiamy na życzenie — napisz do nas, a podłączymy ją razem z Tobą.

Co przepływa

Kierunek	Dane
shopGold → Cornvilla	produkty z wariantami (kod, EAN, waga, zdjęcie, kategoria), zamówienia z adresem dostawy, płatnością (także pobranie), punktem odbioru i anulowaniem
Cornvilla → shopGold	status zamówienia, numer przesyłki, stan magazynowy

Zmiana statusu z Cornvilla nie wysyła klientowi e-maila ze sklepu — tak samo działają inne systemy łączące się ze sklepem.

Krok 1. Pobierz plik łącznika

1. W Cornvilla: Integracje → Dodaj połączenie → Sklep internetowy → shopGold.
2. Kliknij Pobierz plik łącznika. Pobierze się plik o nazwie podobnej do cornvilla-3f9a1c7e2b40.php, a w połączeniu wpisze się sam klucz — nic nie przepisujesz.

Plik ma swój własny klucz. Jeśli kiedyś pobierzesz go ponownie, stary plik przestanie działać — podmień go na serwerze.

Krok 2. Wpisz dane bazy danych

Otwórz plik w zwykłym edytorze tekstu (np. Notatnik). Na samej górze są ustawienia — uzupełnij:

• db_name — nazwa bazy danych sklepu,
• db_user i db_pass — użytkownik i hasło bazy danych,
• db_host — tylko jeśli baza nie jest na tym samym serwerze (najczęściej zostaje localhost).

Te dane znajdziesz w panelu hostingu (sekcja bazy danych MySQL) albo w pliku konfiguracyjnym sklepu. Zapisz plik.

Krok 3. Wgraj plik na serwer

Wgraj plik przez FTP na serwer sklepu, najlepiej do głównego katalogu sklepu (tam, gdzie jest katalog images). Nie zmieniaj nazwy pliku.

Krok 4. Połącz

W Cornvilla wpisz pełny adres pliku, np. https://twojsklep.pl/cornvilla-3f9a1c7e2b40.php, kliknij Testuj połączenie, a potem Dodaj połączenie. Dalej jak przy każdym sklepie: włącz import produktów i zamówień — zobacz Podłączenie sklepu.

Użytkownik bazy

Najbezpieczniej dać plikowi osobnego użytkownika bazy danych, który może tylko to, czego potrzebuje Cornvilla. Wtedy nawet gdyby ktoś zdobył klucz, przez plik nie odczyta danych klientów Twojego sklepu i nie zmieni cen.

Użytkownika założysz w panelu hostingu — w phpMyAdmin (zakładka SQL) wklej polecenia poniżej, zmieniając sklep na nazwę swojej bazy i mocne-haslo na własne hasło:

CREATE USER 'cornvilla'@'localhost' IDENTIFIED BY 'mocne-haslo';
GRANT SELECT ON sklep.products TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.products_description TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.products_stock TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.products_to_categories TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.products_options TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.products_options_values TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.categories TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.categories_description TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.manufacturers TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.tax_rates TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.currencies TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.languages TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.settings TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_products TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_total TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_status TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_status_description TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_status_history TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.orders_shipping TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.modules_payment TO 'cornvilla'@'localhost';
GRANT SELECT ON sklep.modules_payment_params TO 'cornvilla'@'localhost';
GRANT UPDATE (orders_status, last_modified) ON sklep.orders TO 'cornvilla'@'localhost';
GRANT INSERT ON sklep.orders_status_history TO 'cornvilla'@'localhost';
GRANT INSERT, UPDATE ON sklep.orders_shipping TO 'cornvilla'@'localhost';
GRANT UPDATE (products_quantity) ON sklep.products TO 'cornvilla'@'localhost';
GRANT UPDATE (products_stock_quantity) ON sklep.products_stock TO 'cornvilla'@'localhost';

Potem w pliku łącznika wpisz cornvilla jako db_user i swoje hasło jako db_pass.

• Jeśli phpMyAdmin pokaże błąd przy kolumnie last_modified, zmień tę linię na GRANT UPDATE (orders_status) ON … (starsze wersje sklepu nie mają tej kolumny).
• Jeśli Twój hosting nie pozwala zakładać użytkowników, plik zadziała też z głównym użytkownikiem bazy sklepu.

Bezpieczeństwo pliku

• Plik odpowiada tylko na żądania podpisane Twoim kluczem — klucz nie jest przesyłany przez internet, a każde żądanie jest ważne kilka minut.
• Otwarty w przeglądarce nie pokazuje żadnych danych.
• Wykonuje tylko kilka określonych czynności — nie da się przez niego wysłać do bazy dowolnego polecenia.
• Chcesz, żeby Cornvilla tylko czytała dane? Ustaw w pliku allow_write na false.