Elbuz sam konfiguruje połączenie z Twoją stroną: wgrywasz moduł tunelu na hosting i wpisujesz adres strony, a hasło modułu i dane dostępowe do bazy program pobiera z konfiguracji CMS.
Kiedy to się przyda:
- Moduł jest już na stronie — wystarczy adres strony, resztę program ustali sam.
- Już pobierasz ze strony zamówienia tunelem — nowy szablon eksportu weźmie gotowe dane dostępowe.
- Hosting blokuje tunel — komunikat w dzienniku powie, co włączyć: local_infile, zip czy limity czasu.
- Wyszła nowa wersja modułu — przycisk „Aktualizuj” sam zaktualizuje go na stronie.
Od czego zacząć: wgraj moduł do katalogu głównego strony.
Co potrafi połączenie tunelu
- Trzy sytuacje startowe — moduł już jest, modułu nie ma, tunel już działa przy imporcie.
- Instalacja modułu — archiwum do katalogu głównego strony w kilka minut.
- Automatyczna konfiguracja — hasło modułu i dane dostępowe do bazy z konfiguracji .
- Aktualizacja modułu — przyciskiem, bez , z zachowaniem hasła.
Czego potrzeba na stronie
Tunel to pliki na hostingu Twojej strony, folder etrade_http_tunnel2 w katalogu głównym.
Nie musisz zgadywać, jakie warunki ma hosting: gdy połączenie jest skonfigurowane, przycisk „Sprawdź połączenie” pokaże listę wymaganych rozszerzeń PHP razem z memory_limit, post_max_size, upload_max_filesize, max_execution_time, ustawieniami regionalnymi (locale) i wersją samego modułu.
- Moduł jest już na stronieStronę zbudowano z Elbuz albo tunel zainstalowało wsparcie
- Modułu na stronie jeszcze nie maFolder trzeba ręcznie wgrać do katalogu głównego strony
- Tunel jest już skonfigurowany do importu danychJuż pobierasz ze strony zamówienia — dane dostępowe podstawią się same
Moduł jest już na stronie
Wtedy potrzebny jest od Ciebie tylko adres strony. Resztę program ustali sam na etapie połączenia: złoży adres modułu, dobierze login, ustawi hasło i odczyta dane dostępowe do bazy z pliku konfiguracyjnego Twojego CMS.
Modułu na stronie jeszcze nie ma
Wtedy trzeba go wgrać na hosting — archiwum pobierzesz przyciskiem „Pobierz moduł” w sekcji „Strona i CMS” karty szablonu. Kolejność działań opisano poniżej, w sekcji „Instalacja modułu na Twoim hostingu”. Po instalacji adres modułu wygląda tak: https://twoja-strona/etrade_http_tunnel2/etrade_http_tunnel.php — właśnie ten adres program wpisze w pole „Link do modułu”.
Tunel jest już skonfigurowany do importu danych
Najkrótsza droga. Jeśli na koncie jest już szablon importu danych przez tunel — ten, którym pobierasz ze strony zamówienia — nowy szablon eksportu przejmie z niego gotowe: CMS i jego wersję, adres modułu, login i hasło, wszystkie dane dostępowe do bazy strony, i typ tabel.
Razem z nimi przeniesie się też lista obiektów z „Dodatkowych parametrów”. Sekcji połączenia w tym przypadku nie trzeba w ogóle wypełniać.
Jeśli takiego szablonu nie ma, pola wypełniają się wartościami domyślnymi: CMS — OpenCart, wersja 3, port 3306, kodowanie utf8mb4, porównywanie znaków utf8mb4_unicode_ci, typ tabel InnoDB.
Instalacja modułu na Twoim hostingu
Tunel to folder etrade_http_tunnel2 w katalogu głównym Twojej strony. Dopóki go tam nie ma, nie ma się z czym łączyć, więc pierwszy krok jest zawsze taki sam: wgrać moduł na serwer. To jednorazowa praca na kilka minut i potem się do niej nie wraca — moduł aktualizuje się sam.
- Pobierz moduł. W szablonie tunelu, w bloku „Wybór CMS”, jest przycisk „Pobierz moduł” — pobiera aktualne archiwum. To samo przez bezpośredni link: etrade_http_tunnel2.zip.
- Rozpakuj archiwum na swoim komputerze.
- Skopiuj zawartość na hosting — do katalogu głównego strony, tam, gdzie leży główny
index.php, razem z samym folderemetrade_http_tunnel2. Najwygodniej zrobić to klientem FTP, np. FileZilla. Potem adres modułu wygląda tak:https://twoja-strona/etrade_http_tunnel2/etrade_http_tunnel.php. - Połącz się w Elbuz: w bloku „Wybór CMS” szablonu wybierz swój CMS (dla OpenCart — także wersję), podaj adres strony i kliknij „Połącz”.
Dalej Elbuz robi wszystko sam: nadaje modułowi hasło dostępu (jeśli to pierwsza instalacja) i czyta plik konfiguracyjny Twojego CMS, pobierając z niego parametry połączenia z bazą — serwer, nazwę bazy, użytkownika, hasło i prefiks tabel. Nie trzeba ich wpisywać ręcznie. Gdy wszystko się uda, zobaczysz komunikat „Moduł został podłączony!”.
W folderze modułu, oprócz samego tunelu, są puste foldery temp i backup: w pierwszym moduł trzyma pliki robocze, w drugim zapisuje kopie zapasowe bazy strony. Na hostingu muszą być włączone rozszerzenia PHP mysqli, zip i curl.
Napis na przycisku zależy od tego, czy połączenie jest już skonfigurowane. Dopóki parametry są puste — jest tam „Połącz” i to właśnie on wykonuje automatyczną konfigurację. Gdy dane dostępowe są już wypełnione, w jego miejscu pojawia się „Sprawdź połączenie”: niczego nie konfiguruje od nowa, tylko sprawdza, czy moduł odpowiada, i przy okazji pokazuje wersję modułu oraz ustawienia PHP na hostingu.
Jest też przycisk „Pobierz ustawienia” w bloku parametrów ręcznych — nim można ponownie odczytać konfigurację strony, np. po przeniesieniu bazy.
Wtedy te same parametry wpisuje się ręcznie:
- Link do modułu —
https://twoja-strona/etrade_http_tunnel2/etrade_http_tunnel.php; - Login —
admin; - Hasło — to, które jest ustawione w pliku
etrade_http_tunnel_login.phpw module; - Dostęp do bazy danych strony — serwer, port, nazwa bazy, użytkownik, hasło i prefiks tabel. Te wartości są w pliku konfiguracyjnym Twojego CMS (zwykle
config.phplub podobnym).
Typowe przyczyny, dla których automatyczne połączenie nie zadziałało: nie podano adresu strony albo nie wybrano CMS (program ostrzeże osobnym oknem); moduł nie został skopiowany do katalogu głównego strony; hosting blokuje dostęp do pliku modułu.
Instalację i konfigurację tunelu może wykonać wsparcie Elbuz — potrzebny będzie do tego dostęp do Twojego hostingu. To osobna usługa: napisz do wsparcia, a dowiesz się o warunkach.
Aktualizacja modułu
Zwykle nie trzeba niczego aktualizować ręcznie. Kliknij „Sprawdź połączenie”: program pokaże wersję modułu na Twoim hostingu i porówna ją z najnowszą. Jeśli wyszła nowsza, obok pojawi się wiersz „Dostępna nowa wersja modułu” i przycisk „Aktualizuj” — aktualizuje pliki na stronie sam, niczego nie trzeba kopiować.
Ręczna droga jest potrzebna, gdy automatyczna aktualizacja nie przechodzi — np. hosting nie pozwala modułowi zapisywać we własnym folderze. Wtedy używa się archiwum aktualizacji: etrade_http_tunnel2_update.zip. Rozpakowuje się je i nadpisuje pliki w folderze etrade_http_tunnel2 na hostingu.
W archiwum aktualizacji jest tylko rdzeń modułu — pliki robocze, które mają zostać zastąpione nowymi. Nie ma w nim tego, co pojawiło się na hostingu już w trakcie pracy:
etrade_http_tunnel_login.php— plik z loginem i hasłem do modułu. Właśnie dlatego aktualizacja nie resetuje dostępu: hasło, które Elbuz zapisał przy pierwszym połączeniu, zostaje na miejscu i po aktualizacji nie trzeba konfigurować połączenia od nowa;- folder
backup— kopie zapasowe bazy Twojej strony; - folder
temp— pliki robocze modułu.
Dlatego archiwum aktualizacji rozpakowuje się na istniejący folder, a nie zamiast niego. Pełne archiwum (etrade_http_tunnel2.zip) jest potrzebne tylko przy pierwszej instalacji — są w nim te pliki i puste foldery.
Połączenie w karcie szablonu
Karta szablonu tunelu to jedna przewijana strona. U góry jest przyklejony pasek sekcji: „Strona i CMS”, „Moduł tunelu”, „Baza danych strony”, „Co eksportować”, „Wybór produktów”, „Ceny”, „Usuwanie”, „Archiwum bazy”. Kliknięcie nazwy przewija do sekcji, a podczas przewijania pasek podświetla tę, w której jesteś. Połączenie zajmuje pierwsze trzy sekcje. Formularz zapisuje się sam: w stopce widać „Wszystkie zmiany zapisane” albo „Zapisywanie…”.
Kolejność jest taka.
- W sekcji „Strona i CMS”, w karcie „Wybór CMS”, wybierz CMS swojej strony i, jeśli ma wersje, wersję. Na liście: CS-Cart, Magento (wersje 1 i 2), OpenCart (2, 3), PrestaShop, WooCommerce i osobna pozycja „MySQL (SQL custom query)” — dla strony na dowolnym innym silniku, gdy zapytania pisze się ręcznie.
- Wpisz „Link do Twojej strony” — po prostu adres strony głównej, w postaci
https://yoursite.com. - Kliknij „Połącz”.
Co dzieje się po kliknięciu. Najpierw program uzgadnia z modułem hasło: jeśli moduł ma jeszcze hasło fabryczne, program generuje losowe, zapisuje je w module i u siebie w ustawieniach. Czyli hasło fabryczne działa tylko do pierwszego połączenia.
Następnie program czyta plik konfiguracyjny samego CMS i podstawia z niego adres serwera bazy, port, użytkownika, hasło, nazwę bazy, prefiks tabel i kodowanie. Sukces to napis „Moduł został podłączony!” i przycisk „Dalej”: przewija stronę do sekcji „Co eksportować”. Jeśli moduł zwrócił błąd, program pokazuje okno z jego treścią, a przycisk „Połącz” znów staje się dostępny: usuń przyczynę i kliknij go ponownie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Wypełnione dane program umieszcza w dwóch kolejnych sekcjach. „Moduł tunelu” — karta „Ustawienia połączenia z tunelem” — to trzy pola: „Link do modułu”, „Nazwa użytkownika” (program wpisuje admin) i „Hasło”. „Baza danych strony” — karta „Ustawienia połączenia z bazą danych strony” z danymi dostępowymi do bazy: „Adres serwera MySQL”, „Port”, „Nazwa użytkownika bazy”, „Hasło”, „Nazwa bazy”, „Prefiks tabel”, „Kodowanie połączenia”, „Kodowanie porównywania znaków (collation)” i „Typ tabel”.
Obie karty wypełniają się same, ale pola można edytować: jeśli pliku konfiguracyjnego strony nie udało się odczytać, wpisz dane dostępowe ręcznie. Na dole karty bazy jest przycisk „Pobierz ustawienia” — ponownie odczytuje konfigurację strony.
Jeśli strona nie działa na MySQL, w karcie „Ustawienia połączenia z bazą danych strony” nad przyciskiem jest wiersz „Wybór DBMS” z trzema wariantami: MySQL, MariaDB, PostgreSQL. Domyślnie — MySQL.
Gdy dane dostępowe są już wypełnione, przycisk „Połącz” zmienia się na „Sprawdź połączenie”. Warto go kliknąć przed pierwszym przebiegiem: w odpowiedzi moduł opisze hosting i poda swoją wersję.
Jeśli wyszła nowsza wersja modułu, w tej samej odpowiedzi pojawi się wiersz „Dostępna nowa wersja modułu E-Trade Tunnel:” i przycisk „Aktualizuj”. Aktualizuje moduł na hostingu sam, nie trzeba łączyć się ze stroną przez FTP: odpowiedź to „Moduł został zaktualizowany!” albo „Błąd aktualizacji modułu!”. Co zrobić w drugim przypadku — w sekcji „Aktualizacja modułu”.
1
Pasek sekcji2
Link do Twojej strony3
Pobierz moduł4
Stan szablonu- Sekcje karty — kliknij nazwę, żeby przewinąć do tej sekcji.
- Adres strony głównej.
- Pobiera archiwum modułu tunelu do wgrania na hosting.
- Stan szablonu; włączenie uruchamia eksport według harmonogramu.
Scenariusze
Moduł jest już na stronie
Co zrobić. „Dodaj” → „Elbuz” → „Elbuz Tunnel”. W sekcji „Strona i CMS” wybierz CMS i wersję, wpisz adres strony i kliknij „Połącz”, potem „Sprawdź połączenie”.
Efekt. Program zastąpi fabryczne hasło modułu losowym, odczyta dane dostępowe do bazy z konfiguracji CMS i pokaże „Moduł został podłączony!”. Drugi przycisk pokaże rozszerzenia PHP i wersję modułu. Czego nie będzie. Dane jeszcze nie trafią na stronę — przebieg uruchamia się osobno.
Baza strony przeniosła się na inny serwer
Co zrobić. W sekcji „Baza danych strony” kliknij „Pobierz ustawienia” na dole karty „Ustawienia połączenia z bazą danych strony”.
Efekt. Program ponownie odczyta konfigurację strony i podstawi nowe dane dostępowe do bazy. Czego nie będzie. Dla CS-Cart, Magento i PrestaShop 1.7 ręcznie wpisana wartość porównywania znaków nie zostanie zachowana — przycisk zapisze utf8_general_ci; sprawdź ją ponownie (collation).
Hosting nie pozwala modułowi zaktualizować się samemu
Co zrobić. Pobierz archiwum aktualizacji, rozpakuj je i nadpisz pliki w folderze etrade_http_tunnel2 na hostingu.
Efekt. Rdzeń modułu zostanie zaktualizowany, a plik z loginem i hasłem, kopie zapasowe i pliki robocze zostaną na miejscu. Czego nie będzie. Po aktualizacji nie trzeba konfigurować połączenia od nowa.
Co zrobić, gdy tunel się nie łączy
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Podaj link do swojej strony!” | Kliknięto „Połącz” przy pustym polu adresu strony | Wpisz adres strony głównej (o połączeniu) |
| „Wybierz CMS, na którym działa Twoja strona!” | Nie wybrano silnika strony | Wybierz CMS i, jeśli jest, wersję. Twojego CMS nie ma na liście — wybierz „MySQL (SQL custom query)” |
| „Nie podano linku do modułu E-Trade Tunnel, loginu lub hasła!” | Kliknięto „Sprawdź połączenie”, a dane dostępowe modułu nie są wypełnione | Kliknij „Połącz” — program podstawi je sam (o połączeniu) |
| „Podano nieprawidłowy login lub hasło do modułu E-Trade Tunnel!” | Hasło w module na hostingu nie zgadza się z tym w ustawieniach szablonu | Zainstaluj ponownie folder modułu na stronie i jeszcze raz kliknij „Połącz”: program zapisze w module nowe hasło |
| „Eksport danych NIE został zakończony: plik nie został utworzony” | W tunelu prawie zawsze oznacza to, że puste jest jedno z sześciu obowiązkowych pól połączenia: link do modułu, nazwa użytkownika, hasło, adres serwera bazy, nazwa użytkownika bazy, nazwa bazy | Kliknij na pasku sekcji „Moduł tunelu” lub „Baza danych strony”, wypełnij puste pole i kliknij „Sprawdź połączenie” (o połączeniu) |
| „Error! Need mode LOAD DATA LOCAL INFILE! Variable local_infile: OFF” albo „mysqli_query(): LOAD DATA LOCAL INFILE forbidden” | Dane trafiają na stronę jako plik CSV, a moduł wgrywa je do tabeli tymczasowej poleceniem LOAD DATA LOCAL INFILE. Na Twoim hostingu jest ono wyłączone |
W php.ini — mysqli.allow_local_infile = On (domyślnie wiersz jest zakomentowany średnikiem). W my.cnf — local-infile=ON w sekcjach [mysqld] i [mysql], potem restart MySQL. Sprawdzenie: SHOW VARIABLES LIKE 'local_infile'. To ustawienie hostingu, po stronie Elbuz nie da się go zmienić |
| Przebieg kończy się błędem ze wzmianką o zip | Na hostingu nie ma rozszerzenia PHP zip, a pliki trafiają na stronę spakowane |
Zainstaluj rozszerzenie (php-zip) i zrestartuj serwer WWW. Jakie rozszerzenia są na hostingu, pokazuje przycisk „Sprawdź połączenie” |
| „504 Gateway Time-out” albo „502 Bad Gateway” | Serwer WWW strony nie doczekał się odpowiedzi od PHP i przerwał zapytanie. Przy dużej ilości danych tunel pracuje dłużej, niż domyślnie pozwala serwer | To ustawienie hostingu strony, nie Elbuz: zwiększ czas oczekiwania (w nginx — limity czasu proxy, w PHP — czas wykonania skryptu). Doraźnie podziel eksport na mniejsze porcje wyborem produktów |
| „MySQL server has gone away” | Baza strony zamknęła połączenie: albo minął czas oczekiwania, albo porcja danych jest większa niż dozwolony rozmiar pakietu | To również ustawienie hostingu strony: zwiększ wait_timeout i max_allowed_packet w konfiguracji MySQL. Po stronie Elbuz pomaga zmniejszenie objętości jednego przebiegu |
| W dzienniku przebiegu błąd bazy strony „Illegal mix of collations (…) and (…) for operation '='” | Przed wysyłką tunel tworzy w bazie strony tabele tymczasowe z kodowaniem i porównywaniem znaków z sekcji „Baza danych strony”. Jeśli porównywanie znaków jest tam inne niż w tabelach strony, MySQL odmawia porównania wierszy dwóch tabel. Puste pole program wypełnia wartością utf8mb4_unicode_ci; dla CS-Cart, Magento i PrestaShop 1.7 przyciski „Połącz” i „Pobierz ustawienia” za każdym razem zapisują utf8_general_ci i nadpisują wartość wpisaną ręcznie |
Sprawdź porównywanie znaków (Collation) tabeli produktów strony w phpMyAdmin lub w panelu hostingu i wpisz je w „Kodowanie porównywania znaków (collation)”, a część do pierwszego podkreślenia — w „Kodowanie połączenia”: utf8mb4_general_ci → utf8mb4, utf8_general_ci → utf8. Zrób to po „Połącz” i nie klikaj potem ponownie ani jego, ani „Pobierz ustawienia”. Dla Magento tabele tymczasowe są zawsze tworzone w kodowaniu utf8, więc pasuje tam tylko porównywanie postaci utf8_…: z utf8mb4_… tabele w ogóle się nie utworzą. Uruchom przebieg ponownie (o połączeniu) |
Najczęstsze pytania
Tunel zgłasza błąd collation (Illegal mix of collations). Jakie wartości ustawić?
To samo porównywanie znaków co w tabelach strony. Sprawdź „Metoda porównywania napisów” (Collation) tabeli produktów w phpMyAdmin, wpisz je w „Kodowanie porównywania znaków (collation)”, a część do pierwszego podkreślenia — w „Kodowanie połączenia”. Zrób to po „Połącz” (analiza).
Czy moduł na hostingu trzeba aktualizować ręcznie?
Zwykle nie: „Sprawdź połączenie” pokaże wersję modułu, a przycisk „Aktualizuj” sam zaktualizuje go na stronie. Ręczne archiwum aktualizacji jest potrzebne, gdy hosting nie pozwala modułowi zapisywać we własnym folderze.
Skąd wziąć hasło modułu, jeśli łączę się ręcznie?
Z pliku etrade_http_tunnel_login.php w module; login — admin. Po pierwszym automatycznym połączeniu jest tam hasło, które zapisał Elbuz.
Czy po aktualizacji modułu trzeba konfigurować połączenie od nowa?
Nie. W archiwum aktualizacji nie ma pliku z loginem i hasłem, więc zostaje dostęp, który Elbuz zapisał przy pierwszym połączeniu.
Jakie rozszerzenia PHP są potrzebne na hostingu?
mysqli, zip i curl; do kopii zapasowej bazy — także pdo. Jakie rozszerzenia są na hostingu, pokaże przycisk „Sprawdź połączenie”.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych → karta szablonu Elbuz Tunnel
- Inne wejścia
- sekcje „Strona i CMS”, „Moduł tunelu” i „Baza danych strony” karty szablonu
- Uprawnienia
- karta szablonu eksportu
- Przygotuj
- dostęp do hostingu strony; PHP z mysqli, zip i curl
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu tunelu — Jak eksportować produkty do bazy własnej strony.
- Jeśli strona jest połączona i trzeba wybrać, co eksportować — Co trafi na stronę przez Elbuz Tunnel.
- Jeśli ten sam moduł jest potrzebny, by pobrać ze strony katalog lub zamówienia — Import katalogu przez Elbuz Tunnel.
- Jeśli Twojego CMS nie ma na liście — Aktualizacja strony własnymi zapytaniami SQL.
