Instrukcja użytkownika Porównywarki cen Liquid Wersja
Spis treści 1 Wstęp... 3 2 Opis obszaru... 4 Towary... 5 Relacje... 6 Edytuj... 7 2.3.1 Konfiguracja... 7 2.3.2 Kategorie... 7 2.3.3 Ustawienia... 8 2.3.4 Dostępność... 9 2.3.5 Atrybuty towaru... 11 2.3.6 Szablon... 12 3 Dodawanie nowej porównywarki... 14 2
1 Wstęp udostępnia mechanizm pozwalający na generowanie plików XML dla porównywarek cenowych w oparciu o silnik Liquid. Mechanizm ten pozwala na dowolną ingerencję w plikach wysyłanych do porównywarek. Umożliwia także na samodzielną integrację z dowolną porównywarką dostępną na rynku. Zastosowanie funkcjonalności nie ogranicza się wyłącznie do porównywarek cen. Użytkownik może użyć generowanych plików do przekazania oferty swoim klientom bądź sprzedawcom. Użytkownik ma możliwość wyboru języka, ceny oraz waluty, dla generowanego pliku. Modyfikacja typu pliku pozwala na generowanie plików w takich popularnych formatach, jak XML, CSV, TXT, JSON i innych. Generowane pliki można zabezpieczyć, poprzez ograniczenie dostępu do nich tylko dla zalogowanych użytkowników, bądź poprzez dodanie losowo generowanego ciągu znaków do linku z plikiem. Dzięki temu nieuprawnione osoby nie otrzymają dostępu do pliku z zasobami sklepu. 3
2 Opis obszaru Porównywarki cen znajdują się w obszarze Pasaże i Serwisy aukcyjne W sekcji Pasaże > Porównywarki cen Strona główna obszaru pozwala na: dodawanie nowych plików wybór towarów, które mają być generowane w pliku ustalanie relacji pomiędzy kategoriami porównywarki i kategoriami sklepowymi (opcja dostępna dla porównywarek, dla których istnieje lista kategorii) edycję ustawień pliku pobranie pliku 4
Towary Obszar prezentuje listę wszystkich towarów dostępnych w sklepie. Użytkownik wybiera, które towary mają być generowane w pliku. Uw aga: Lista zawiera towary, które posiadają przypisaną grupę dom yślną w systemie ERP. 5
Relacje Obszar jest dostępny wyłącznie dla porównywarek, które posiadają zdefiniowaną strukturę kategorii. Zawiera listę kategorii sklepowych oraz listę kategorii porównywarki. Uw aga: W celu aktywacji obszaru należy w edycji na zakładce Kategorie pobrać kategorie, lub załadować listę kategorii z pliku. W celu utworzenia powiązania pomiędzy kategoriami należy przeciągnąć kategorię sklepową na kategorię porównywarki. Lista utworzonych relacji znajduje się poniżej Dla przyspieszenia procesu tworzenia relacji powyżej każdej z list znajduje się wyszukiwarka, która pozwala zawęzić listę. 6
Edytuj 2.3.1 Konfiguracja Użytkownik może zdefiniować własną nazwę dla porównywarki oraz wybrać język, cenę i walutę, w której będą generowane towary do pliku. Konfiguracja zawiera także dwie opcje zabezpieczenia pliku przed niepowołanym dostępem. Opcja Auth ogranicza dostęp do pliku tylko dla użytkowników zalogowanych w sklepie. Pole Hash pozwala na podanie ciągu znaków, który zostanie doklejony do linku z plikiem, dzięki czemu będzie on mniej przewidywalny. Przycisk Generuj znajdujący się po prawej stronie pola pozwala na wygenerowanie losowego ciągu znaków. Pole Content-Type pozwala na zmianę typu pliku, dzięki czemu użytkownik może generować plik w dowolnym formacie, np. CSV, TXT, HTML i inne. 2.3.2 Kategorie Dla domyślnie zintegrowanych porównywarek, które posiadają predefiniowane kategorie, obszar pozwala na pobranie aktualnych kategorii. 7
Dla pozostałych porównywarek istnieje możliwość załadowania struktury kategorii z odpowiednio zdefiniowanego pliku XML. 2.3.3 Ustawienia Sekcja Ustawienia zawiera listę wyboru rodzaju sklepu (dla wybranych porównywarek). Użytkownik może tutaj dodać swój atrybut o określonej nazwie i wartości, który zostanie zwrócony w Liquid po wywołaniu settings.nazwa_zdefiniowanego_atrybutu. 8
2.3.4 Dostępność Obszar zawiera słownik, który tłumaczy nazwy statusów dostępności porównywarki na wartości wymagane przez porównywarki. Poniżej znajduje się lista sklepowych statusów dostępności, do których należy przypisać odpowiadające im statusy porównywarki. 9
Oferta może zostać zawężona do towarów o określonym statusie dostępności. Większość porównywarek wymaga, żeby udostępniane towary były dostępne do zamówienia w sklepie, do spełnienia tego wymogu służy opcja udostępniania towarów z dodatnim stanem magazynowym. 10
Ze względu na pozycjonowanie witryny sklepu, nie zaleca się wysyłania do porównywarek opisu towaru w sklepie. Jeżeli użytkownik chce udostępnić opis, to może to zrobić zaznaczając opcję Wyślij w sekcji z opisem. 2.3.5 Atrybuty towaru Sekcja z atrybutami towaru pozwala na zmianę nazwy atrybutu przesyłanego z systemu ERP w pliku XML. Przykładowo, jeżeli użytkownik zdefiniuje w systemie ERP atrybut o nazwie Kod BLOZ 12, to odwiedzający sklep klient na towarze zobaczy atrybut o takiej nazwie, natomiast w pliku XML wygeneruje się on, jako BLOZ_12. 11
2.3.6 Szablon W sekcji Szablon znajduje się edytor pozwalający na edycję kodu wysyłanego pliku. 12
Kod zapisany jest z użyciem składni Liquid. Więcej na temat Liquid można znaleźć w dokumentacji, która znajduje się w obszarze Zarządzanie stronami/liquid/konfiguracja Uw aga: W przeciwieństwie do składni Liquid używanej do tworzenia szablonów sklepowych, w przypadku plików, dla poszczególnych produk tów, zamiast tagu for należy stosować tag foreach. 13
3 Dodawanie nowej porównywarki 1. W celu dodania nowej porównywarki należy w obszarze Pasaże i serwisy aukcyjne/pasaże/porównywarki cen wybrać opcję Dodaj. 2. W oknie, które się pojawi należy wprowadzić nazwę, która pozwoli na identyfikację na liście. 3. Po kliknięciu przycisku Dodaj zostanie wyświetlone okno konfiguracji. Opis poszczególnych pól znajduje się w rozdziale 2.3.1 4. Kolejna zakładka służy do wgrania pliku ze strukturą kategorii, jeżeli w porównywarce nie występuje sprecyzowana struktura kategorii, można ją pominąć. 14
5. Zakładka Ustawienia pozwala na dodawanie dodatkowych atrybutów, które można wywołać z kolekcji settings. Przykładowo, żeby wywołać atrybut rodzaj widoczny na poniższym obrazku, należy użyć polecenia {{settings.rodzaj}}, które zwróci wartość opony 15
Obszar pozwala na wprowadzenie w pliku zmiennych, których edycja nie będzie wymagała modyfikacji szablonu. 6. Słownik dostępności umożliwia przypisanie do nazw dostępności używanych w porównywarce odpowiednich wartości. Następnie można je wybrać do zmapowania ze sklepowymi statusami dostępności. Przykładowo, w przypadku widocznym na poniższym obrazku, sklepowy status dostępności o nazwie Zapowiedź zostanie w pliku zastąpiony wartością 1. 16
7. Zawężanie oferty pozwala wybrać statusy towarów, jakie mają zostać zwrócone w pliku. Na poniższej konfiguracji widać, że tylko produkty ze statusem dostępności Od ręki, W ciągu24 godzin, W ciągu 48 godzin, zostaną wygenerowane w pliku. Dodatkowo oferta zostanie zawężona tylko do towarów z dodatnim stanem magazynowym. 17
8. Domyślnie opis dla towarów nie jest zwracany w generowanym pliku, żeby to zmienić należy aktywować poniższą opcję Wyślij 9. Zakładka Atrybuty towaru umożliwia zmianę nazwy atrybutu wprowadzonej w systemie ERP dla potrzeb generowanego pliku. Na poniższym przykładzie atrybut klasa energetyczna zostanie zastąpiony w pliku nazwą eec 18
10. Szablon pliku pozwala na edycję kodu szablonu. Kod zawiera składnię w języku XML oraz fragmenty Liquid. Więcej o składni Liquid w osobnej dokumentacji. 19
20
Uw aga: W przeciwieństwie do składni Liquid używanej do tworzenia szablonów sklepowych, w przypadku plików, dla poszczególnych produk tów, zamiast tagu for należy stosować tag foreach. 21
COMARCH e-commerce Nieautoryzowane rozpowszechnianie całości lub fragmentu niniejszej publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą kserograficzną, fotograficzną, a także kopiowanie na nośniku filmowym, magnetycznym lub innym, powoduje naruszenie praw autorskich niniejszej publikacji. Copyright 2016 COMARCH Wszelkie prawa zastrzeżone. 22