Instrukcja korzystania z modułu Onet Export (wtyczka oscommerce) (wersja 01.06.09) 1
Spis Treści: 1. Wymagania funkcjonalne:... 3 2. Charakterystyka wtyczki... 3 3. Instalacja.... 3 4. Konfiguracja Exportów... 5 5. Wykonywanie exportu... 7 6. Konfiguracja Harmonogramu... 8 7. Mapowanie Kategorii... 9 2
1. Wymagania funkcjonalne: Moduł Onet Export został opracowany dla sklepów, będących na platformie OsCommerce, zgodnych z podaną poniżej specyfikacją: oscommerce w wersji 2.2 RC1 do wersji 2.2 RC2a PHP w wersji 4.1 do wersji 5.2.4 MySQL od wersji 4.1 do wersji 5.1.28 Niezbędne moduły apache a, które muszą zostać włączone to: Mod_rewrite Mod_zip Do kompresowania ofert php należy zainstalować bibliotekę php_zip co najmniej w wersji 5.0. Należy też dodać wpis w cronetab, odpytujący co minutę plik make_export w katalogu /admin. 2. Charakterystyka Modułu Onet Export Moduł Onet Export zostaje udostępniony w wersji opensource. Jeżeli Państwa sklep nie spełnia warunków opisanych w Rozdziale 1 Wymagania funkcjonalne, moduł Onet Export należy dostosować we własnym zakresie, kontaktując się ze swoim informatykiem lub osobą/firmą która projektowała i wdrażała Państwa sklep. 3. Instalacja. W celu zainstalowania modułu Onet Export, będzie potrzebny: Katalog ze ściągniętym modułem Onet Export (udostępniony w formie archiwum ZIP, do samodzielnego rozpakowania) Dostęp do konta FTP gdzie znajdują się pliki Państwa sklepu Program do logowania się na konto FTP Po spełnieniu tych kryteriów, za pomocą programu do logowania się na konto FTP (np. Total Commander), należy zalogować się na konto FTP Państwa sklepu. Po zalogowaniu, należy upewnić się, że znajdujemy się w głównym (nadrzędnym) folderze sklepu. 3
Rysunek 1 Przykładowa struktura katalogów i plików. Należy wykonać kopiowanie całego folderu onet na serwer FTP. Po skopiowaniu wszystkich plików w przeglądarce, proszę uruchomić adres: naszsklep.pl/onet/install.php, gdzie za naszsklep.pl należy wstawić właściwą domenę Państwa sklepu: Rysunek 2 Adres URL wywołujący instalatora Modułu Onet Export. Po poprawnym skopiowaniu, pojawi się informacja: Instalacja modułu Onet Export została ukończona : Rysunek 3 Okno ukończenia instalacji Modułu Onet Export Pojawienie się zielonego koloru oznacza, że instalacja przebiegła PRAWIDŁOWO 4
W tym miejscu należy zwróć uwagę na komunikat na temat kompresji Zip. Jeżeli zostanie wyświetlona informacja o braku zainstalowanego modułu kompresji ZIP, oznacza to, że nie będzie możliwości kompresowania ofert sklepu, co zwiększa wielkość plików wynikowych eksportu! 4. Konfiguracja Exportów Instalacja modułu Onet Export nie jest równoznaczna z funkcjonowaniem eksportu. Moduł Onet Export należy dostosować do własnych potrzeb. W tym celu proszę zalogować się do panelu administracyjnego Państwa sklepu. Do menu sklepu została dodana pozycja: Export Onet : Rysunek 4 Okno menu Modułu Onet Export Klikając na pozycję Export Onet, mamy dostępne menu. Po prawej stronie ekranu, pojawi się okno z exportem produktów: Rysunek 5 Okno wyboru kategorii do dokonania zrzutu Po kliknięciu w tekst więcej opcji, widoczny po prawej stronie rysunku, pojawi się lista Opcji Exportu : 5
Rysunek 6 Opcje Exportu Na rysunku 6 pokazano możliwości wybrania trybów pracy modułu Onet Export: Tryb zastępowania treści jest rodzajem eksportu, polegającym na każdorazowym usuwaniu wcześniejszej oferty z bazy Galerii Handlowej OnetZakupy i zastępowaniu jej najnowszym eksportem. Tryb aktualizacji uaktualnia tylko te wpisy, które są w wynikowym pliku exportu. Zadeklarowanie okresu, w którym system pobiera plik z ofertami Państwa sklepu, jest potrzebne w sytuacji, kiedy został włączony tryb aktualizacji oraz usunięty/usunięte z naszej oferty produkt/produkty. Zadeklarowanie okresu daje pewność, że baza ofert Galerii Handlowej OnetZakupy zostanie zaktualizowana. Ostatnie dwie opcje ( plik xml oraz plik zip ) decydują o typie pliku wynikowego: eksport zostaje zapisany w pliku xml eksport zostaje zapisany w pliku xml i skompresowany do pliku ZIP. Klikając guzik wykonaj export, konfiguracja exportów zostaje zapisana i eksport ofert do wybranego pliku (xml lub zip) zostaje wykonany. 6
Po prawej stronie ekranu zostaje wyświetlona lista kategorii jakie istnieją w Państwa sklepie: Rysunek 7 Rozwinięte drzewo kategorii Na rysunku 7 pokazany został przykład rozwiniętego drzewa kategorii. Przy każdej kategorii, po lewej stronie ekranu, znajduje się okienko, którego kliknięcie jest równoznaczne z zaznaczeniem wszystkich podkategorii danego elementu (np. zaznaczając okienko DVD Movies zaznaczymy wszystkie podkategorie oraz wszystkie produkty należące do tej kategorii). Przy produktach znajduje się okienko onetefekt, którego zaznaczenie pozwala skorzystać z płatnej reklamy efektywnościowej w Galerii Handlowej OnetZakupy. Więcej informacji na temat OnetEfekt znajdą Państwo w Podręczniku Integracji z Galerią Handlową OnetZakupy (http://zakupy.onet.pl/panel/_i/podrecznik_integracji.pdf), na stronie 16. 5. Wykonywanie exportu Po wybraniu produktów, należy kliknąć guzik wykonaj export, pojawi się komunikat Dokonano exportu produktów z wybranych kategorii : Rysunek 8 Komunikat o poprawnym exporcie produktów Następnie proszę przejść do listy exportów, w której zostaną wyświetlone wszystkie aktualnie wykonane exporty przeprowadzone przez moduł Onet Export dla Państwa sklepu. 7
Rysunek 9 Wygląd Listy Exportów Adres w zielonej ramce prowadzi nas zawsze do najnowszej wygenerowanej oferty i ma postać: adres_naszego_sklepu/oferta/oferta.xml - adres ten należy podać w zakładce eksport pasywny, po załogowaniu do panelu Państwa sklepu w Galerii Handlowej OnetZakupy. Dla każdego exportu mamy 2 opcje: Export pasywny zostaje wyświetlony adres URL do aktualnej oferty, który należy skopiować a następnie wstawić do panelu Państwa sklepu w Galerii Handlowej OnetZakupy. Export aktywny zostaje wywołany plik do ściągnięcia i zapisania na dysk przydatne przy wrzucaniu ofert ręcznie. 6. Konfiguracja Harmonogramu Harmonogram eksportu ofert do Galerii Handlowej OnetZakupy wymaga konfiguracji przez użytkownika. Uwaga!!! Przy pierwszym uruchomieniu sklepu z zainstalowanym modułem Onet Export, generowanie ofert jest wyłączone. Tą opcję należy włączyć w panelu administracyjnym Państwa sklepu. Następnie należy wskazać plik, który ma być sprawdzany przez harmonogram czyli tzw. demon crona. Administrator sklepu powinien zgłosić się do administratora domeny sklepu w celu dodania do tzw. cronetab a wpisu, wskazującego na plik make_export.php. Plik znajduje się w katalogu admin Państwa sklepu (naszsklep.pl/admin/). Odpytywanie pliku przez crona należy ustawić co minutę. Po odpowiedniej konfiguracji crona do obsługi Państwa sklepu, należy kliknąć guzik Tak. Zostanie rozwinięta kolejna opcja ustawiania Interwału Czasowego, określająca częstotliwość wykonywania eksportu. 8
Zostanie wyświetlony następujący panel: Rysunek 10 Panel Interwału Czasowego Wybierając zrzut codzienny możemy wybrać godzinę, dzień tygodnia lub dzień miesiąca, w którym wykonujemy export Do wykonywania eksportu polecamy godziny nocne ze względu na dużo mniejsze obciążenie serwera. W celu wybrania więcej niż jednego dnia tygodnia, proszę użyć klawisza Crt. Po ustaleniu harmonogramu, należy kliknąć guzik wykonaj. 7. Mapowanie Kategorii Do poprawnego działania modułu Onet Export, konieczne jest dokonanie mapowania kategorii, czyli przyporządkowania kategorii Państwa sklepu do kategorii Galerii Handlowej OnetZakupy W celu zmapowania kategorii, należy wybrać z menu modułu Onet Export pozycje: Mapowanie Kategorii Sklepu. Pierwsze uruchomienie strony może potrwać dłużej ze względu na pobieranie listy wszystkich kategorii występujących w Galerii Handlowej OnetZakupy. Przy każdej z kategorii znajduje się hiperłącze mapuj, które po kliknięciu, pokaże Państwu rozwijalne menu, z którego należy wybrać odpowiednią kategorie. Po pomyślnym zakończeniu mapowania, wybrana kategoria zostanie podświetlona na zielono a wszystkie znajdujące się w niej kategorie, zostaną rozwinięte. Po zmapowaniu wszystkich kategorii, proszę kliknąć guzik plik mapowania kategorii otrzymując tym samym, gotową do przesłania do Galerii Handlowej OnetZakupy, definicje mapowań. 9
Rysunek 11 Widok Mapowania kategorii Mapowanie kategorii najlepiej zacząć od kategorii najogólniejszych, kończąc na tych szczegółowych. Po dokonaniu mapowań konfiguracja jest już zakończona. Uwaga!!! W momencie usuwania jakiejkolwiek oferty ze sklepu, tworzona jest Historia Usuniętych Produktów dostępna z poziomu menu. Dzięki temu jesteśmy poinformowani, czy faktycznie usunięte produkty są dodawane do exportu oraz czy są usuwane po pewnym czasie. 10