PIR MatysArt Podgaje 7 26-804 Stromiec www.matysart.pl biuro@matysart.pl Tel. 48 368 33 58 INSTRUKCJA OBSŁUGI I INSTALACJI KONPONENTU MATYSALLEGRO Szanowny Kliencie! Instrukcja dotyczy najnowszej wersji komponentu MatysAllegro integrującego sklep internetowy z platformą Allegro.pl. Umożliwiającego szybkie wystawianie przedmiotów ze sklepu VirtueMart jako aukcje na allegro.pl. Komponent posiada automatyczną rejestrację kupujących na sklepie, powiązania kategorii i inne funkcje ułatwiające zarządzanie sprzedażą produktów. Funkcje komponentu rozszerzono o: - Nowe opcje płatności i wysyłki - Hurtowa edycja cen i nazw produktów na sklepie - Rejestracja na sklepie zakupionych na allegro przedmiotów - Przypomnienia o niepotwierdzonych aukcjach - Zmodyfikowane ustawienia kategorii Oferujemy pełne wsparcie techniczne w instalacji i konfiguracji komponentu. Tutorial ten ma na celu ułatwienie przejścia tych procedur. Ze względu na dynamiczny rozwój komponentu zmiany w wyglądzie i funkcjach nie zawsze są dokładnie odwzorowane w instrukcji. Na życzenie udostępniamy wersja testowa komponentu, umożliwiającą zapoznanie się z jego funkcjami przed zakupem komponentu. Wersję testową udostępniamy na życzenie w tym celu prosimy pisać na adres: allegro@matysart.pl W sprzedaży posiadamy komponent w wersji 1.0 dla joomli 1.5 i VM 1.0 oraz wersja 2.0 dla joomli 2.5 i VM 2.0. Cena komponentu 280 zł netto dla jednej domeny, zakup każdego kolejnego komponentu 200 zł netto. Licencja na komponent udzielana jest dożywotnio. Uwaga! Komponent jest optymalizowany pod przeglądarki FireFox i Opera. Nie odpowiadamy za działanie komponentu w przeglądarce Internet Explorer. W przypadku pytań zapraszamy do kontaktu Z poważaniem Zespoł Matysart 1
Spis treści: I. Instalacja komponentu... 3 - wymagania komponentu - proces instalacji II. Konfiguracja wstępna... 4 - krok I - krok II - krok III - krok IV III. Pierwsze kroki... 7 - opcje główne menu komponentu IV. Drzewo Kategorii... 7 V. Konfiguracja... 9 VI. Kategorie... 9 VII. Powiązania kategorii... 10 VIII.Ustawienia kategorii... 10 IX. Szablony... 11 X. Edycja produktów... 11 XI. Rejestracja użytkowników allegro na sklepie... 12 XII. Sposoby dodawania wpisów do Crona... 16 XIII.Wkrótce w komnpnencie... 17 materiały i opracowanie: P.W. MatysArt.pl, 19.05.2010, wersja 2.0 2
I. INSTALACJA KOMPONENTU 1. Wymagania konieczne do poprawnego zainstalowania i skonfigurowania komponentu: a) VirtueMart - sklep internetowy dla Joomla! (wersja 1.1.2 i nowsze) b) hosting, VPS lub serwer dedykowany posiadający: - ion cuble - php5 ( z włączonym allow_url_fopen) - mysql - obsługa CRON - curl (wersja min: 7.21...) - obsługa SSL - soap c) konto na allegro.pl i własny klucz allegro webapi w wersji darmowej d) plik instalacyjny dostarczany przez MatysArt 2. Proces instalacji: Krok 1: Z głównego menu panelu administracyjnego sklepu wybieramy kolejno pozycje: - Rozszerzenie - Instalator Krok 2: Klikając Przeglądaj... wybieramy ścieżkę do kliku instalacyjnego i klikamy Wczytaj plik & Zainstaluj aby ropocząć instalację Po wyświetleniu się komunikatu o Zainstalowaniu komponentu z powodzeniem proces instalacji jest zakończony i można go uruchomić. 3
Konfiguracja wstępna uruchamia się automatycznie przy pierwszym włączeniu komponentu i jest ostatnim, bardzo ważnym etapem instalacji. Aby włączyć komponent wystarczy z głównego menu panelu administracyjnego sklepu wybrać kolejno pozycje: Komponenty, Matys Allegro. Proces konfiguracji jest podzielony na cztery kroki. Wprowadzone dane można edytować w trakcie korzystania z komponentu. Wypełnienie danych niezbędnych do integracji sklepu internetowego z allegro.pl Należy podać dane użytkownika i klucz webapi oraz wybrać platformę na której będą wystawione aukcje ( allegro.pl lub testowa wersja - Test Webapi. Wybranie kategorii z allegro.pl (lub TestWebapi - jeśli wybrano krok 1), z których chcemy korzystać.
Powiązanie kategorii ze sklepu z kategoriami z allegro ( lub TestWebapi - jeśli wybrano w k.1.) Podstawowa konfiguracja wystawiania przedmiotów dla wybranych lub wszystkich kategorii i podkategorii. Konfiguracja dotyczy domyślnych ustawień przy wystawieniu przedmiotów. Domyślnie konfiguruje się je do wszystkich kategorii i podkategorii. Po zatwierdzeniu tych ustawień pojawia się po prawej stronie lista kategorii. Wybrana kategoria podświetlana jest na niebiesko. Wszystkie wprowadzone zmiany dotyczą wówczas tylko tej kategorii. Warunkiem koniecznym do wprowadzenia zaznaczonych ustawień jest wybranie przycisku Zatwierdź.
6. Zmiana ceny - daje możliwość ustalenia na podstawie wzoru innych cen dla aukcji niż produktów w sklepie. W ustawieniach kategorii można ustawiać takie zmiany dla poszczególnych kategorii w sklepie lub allegro. Można wprowadzać różnego rodzaju wzory wykorzystując mnożenie (*), dzielenie (/), odejmowanie (-), dodawanie (+), oraz operacje na procentach, przy czym produkt musi być pierwszy a działania wykonywane są kolejno. Przykładowe działanie produkt+10%-2,2*1,23" czyli wartość produktu powiększona o 10%, od której odjęto 2 zł i 20 groszy, następnie pomnożone przez 1,23 (np.. w ten sposób dodając VAT). Po zatwierdzeniu wszystkich wprowadzonych konfiguracji w kroku czwartym, jeśli konfiguracja przebiegła prawidłowo po wybraniu przycisku Zakończ pojawi się komunikat o poprawnym przebiegu instalacji. Można rozpocząć korzystanie z komponentu. UWAGA! Wprowadzone podczas konfiguracji ustawienia komponentu można edytować.
III. PIERWSZE KROKI Drzewo kategorii - Podgląd listy kategorii sklepu bądź allegro, razem z przedmiotami w poszczególnych kategoriach i podkategoriach. W tym miejscu wystawia się właściwe aukcje oraz ustawia szczegóły ich dotyczące. W drzewie można również monitorować stan aukcji. Konfiguracja - Ustawienie min. dostępu do konta użytkownika Allegro, klucza webapi, ilości aukcji na stronie, różnicy cen między sklepem, a aukcjami. Kategorie - W tej podstronie definiuje się kategorie, spośród dostępnych w sklepie, z których będą wystawiane na allegro. W późniejszym kroku będą powiązane z kategoriami allegro. Powiązania kategorii - Przypisywanie kategorii ze Sklepu kategoriom w Allegro. Konfiguracja tutaj jest niezbędna do wystawiania przedmiotów na aukcjach. Do jednej kategorii w allegro można przypisać wiele kategorii ze sklepu i odwrotnie. Ustawienia kategorii - Podstawowa konfiguracja MatysAllegro oraz Sklepu. Ustawienia mogą być dokonane globalnie bądź dla poszczególnych kategorii i podkategorii. Szablony - W tej zakładce: - Wklejamy, edytujemy, zapisujemy szablony aukcji - Ustawiamy domyślny szablon - Mamy podgląd szablonu przed zaakceptowaniem zmian Edycja produktów - część komponentu odpowiadająca za edycję cen na sklepie oraz nazwy produktu. Ceny można zmieniać dla pojedynczych produktów w obrębie jednej kategorii bądź dla całej kategorii zunifikować cenę. IV. DRZEWO KATEGORII
Widok kategorii można zmienić z rozszerzonego na skrócony. Można też zmienić sposób sortowania kategorii według kategorii ze sklepu na wyświetlanie według wybranych kategorii allegro.pl. Jeśli po lewej stronie nazwy kategorii znajduje się więcej niż jedna strzałka, oznacza to że kategoria ta ma przypisane podkategorie. Operując na drzewie kategorii należy pamiętać iż dokonując zmian dla kategorii nadrzędnych zmieniamy wszystkie kategorie podrzędne oraz produkty im podlegające. Podświetlony na zielono pasek PRZECIĄGNIJ zawierający podstawowe operacje można przemieszczać dowolnie w oknie przeglądarki. Jest on zawsze przyklejony do miejsca na monitorze w którym się go pozostawiło. Będzie pod ręką, gotowy do użycia bez względu na to czy przeglądany jest początek czy koniec listy. Wystaw zaznaczone - wystawia na allegro wszystkie zaznaczone (podświetlone na niebiesko) aukcje. Edytuj zaznaczone dane / Edytuj zaznaczone kategorie - pola służą do edycji wybranych produktów lub kategorii produktów w komponencie. Należy jednak pamiętać, że zmiany pojawią się na allegro od daty kolejnego wznowienia aukcji (przy kolejnym wystawieniu aukcji). Komponent w obecnej wersji nie pozwala jednocześnie zmieniać wybranych aukcji i kategorii. Zaznaczając daną kategorię NIEZAZNACZAMY podległych pod nią aukcji i podkategorii. Zaznacz wszystkie / Odznacz wszystkie - zaznacza / odznacza widoczne przedmioty i kategorie z rozwiniętych list kategorii i podkategorii. Zaznaczone przedmioty są podświetlone na niebiesko. Uwaga! Dotyczy to tylko widocznych na ekranie produktów. Zaznaczenie widocznej kategorii nie oznacza zaznaczenia nierozwiniętych produktów do niej należących. Różowe podświetlenie produktu oznacza, że produkt ma już wystawioną aukcję na allegro.pl. Aby wystawić aukcję na allegro.pl należy wybrać przycisk Wystaw. Wybranie przycisku Zakończ dla wystawionego przedmiotu oznacza zakończenia aukcji na platformie allegro.pl, aukcja będzie widoczna ponownie do wystawienia. Dla każdego wystawionego na allegro produktu widoczna jest data zakończenia aukcji oraz link bezpośrednio do aukcji. Zaznaczenie opcji Autowystawianie spowoduje, że przedmiot po zakończeniu aukcji będzie automatycznie wystawiony ponownie. Dla łatwiejszego przeglądania produktów wprowadzone zostały filtry ograniczające wyniki przeglądania. Filtry zaawansowane są domyślnie zwinięte. Należy wybrać link pokaż aby wyświetliły się dostępne filtry. Wybrane filtry można usuwać pojedynczo lub wszystkie po wybraniu opcji usuń wszystkie. Opis aukcji i Opis płatności wysyłki można edytować za pomocą specjalnego edytora funkcjonalnie zbliżonego do powszechnie używanych edytorów tekstowych.
Zawartą tutaj listę kategorii z allegro.pl (lub Test Wabapi) wykorzystujemy do modyfikowania, dodawania i usuwania powiązań z kategoriami sklepu. Kategorie w testowym komponencie pochodzą z testowego webapi Allegro. W wersji dla klientów oczywiście będą się pobierały kategorie z allegro. W tym miejscu wybieramy kategorie z tych na allegro w jakich będziemy wystawiać aukcje. Jak widać na poniższym screenie kategorie są zaznaczone na niebiesko i podkreślane. Po kliknięciu na nie rozwijamy listę dostępnych podkategorii i podpodkategorii. Jeżeli klikniemy ponownie zwiniemy listę podkategorii. Możemy zaznaczać całe kategorie (powodując zaznaczenie wszystkich podkategorii). Na zielono są oznaczone kategorie już wskazane do obsługi w ramach komponentu lub kategorie zawierające zaznaczone podkategorie (w takim przypadku dodatkowo podkreślone).
VII. POWIĄZANIA KATEGORII W zakładce USTAWIENIA KATEGORII można modyfikować ustawienia wybrane w czasie konfiguracji komponentu. Poszczególne pola reprezentują te same wartości (patrz Instalacja komponentu Krok 4). Należy pamiętać, że nie można edytować konfiguracji dla kategorii, dla których nie wybrano powiązań w poprzednim kroku.
X. EDYCJA PRODUKTÓW Podświetlony na zielono pasek PRZECIĄGNIJ zawierający podstawowe operacje można przemieszczać dowolnie w oknie przeglądarki. Jest on zawsze przyklejony do miejsca na monitorze w którym się go pozostawiło. Będzie pod ręką, gotowy do użycia bez względu na to czy przeglądany jest początek czy koniec listy. Zaznacz wszystkie / Odznacz wszystkie - zaznacza / odznacza widoczne przedmioty i kategorie z rozwiniętych list kategorii i podkategorii. Zaznaczone przedmioty są podświetlone na niebiesko. Uwaga! Dotyczy to tylko widocznych na ekranie produktów. Zaznaczenie widocznej kategorii nie oznacza zaznaczenia nierozwiniętych produktów do niej należących.
Zmień produkty w kategoriach - edytowanie całych zaznaczonych kategorii. Zmień zaznaczone produkty - edytowanie wybranej grupy produktów. Jeśli po lewej stronie nazwy kategorii znajduje się więcej niż jedna strzałka, oznacza to że kategoria ta ma przypisane podkategorie. Operując na drzewie kategorii należy pamiętać iż dokonując zmian dla kategorii nadrzędnych zmieniamy wszystkie kategorie podrzędne oraz produkty im podlegające. XI. REJESTRACJA UŻYTKOWNIKÓW ALLEGRO NA SKLEPIE System ten wykorzystuje wiadomości z Allegro celem rejestracji użytkowników na sklepie. Nadaje im unikalny login i hasło by łatwiej śledzić zamówienia. Do działania konieczne jest zdefiniowanie takiego linku/linków w panelu zarządzania konta allegro z jakiego dokonuje się sprzedaży. Użytkownik zostaje następnie przekierowany do formularza na sklepie gdzie zostają pobrane jego dane użytkownika, (opcjonalnego) dodatkowego adresu wysyłki oraz sposobu płatności. Wszystkie opcje mają możliwość edycji. Każdy następny zakup danego użytkownika będzie dodawany do konta na sklepie. 1. Logujemy się do panelu zarządzania kontem na Allegro i przechodzimy do zakładki ustawień WebAPI.
Link przekieruje do sklepu na został skonfigurowany. Przed klientem pokaże się formularz z jego danymi pobranymi z Allegro z możliwością poprawy, a także dodania innego adresu wysyłki.
XII. SPOSÓB DODAWANIA WPISÓW DO CRONA Cron jest to program odpowiedzialny za cykliczne wykonywanie zadań. W naszym przypadku będzie odpowiedzialny za wystawianie i zakończanie aukcji oraz rejestrację kupujących na sklepie. Wpisy jakie trzeba dodać zawierają adres sklepu gdzie jest zainstalowany komponent oraz rozszerzenie adresu wykonujące określone czynności. Przykład: Jeśli komponent jest zainstalowany w sklepie pod adresem sklep.matysart.pl, a rozszerzenia mają postać: components/com_matysallegro/models/cronrun.php components/com_matysallegro/models/cronupdaterun.php to wpisy wyglądają tak: */2 * * * * lynx > /dev/null -dump "http://test.matysart.pl/components/com_matysallegro/models/cronrun.php */2 2-5 * * * lynx > /dev/null -dump "http://test.matysart.pl/components/com_matysallegro/models/cronupdaterun.php" Linki można dodawać do Crona z poziomu konsoli systemowej bądź panelu hostingowego ( o ile provider udostępnia takową opcję) Dodając do panelu hostingowego (w tym przypadku jest to ISPConfig):
Wpisanie linków do harmonogramu Crona w konsoli linuksowej. Osoby posiadające dostęp do tzw. konsoli serwera działającego na linuksie mogą umieścić wpisy wykonując kilka prostych czynności: - W pierwszej kolejności trzeba się zalogować do konsoli - Wykonać polecenie crontab -e (spowoduje to otworzenie pliku w którym będą wpisywane zadania dla Crona) - Jeśli są tam jakieś wpisy to należy je zostawić ( z zasady nie tykamy nieznanego, czyjegoś wpisu) i - Wpisujemy od nowego wiersza następującą treść: * * * * * curl -s -o /dev/null tutaj_adres_strony/index.php?option=com_matysallegro&task=submitauctions * * * * * curl -s -o /dev/null tutaj_adres_strony/index.php?option=com_matysallegro&task=endauctions * * * * * curl -s -o /dev/null tutaj_adres_strony/index.php?option=com_matysallegro&task=noclickmail * * * * * curl -s -o /dev/null tutaj_adres_strony/index.php?option=com_matysallegro&task=infoshopping Przykład: sklep widnieje pod adresem http://skleptest.pl, a chcę wystawiać aukcje co 2 minuty. Należy więc wpisać tak: */2 * * * * curl -s -o /dev/null http://skleptest.pl/index.php?option=com_matysallegro&task=submitauctions Wpisanie linków do harmonogramu Crona w konsoli linuksowej