Instrukcje dotyczące pracy z platformą
hotlist.biz/admin/
Jeśli ukryjesz menu autoryzacji na stronie, to aby wejść do administratora, wystarczy wpisać ścieżkę wskazaną powyżej w pasku adresu.
Przykład linku uwierzytelniającego użytkownika
Strony
Strona - blok znajdujący się w centrum serwisu, w obszarze treści, który może zawierać dowolne dane HTML (HTML, XHTML, JAVASCRIPT, CSS lub inne).
Ładowanie zawartości strony Ajax.
Ładowanie zawartości strony Ajax.
Link z klasą «ajax_load_page» otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie «data-content-block».
Ścieżka do załadowanej strony jest określona w parametrze href.
Ścieżka strony może być względna lub w pełni kwalifikowana z http.
Możesz także użyć własnych skryptów, przekazując parametr GET lub POST «p» z nazwą
(lub pełnym adresem URL) strony w «/ajax.php»
Możliwe jest również korzystanie z bezpośrednich żądań bez użycia Ajax.
Na przykład, aby załadować dane do elementu iframe. Ścieżka jest taka sama jak w przypadku korzystania z Ajax.
Skrypt ładowania danych w wyskakującym okienku:
Skrypt wyskakujący ładujący Ajax
Katalog artykułów
Katalog artykułów to ten sam blok co strony, które dodatkowo zawierają krótkie opisy wyświetlane w formie listy z linkiem umożliwiającym wyświetlenie pełnego tekstu artykułu, a także możliwość podziału list artykułów według kategorii.
Oprócz wyświetlania list artykułów w kategoriach możesz także generować własne listy.
Ajax ładuje treść artykułu
Ajax ładuje treść artykułu.
Link z klasą «ajax_load_blog» otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie «data-content-block».
Ścieżka do załadowanej strony jest określona w parametrze href.
Ścieżka strony może być względna lub w pełni kwalifikowana z http.
Możesz także użyć własnych skryptów, przekazując parametr GET lub POST «blog_cat_p», z pełnym adresem
artykułu, na «/ajax.php»
Możliwe jest również korzystanie z bezpośrednich żądań bez użycia Ajax.
Na przykład, aby załadować dane do elementu iframe. Ścieżka jest taka sama jak w przypadku korzystania z Ajax.
Skrypt ładowania danych w oknie popup:
Ajax ładujący wyskakujący skrypt
Przykład skryptu Ajax do ładowania własnej listy artykułów
Przykład ładowania artykułu przez Ajax w formacie JSON
Blok/Menu
Blok/Menu to blok, w którym można wstawić dowolne kody HTML. Możesz także korzystać z menu z predefiniowanymi funkcjami, takimi jak koszyk, filtr wyszukiwania, bestsellery, najnowsze artykuły i nie tylko.
Block/Menu można wykorzystać do stworzenia własnego stylu/projektu strony internetowej. Na przykład możesz utworzyć nagłówek witryny, umieścić w nim niezbędne elementy (logo, kontakty, linki nawigacyjne witryny, formularz wyszukiwania itp.) i napisać CSS dla nich style w edytorze projektu. Za pomocą bloków/menu można umieszczać skrypty, w tym w metatagach, a także włączać/wyłączać wyświetlanie tych danych na określonych stronach lub urządzeniach. W większości przypadków wystarczy skorzystać z Nagłówka/Nagłówka i Stopki/Dółu strony, a także np. lewego lub prawego Bloku/Menu, aby umieścić filtr wyszukiwania. Możesz umieścić skrypty witryny w jednym Bloku/Menu i umieścić je np. w Service tags.
Blok menu można umieścić w 7 głównych częściach serwisu:
- "Nagłówek witryny (Header)" - blok nagłówka witryny, wyświetlany nad głównym blokiem treści, wewnątrz elementu "#hotengine-header".
- "Dół serwisu (stopka)" - blok dolnej części serwisu, wyświetlany pod głównym blokiem z treścią, wewnątrz elementu "#hotengine-footer".
- "Prawo" - blok jest wyświetlany po prawej stronie obok głównego bloku z treścią i nie wykracza poza treść.
- "Lewy" - blok wyświetlany jest po lewej stronie obok głównego bloku z treścią i nie wykracza poza treść.
- «Góra» - blok jest wyświetlany u góry treści i nie wykracza poza jego obszar.
- «Dół» - blok jest wyświetlany na dole treści i nie wykracza poza jego obszar.
- "Tagi usługi przed tagiem Body (Meta nagłówka)" - blok znajduje się pod metatagami usługi i może być używany do wstawiania JavaScript, metatagów i innych danych usługi.
Wszystkie menu będą miały dodaną klasę elementu, a także unikalny ID menu_id. Podstawowe znaczniki blokowania witryn ↓
Aby utworzyć rozszerzoną wersję mobilnego menu (w stylu aplikacji), użyj «Mobile Menu Builder». Konstruktor umożliwia utworzenie wielopoziomowego menu, wyskakującego okienka «Filtr wyszukiwania», a także własnych ikon.
Sklep
Sklep może zawierać uporządkowaną listę produktów wraz z przyciskami służącymi do ich zamawiania. Sklep dostarcza dużo dodatkowych danych, podział według producentów, kategorie, typy produktów, cechy i inne właściwości.
Pamiętaj, że Twoje produkty będą dodatkowo umieszczane w naszym międzynarodowym katalogu, a kupujący będą mogli zostawić opinię na temat jakości Twojej pracy.
Listy kategorii mogą być wyświetlane na stronach lub blokach/menu. W tym celu utwórz stronę lub Blok/Menu, a w tekście umieść kod Widżet z kategoriami sklepu
Ładowanie produktu Ajax
Ładowanie produktu Ajax.
Link z klasą «ajax_load_shop» otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie «data-content-block».
Ścieżka do załadowanej strony jest określona w parametrze href.
Ścieżka strony może być względna lub w pełni kwalifikowana z http.
Możesz także użyć własnych skryptów przekazując parametr GET lub POST "shop_cat_p", z pełnym adresem
produktu, pod adresem "/ajax.php"
Możliwe jest również korzystanie z bezpośrednich żądań bez użycia Ajax.
Na przykład, aby załadować dane do elementu iframe. Ścieżka jest taka sama jak w przypadku korzystania z Ajax.
Skrypty dodawania towarów do koszyka muszą być dodatkowo załadowane, jeśli korzystasz z iframe.
Skrypt ładowania danych w oknie popup:
Ajax ładujący wyskakujący skrypt
Ajax ładuje recenzje produktów
Ajax ładuje recenzje produktów.
Link z klasą «ajax_load_shop_comments» otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie «data-content-block».
Ścieżka do załadowanej strony jest określona w parametrze href.
Do recenzji używane są trzy parametry:
"hotengine_shop_comments_shop_cat_page_id" - ID produktu.
"nc" - numer strony komentarza.
"snc_on_page" - liczba komentarzy na stronie (od 1 do 50).
Ścieżka strony może być względna lub w pełni kwalifikowana z http. Ścieżka musi być albo ścieżką do produktu, albo możesz od razu podać ID produktu, którego recenzje chcesz pobrać.
Możesz także użyć własnych skryptów, przekazując parametr GET lub POST «hotengine_shop_comments_shop_cat_page_id», z pełnym adresem
produktu (lub identyfikatorem produktu), w «/ajax.php». "nc" - numer strony, "snc_on_page" - liczba komentarzy na stronie. Dodatkowo możesz filtrować komentarze według oceny, przekazując zmienną „starrating_quality”, na przykład starrating_quality=5.
Możliwe jest również korzystanie z bezpośrednich żądań bez użycia Ajax.
Na przykład, aby załadować dane do elementu iframe. Ścieżka jest taka sama jak w przypadku korzystania z Ajax.
Skrypty dodawania towarów do koszyka muszą być dodatkowo załadowane, jeśli korzystasz z iframe.
Skrypt ładowania danych w oknie popup:
Ajax ładujący wyskakujący skrypt
Aby uzyskać dane w formacie JSON, wystarczy dodać zmienną GET/POST „json”.
Przykład skryptu Ajax do ładowania listy towarów + "Generator listy towarów"
Wózek ładujący Ajax
Wózek ładujący Ajax.
Link z klasą «ajax_load_cart» otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie «data-content-block».
Aby załadować koszyk, przejdź na stronę «/ajax.php?cart&load_cart_ajax»
Przykład skryptu Ajax do ładowania wózka po najechaniu myszką
Ajax ładuje listę obrazów kart produktów
Lista ładowania Ajax wszystkich kategorii w formacie JSON
Ajax ładuje listę wszystkich kategorii w formacie JSON.
Aby uzyskać listę wszystkich kategorii sklepów, po prostu uruchom zapytanie pod adresem /ajax.php?json&shop_categories&start=0¶m=:productsGdzie
- &start= - ID kategorii, od której ma się rozpocząć wyświetlanie.
- ¶m= parametry jakie można uzyskać w Widżecie z kategoriami (parametr opcjonalny)
- Żądanie działa tylko na przykład z Twoją domeną http://example.com/ajax.php?json&shop_categories&start=0
Przykład wyniku: {"id":"ID kategorii","parentID":"ID kategorii nadrzędnej","child_cat":"Liczba zagnieżdżonych kategorii","child_items":"Liczba produktów w kategorii","image":"Ścieżka obrazu kategorii","title":"Nazwa kategorii"},
Ajax ładuje produkt w formacie JSON
Ajax ładuje produkt w formacie JSON.
Aby otrzymać dane karty produktu w formacie JSON, wystarczy złożyć wniosek pod wskazany adres /ajax.php?json&shop_products&id=0Podczas rozładunku towaru możesz określić opcje sortowania i filtrowania według następujących parametrów:
- id - identyfikator karty produktu (jedna lub więcej wartości oddzielonych przecinkami).
- pers_shop_cat_page_catid - identyfikator kategorii sklepu (jedna lub więcej wartości oddzielonych przecinkami)
- producer - producent (jedna lub więcej wartości oddzielonych przecinkami)
- collection - kolekcja (jedna lub więcej wartości oddzielonych przecinkami)
- sort_by - sortowanie
- order_by - sortowanie
- sort_instock_priority - priorytet sortowania
- price_from - cena od
- price_to — cena do
- stock - dostępność
Żądanie działa tylko na przykład z Twoją domeną http://example.com/ajax.php?json&shop_products&id=0
Ładowanie formularza Ajax (formularze wyskakujące)
Jak utworzyć formularz opinii?
Istnieją 3 sposoby tworzenia formularza.
- 1) Najbardziej elastycznym sposobem jest otwarcie kreatora formularzy i utworzenie formularza z wymaganymi polami. Wszystkie instrukcje są dostępne w konstruktorze formularza.
- 2)Utwórz funkcjonalną stronę (informacje zwrotne), która po otwarciu wyświetli standardowy formularz opinii.
- 3)Użyj wyskakującego formularza zwrotnego utworzonego za pomocą następującego kodu:
Code: html<a class="hotengine-dialog-email" data-site="XXXX" href="javascript://">Napisz do nas</a>
class="hotengine-dialog-email" - oznacza, że przycisk służy do wyskakującego formularza opinii, a rel="XXXX" to ID witryny.
XXXX zastąp identyfikatorem swojej witryny, który możesz znaleźć po najechaniu kursorem na przycisk PANEL ADMINISTRACYJNY.
Możesz także określić nazwę wyskakującego okienka oraz treść przycisku «Zamknij». W tym celu dodaj data-close-button="Zamknij" i data-title="Feedback" do linku z klasą e-mail.
Szerokość i wysokość okna można ustawić za pomocą data-width="600" i data-height="640".
Tekst przycisków w formularzu można ustawić za pomocą atrybutów data-send-button="Submit" i data-clear-button="Clear"
Możesz zmienić nazwy pól wejściowych za pomocą stylów CSS (tekst jest wprowadzany w formie treści, w css nie ma poklas after).
Uwaga! Witryna zapewnia możliwość tworzenia własnych formularzy w trybie automatycznym, a także wykorzystania wyskakujących okienek do wysyłania niezbędnych danych od odwiedzającego. Aby to zrobić, użyj projektant form.
Ajax ładuje komentarze
Ajax загрузка комментариев.
Element z klasą „ajax_load_comments” otworzy zawartość Ajax wewnątrz bloku określonego w atrybucie „data-content-block”.
Identyfikator załadowanej strony jest określony w parametrze data-page-id. Dodatkowo możesz filtrować komentarze według oceny, przekazując zmienną „starrating_quality”, na przykład starrating_quality=5.
Do komentarzy używane są 4 parametry:
- hotengine_comments_hotengine_page_id — identyfikator strony.
- nc - numer strony komentarzy.
- snc_on_page" - liczba komentarzy na stronę (od 1 do 50).
- hotengine_comments_page_type — typ strony.
Dostępne typy stron (wymagane):
- strona - strony
- shop_category - kategorie sklepów
- shop_collection – kolekcje sklepów
- shop_producer - producenci
- blog_category - kategoria katalogu artykułów
- strona_blogu - artykuł
- news_page - aktualności
Możesz użyć własnych skryptów, przekazując parametry GET lub POST „hotengine_comments_hotengine_page_id” i „hotengine_comments_page_type” do „/ajax.php”. "nc" - numer strony, "snc_on_page" - liczba komentarzy na stronie.
Aby uzyskać dane w formacie JSON, wystarczy dodać zmienną GET/POST „json”.
Ajax загрузка отзывов к товарам
Jak korzystać z wielu lądowań?
Na platformie HotList.biz możesz skonfigurować strony Multilanding, aby w przypadku dopasowania żądania (częściowego lub pełnego) zmieniała się zawartość całych bloków na stronie (na stronach, w produktach iw menu). Zapytaniem mogą być dane zapytania wyszukiwania (ustalane automatycznie) jak również własne ustawione zmienne GET. Np. dodając tagi UTM w reklamach możesz użyć tagu "utm_term", dzięki czemu strona Multilanding będzie aktywna dla zmiennej GET "utm_term". Dane źródła skierowań są przechowywane maksymalnie przez 24 godziny. Jednocześnie dane dotyczące źródła skierowania do programu partnerskiego są przechowywane przez 120 dni.
Aby potwierdzić witrynę w centrum webmasterów (na przykład Google lub Yandex), musisz dodać tag <meta> kod.
Aby to zrobić, utwórz blok/menu, wstaw wymagany metakod i umieść go w znacznikach usług. Następnie Twoja witryna zostanie zweryfikowana.
W ten sam sposób możesz stworzyć własny nagłówek i dół strony. Do menu można wstawić prawie dowolny kod HTML.
* - nagłówek «Producent» można zastąpić słowem, którego potrzebujesz.
Zalecamy wywołanie nadrzędnej (pierwszej) rubryki «Sklep» (Store).
Przykład tworzenia kategorii sklepu:
Na początek zalecamy utworzenie kategorii głównej, w której utworzysz podkategorie.
Otwórz Edytor kategorii Sklepu w Centrum administracyjnym i kliknij «Dodaj kategorię».
Wybierz swoją witrynę i kliknij OK.
Następnie wprowadź nazwę (będzie to adres Twojej kategorii). Na przykład dla kategorii głównej utwórzmy grupę «Sklep» o nazwie «store».
Gotowe.
Podobnie możesz zarządzać kategoriami Producenci (dodatkowe kategorie).
** - Dodatkowo, jeśli chcesz otworzyć listę produktów określonej kategorii i określonego producenta, wystarczy dodać zmienną GET PRODUCER. Wystarczy podać w zmiennej ID producenta lub jego nazwę. Przykład: "/pers_shop/water/?producer=bonaqua" W tym przypadku zostanie wyświetlona lista produktów pod nagłówkiem "water", których producentem jest "bonaqua".
Wyszukiwanie odbywa się po przesłaniu formularza ze zmienną «szukaj». Typ danych do wyszukania ustalany jest za pomocą ścieżki (strony), do której przesyłany jest formularz. Aby wyszukać w "Katalogu towarów" należy dokonać wysyłki na stronie "/sklep/".
Jak dodać formularz wyszukiwania do nagłówka strony?
W Bloku/Menu znajdującym się w nagłówku strony możesz dodać następujący kod:
<div align="center" id="hotengine-search_form_block" itemscope itemtype="https://schema.org/WebSite">
<link itemprop="url" href="//{HOTENGINE-SC:site_url}/"/>
<form id="hotengine-search-searchinput" name="hotengine-search-searchinput" method="post" action="/pl/shop/" itemprop="potentialAction" itemscope itemtype="https://schema.org/SearchAction">
<meta itemprop="target" content="//{HOTENGINE-SC:site_url}/pl/shop/?search={search}"/>
<label>
<input class="input" name="search" type="text" placeholder="Szukaj..." id="hotengine-smart_search_input" value="" itemprop="query-input">
</label>
<label>
<button type="submit" class="search-button">Odnaleźć</button>
">
</label></form>
</div>
Kod natychmiast zawiera Micromarkup dla Google. W drodze do wysłania formularza (//{HOTENGINE-SC:site_url}/pl/shop/?search={search}) określony pl język, możesz go zmienić.
Przykład:
CSS blokowy, zastępując przycisk wysyłania obrazem:
#hotengine-search_form_block{
position: relative;
width:300px;
float: right;
z-index:2;
height: 41px;
margin:33px 0px 33px 10px;
}
#hotengine-search_form_block input{
height: 20px;
vertical-align: middle;
border: 1px solid #e5e5e5;
padding: 0.15em;
width: 20.0em;
color:#9c9b9b;
height: 20px;
background: #fff;
padding: 0 13px;
height: 41px;
}
#hotengine-search_form_block input[type="text"]{
text-indent:4px;height: 39px;
}
#hotengine-search_form_block .search-button{
background:#41474c;
border-radius:0px;
vertical-align:middle;
display:block;
position:absolute;
top:0px;
right:0px;
border:none;
color:#fff;
width:41px; height:41px;
text-align:center;
font-size:12px;
line-height:25px;
cursor:pointer; overflow:hidden;
}
#hotengine-search_form_block .search-button:after{
content:""; width:41px; height:41px; display:block; position: absolute; right:0px; top:0px;
background:none; background-color:#d6d6d6;
-webkit-mask:url("data:image/svg+xml;base64,PCFET0NUWVBFIHN2ZyBQVUJMSUMgIi0vL1czQy8vRFREIFNWRyAxLjEvL0VOIiAiaHR0cDovL3d3dy53My5vcmcvR3JhcGhpY3MvU1ZHLzEuMS9EVEQvc3ZnMTEuZHRkIj4KDTwhLS0gVXBsb2FkZWQgdG86IFNWRyBSZXBvLCB3d3cuc3ZncmVwby5jb20sIFRyYW5zZm9ybWVkIGJ5OiBTVkcgUmVwbyBNaXhlciBUb29scyAtLT4KPHN2ZyB3aWR0aD0iODAwcHgiIGhlaWdodD0iODAwcHgiIHZpZXdCb3g9IjAgMCAxNiAxNiIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiBmaWxsPSJub25lIj4KDTxnIGlkPSJTVkdSZXBvX2JnQ2FycmllciIgc3Ryb2tlLXdpZHRoPSIwIi8+Cg08ZyBpZD0iU1ZHUmVwb190cmFjZXJDYXJyaWVyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiLz4KDTxnIGlkPSJTVkdSZXBvX2ljb25DYXJyaWVyIj4KDTxwYXRoIGZpbGw9IiMwMDAwMDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIgZD0iTTcuMjUgMmE1LjI1IDUuMjUgMCAxMDMuMTQ0IDkuNDU1bDIuMzI2IDIuMzI1YS43NS43NSAwIDEwMS4wNi0xLjA2bC0yLjMyNS0yLjMyNkE1LjI1IDUuMjUgMCAwMDcuMjUgMnpNMy41IDcuMjVhMy43NSAzLjc1IDAgMTE3LjUgMCAzLjc1IDMuNzUgMCAwMS03LjUgMHoiIGNsaXAtcnVsZT0iZXZlbm9kZCIvPgoNPC9nPgoNPC9zdmc+") center center no-repeat;
-webkit-mask-size:20px;
}
#hotengine-search_form_block .search-button:hover:after{
background-color:#fff;
}
#hotengine-search_form_block .search-button:active:after{ top:1px; }
Wydanie wyniku wyszukiwania w formacie JSON / wskazówki wyszukiwania / rozwijana lista produktów.
Aby uzyskać dane JSON z nazwą produktu, ceną, obrazem i linkiem, możesz wykonać żądanie AJAX do pliku "/ajax.php?search_shop"
W zmiennej GET/POST "szukaj" należy podać część nazwy lub ID produktu. Żądanie można wykonać tylko w przypadku płatnego hostingu z zaparkowaną domeną. Dane mogą być wykorzystane do realizacji wydawania podpowiedzi w formularzu wyszukiwania.
Podpowiedzi możesz włączyć w "Ustawieniach", w zakładce "Szukaj" - "Włącz podpowiedzi przy wpisywaniu zapytania".
Utwórz «Typ produktu» – «Trampki».
"Charakterystyka" - określ kilka pól, "Wielokrotnego wyboru (pole wyboru)" z nazwami: "Kolor", "Miejsce docelowe", "Producent".
Po zapisaniu nazw pól, po prawej stronie będziesz mógł wypełnić możliwe opcje.
Twórz wartości.
Kolor: biały, czerwony, zielony.
Przeznaczenie: bieganie, koszykówka, piłka nożna.
Producent: Adidas, Asics, Nike
Teraz w karcie produktu w zakładce "Parametry i charakterystyki" określ "Typ produktu" i podaj odpowiednie wartości.
Jeśli potrzebujesz utworzyć filtr wyszukiwania, to w sekcji «Moje bloki/menu» utwórz «Menu funkcyjne» - «Wyszukiwanie z filtrem według typów produktów».
Ten blok będzie wyświetlany wszędzie tam, gdzie włączysz wyświetlanie.
Aby wymagany typ produktu został automatycznie otwarty w określonej kategorii, w tekście «Blok funkcjonalny / menu» należy podać ID odpowiedniego typu produktu, a także dodać tekst «autopath» , aby podczas wyszukiwania odbywało się ono na tej samej stronie i nie przechodziło do ogólnego wyszukiwania witryny.
Na przykład, jeśli ID wcześniej utworzonego typu produktu wynosił 1123, tekst bloku/menu brzmiałby «1123autopath».
Teraz określ ścieżkę, gdzie ma być wyświetlany blok/menu za pomocą filtra wyszukiwania
"Wprowadź znaki, aby wyświetlić blok/menu po znalezieniu:"
/category_name/
Gdzie category_name – nazwę kategorii, ścieżkę, wzdłuż której się znajduje.
Aby ukryć filtr wyszukiwania podczas przeglądania karty produktu, w pozycji «Wprowadź znaki, po wykryciu których nie wyświetla się Blok / Menu:» wpisz
.htm
Aby ukryć pole wyszukiwania nad Typem produktu, w Edytorze wzornika w stylach CSS, dodaj «.menu_position_left .hotengine-smart_search_input_label { display: none;}»
Aby ukryć pole wyszukiwania wyboru Typu produktu, w Edytorze wzornika w stylach CSS, dodaj «.menu_position_left .shop_catalog_product_types_id_label { display: none;}»
.menu_position_left - oznacza, że ukrywamy pola w lewym bloku strony.
Aby wyświetlić liczbę produktów z podanym parametrem, można użyć parametru «count» przy tworzeniu Funkcjonalnego Bloku/Menu z filtrem wyszukiwania.
Aby ukryć nieznalezione cechy - «hideempty» (szczegóły są opisane na stronie tworzenia Funkcjonalnego Bloku/Menu).
Aby wyświetlić wybrane przez użytkownika wartości filtra wyszukiwania w górnej części strony, można użyć parametru «checkedlist». Tę funkcję można również aktywować w sekcji «Menu mobilne: Aplikacja» na karcie «Filtr wyszukiwania». Ułatwia ona użytkownikowi dostęp do wybranych wartości wyszukiwania, co jest szczególnie wygodne podczas przeglądania strony na urządzeniach mobilnych lub ekranach o niższej rozdzielczości. Funkcję wystarczy włączyć tylko raz — albo za pomocą parametru «checkedlist» w sekcji «Moje Bloki/Menu» - «Filtr wyszukiwania», albo w sekcji «Menu mobilne: Aplikacja» na karcie «Filtr wyszukiwania».
Np. po dodaniu produktu do koszyka funkcja jest wywoływana callback_hotengine_cart_plus_after, jeśli istnieje
if(typeof(callback_hotengine_cart_plus_after) === "function"){
callback_hotengine_cart_plus_after();
}
Aby uruchomić własny skrypt funkcji callback_hotengine_cart_plus_after, musisz go utworzyć.
function callback_hotengine_cart_plus_after(){
// twój scenariusz
}
Lista niektórych dostarczonych funkcji `Callback`:
callback_hotengine_ajax_load_products_list - po załadowaniu listy produktów (uniwersalna funkcja w każdym przypadku ładowania listy produktów przez skrypt)
callback_hotengine_ajax_load_products - po załadowaniu listy produktów, po naciśnięciu przycisku "Pokaż więcej".
callback_hotengine_shop_products_list_div_button - po przewinięciu listy produktów w slajdzie
callback_hotengine_shop_page_boughtwith_loaded($id) - po załadowaniu listy, "z towarem kupują" ($id-ID załadowanych towarów)
Sklep / Opis automatyczny
callback_hotengine_shop_autodescription($type) - po wyświetleniu opisu automatycznego ($type - html,ajax)
callback_hotengine_shop_autodescription_readmore($id,$job) - po załadowaniu rozwiniętego tekstu opisu automatycznego ($job - show,hide,load)
Sklep / Koszyk
callback_hotengine_cart_plus - po wysłaniu żądania dodania towaru do koszyka
callback_hotengine_cart_addresult($result,$item_id) - po dodaniu towaru do koszyka, różne warianty wyniku ($result-wartość wyniku. Wartości: "added" - dodany, "removed" - usunięty, "instock_smaller" - pozostałość mniejsza niż dodawana, "instock_smaller_exists" - pozostałość mniejsza niż już dodana do koszyka)
callback_hotengine_cart_plus_after($items_in_cart) - po dodaniu towaru do koszyka ($items_in_cart - liczba towarów w koszyku po wykonaniu)
callback_hotengine_cart_plus_after_boughtwith($ids) - po dodaniu towaru do koszyka przesyła listę "Z towarem kupują" w zmiennej $ids
callback_hotengine_cart_plus_after_boughtwith_email($ids) - po dodaniu towaru do koszyka przesyła "Listę do wysyłki" w zmiennej $ids (E-mail do wysyłki innych towarów)
callback_hotengine_cart_count_product_num - po wyborze produktu do zmiany jego ilości w koszyku
Sklep / Wariant
callback_hotengine_shop_product_variaty_select - po wyborze wariantu
callback_hotengine_variety_change_price($price) - po wyborze wariantu i zmianie ceny ($price - nowa cena)
callback_hotengine_variety_change_sku($sku) - po wyborze wariantu i zmianie kodu towaru ($sku - nowy sku)
callback_hotengine_variety_change_skuimage($img) - po wyborze wariantu, jeśli podano nowe zdjęcie ($img - nowa ścieżka do zdjęcia)
callback_hotengine_variety_change_stock_count($stock) - po wyborze wariantu i zmianie ilości w magazynie ($stock - nowa ilość w magazynie). Ta funkcja nie jest inicjowana, jeśli nie została stworzona, ponieważ nie zawsze konieczne jest zmienianie ilości towaru w magazynie.
callback_hotengine_variety_require() - jeśli nie wybrano wariantu, przed wywołaniem okna dialogowego wiadomość
callback_hotengine_variety_require_list($href) - jeśli nie wybrano wariantu, przed wywołaniem okna dialogowego z wiadomością, przy przeglądaniu listy towarów ($href - link do przeglądania karty towaru)
Sklep / Ulubione / Porównaj
callback_hotengine_favorite_addresult($result,$count_favorite) - po dodaniu towaru do ulubionych, różne warianty wyniku ($result-wartość wyniku. Wartości: "added" - dodany, "removed" - usunięty; $count_favorite - liczba towarów w ulubionych)
callback_hotengine_compare_plus() - po dodaniu towaru do listy porównawczej
Sklep / Wyszukiwanie
callback_hotengine_shop_catalog_product_types - po wyborze typu produktu w filtrze wyszukiwania
Sklep / Stan
callback_hotengine_shop_product_stock_inform- po wywołaniu okna "Poinformuj o dostępności"
callback_hotengine_shop_product_stock_inform_send - po wysłaniu żądania "Poinformuj o dostępności"
Sklep / Dostawa
callback_hotengine_loading_delivery_type - po wyborze sposobu dostawy
callback_hotengine_loading_delivery_type_finalvalues - po wyborze sposobu dostawy wartości końcowe
Użytkownik
callback_hotengine_authorize_result($result) - funkcja po autoryzacji użytkownika ($result - rezultat wykonania: 2-błąd logowania lub hasła, 3-konto zablokowane, 4-konieczna aktywacja,5-Aktywacja powiodła się,6-Niepoprawny kod Captcha)
Sklep / Statystyki sprzedaży
callback_hotengine_statisticsell_printorder($a) - po wywołaniu okna wydruku zamówienia. $a=1 - przed wyświetleniem okna. $a=2 - po wyświetleniu okna.
Blog
callback_hotengine_blog_page_list_div_button - po przewinięciu listy artykułów w slajdzie
Dialog
callback_hotengine_dialog_email- po wywołaniu okna dla informacji zwrotnej
callback_hotengine_form_submit_result($a) - po wysłaniu formularza przez okno dialogowe. $a=0 - błąd. $a=1 - ok.
Mobilny
callback_hotengine_mobilemenu_click($a,$href) - naciśnięcie na linki w mobilnym menu. $a=0 - linki punktów i górne ikony. $a=1 - linki podkategorii. $a=2 - po wyświetleniu okna ajax z treścią.
callback_hotengine_mobilemenu_show - funkcja wyświetlania zawartości menu mobilnego (w celu stworzenia efektu wyglądu). Domyślny $("#hotengine-mobile-outer").show(0);
Większość rozwiązań możesz zaimplementować za pomocą skryptów (JavaScript). Niektóre z nich są opisane na stronie instrukcji, inne na stronie ustawień. Dodatkowo na stronie można znaleźć gotowe rozwiązania Skrypty do użytku na stronach internetowych.
Dostępne formaty:
- Sitemap.xml Mapa witryny ze wszystkimi danymi
- XML Google Merchant (Rozszerzone i skrócone)
- XML Yandex Market
- CSV Price
- JSON Wszystkie dane katalogowe sklepu
- Cena za Hotline.ua + marża własna
- Cennik dla Prom.ua + marża własna
- XML dla Rozetka.ua + marża własna
Generator i lista linków dostępnych w panelu administracyjnym - «XML/CSV/XLS/JSON»
Dodatkowo przy rozładunku towaru możesz określić opcje sortowania i filtrowania według poniższych parametrów:
- sort_by - sortowanie
- order_by - sortowanie
- sort_instock_priority - priorytet sortowania
- price_from – Cena od
- price_to – cena do
- producer – producent (jedna lub więcej wartości oddzielonych przecinkami)
- stock - obecność
- collection - kolekcja (jedna lub więcej wartości oddzielonych przecinkami)
- pers_shop_cat_page_catid - ID kategorii sklepu (co najmniej jedna wartość oddzielona przecinkami)
Parametry można podać jako zmienną GET, po głównej ścieżce do pliku XML. Na przykład «ścieżka.xml?producent=1» Możesz znaleźć opcje wartości na stronie importu produktu w instrukcjach.
Aby to zrobić, określ nasze serwery NS w ustawieniach swojej domeny:
NS1.HOTLIST.BIZ
NS2.HOTLIST.BIZ
Lub adres IP 88.218.28.193 we wpisie «A» rekord.
W takim razie skontaktuj się z nami za pomocą formularza opinii . W żądaniu podaj witrynę, do której chcesz podłączyć domenę *, oraz adres tej domeny.
* - nie sprzedajemy domen, aby podłączyć swoją domenę, musisz wstępnej rejestracji/zakupu.
Domeny w strefie .RU nie są obecnie obsługiwane.
SSL
SSL oznacza Secure Socket Layer i jest standardową technologią bezpieczeństwa internetowego, która służy do zapewnienia szyfrowanego połączenia między serwerem (stroną) a przeglądarką. Certyfikat SSL pozwala nam korzystać z protokołu HTTPS (po podłączeniu certyfikatu SSL Twoja strona nie otworzy się przez HTTP, ale przez protokół HTTPS).Co to jest HTTPS?
HTTPS (Hypertext Transport Protocol Secure) – jest to protokół zapewniający bezpieczeństwo i prywatność w wymianie informacji pomiędzy serwisem a urządzeniem użytkownika. Odwiedzający serwis oczekują, że podane przez nich dane nie wpadną w ręce oszustów. Aby chronić dane, które odwiedzający zostawiają w Twojej witrynie, zacznij korzystać z protokołu HTTPS.Jak podłączyć certyfikat SSL
Możesz podłączyć nasz certyfikat SSL przy płaceniu za hosting, zaznaczając pole «SSL certyfikat».
Ponadto możesz podłączyć certyfikat SSL dla swojej domeny, kupując go od dowolnego rejestratora. Koszt podłączenia i korzystania z certyfikatu wynosi 1 USD miesięcznie (minimalny okres płatności to 12 miesięcy).
Dla sklepu internetowego wystarczy certyfikat Comodo Positive SSL.
Płatne połączenie SSL.
Możesz podłączyć usługę pocztową Google.com, Zoho.com, Yandex, Mail.ru i inne do swojej domeny.
2)Wybierz odpowiedni plan, np. 5GB - ZA DARMO, za darmo
3) Dodaj swoją domenę @twojadomena. W celu weryfikacji musisz utworzyć zawijanie CNAME lub TXT w rekordach NS domeny. Możesz przesłać dane, a my je dodamy, lub wprowadź je samodzielnie. Prześlij zarówno dane TXT, jak i CNAME.
4) Dodaj rekordy MX z nazwą @ lub pustą nazwą.
Wartości w poniższej tabeli:
Host/ Domain | Address/ Mail Server/ MX Entries/ Value | Priority |
@/ Blank/ Domain name | mx.zoho.eu. | 10 |
@/ Blank/ Domain name | mx2.zoho.eu. | 20 |
@/ Blank/ Domain name | mx3.zoho.eu. | 50 |
5) W rekordach NS domeny utwórz wpis tekstowy o wartości "v=spf1 ip4:88.218.28.193 include:zoho.eu ~all"
6) Opcjonalnie możesz dodać Podpis DKIM https://www.zoho.eu/mail/help/adminconsole/dkim-configuration.html
7) Utwórz adresy e-mail i użytkowników.
8) Określ utworzoną skrzynkę jako serwer SMTP na stronie.
SMTP server: smtp.zoho.eu
Port: 465
Security Type: SSL
Lub
SMTP server: smtp.zoho.eu
Port: 587
Security Type: TLS
https://www.zoho.eu/mail/help/zoho-smtp.html.
Instrukcja podłączenia na www.zoho.eu.
Aby połączyć się z kanałem z powiadomieniem o nowych zamówieniach, musisz wysłać hotlist_viber_key (gdzie klucz to twój klucz) na kanał https://viber.com/hotlistbiz. Możesz udostępnić ten klucz i używać go z różnych urządzeń z Viber.
Możesz zainstalować klucz w "Ustawieniach", w zakładce "Powiadomienia". Alternatywnie można użyć klucza formularza, który można określić w Edytorze formularzy.
Aby wyłączyć powiadomienia, musisz albo zmienić klucze, albo wysłać DISABLE hotlist_key (gdzie klucz to Twoja strona lub klucz formularza) do Viber.
Aby połączyć się z kanałem z powiadomieniem o nowych zamówieniach, musisz wysłać hotlist_telegram_key (gdzie klucz to twój klucz) na kanał https://t.me/ hotlistbiz_bot. Możesz udostępnić ten klucz i używać go z różnych urządzeń z Telegramem.
Klucz możesz ustawić w "Ustawieniach", w zakładce "Powiadomienia". Alternatywnie można użyć klucza formularza, który można określić w Edytorze formularzy.
Aby wyłączyć powiadomienia, musisz albo zmienić klucze, albo wysłać DISABLE hotlist_key (gdzie klucz to Twoja witryna lub klucz formularza) do Telegrama.
Ten znacznik zawiera następujące dane:
data-hotengine-marking-type= typ strony
data-hotengine-marking-timestamp= data utworzenia strony
data-hotengine-marking-view= liczba wyświetleń
Dane są wymagane, jeśli chcesz wyłączyć lub wyświetlić dodatkowe dane, na określonej stronie, przy określonym typie strony lub jeśli potrzebujesz wyświetlić liczbę wyświetleń lub datę materiału (aktualność, artykuł, produkt). Dodatkowo, sprawdzając ten element, możesz znaleźć ID wpisu (strony, artykułu lub produktu), a także inne dodatkowe dane.
Jeśli potrzebujesz więcej danych w znacznikach, daj nam znać.
<span class="hotengine-marking" data-hotengine-marking-type="shop_catalog_page" data-hotengine-marking-timestamp="1422368197" data-hotengine-marking-view="6" data-hotengine-marking-shop_catalog_page_id="71111" data-hotengine-marking-shop_catalog_page_price="1" data-hotengine-marking-shop_catalog_page_price_currency="USD" data-hotengine-marking-shop_catalog_page_complectation="22323" data-hotengine-marking-video="https://youtu.be/tAyVrZ1jzC4">
Dodatkowo przy ustalaniu indywidualnych parametrów dostawy dodawane są kolejne atrybuty:
data-hotengine-marking-delivery="xxx"
data-hotengine-marking-delivery_price="xxx"
data-hotengine-marking-delivery_note="xxx"
W obecności wymiarów i wagi towarów dodaje się następujące atrybuty: data-hotengine-marking-shop_cat_page_deliv_width="XX"
data-hotengine-marking-shop_cat_page_deliv_height="XX"
data-hotengine-marking-shop_cat_page_deliv_length="XX"
data-hotengine-marking-shop_cat_page_deliv_units="XX"
data-hotengine-marking-shop_cat_page_deliv_weight="XX"
data-hotengine-marking-shop_cat_page_deliv_weight_units="XX"
data-hotengine-marking-shop_cat_page_deliv_capacity="XX"
Przykład skryptu sprawdzającego stronę pod kątem obecności obiektu znaczników i typu strony «shop_catalog_page» (strona karty produktu).
let product_marking = $(".hotengine-marking[data-hotengine-marking-type='shop_catalog_page']");
if(typeof product_marking !== typeof undefined && product_marking !== false && product_marking !='undefined' && product_marking !=''){
let product_id = product_marking.attr("data-hotengine-marking-shop_catalog_page_id");
console.log("ID PRODUCT IS "+product_id);
}
Jeśli strona jest zdefiniowana jako karta produktu, to wyodrębniamy ID produktu - data-hotengine-marking-shop_catalog_page_id.
Dostępne typy stron:
Shop:
- shop_catalog_page - karta produktu
- shop_catalog_page_incategory - karta produktu na stronie z listą *
- shop_catalog_page_incategory_search - karta produktu na stronie wyników wyszukiwania
- shop_catalog_page_cart_products_list - karta produktu w koszyku
- pers_shop_catalog_category - kategoria sklepu
- shop_catalog_category - kategoria sklepu w katalogu hotlist.biz
- shop_catalog_category_collection - kategoria kolekcji, sklep
- shop_catalog_category_producer - kategoria producenta, sklep
- shop_statistic_sale - statystyki sprzedaży
- shop_catalog_page_cart_bought_with - kup z towarem (podczas przeglądania koszyka)
- blog_catalog_page - artykuł
- blog_catalog_page_incategory – lista artykułów *
- news_catalog_page - Aktualności
- news_catalog_page_incategory - lista aktualności *
- news_catalog_page_incategory_menu - Blok/Menu, generowana lista wiadomości *
* - te obiekty listy mają dodane atrybuty mikroznaczników bez użycia oddzielnego elementu oznaczania hotengine.
Ponadto <HTML> znaczniki są dodawane dla użytkowników data-hotengine-marking-userid, z identyfikatorem użytkownika.
Jeśli użytkownik jest dodany jako «Klient» z własnym rabatem, to dodawany jest również znacznik data-hotengine-marking-user-group-discount z wielkością jego rabatu.
<html lang="pl" data-hotengine-marking-userid="USERID" data-hotengine-marking-user-group-discount="-10%">
pl - język strony
USERID - ID użytkownika
10% - rabat dla klienta.
Jeżeli użytkownik jest dodany do Grupy Klientów, to dodatkowo wskazywany jest ID grupy, do której należy.
<html lang="pl" data-hotengine-marking-userid="XXXXX" data-hotengine-marking-user-group-discount="-20%" data-hotengine-marking-user-group-id="XXXXX">
Ponadto do niektórych bloków witryny dodano znaczniki "data-hotengine-..." z dodatkowymi danymi.
Na przykład "data-hotengine-product-images-count" - ilość zdjęć produktu.
W koszyku znaczniki wskazują ilość towarów, koszt całkowity oraz walutę (data-hotengine-cart-count, data-hotengine-cart-total-price, data-hotengine-cart-currency)
Dodatkowe znaczniki, «data-» zaimplementowane bezpośrednio w elementach znaczników, na przykład element class="hotengine-categories-list-block" (blok ikon kategorii) może zawierać znaczniki: data-image="1" -wskazany jest obraz kategorii, data-child-cat="7" - liczba podkategorii data-child-items="5114" - Ilość produktów we wszystkich działach wewnętrznych, a także ilość podkategorii, data-cid="44" - ID kategorii. (data-cid - kategorie sklepu, data-pcid - kategorie producentów, data-ccid - kategorie kolekcji, data-bcid - kategorie katalogu artykułów)
W statystykach sprzedaży, przeglądając zamówienie osobno, pojawia się również mikronarzut.
Dodatkowe klocki w wózku: Jeśli produkt ma cenę hurtową, tworzony jest element SPAN .hotengine-shop-product-price_bulk_inform_block.
<span class="hotengine-shop-product-price_bulk_inform_block"><span class="hotengine-shop-product-price_bulk_inform_block_title"></span><span class="hotengine-shop-product-price_bulk_inform_original_price">100</span><span class="hotengine-shop-product-price_bulk_inform_original_price_bulk">100</span></span>
.hotengine-shop-product-price_bulk_inform_block_title - blok z tekstem "Cena hurtowa" (możesz zmienić za pomocą stylów CSS, treści).
.hotengine-shop-product-price_bulk_inform_block - blok informacji o zniżkach
.hotengine-shop-product-price_bulk_inform_original_price - cena
.hotengine-shop-product-price_bulk_inform_original_price_bulk - cena hurtowa
Jeśli produkt ma Promocję, tworzony jest element SPAN .hotengine-shop-product-price_sale_inform_block.
<span class="hotengine-shop-product-price_sale_inform_block"><span class="hotengine-shop-product-price_sale_inform_block_title"></span><span class="hotengine-shop-product-price_sale_inform_original_price">100</span><span class="hotengine-shop-product-price_sale_inform_original_price_old">120</span></span>
.hotengine-shop-product-price_sale_inform_block_title - blok z tekstem «Cena promocyjna» (możesz zmienić za pomocą stylów CSS, treści).
.hotengine-shop-product-price_sale_inform_block - blok informacji o zniżkach
.hotengine-shop-product-price_sale_inform_original_price - cena
.hotengine-shop-product-price_sale_inform_original_price_old - stara cena produktu (wyświetlana tylko jeśli wartość jest podana i różna od zera)
Każda strona posiada unikalne dane, np. może to być ID strony (artykuł, produkt, strona).
Poniżej znajduje się lista podstawowych danych dla Autokorekty.
{HOTENGINE-SC:current_page_id} - ID bieżącej strony (artykuły, strony, produkty, aktualności)
{HOTENGINE-SC:site_url} - URL Twojej witryny (adres)
{HOTENGINE-SC:lang} - Otwórz język strony
{HOTENGINE-SC:site_tagline} - Slogan strony internetowej
{HOTENGINE-SC:contacts} - Blokuj z kontaktami
{HOTENGINE-SC:slide_menu_widget:XX} - Blokuj za pomocą widżetu Menu slajdów
{HOTENGINE-SC:slider_widget:XX} — blok z widżetem suwaka
{HOTENGINE-SC:smart_search_widget:PARAM} - Blokuj z filtrem wyszukiwania widgetów
{HOTENGINE-SC:main_menu_widget} - Menu główne
{HOTENGINE-SC:langmenu} - zmiana języka
{HOTENGINE-SC:user_nickname} - Nazwa użytkownika (jeśli jest autoryzowana)
{HOTENGINE-SC:user_id} - ID użytkownika (jeśli jest autoryzowany)
{HOTENGINE-SC:user_login} - Login użytkownik (jeśli ma autoryzację)
{HOTENGINE-SC:user_discount} - Niestandardowy rabat
{HOTENGINE-SC:user_cashback} - Balansować Cashback
{HOTENGINE-SC:user_group_id} - ID grupy użytkowników
{HOTENGINE-SC:shop_cart_menu} - koszyk (Koszyk z blokami/menu)
{HOTENGINE-SC:favorites} - link do wybranych produktów
{HOTENGINE-SC:shop_compare_menu} - porównanie towarów
{HOTENGINE-SC:shop_cat_page_image} - Ścieżka do obrazu produktu (jeśli strona produktu jest otwarta)
{HOTENGINE-SC:shop_cat_page_id} - ID produktu (jeśli strona produktu jest otwarta). Możesz też użyć {HOTENGINE-SC:current_page_id}
{HOTENGINE-SC:shop_cat_page_sku} - Kod produktu (jeśli strona produktu jest otwarta)
{HOTENGINE-SC:shop_cat_page_currency} - Waluta produktu (skrócona) (jeśli strona produktu jest otwarta)
{HOTENGINE-SC:shop_cat_page_currency_iso} - Waluta produktu (ISO) (jeśli strona produktu jest otwarta)
{HOTENGINE-SC:shop_cat_page_price} - Cena produktu (jeśli strona produktu jest otwarta)
{HOTENGINE-SC:shop_cat_page_title} - Nazwa produktu
{HOTENGINE-SC:shop_cat_page_video} – Video URL (link do filmu)
{HOTENGINE-SC:pers_shop_cat_val_name} - Nazwa kategorii sklepu (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:pers_shop_cat_val_title} - Tytuł kategorii sklepu (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:pers_shop_cat_val_id} - ID kategorii sklepu (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:shop_cat_producer_val_name} - Nazwa kategorii producenta (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:shop_cat_producer_val_id} - ID kategorii dostawcy (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:shop_cat_collection_val_name} - Nazwa kategorii kolekcji (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:shop_cat_collection_val_id} - ID kolekcja kategorii (tylko wewnątrz kategorii i przycisku na liście podkategorii)
{HOTENGINE-SC:blog_cat_val_name} - Nazwa kategorii katalogu artykułów (tylko wewnątrz kategorii i przycissku na liście podkategorii)
{HOTENGINE-SC:blog_cat_val_id} - ID kategorii katalogu artykułów (tylko w przycisku kategorii)
{HOTENGINE-SC:blog_cat_page_id} - ID artykułu (tylko w katalogu artykułów)
{HOTENGINE-SC:blog_cat_page_title} - Tytuł artykułu (tylko w katalogu artykułów)
{HOTENGINE-SC:blog_cat_val_id} - ID kategorii katalogu artykułów (tylko wewnątrz kategorii i przycisku na liście podkategorii)
Możesz na przykład użyć tego kodu do wyświetlenia nazwy autoryzowanego użytkownika na stronie internetowej:
<span class="user_login_name">Witamy {HOTENGINE-SC:user_login}</span>
Możesz też użyć tego kodu do wygenerowania metadanych dla mediów społecznościowych (takich jak znaczniki Open Graph):
<meta property="og:image" content="{HOTENGINE-SC:shop_cat_page_image}"/>
<meta property="og:title" content="{HOTENGINE-SC:shop_cat_page_title}>
Przykład utworzenia linku do profilu autoryzowanego użytkownika:
https://hotlist.biz/{HOTENGINE-SC:lang}/users.php?p=user_profile&action=userprofile&userid={HOTENGINE-SC:user_id}
Jednym ze sposobów implementacji witryn wielojęzycznych jest użycie tasgu z atrybutem hreflang. Przykład takiego tagu:
<link rel="alternate" hreflang="lang_code" href="url_of_page" />
Na różnych stronach serwisu (kategorie, strony, artykuły, karty produktów i inne) zaimplementowana jest funkcja wielojęzyczności. Jeśli np. posiadasz dodatkową kartę produktu w języku angielskim, białoruskim, rosyjskim i ukraińskim, to wystarczy, że we wszystkich kartach produktów w komórce «Produkt w innych językach» wpiszesz tę samą wartość, np. «1». W takim przypadku podczas otwierania strony w jednym z języków zostaną dodane tagi hreflang z linkami do stron w innych językach. Zaleca się użycie identyfikatora pierwszej karty produktu, aby uniknąć zduplikowanych wartości i kolejnych błędów. Na przykład, jeśli dodałeś produkt «Trampki» o numerze identyfikacyjnym «12345», a następnie dodałeś podobny produkt w języku angielskim, w pozycji «Produkt w innych językach» podaj «12345».
Główny wybrany język strony zostanie oznaczony dodatkowym znacznikiem hreflang="x-default".
Aby utworzyć nagłówki dla katalogu artykułów lub sklepu, zalecamy użycie prefiksu języka. Na przykład nagłówek «sukienka» można utworzyć w innych językach za pomocą przedrostka «dress_ua», «dress_de», «dress_fr»…
Możliwe jest użycie tej samej ścieżki do kategorii w innych językach, jednak podczas importu danych, np. produktu, mogą wystąpić błędy, ponieważ platforma nie będzie w stanie rozpoznać języka kategorii, do której jest dodana. Dlatego zalecamy stosowanie przedrostków w działach z nagłówkami, katalogu artykułów i sklepie internetowym. W przypadku stosowania przedrostków językowych opisanych powyżej zmienna «Kategoria w innych językach» zostanie ustawiona automatycznie.
Podczas tworzenia kart produktów «Kod produktu» musi być unikalny, dlatego w innym języku możesz użyć np. własnych końcówek «SKU/CODE_EN». W przypadku określenia «Produkt w innym języku» to przy zmianie podstawowych danych (koszt, dostępność, nowość, bestseller, dostęp) zostaną również zaktualizowane wszystkie tagi produktów wskazane jako alternatywna wersja produktu głównego.
«Filtr wyszukiwania» i «Bloki / menu» mogą być używane jednocześnie dla wszystkich języków i można osobno określić język, w którym ma być wyświetlany. Na przykład utwórz «Blocks/Menu», nagłówek witryny i umieść go na wszystkich stronach, określając język «polski (pl)». Taki blok będzie się wyświetlał wszędzie tylko wtedy, gdy otwarta będzie polska wersja serwisu. W ten sam sposób możesz utworzyć nagłówek dla innych języków. Jeśli trzeba umieścić jakiś kod, to nie trzeba tworzyć takich «Bloków / menu» dla każdego języka, można określić język «Wszystkie (wszystkie)», a blok będzie wyświetlany niezależnie od wybranego języka gość.
Prefiks języka na platformie Hotlist.biz jest wskazany na początku, na przykład, «/pl/page.htm».
Przed importem musisz zapisać plik w formacie «XLS» lub «CSV». Po zaimportowaniu sprawdź, czy język nowych kategorii jest odpowiedni. Jeśli z jakiegoś powodu określono niewłaściwy język, zmień język głównej kategorii swojego katalogu, do którego zostały dodane, w sekcji «Sklep» - «Kategorie sklepu». We wszystkich podkategoriach podrzędnych język również zostanie zastąpiony. Jeśli nie ma wielu kategorii, możesz skopiować kategorie, zastępując w nich język i nazwę, w sekcji «Sklep» - «Kategorie sklepu».
Dokonaj importu, w dziale "Sklep" - "Importuj towary". Możesz szybko uzupełnić korespondencję komórek, klikając «Pola z pliku, określ korespondencję» - «Wypełnij wybór pól korespondencji zgodnie z plikiem eksportu (pola« Wyładuj wszystko )».
Dodatkowo w celu tworzenia poprawnych znaczników dla wyszukiwarek, a także przekierowania między produktami w różnych językach, w produktach głównego języka należy eksportować i ponownie importować poprzez skopiowanie wartości komórki «ID» do pola «Produkty w inne języki». (W tym przypadku można zaimportować tylko jedną komórkę «Produkt w innych językach» i określić identyfikator lub «Kod produktu», według którego zostaną znalezione produkty do nadpisania). Zatem zarówno nowe, jak i poprzednie utworzone produkty będą miały identyczne znaczenie «Produkt w innych językach».
Kod z poniższego przykładu generuje przycisk przełączania na alternatywne języki, a jeśli dla strony/artykułu/kartki produktu zostanie podana alternatywna wersja językowa, to zostanie ona aktywowana.
1) Wklej kod CSS do Edytora projektu, w zakładce CSS.
2) Dodaj JavaScript do bloku/menu, które jest wyświetlane na wszystkich stronach.
3) Wklej kod listy rozwijanej języka do bloku/menu, w którym chcesz go umieścić, na przykład w nagłówku witryny.
4) Usuń niepotrzebne języki z bloku (class hotengine-shop-select-language-val)
Kod menu wyboru języka:
<span class="hotengine-shop-select-language-box">
<span class="hotengine-shop-select-language" data-lang="pl"></span>
<span class="hotengine-shop-select-language-values">
<a class="hotengine-shop-select-language-val" data-lang="be"></a>
<a class="hotengine-shop-select-language-val" data-lang="de"></a>
<a class="hotengine-shop-select-language-val" data-lang="en"></a>
<a class="hotengine-shop-select-language-val" data-lang="es"></a>
<a class="hotengine-shop-select-language-val" data-lang="fr"></a>
<a class="hotengine-shop-select-language-val" data-lang="kk"></a>
<a class="hotengine-shop-select-language-val" data-lang="pl"></a>
<a class="hotengine-shop-select-language-val" data-lang="ru"></a>
<a class="hotengine-shop-select-language-val" data-lang="uk"></a>
</span>
</span>
CSS style:
/*LANGUAGE BLOCK*/
.hotengine-shop-select-language-box { display:inline-block; width:71px; height:auto; overflow:hidden; border:1px solid transparent; line-height:30px; position:relative; z-index:1000; }
.hotengine-shop-select-language { display:block; width:100%; text-align:center; cursor:pointer; }
.hotengine-shop-select-language-values { display:block; width:100%; vertical-align: top; position:absolute; background:rgba(255, 255, 255, 0.80); }
.hotengine-shop-select-language-box:hover{ overflow:visible;}
.hotengine-shop-select-language-values:hover .hotengine-shop-select-language-val{ position:relative; }
.hotengine-shop-select-language-val { width:auto; display:block; margin:0px; vertical-align:top; cursor:pointer; text-align:center; color:inherit; text-decoration:none; }
.hotengine-shop-select-language-val:hover {background:inherit;color:inherit;}
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="ru"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="ru"]:after { content: "RU"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="en"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="en"]:after { content: "EN"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="uk"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="uk"]:after { content: "UA"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="de"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="de"]:after { content: "DE"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="es"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="es"]:after { content: "ES"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="fr"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="fr"]:after { content: "FR"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="kk"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="kk"]:after { content: "KK"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="be"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="be"]:after { content: "BE"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="ro"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="ro"]:after { content: "RO"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="tr"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="tr"]:after { content: "TR"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="it"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="it"]:after { content: "IT"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="sk"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="sk"]:after { content: "SK"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="da"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="da"]:after { content: "DA"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="pl"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="pl"]:after { content: "PL"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="zh"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="zh"]:after { content: "ZH"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="hi"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="hi"]:after { content: "HI"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="ar"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="ar"]:after { content: "AR"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="pt"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="pt"]:after { content: "PT"; }
.hotengine-shop-select-language-box .hotengine-shop-select-language[data-lang="bn"]:after,
.hotengine-shop-select-language-box .hotengine-shop-select-language-val[data-lang="bn"]:after { content: "BN"; }
/*LANGUAGE BLOCK*/
Plik jest automatycznie pobierany na stronie, jeśli wskazane są dostępne języki:
<script type="text/javascript" src="/templates/scripts/hotengine-script-language.js"></script>
Zawartość pliku
Tekst jest rozdzielany za pomocą nadrzędnego atrybutu lang elementu html.
Przykład
html:lang(ru) .hotengine-form-feedback-yourname-title:after{ content:"Ваше имя:"; }
html:lang(en) .hotengine-form-feedback-yourname-title:after{ content:"Your name:"; }
html:lang(uk) .hotengine-form-feedback-yourname-title:after{ content:"Ваше ім'я:"; }
html:lang(de) .hotengine-form-feedback-yourname-title:after{ content:"Ihr name:"; }
html:lang(es) .hotengine-form-feedback-yourname-title:after{ content:"Su nombre:"; }
html:lang(fr) .hotengine-form-feedback-yourname-title:after{ content:"Votre nom:"; }
html:lang(kk) .hotengine-form-feedback-yourname-title:after{ content:"Сіздің атыңыз:"; }
html:lang(be) .hotengine-form-feedback-yourname-title:after{ content:"Ваша імя:"; }
html:lang(ro) .hotengine-form-feedback-yourname-title:after{ content:"Numele dvs.:"; }
html:lang(tr) .hotengine-form-feedback-yourname-title:after{ content:"Adınız:"; }
html:lang(it) .hotengine-form-feedback-yourname-title:after{ content:"Il tuo nome:"; }
html:lang(sk) .hotengine-form-feedback-yourname-title:after{ content:"Vaše meno:"; }
html:lang(da) .hotengine-form-feedback-yourname-title:after{ content:"Dit navn:"; }
html:lang(pl) .hotengine-form-feedback-yourname-title:after{ content:"Twoje imię:"; }
html:lang(zh) .hotengine-form-feedback-yourname-title:after{ content:"你的名称:"; }
html:lang(hi) .hotengine-form-feedback-yourname-title:after{ content:"आपका नाम:"; }
html:lang(ar) .hotengine-form-feedback-yourname-title:after{ content:"اسمك:"; }
html:lang(pt) .hotengine-form-feedback-yourname-title:after{ content:"Seu nome:"; }
html:lang(bn) .hotengine-form-feedback-yourname-title:after{ content:"আপনার নাম:"; }
Jak przetłumaczyć całą witrynę?
Tworząc witrynę wielojęzyczną, określ język w tworzonych treściach (strona, menu, kategorie...)
I użyj ścieżek językowych na początku, /pl/ /en/ ...
Głównym językiem będzie język określony podczas rejestracji na stronie.
Podczas dodawania produktów język ustalany jest zgodnie z kategorią, w której jest dodawany.
Większość elementów na stronie możesz zastąpić stylami CSS i pseudoelementami.
Napisy o liczbie towarów
html:lang(pl).hotengine-shop-product-price_for-lang-1:after{ content:"za 1 sztukę";}
Zastąp liczbę lang-1, gdzie 1 oznacza wybraną jednostkę miary, a (pl) to język.
Lista wartości:
- 1 - 1 sztuka;
- 2 - 100 sztuk;
- 3 - 1000 sztuk;
- 4 - za 1 opakowanie;
- 5 - 1 kg;
- 6 - 1000 kg;
- 7 - 1 m2;
- 8 - za 1 metr;
- 9 - za 1 km;
- 10 - za zestaw;
- 11 - za 1 godzinę;
- 12 - za 1 dzień;
- 13 - za 1 miesiąc;
- 14 - za 1 rok;
- 15 - za 100 jednostek;
- 16 - za akr;
- 17 - za hektar;
- 18 - za działkę;
- 19 - za obiekt;
- 30 - za 1 ml;
- 31 - za 1 litr;
- 32 - za 1 km3;
- 33 - za 1 m3;
- 34 - za 1 dm3;
- 35 - za 1 cm3;
- 36 - za 1 mm3;
- 37 - za 1 hl;
- 38 - za 100 gramów;
- 39 - 1 funt;
- 40 - za 1 gram;
- 41 - za 10 kg;
- 42 - za 1 kwintal;
- 43 - za 1 tonę;
- 44 - za 1 ar;
- 45 - za 1 parę;
- 46 - za 1 tuzin;
- 47 - za 1 galon;
- 48 - za 1 beczkę;
- 49 - za 1 minutę;
- 50 - za 1 tydzień;
- 51 - za 1 usługę;
- 52 - za 1 podróż;
- 53 - za 1 osobę;
- 54 - za 1 maszynę;
- 55 - za 1 metr bieżący;
<script>
$(document).ready(function(){ $("#hotengine-shop-cart-form .hotengine-form-submit input[type='submit']").val('Wyślij zamówienie'); });
</script>
Tłumaczenie odbywa się za pomocą narzędzia Tłumaczenie wartości charakterystycznych.
Możesz także tłumaczyć za pomocą JavaScript. Jednak przy takim tłumaczeniu XML charakterystyka zostanie przesłana do MarketPlac w jednym języku.
Weźmy na przykład tłumaczenie z angielskiego na polski.
W takim przypadku, aby przesłać XML do MarketPlac, użyj głównego języka filtra wyszukiwania.
Główne bloki witryny
ID i Class główne bloki witryny.#hotengine-wrapper
#hotengine-header
#hotengine-footer
|
* - Główny wewnętrzny blok z treścią jest realizowany za pomocą CSS Grid:
Za pomocą wskaźnika myszy możesz zmienić wysokość nagłówka strony, rozmiar logo, położenie menu głównego oraz slogan.
Jak stworzyć własny projekt nagłówka strony internetowej?
Utwórz Blok/Menu znajdujący się w Nagłówku (Nagłówku strony) i umieść w nim niezbędne elementy. Na przykład Div z numerem telefonu i Div z nazwą firmy (nie zapomnij nadać im odpowiedniej klasy lub identyfikatora, aby można było się do nich później odwołać).
Otwórz edytor projektu, ustaw położenie i właściwości projektowe tworzonych elementów w stylach CSS.
W ten sam sposób możesz stworzyć dowolne elementy graficzne na stronie i umieścić je w potrzebnych miejscach.
Wewnątrz tych bloków będzie utworzona treść lub menu.
Każdy «typ strony» wyróżnione odpowiednim blokiem, z nadaniem określonego identyfikatora.
Na przykład:
- Strony - #hotengine-content-page
- Aktualności - #hotengine-content-news
- Katalog artykułów - #hotengine-content-blog
- Katalog produktów - #hotengine-content-shop
- Katalog produktów (producenci) - #hotengine-content-shop
- Katalog produktów (kolekcje) - #hotengine-content-shop
Ten blok jest tworzony wewnątrz elementu #hotengine-content
Ponadto na stronach kategorii, na których znajduje się podrzędna lista stron, dodawana jest klasa:
- Katalog produktów — .hotengine-content-shop-category
- Katalog produktów (kolekcja) - .hotengine-content-shop-collection
- Katalog produktów (producenci) - .hotengine-content-shop-producer
- Katalog artykułów - .hotengine-content-blog-category
- Katalog wiadomości — .hotengine-content-news-category
Dodatkowo dla bloków/menu listy aktualności lub artykułów tworzony jest dodatkowy blok:
Menu ostatnich artykułów - #hotengine-content-menu-lastblogpost
Menu najnowszych wiadomości #hotengine-content-menu-lastnewspost
Jeśli używasz dołączonego szablonu, jego style mają pierwszeństwo przed niektórymi z powyższych wartości. Przed użyciem szablonu wtyczki zalecamy zresetowanie projektu do wartości domyślnej.
Css style domyślne: CSS plik Bloki strony głównej
Jeśli przesunięcia i pozycjonowania elementów nie można wykonać za pomocą CSS, możesz użyć Javascript i przesuwać obiekty po stronie.
Zmiana położenia niektórych elementów za pomocą Javascript.
<script type="text/javascript">
$(function(){
let newproducer = $(".hotengine-shop-product-desc-block .hotengine-shop-product-producer").html();
if(typeof newproducer !== typeof undefined && newproducer !== false && newproducer !='undefined' && newproducer !=''){
$(".hotengine-shop-product-desc-block .hotengine-shop-product-producer").hide();
$(".hotengine-shop-product-sku-box").after('<span class="hotengine-shop-product-producer">'+newproducer+'</span>');
}
});
</script>
W tym przykładzie sprawdzamy, czy producent jest określony. Jeśli producent jest określony, ukryj go i umieść za polem «Kod produktu».
«Zawijanie» elementów za pomocą Javascript.
<script type="text/javascript">
$(function(){
$(".element").wrap("<div class='new'></div>");
});
</script>
W rezultacie obiekt z elementem klasy zostanie «owinięty» w element div z klasą new (<div class="new"><span class="element"></span></div>)
Katalog szablonów - https://templates.hotlist.biz/
Możesz włączyć śledzenie odwiedzających Google Analytics na stronie Ustawienia, w zakładce Statystyki/Google Analytics.
Tagi śledzenia będą wysyłać standardowe zdarzenia e-commerce dla Google Analytics 4 lub Google Tag Manager. Dodatkowo na stronie realizacji zamówienia lub przesłania formularza możesz dodatkowo ustawić własne kody konwersji.
Opisy zdarzeń:
Google Analytics 4: https://developers.google.com/analytics/devguides/collection/ga4/events
Google Tag Manager: https://developers.google.com/tag-platform/gtagjs
Ponadto będziesz mógł zaimplementować transfer własnych tagów za pomocą JavaScript, Shortcodes i Mikroznakowanie hotengine-markers, które umożliwiają zastępowanie danych dynamicznych.
- add_to_cart - dodanie produktu do koszyka
- add_to_wishlist - dodanie produktu do ulubionych
- begin_checkout - początek kasy
- purchase – udane zamówienie
- remove_from_cart – usunięcie towaru z koszyka
- search – Wyszukiwanie w witrynie
- select_item – wybór rodzaju produktu
- generate_lead - wyślij dane przez formularz
- sign_up - rejestracja
- view_cart - wyświetl koszyk
- view_item - wyświetl kartę przedmiotu
ID śledzenia Facebook Pixel można określić w ogólnych ustawieniach serwisu, w zakładce «Statystyki». Piksel będzie przesyłał dane o wizytach na stronie (PageView), zdarzeniach dodania produktu do koszyka (AddToCart), wyświetlenia produktu (ViewContent), rozpoczęcia (InitiateCheckout) i zakończenia kasy (Purchase). Koszt towarów jest tworzony w USD według kursu Twojej witryny.
Dodatkowo możesz utworzyć blok menu, aby samodzielnie wygenerować piksel z danymi produktu.
- Witryna jest dostępna do korzystania z ogonów poleceń. Podczas zamawiania towaru lub wysyłania listu za pośrednictwem informacji zwrotnej do listu zostanie dodana informacja o źródle przejścia na Twoją stronę. Również podczas używania końcówek UTM (Łącznik URL) dane te zostaną dodane do pisma.
Oprócz standardowych danych linkera dostępny jest podział źródeł na grupy, które wykorzystywane są w statystykach sprzedaży do wyodrębnienia źródeł i wygodniejszego obliczania konwersji. Wartość grupy można ustawić za pomocą zmiennej GET «hotengine_referral_group». Jeśli nie określono żadnej wartości, a podano utm_source, zostanie ona użyta do określenia grupy hotengine_referral_group.
Dane źródła odesłania mogą być ukryte w ustawieniach przeglądarki odwiedzającego lub przy użyciu bezpiecznego protokołu strony źródłowej. Dodatkowo możesz dodatkowo grupować zamówienia za pomocą zmiennej "shop_cart_statistic_group" w linku, lub ręcznie po złożeniu zamówienia.
Możesz włączyć ogony skierowań na stronie Ustawienia, w zakładce Statystyki.
Przykład linku ze znacznikami UTM:
https://hotlist.biz/?utm_source=google&utm_medium=cpc&utm_term=slova&utm_content=soderjimoe&utm_campaign=nazvnie
Przykład linku z automatycznym znacznikiem Yandex Direct i znacznikiem UTM:
https://hotlist.biz/?utm_source=yandex_{source_type}&utm_medium=cpc&utm_term={keyword}&utm_campaign=id:{campaign_id}&utm_content=ad:{ad_id}|gbid:{gbid}|phrase:{phrase_id}|param1:{param1}|position_type:{position_type}|position:{position}|source:{source}|source_type:{source_type}|param2:{param2}
Pełne instrukcje
Przykład linku z automatycznym tagowaniem Google Adwords i znacznikami UTM:
https://hotlist.biz/?utm_source=google_adwords_{network}&utm_medium=cpc&utm_term={keyword}&utm_campaign={campaignid}&utm_content=creative:{creative}|from:{ifsearch:search}{ifcontent:content}|matchtype:{matchtype}|adgroupid:{adgroupid}|feeditemid:{feeditemid}|targetid:{targetid}|device:{device}|adposition:{adposition}|placement:{placement}|network:{network}|param1:{param1}|param2:{param2}
Pełne instrukcje
Na podany adres zostanie wysłane zapytanie POST, zawierające wszystkie dane dotyczące zamówienia, w tym dane kontaktowe klienta oraz listę towarów. Dane kontaktowe i informacje o zamówieniu zostaną przesłane w formacie JSON, żądanie POST.
Na przykład w 1s możesz zaimplementować przyjmowanie zamówień przez «HTTP usługa»->«SiteExchange» -> «POSTData»
Na podany adres zostanie wysłane żądanie POST ze wszystkimi danymi zamówienia, które uległy zmianie w Statystyce sprzedaży. Informacje zostaną przesłane żądaniem POST w formacie JSON.
Na przykład w 1s możesz zaimplementować przyjmowanie zamówień przez «HTTP usługa»->«SiteExchange» -> «POSTData»
Ponadto możesz włączyć zewnętrzny dostęp do swoich statystyk, określając «Klucz dostępu do statystyk sprzedaży».
Określ klucz dostępu do statystyk sprzedaży w ustawieniach, w zakładce «Sklep»;. Jeśli potrzebujesz uzyskać dostęp do statystyk sprzedaży przez zewnętrzną aplikację, możesz wykonać żądanie (POST/GET lub AJAX) do «/ajax.php?statistic_sell»
W takim przypadku musisz podać klucz w żądaniu z szyfrowaniem MD5. Na przykład, jeśli masz klucz «123», wtedy w zapytaniu będzie «202cb962ac59075b964b07152d234b70».
W takim przypadku prośba będzie wyglądać następująco: «/ajax.php?statistic_sell&key=202cb962ac59075b964b07152d234b70»
W żądaniu możesz określić dane do sortowania lub wyszukiwania (parametry GET / POST), które możesz pobrać ze swojej strony statystyk sprzedaży w centrum administracyjnym (/page.php?p=statistic_sell&mystat). Sortowanie i selekcja parametrów odbywa się za pomocą żądania GET/POST, na przykład, «&sort_dateperiod=1week» oznacza, że będą wyświetlane tygodniowe statystyki sprzedaży.
Dane są wyświetlane w formacie JSON.
Pamiętaj, że jeśli korzystasz z żądań stron otwartych dla odwiedzających, będą oni mogli uzyskać dostęp do Twoich statystyk sprzedaży za pomocą Twojego klucza .
Określ klucz dostępu do cennika sklepu w ustawieniach, w zakładce «Sklep». Pełna wersja cennika do pobrania znajduje się pod adresem «/csv_export_products.csv»
W takim przypadku musisz podać klucz w żądaniu z szyfrowaniem MD5. Na przykład, jeśli masz klucz «123», wtedy w zapytaniu będzie «202cb962ac59075b964b07152d234b70».
В таком случае запрос будет выглядеть так: «/csv_export_products.csv?key=202cb962ac59075b964b07152d234b70»
W żądaniu możesz określić dane do sortowania i wybierania pól, które możesz pobrać na swojej stronie eksportu w centrum administracyjnym (/page.php?p=submit_catalog_page&subpage&export_from_shop). Sortowanie i selekcja parametrów odbywa się za pomocą żądania GET/POST, na przykład, «&export_product_access=export_product_access» oznacza, że wyładuje pole z danymi o dostępie do produktu.
Dane są wyświetlane w formacie CSV.
Przesyłany plik jest zapisywany w pamięci podręcznej w celu zmniejszenia obciążenia i jest aktualizowany raz dziennie. Możesz usunąć pamięć podręczną za pomocą przycisku «Wyczyść pamięć podręczną przesyłania plików XML/CSV».
Przykład: https://blog.hotlist.biz/csv_export_products.csv?key=202cb962ac59075b964b07152d234b70
Ponadto wdrożono mechanizm wymiany danych za pośrednictwem API, podobny do WooCommerce API. API umożliwia otrzymywanie i aktualizowanie informacji o zamówieniach i produktach, a także kategoriach. Instrukcje i ustawienia w sekcji «Sklep» - «Wymiana danych API Json».
Commerce API — Krótki przewodnik po metodach
Klucz dostępu
Aby korzystać z API, potrzebny jest klucz dostępu (Consumer Secret), który tworzysz w sekcji „Ustawienia”, „Sklep”, „Dostęp do statystyk sprzedaży”. Klucz generowany jest na podstawie klucza dostępu do statystyk sprzedaży.
Metody API (HTTP)
Wszystkie zapytania wykorzystują bazowy URL Twojej strony, na przykład: https://site.com/api/commerce/
lub https://site.com/wp-json/wc/v3/
1. Statystyki sprzedaży
Metoda | URL | Opis |
---|---|---|
GET | /orders | Pobierz statystyki zamówień |
GET | /orders/{id} | Pobierz pojedyncze zamówienie według ID |
DELETE | /orders/{id} | Usuń zamówienie według ID |
POST | /orders | Dodaj nowe zamówienie |
UPDATE | /orders/{id} | Zaktualizuj zamówienie (PATCH/PUT/UPDATE) |
2. Produkty
Metoda | URL | Opis |
---|---|---|
GET | /products | Pobierz listę produktów |
GET | /products/{id} | Wyświetl pojedynczy produkt według ID |
POST | /products | Masowe dodawanie nowych produktów |
DELETE | /products/{id} | Usuń produkt według ID |
3. Kategorie sklepu
Metoda | URL | Opis |
---|---|---|
GET | /products/categories | Pobierz listę kategorii produktów |
GET | /products/categories/{id} | Pobierz kategorię według ID |
4. Sortowanie i paginacja
Dla metod /orders
i /products
dostępne są parametry stronicowania i sortowania:
Parametry paginacji
Parametr | Typ | Opis |
---|---|---|
page | int | Numer strony (domyślnie 1) |
per_page | int | Liczba elementów na stronę (domyślnie 90, maksymalnie 2000) |
Parametry sortowania
Parametr | Typ | Dozwolone wartości | Opis |
---|---|---|---|
orderby | string | id , title , price , date , views | Pole do sortowania |
order | string | asc , desc | Kierunek sortowania |
Opcje językowe
Parametr | Тип | Dozwolone wartości | Opis |
---|---|---|---|
l | string | ru , ua , en , de , fr , es , it , pl | Język wyświetlania wartości |
Dodatkowo dla zamówień
Można filtrować zamówienia według daty i statusu:
?after=YYYY-MM-DD
— Data początkowa (format ISO)?before=YYYY-MM-DD
— Data końcowa?status=pending|processing|on-hold|completed|cancelled|0|1|2|3|5|6|7|8
— Status zamówienia (można podać status WooCommerce lub kod liczbowy)0
— Oczekujące (pending)1
— W trakcie realizacji (processing)7
— Wstrzymane (on-hold)3
— Zrealizowane (completed)8
— Zrealizowane i zakończone (completed)2
— Anulowane (cancelled)5
— Anulowane: brak na stanie (cancelled)6
— Anulowane: odrzucone (cancelled)?show_deleted=1
— Pokaż usunięte (ukryte) zamówienia
Przykłady
GET /orders?page=2&per_page=100&after=2024-06-01&before=2024-06-30
GET /products?orderby=price&order=asc&per_page=50
Przykład autoryzacji
W zapytaniu należy podać klucze:
?consumer_secret=TWOJ_SEKRET (uwaga, nie udostępniaj tego klucza publicznie!)
Lub przez nagłówek Authorization
z OAuth 1.0a.
Dodaj nowe zamówienie (POST /orders)
Aby utworzyć nowe zamówienie przez API, wyślij żądanie POST na /orders
z treścią JSON.
Minimalnie musisz podać:
email
— Email klienta (wymagane!)line_items
— Lista produktów do dodania
Parametry zamówienia
Podczas tworzenia zamówienia możesz podać dodatkowe pola, na przykład:
{
"first_name": "Imię",
"last_name": "Nazwisko",
"email": "alex@example.com",
"phone": "+487001112233",
"address": "Pełny adres jeśli nie używasz eform",
"buyer_address_eform1": "Województwo",
"buyer_address_eform2": "Miasto",
"buyer_address_eform3": "Ulica",
"buyer_address_eform4": "Numer domu",
"buyer_address_eform5": "Mieszkanie",
"postcode": "01-001",
"total": "999",
"status": "processing",
"status_for_customer": "processing",
"line_items": [ ... ]
}
Opis pola total
:
total
— końcowa kwota zamówienia (ciąg lub liczba). Jeśli podana, będzie użyta jako ostateczna cena zamówienia.- Jeśli
total
nie jest podane, kwota zamówienia zostanie automatycznie obliczona na podstawie sumyline_items
. - Pole
total
nie jest wymagane i może być użyte do zamówień bez produktów.
Format line_items
Parametr line_items
to tablica produktów. Każdy produkt to obiekt z następującymi polami:
"line_items": [
{
"product_id": 478734,
"quantity": 1,
"price": 100,
"currency": "USD"
},
{
"product_id": 478268,
"quantity": 10,
"variation": "51"
},
{
"product_id": 478266,
"quantity": 1,
"variation_id": 735302
}
]
- product_id — ID produktu (wymagane!).
- quantity — Ilość sztuk (wymagane!).
- price — (opcjonalne) Jeśli podana cena — będzie użyta ta wartość zamiast ceny wyliczonej na stronie.
- currency — (opcjonalne) Waluta konkretnego produktu (np.
USD
lubPLN
). Jeśli podana i różna od głównej waluty zamówienia (currency
), system automatycznie przeliczy cenę. - variation_id — ID wariantu produktu — sposób wskazania wariantu, jeśli istnieje.
- variation — Nazwa lub kod wariantu — używane, jeśli nie ma
variation_id
. Jeśli podane oba — priorytet mavariation_id
.
Ważne: Jeśli główna waluta zamówienia (currency
) nie jest podana — użyta zostanie domyślna waluta sklepu.
Jeśli waluta produktu różni się od głównej — cena zostanie przeliczona automatycznie.
Aktualizacja produktów
Aktualizacja produktu odbywa się przez HTTP UPDATE
(lub PATCH/PUT) z użyciem URL z ID lub SKU produktu, albo wielu produktów jednym żądaniem:
/products/{id}
— aktualizacja produktu po ID/products/sku/{sku}
— aktualizacja produktu po kodzie SKU/products
— masowa aktualizacja wielu produktów (do 5000 w jednym żądaniu)
Przy masowej aktualizacji ścieżka /products
nie zawiera ID ani SKU. W tym przypadku należy przesłać tablicę obiektów produktów w parametrze products
. Każdy element musi zawierać co najmniej id
lub sku
. Jeśli podane jest id
, ma ono priorytet i może zastąpić sku
. Jeśli id
nie jest podane, wyszukiwanie odbywa się po sku
.
Aktualizacja przesyła pełny zestaw danych produktu w formacie JSON. Wszystkie przesłane dane zastępują istniejące wartości, w tym:
- Główne właściwości produktu (nazwa, opis, ceny, status itp.)
- Atrybuty
- Warianty
- Obrazy
- Kategorie i tagi
- Ustawienia dodatkowe i meta pola
Warianty są aktualizowane zgodnie z poniższym algorytmem dla każdego wariantu w tablicy variations
:
- Jeśli podane jest
id
, aktualizacja odbywa się po nim. - Jeśli
id
brak, ale podane jestsku
, aktualizacja odbywa się po kodzie. - Jeśli nie ma ani
id
, anisku
, ale jesttitle
, aktualizacja odbywa się po nazwie. - Jeśli wariant nie zostanie znaleziony, zostanie utworzony nowy z podanymi parametrami.
Aktualizacja po SKU jest wygodna, gdy ID wariantu nie jest znane, ale znany jest unikalny kod.
Przy aktualizacji wszystkie pola w JSON zastąpią aktualne wartości produktu; aby zachować dane bez zmian, po prostu ich nie wysyłaj.
- Duplikaty wariantów: jeśli w tablicy
variations
występują powtarzające się po SKU lub nazwie warianty — zostaną pominięte (ten sam wariant nie zostanie dodany dwa razy). - Główny obraz: w tablicy
images
obraz pod indeksem0
jest uznawany za główny. Jeśliimages[0]
nie istnieje lub nie jest przesłany — głównym zostanie pierwszy poprawnie załadowany obraz. - Maksymalna liczba obrazów: dla jednego produktu można przesłać maksymalnie 10 obrazów. Próba przesłania większej liczby spowoduje pominięcie nadmiarowych plików.
-
Zarządzanie obrazami:
- Usuwanie obrazów: aby usunąć obraz po indeksie, ustaw w tablicy
images
wartość"delete"
. Na przykładimages[2] = "delete"
usunie obraz o indeksie 2. Możesz jednocześnie usuwać i przesyłać, wskazując wiele kluczy:images[3] = "delete"
,images[1] = "https://..."
. - Puste indeksy: jeśli podasz pusty ciąg lub
false
, ten indeks zostanie pominięty bez błędu. - Nadpisanie obrazów: parametr
images_replace
: jeślitrue
, system nadpisze istniejące pliki obrazów pod podanymi indeksami (usunie stary plik i cache). Jeślifalse
lub brak — nadpisanie jest wyłączone. - Pomijanie zajętych indeksów: parametr
images_skip_index
: jeślitrue
, a indeks jest zajęty i nadpisanie jest wyłączone — system znajdzie kolejny wolny indeks i zapisze tam plik. Jeślifalse
lub brak — indeks jest brany dokładnie jak podany. - Nowy indeks przy konflikcie: parametr
images_replace_new_index
: jeślitrue
, a indeks jest zajęty i zarówno nadpisanie, jak i auto-pomijanie są wyłączone — plik zostanie zapisany pod nowym wolnym indeksem. Jeśli wszystkie trzy parametry tofalse
lub brak i indeks jest zajęty — plik nie zostanie przesłany.
- Usuwanie obrazów: aby usunąć obraz po indeksie, ustaw w tablicy
Parametry produktu
Dostępne wartości można zobaczyć w przykładowym kodzie poniżej. Znajdują się tam również dodatkowe wyjaśnienia niektórych wartości, które mogą być przydatne.
-
Dostępne wartości
price_for
Dla każdego produktu można określić parametr
price_for
, który ustala jednostkę rozliczeniową ceny. Dozwolone jest użycie kodu liczbowego lub tekstu (na przykład „Za 1 kg”). Oto pełna lista wartości:Można użyć wartości liczbowej lub tekstowej — system automatycznie rozpozna i przypisze właściwy kod.
-
Dostępne wartości
stock_status
Dla każdego produktu możesz ustawić parametr
stock_status
, który określa status dostępności produktu i jego zachowanie na stronie. Można użyć kodu liczbowego lub słowa kluczowego — system rozpoznaje obie wersje.Można podać wartość liczbową lub tekst — system automatycznie rozpozna i przekształci na odpowiedni kod.
Jeśli dla produktu ustawiono
3
, zostanie on ukryty na liście produktów na stronie. Jeśli ustawiono4
, produkt będzie widoczny, ale nie będzie można go dodać do koszyka. Opcja5
informuje kupującego, że dostępność należy potwierdzić. -
Promocja i dostępne wartości
promotion_expires_job
Dla każdego produktu możesz ustawić parametr
promotion_expires_job
, który określa, co zrobić z promocją po upływie jej terminu.
Można użyć kodu liczbowego lub słowa kluczowego — system rozpoznaje obie wersje.Można podać wartość liczbową lub tekst — system automatycznie rozpozna i przekształci na odpowiedni kod.
Ważne: Aby aktywować licznik promocji, pamiętaj, aby ustawić
promotion
na1
— to oznacza, że promocja jest aktywna.Należy również podać datę zakończenia promocji w parametrze
promotion_expires
— można ją ustawić jako czas UNIX (np.time()
) lub w formacieYYYY-MM-DDTHH:MM:SS+00:00
(np.2025-06-28T00:00:00+00:00
).
Dodawanie produktów
Ta metoda pozwala dodać jeden lub kilka produktów jednym żądaniem (do 3000 w jednym żądaniu).
Format żądania jest identyczny jak przy aktualizacji: możesz przesłać tablicę products
lub pojedynczy produkt.
- Sprawdzanie ID: podczas dodawania nowego produktu pole
id
powinno być puste lub pominięte. Jeśliid
jest podane i produkt z tym ID już istnieje — system zaktualizuje ten produkt zamiast tworzyć nowy. - Sprawdzanie SKU: przed dodaniem system sprawdzi, czy istnieje produkt z tym SKU. Jeśli tak — zostanie zaktualizowany, a nie dodany ponownie.
Możesz dodać nowe produkty i zaktualizować istniejące jednym żądaniem.
To podstawowy opis głównych metod pracy z Commerce API / WooCommerce API v3 dla zamówień, produktów i kategorii.
Poniżej znajdują się przykładowe skrypty, które pomogą prawidłowo używać metod API w praktyce.
Więcej informacji o sposobach reklamy i promocji znajduje się na tej stronie. https://hotlist.biz/pl/user_guide_seo.html
Zalecamy włączenie «przekierowania z powiązaniem języka». Ta funkcja pomaga uniknąć duplikatów strony początkowej (duplikaty są szkodliwe dla SEO). Ze względu na fakt, że strona startowa domain.com i strona domena.com/pl/ w określonym języku to ta sama strona, zalecamy włączenie przekierowań 301 na stronę w określonym języku. Można to zrobić w Centrum administracyjnym, Ustawienia, Strona początkowa.
Jeśli planujesz używać własnej domeny, zalecamy tymczasowe ograniczenie dostępu do witryny i otwarcie jej po zakupie domeny.
Jeśli chcesz usunąć informacje o witrynie / firmie, otwórz stronę do zmiany informacji o witrynie / firmie i zaznacz pole «Usuń witrynę i wszystkie dane» u dołu. Po pewnym czasie informacje o firmie / stronie znikną z emisji wyszukiwarek.
Buforowanie plików multimedialnych
W oparciu o zalecenia wyszukiwarek i dla wygody odwiedzających włączyliśmy w Twojej witrynie «Kompresję danych» oraz Buforowanie plików graficznych i skryptów JavaScript. Czas pamięci podręcznej dla tych plików – jeden tydzień.Jeśli prześlesz nowy obraz na stary, zobaczysz stary obraz, dopóki pamięć podręczna przeglądarki nie zostanie wyczyszczona. Każda przeglądarka ma swój własny sposób czyszczenia pamięci podręcznej. Na przykład w Chrome, aby wymusić wyczyszczenie, musisz nacisnąć «CTRL + F5» w oknie przeglądarki, w Twojej witrynie.
Buforowanie serwera
Dodatkowo, aby przyspieszyć pracę serwisów, wdrożyliśmy również buforowanie niektórych danych tekstowych, które jest czyszczone automatycznie w przypadku ich zmiany. Jeśli jednak zmieniłeś zawartość strony/produktu/artykułu/menu, ale zmiany nie zostały wyświetlone na stronie, to musisz wymusić wyczyszczenie pamięci podręcznej za pomocą linku w panelu administracyjnym «Wyczyść pamięć podręczną» na stronie, na której zmiany nie były wyświetlane.Utrzymanie witryny i czyszczenie Buforowanie
Witryna przechowuje w pamięci podręcznej takie dane, jak «Typ produktu», «Promocje» (w tym licznik czasu), przesłane pliki «RSS/XML/CSV» oraz liczba produktów w kategorii. Aby wyczyścić pamięć podręczną RSS/XML/CSV, wybierz «XML/CSV/XLS/JSON» - «Wyczyść pamięć podręczną przesłanych plików XML/CSV» w panelu administratora.Aby przeliczyć odmiany, liczbę produktów w kategoriach i wyczyścić pamięć podręczną Promocji, przejdź do «Ustawień», «Sklepu» i na dole listy w pozycji «Przeliczanie produktów i kategorii» wybierz parametry niezbędne do ponownego obliczenia i konserwacji.
Ta procedura jest zalecana po większej aktualizacji danych w sklepie, zmianie kategorii, dodaniu i zmianie lub usunięciu dużej liczby odmian, dodaniu i zmianie kategorii, przeniesieniu tagów produktów do innych kategorii lub gdy timer wygasa w promocjach .
Administracja serwisu nie prowadzi działalności handlowej i nie ponosi odpowiedzialności za jakość usług/towarów sprzedawanych w ramach Hotlist.biz. Odpowiedzialność za wszystkie opublikowane towary i usługi ponoszą użytkownicy, którzy je dodali.
Łączność: https://hotlist.biz/pl/feedback.html