Instrukcja obsługi i konfiguracji dodatku Ceneo dla Virtuemart 2 v 1.0.1 Wersja dokumentu 1.0.0 20.12.2012 Wersja dokumentu 1.0.1 17.07.2013 Spis treści Instrukcja obsługi i konfiguracji dodatku Ceneo dla Virtuemart 2 v 1.0.1...1 1. Instalacja...1 2. Podstawowa konfiguracja...2 Powiązanie kategorii...2 Od wersji 1.0.2 pluginu należy domyślnie wiązad kategorie VM2 i Ceneo...3 Atrybuty produktów...3 Kod EAN...3 Opis produktu...3 3. Generowanie pliku XML...4 4. Automatyzacja generowania pliku XML...5 Małe sklepy...5 Duże sklepy...5 5. Dodatkowe informacje:...6 6. Pomoc i kontakt...6 1. Instalacja Po zakupieniu dodatku, klient otrzymuje dostęp do 2 rozszerzeo: - komponentu Porównywarki VM2 (com_porownywarki_vm2.zip) - oraz pluginu Ceneo do komponentu (plg_ceneo_dla_virtuemart_2.zip)
Instalacja wygląda standardowo, jeśli mowa o rozszerzenia dla Joomla, używamy instalatora i instalujemy rozszerzenia w kolejności: 1. Komponent, 2. Plugin. Po zainstalowaniu pluginu, musimy go opublikowad na liście dodatków. Następnie po wejściu do komponentu Porównywarki dla Virtuemart 2, wybieramy ikonkę Ceneo. Wyskoczy nam komunikat o potrzebie aktualizacji listy kategorii. 2. Podstawowa konfiguracja Z naszego doświadczenia wiemy, że są 2 najważniejsze informacje wymagane przez Ceneo, do bezproblemowego zaciągania produktów z naszego sklepu przez ichniejszy system: - powiązanie kategorii sklepu (VM2) z kategoriami Ceneo - kod EAN produktu Te problemy rozwiążemy przypisując kategoriom Virtuemart, kategorie Ceneo, co zrobimy w głównym panelu pluginu Ceneo, po kliknięciu w przycisk Powiąż kategorie Ceneo i VM. Powiązanie kategorii Po kliknięciu w przycisk Utwórz, wybieramy kategorie VM2 (możemy wybrad kilka w tym celu używamy klawisza CTRL i klikamy w kolejne kategorie), oraz odpowiadającą im kategorię w Ceneo. Za pomocą filtrów możemy łatwo wyszukiwad odpowiednie kategorie.
Od wersji 1.0.2 pluginu należy domyślnie wiązać kategorie VM2 i Ceneo Wykorzystywanie opcji "Generuj XML dla produktów bez powiązanych kategorii między kategoriami sklepu a kategoriami Ceneo" ustawionej na TAK będzie powodowad niepoprawnym obliczaniem cen dla rabatów i podatków (reguły obliczeniowe). Więc jeśli w sklepie używane są rabatów/reguły obliczeniowe to: 1. ustaw wspominaną powyżej opcję na "NIE" 2. połącz swoje kategorie VM2 z kategoriami Ceneo 3. ustaw odpowiednią dla siebie wartośd dla opcji "Rabaty" w konfiguracji pluginu (domyślnie wszystkie kategorie produktu powinny byd włączane do obliczeo rabatów) Atrybuty produktów Po wybraniu kategorii, możemy także zdefiniowad atrybuty dla produktów w danej kategorii. W tym celu, uzupełniamy sekcję Połącz atrybuty ceneo z polami dodatkowym Virtuemart 2, na tej samej podstronie. Możemy korzystad ze zdefiniowanych z góry przez Ceneo atrybutów i wiązad je z polami dodatkowymi produktów. Możemy tworzyd także własne atrybuty, przypisując je do odpowiedniej grupy oraz wybierając pole dodatkowe Virtuemart 2, które ma byd zawartością danego atrybutu. Kod EAN Aby kod EAN był wyświetlany w pliku XML dla Ceneo, wystarczy połączyd atrybut EAN (który znajduje się w prawie każdej grupie atrybutów) z polem dodatkowym produktu, które jest kodem EAN, lub polem SKU produktu, jeżeli w naszym sklepie to właśnie SKU przetrzymuje EAN. Opis produktu Domyślnym ustawieniem w komponencie jest generowanie opisu produktu dla Ceneo, na podstawie pola zwięzły opis. Można to zmienid w konfiguracji pluginu.
3. Generowanie pliku XML Po ustawieniu wszystkich parametrów, powiazaniu kategorii, oraz konfiguracji innych opcji, można wygenerowad plik XML dla Ceneo. W tym celu wchodzimy do działu Generuj plik XML w komponencie Ceneo i klikamy w poniższy przycisk: Po poprawnym wykonaniu procesu, otrzymamy podobny komunikat do:
W komunikacie otrzymujemy link do XMLa, który używamy w Ceneo. Nazwa pliku jest stała, także możemy się nią posługiwad cały czas, nazwę generowanego pliku można zmienid w konfiguracji pluginu Ceneo. 4. Automatyzacja generowania pliku XML Linki do automatycznego tworzenia pliku XML dla Ceneo znajdują się w dziale Generuj plik XML. Małe sklepy Dla sklepów z małym asortymentem do 500, 1000 produktów polecam użycie komponentu JPrc Cron (http://www.prieco.com/en/extensions/utilities/174-jprc-cronjobs.html). W ustawieniach komponentu, dla każdego linku z sekcji Linki dla CRONa ustawiamy osobne zadanie, odpalane najlepiej z 5 minutową różnicą w czasie (jeśli oczywiście mamy więcej linków niż 1 w sekcji Linki dla CRONa ). Oczywiście można wpisad linki także do CRON tab a, ale nie każdy hosting daje taką możliwośd. Duże sklepy Jeśli mowa o sklepach z kilkutysięczną zawartością produktów - polecam aby wrzucano linki z sekcji Linki dla CRONa do tabeli zadao CRONa, udostępnianej przez hosting. Najlepiej w 5 minutowym odstępie czasu (jeśli mamy więcej niż 1 link), o godzinie 1 w nocy.
5. Dodatkowe informacje: - Aby produkty wyświetlały się w pliku XML, muszą mied ustawioną minimum jedną kategorię Virtuemart, produkty bez przypisanych kategorii, nie będą wyświetlane - Produkty pochodne będą wyświetlane w pliku XML, tylko jeśli będą miały przypisaną kategorię - Z poziomu powiązania kategorii można wybrad produkty, które zostaną umieszczone w XMLu dla Ceneo, reszta produktów zostanie wykluczona z pliku. 6. Pomoc i kontakt W razie problemów z konfiguracją, proszę pisad na adres: kontakt@dodatkijoomla.pl