Elbuz Tunnel przenosi produkty, ceny i stany z katalogu prosto do bazy Twojej strony: bez pliku i ręcznego importu, nowa cena jest na stronie od razu po przebiegu.
Kiedy to się przyda:
- Strona na OpenCart, WooCommerce lub innym CMS z listy — tunel sam odczyta dane dostępowe do bazy z konfiguracji strony.
- Ceny i stany mają się aktualizować codziennie — harmonogram z „Eksportować tylko nowe dane” wysyła tylko zmiany.
- Błędny eksport jest już na stronie — przed scalaniem tunel robi kopię zapasową bazy.
- Strona napisana na zamówienie — tryb „MySQL (SQL custom query)” pozwala opisać scalanie własnymi zapytaniami.
Od czego zacząć: wgraj moduł na hosting, potem „Dodaj” → „Elbuz” → „Elbuz Tunnel”.
Co potrafi tunel
- Dane bez pliku — produkty, kategorie, producenci, zdjęcia, artykuły i opinie trafiają prosto do bazy strony.
- Połączenie strony — instalacja modułu; hasło i dane dostępowe do bazy program ustawi sam.
- Wybór danych i produktów — co eksportować, jaka cena trafi na stronę i które produkty.
- Kategorie — drzewo strony takie jak w katalogu, skróty dla kilku stron.
- Porządki na stronie — wyłącz lub usuń to, czego nie ma w eksporcie.
- Kopia zapasowa — kopia bazy przed scalaniem i przywracanie z niej.
- Pola i statusy — co zapisywać na stronie, formuły, niestandardowe pola.
- Własne zapytania SQL — dla spoza listy i dla dodatków.
Czym tunel różni się od feedu w pliku
Feed ma plik: program go generuje, umieszcza w folderze Twojego konta i daje link, który przekazujesz marketplace’owi. Tunel pliku nie ma.
Program zapisuje dane w plikach roboczych , a pobiera je — moduł na hostingu strony.
Moduł wgrywa je do tabel tymczasowych w bazie strony i wykonuje zestaw zapytań scalających. Potem pliki robocze i tabele tymczasowe są usuwane.
Co to oznacza w praktyce:
- Kolumna „Plik” na liście szablonów jest pusta, a przy szablonie tunelu nie ma przycisku „Kopiuj link”. To nie awaria: szablon tunelu nie tworzy pliku — dane trafiają na stronę bezpośrednio.
- Dane pojawiają się na stronie od razu — nie wtedy, gdy marketplace zechce pobrać feed, ale w chwili przebiegu.
- Przesyłane są nie tylko produkty. Feed to produkty i kategorie. Tunel potrafi wysłać też producentów, atrybuty, opcje, zdjęcia jako pliki, języki, sklepy, magazyny, artykuły, opinie, FAQ i rodziny produktów.
- Błąd kosztuje więcej. Błędnego feedu można nie przekazywać marketplace’owi. Tunel już zapisał dane w bazie strony — dlatego ma kopię zapasową i przywracanie.
Tunel nie ma przebiegu próbnego dla jednego produktu. Przycisk z kolbą „Sprawdź”, którym w feedach sprawdza się jeden produkt, odpowie tu: „Dla tego formatu szablonu sprawdzenie nie jest jeszcze dostępne”. Sprawdzać trzeba pełnym przebiegiem i dziennikiem — tym bardziej warto zostawić włączoną kopię zapasową.
Uruchomienie i harmonogram
Szablon tunelu uruchamiasz tak samo jak każdy inny — przyciskiem „Eksportuj” w wierszu listy. Najpierw otworzy się okno „Co zostanie wyeksportowane” (można je wyłączyć dla całego konta) i dopiero z niego rusza przebieg. W samej karcie szablonu nie ma przycisku uruchomienia: w nagłówku jest tylko plakietka stanu i przycisk z wykresem „Historia uruchomień”.
Reguły stop działają zawsze: jeśli reguła jest w trybie „Zatrzymaj eksport” i próg zostanie przekroczony, przebieg w ogóle nie dotrze do strony. Szczegóły — w artykułach o uruchamianiu i o regułach stop.
Harmonogram ustawiasz wierszem „Ustawienia harmonogramu” w kolumnie „Dodatkowo” po prawej stronie karty szablonu.
Przebieg idzie porcjami: w jednej paczce moduł dostaje 50 wierszy i pracuje nie dłużej niż 15 sekund, po czym program sprawdza jego stan i wysyła kolejną porcję. Sprawdza co 3 sekundy, w dzienniku widać to jako wiersze „Wczytano N wierszy”. Właśnie przez porcje duży katalog jedzie długo: moduł pracuje krótkimi seriami, a nie jednym długim zapytaniem.
Przycisk „Zatrzymaj” w Centrum operacji działa między porcjami: program poczeka do końca bieżącej paczki i napisze „Eksport przerwany przez użytkownika!”. Co zdążyło się wydarzyć, zależy od kroku, na którym zatrzymano przebieg. Podczas przesyłania danych strona się nie zmienia — wszystko jest w tabelach tymczasowych. Po rozpoczęciu scalania część danych jest już na stronie; to normalny stan, kolejny przebieg uzupełni resztę. W sklepie na Elbuz CMS zatrzymanie działa też na krok wczytywania zdjęć.
Kolejność kroków w dzienniku jest taka sama w każdym przebiegu. Najpierw przesyłanie — wiersze „Eksport …”: waluty i kursy, języki, kontrahenci, jednostki miary, sklepy, magazyny, kategorie produktów, produkty, producenci, grupy atrybutów, atrybuty, wartości atrybutów, zdjęcia, artykuły, opinie, FAQ, rodziny produktów.
Które wiersze się pojawią, zależy od tego, co zaznaczysz. Potem zaczyna się scalanie, a jego wiersze zależą już od silnika strony.
Dla OpenCart są to: „Utworzono kopię zapasową bazy danych strony:”, „Usuwanie z bazy danych strony pozycji, które zostały wcześniej usunięte”, „Wykonywanie zapytań SQL przed aktualizacją”, „Synchronizacja ID pozycji z bazą danych strony”, „Aktualizacja strony”, „Aktualizacja atrybutów”, „Wykonywanie zapytań SQL po aktualizacji” i „Usuwanie tabel i plików tymczasowych”. Całość kończy wiersz „Eksport danych zakończony” z czasem trwania.
Przed pierwszym przebiegiem
Sklep na Elbuz CMS: eksport tylko zmienionych produktów
Szablon sklepu na Elbuz CMS z włączonym przełącznikiem „Eksportować tylko nowe dane” przed wysyłką porównuje dane produktów w Elbuz z poprzednią wysyłką na tę stronę i wysyła tylko te, które się różnią. W nowym sklepie przełącznik jest włączony domyślnie.
Nie ma znaczenia, skąd wzięła się zmiana danych produktu: edycja w karcie, import czy cennik. Produkt, którego nie ma na stronie, też zostanie wysłany, nawet jeśli usunięto go tam ręcznie. Przy katalogu ze 127 tysięcy produktów przebieg bez zmian trwa poniżej minuty, a pełna wysyłka — 18 minut.
Porównywane są tylko produkty, które przechodzą wybór w szablonie. Kategorie, producenci, atrybuty i artykuły, jeśli są zaznaczone, trafiają w całości w każdym przebiegu, w którym strona jest aktualizowana. Ile produktów trafi, pokazuje wiersz dziennika „Sprawdzanie zmian: na stronę trafi N z M produktów”, gdzie M to produkty przechodzące wybór.
Jeśli nie zmieniły się ani produkty, ani słowniki, nic nie czeka na usunięcie, a w szablonie nie ma własnych zapytań SQL ani skryptu, strona w ogóle nie jest aktualizowana: dziennik pokaże „Brak zmian: produkty i słowniki są zgodne ze stroną, strona nie została zaktualizowana”. Na koncie demo i w „Eksporcie testowym” porównania nie ma: tam trafia ograniczona liczba produktów.
Kiedy cały katalog jedzie sam
- Raz w tygodniu i w pierwszym przebiegu z tym przełącznikiem.
- Zmieniły się ustawienia szablonu lub atrybuty: flagi danych i usuwania, warunki wyboru, pola, statusy.
- Włączono „Usuwać, jeśli brak w eksporcie”: ta reguła potrzebuje pełnej listy, więc katalog jedzie w każdym przebiegu.
- Zmieniła się ponad połowa produktów.
- Nie udało się porównać. Przebieg nie kończy się błędem, tylko wysyła cały katalog.
Zmiany szablonu opisu i zapytań SQL porównanie nie wychwytuje. Po takiej zmianie kliknij „Eksportuj wszystko”.
Przycisk „Eksportuj wszystko”
Jest pod przyciskiem „Eksportuj” w prawej kolumnie karty szablonu i wysyła cały katalog, nawet jeśli nie ma zmian. Przebieg zaczyna się od razu, bez okna „Co zostanie wyeksportowane”. Przycisk jest widoczny, gdy przełącznik jest włączony, a sklep ma już za sobą pierwszy eksport.
1
Eksportuj wszystko2
Eksportuj- „Eksportuj wszystko” — wysyła na stronę ponownie cały katalog, a nie tylko zmienione pozycje.
- „Eksportuj” — wysyła tylko to, co zmieniło się od ostatniego przebiegu.
Zmiany wprowadzonej bezpośrednio na stronie lub w jej bazie porównanie nie widzi: nie odczytuje zawartości strony. Zmiana zostaje, dopóki produkt nie zmieni się w Elbuz albo nie pójdzie pełny eksport. Wtedy pola, które eksportuje szablon, dostaną dane z Elbuz. Żeby zmiana nie przepadła, wprowadź ją w Elbuz. Żeby od razu przywrócić na stronie dane z Elbuz, kliknij „Eksportuj wszystko”.
Jak zatrzymanie działa na wczytywanie zdjęć
Podczas wczytywania zdjęć przycisk „Zatrzymaj” działa między paczkami: bieżąca jest dociągana do końca, zwykle do 30 sekund, najdłużej około 45. Zatrzymany przebieg nie jest uznawany za wykonany, więc kolejne uruchomienie wyśle te same produkty jeszcze raz.
Scenariusze
Codzienna aktualizacja cen i stanów na stronie
Co zrobić. W sekcji „Co eksportować” zostaw włączone „Kategorie”, „Produkty”, „Producenci” i „Eksportować tylko nowe dane”. Wierszem „Ustawienia harmonogramu” w kolumnie „Dodatkowo” ustaw harmonogram.
Efekt. Każdy przebieg bierze tylko produkty, kategorie i producentów, które zmieniły się od poprzedniego przebiegu, a po udanym wgraniu na stronę oznacza jako wyeksportowane wysłane produkty wraz z ich zdjęciami i wartościami atrybutów, a kategorie, producentów i atrybuty — całego katalogu.
Jeśli wgrywanie się nie powiodło (błąd w zapytaniach „Po aktualizacji”, zerwane połączenie z modułem), oznaczenia nie są ustawiane i kolejny przebieg wyśle te same zmiany jeszcze raz. Cena na stronie to RRP, jeśli jest wypełniona i zaznaczono „Aktualizować cenę na stronie na podstawie ceny sugerowanej (RRP)”, w przeciwnym razie zwykła cena produktu.
Czego nie będzie. Produkt, który nie zmienił się w katalogu, nie jest nadpisywany na stronie: zmiana wprowadzona w panelu strony zostanie do następnej zmiany tego produktu w Elbuz. Produkty, kategorie i producenci nie są usuwane ze strony, dopóki w sekcji „Usuwanie” nie zaznaczysz żadnej flagi. W sklepie na Elbuz CMS ten tryb działa inaczej.
Strona na CMS, którego nie ma na liście
Co zrobić. W sekcji „Strona i CMS” wybierz „MySQL (SQL custom query)”, wpisz ręcznie dane dostępowe do bazy, a scalanie opisz zapytaniami w oknie „Ustawienia zapytań SQL”.
Efekt. Tunel wgra zaznaczone dane do tabel tymczasowych w bazie strony, a potem wykona Twoje zapytania. Czego nie będzie. Program nie odczyta konfiguracji strony, a kopia zapasowa bazy w tym trybie nie jest tworzona. Krok po kroku — aktualizacja strony własnymi zapytaniami SQL.
Co zrobić, gdy przebieg się nie odbył
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Anulowano eksport według harmonogramu, powód: eksportowany jest inny szablon (konflikt przetwarzania danych).” | Dwa eksporty według harmonogramu nałożyły się na siebie | Rozsuń w czasie harmonogramy szablonów (o uruchamianiu) |
| „Eksport przerwany przez użytkownika!” | Kliknięto „Zatrzymaj” w Centrum operacji; przebieg zakończył się na granicy porcji | Nic. Część danych jest już na stronie, kolejny przebieg uzupełni resztę |
| „Dla tego formatu szablonu sprawdzenie nie jest jeszcze dostępne” | Tunel nie ma przebiegu próbnego dla jednego produktu | Uruchom pełny eksport i sprawdź dziennik w Centrum operacji |
| „Uwaga, korzystasz z wersji DEMO! Eksport jest ograniczony do 100 produktów.” | Konto demo: na stronę trafi pierwszych 100 produktów i 500 zdjęć | Doładuj saldo — menu „Panel klienta” → „Saldo” → „Płatność” |
Najczęstsze pytania
Dlaczego kolumna „Plik” mojego szablonu tunelu jest pusta?
Bo tunel nie ma pliku. Dane trafiają prosto do bazy danych strony i nie powstaje link, który można by komuś przekazać. Pusta kolumna „Plik” przy szablonie tunelu to normalny stan.
Czy można sprawdzić jeden produkt przed pełnym przebiegiem?
Nie. Przycisk „Sprawdź” w tunelu odpowiada „Dla tego formatu szablonu sprawdzenie nie jest jeszcze dostępne”. Jedyne sprawdzenie to pełny przebieg i dziennik w Centrum operacji, dlatego przed pierwszym uruchomieniem zostaw włączoną kopię zapasową.
Moja strona nie działa na CMS z listy. Tunel się nie nada?
Nada się: na liście silników jest pozycja „MySQL (SQL custom query)” dla każdego innego silnika. Dane dostępowe do bazy wpisuje się ręcznie, a zapytania scalające — w oknie „Ustawienia zapytań SQL”.
Czym tunel eksportu różni się od „Import danych” przez tunel?
Kierunkiem. Eksport wysyła katalog z Elbuz na stronę. Zamówienia, klientów i opinie ze strony pobiera „Import danych” — sąsiednia pozycja menu z osobnym szablonem, przez ten sam moduł (import przez tunel).
Dlaczego duży katalog eksportuje się długo?
Przebieg idzie porcjami: w jednej paczce moduł dostaje 50 wierszy i pracuje nie dłużej niż 15 sekund, po czym program wysyła kolejną porcję. Postęp widać w dzienniku jako wiersze „Wczytano N wierszy”. W sklepie na Elbuz CMS katalog bez zmian przechodzi szybciej: jadą tylko zmienione produkty.
Cenę poprawiono bezpośrednio na stronie sklepu Elbuz CMS. Dlaczego przebieg jej nie rusza?
Porównanie zestawia dane Elbuz z poprzednią wysyłką, a zawartości strony nie odczytuje. Zmiana zostaje, dopóki produkt nie zmieni się w Elbuz albo nie pójdzie pełny eksport, np. cotygodniowy lub przyciskiem „Eksportuj wszystko”. Wtedy pola, które eksportuje szablon, dostaną dane z Elbuz.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Eksport danych
- Inne wejścia
- „Dodaj” → grupa „Elbuz” → „Elbuz Tunnel”; skrót „Eksport” na pulpicie
- Uprawnienia
- okno „Eksport danych” i osobno karta szablonu
- Przygotuj
- moduł w katalogu głównym strony; na hostingu PHP z mysqli, zip i curl
1
Eksport danych2
Import danych- „Eksport danych” — otwiera okno, w którym konfiguruje się i uruchamia szablony eksportu na Twoją stronę.
- „Import danych” — przeciwny kierunek: wczytywanie danych do Elbuz, łatwo pomylić z eksportem.
1
Grupa „Elbuz”2
Elbuz Tunnel- „Elbuz” — grupa własnych typów miejsc docelowych Elbuz.
- „Elbuz Tunnel” — typ miejsca docelowego do eksportu na własną stronę przez moduł tunelu.
Sam tunel nie ma osobnej pozycji menu: to jeden z typów szablonu we wspólnym oknie eksportu. Wszystko, co dotyczy szablonów ogólnie — lista, podsumowanie przed startem, reguły stop, dziennik przebiegu — omawia artykuł o szablonach eksportu.
Tunel jest na każdym koncie, bez osobnego modułu: kto ma uprawnienia do okna, ale nie do karty szablonu, zobaczy listę kanałów, ale nie otworzy ustawień.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Powiązane tematy
- Jeśli potrzebujesz ogólnej mechaniki szablonów — Jak skonfigurować eksport produktów.
- Jeśli chcesz pobrać ze strony katalog lub zamówienia — Import katalogu przez Elbuz Tunnel.
- Jeśli dane dostawców nie są jeszcze w katalogu — Aktualizacja katalogu bazowego z cenników.
- Jeśli strona nie jest jeszcze połączona — Jak połączyć stronę z Elbuz Tunnel.
- Jeśli budujesz jeden katalog produktów dla strony i marketplace’ów — co to daje Twojemu sklepowi.
- Jeśli stronę trzeba wypełnić produktami i opisami — jak wypełnić stronę treścią.
