Uwaga! Poniższa procedura opisuje podstawową instalację Magento CE dla celów testowych, developerskich etc. Nie są w tym opisie uwzględnione m.in. zagadnienia dotyczące bezpieczeństwa. W środowisku produkcyjnym należy zapoznać się z dokumentacją Magento oraz systemu operacyjnego i wykonać działania zabezpieczające dostęp do poufnych informacji. Konieczna jest również instalacja łatek publikowanych na stronach projektu Magento. Uwaga na myślniki przy kopiowaniu z PDF (mogą się źle kopiować) Instalacja platformy Magento CE Celem tego ćwiczenia jest zapoznanie się z procesem instalacji platformy Magento CE. W ramach ćwiczenia zostanie zainstalowany przykładowy sklep dostarczany wraz z Magento. 1. Uruchom maszynę wirtualną zgodnie z poleceniami prowadzącego zajęcia. 2. Zaloguj się jako użytkownik ziwee z hasłem ziweestudent1. 3. Pobierz plik magento_all.zip z odnośnika wskazanego przez prowadzącego i zapisz ten plik w katalogu /home/ziwee/downloads. 4. Uruchom Menedżer Plików (Akcesoria Menedżer Plików). 5. Przejdź do katalogu /home/ziwee/downloads. 6. Rozpakuj w tym katalogu plik magento_all.zip. Możesz do tego celu wykorzystać narzędzie Xarchiver dostępne z menu kontekstowego lub opcję Rozpakuj tutaj również dostępną w menu kontekstowym. 7. Uruchom przeglądarkę Iceweasel i przejdź do strony http://localhost/phpmyadmin i zaloguj się na użytkownika root z hasłem root_student. 8. Przejdź do zakładki Privileges 9. Wybierz odnośnik Add a new User. Podaj następujące parametry: nazwa użytkownika (User name): magentowww host: localhost hasło (Password): magentowwwstudent1 Zaznacz opcję Create database with same name and grant all privileges.
10. Wybierz przycisk Create User. 11. Skopiuj zawartość katalogu /home/ziwee/downloads/magento do katalogu serwera (/var/www). Skorzystaj z polecenia cp -r. Terminal możesz uruchomić wybierając Akcesoria LXTerminal. sudo cp -r /home/ziwee/downloads/magento /var/www 12. Skopiuj katalog /home/ziwee/downloads/magento-sample-data-1.9.1.0/media do katalogu /var/www/magento. Skorzystaj z polecenia cp -r. 13. Skopiuj katalog /home/ziwee/downloads/magento-sample-data-1.9.1.0/skin do katalogu /var/www/magento. Skorzystaj z polecenia cp -r. 14. Ponieważ serwer www domyślnie działa z innymi uprawnieniami niż użytkownik root (i słusznie), konieczne jest ustawienie odpowiednich uprawnień dla skopiowanych plików. Zmień właściciela katalogów i plików oraz przypisz im odpowiednie uprawnienia: su - (podaj hasło użytkownika root) cd /var/www/magento chown www-data -R. find. -type d -exec chmod 700 {} \; find. -type f -exec chmod 600 {} \; 15. Wprowadź przykładowy zestaw danych do bazy danych. W tym celu należy zaimportować bazę danych z pliku SQL. mysql -u root -p magentowww < /home/ziwee/downloads/magento-sample-data- 1.9.1.0/magento_sample_data_for_1.9.1.0.sql 16. Wykonaj polecenie a2enmod rewrite (jako użytkownik root). Umożliwi ono włączenie ładnych adresów url. Zrestartuj serwer www używając polecenia service apache2 restart. Zignoruj informacje typu warning. 17. W przeglądarce internetowej otwórz stronę http://localhost/magento. Jest to pierwsza nasza wizyta na tej stronie, dlatego włączy się instalator Magento.
18. Zgódź się na zaproponowane warunki i kliknij przycisk Continue. Na następnym ekranie ustaw zgodnie z poniższym zrzutem ekranu opcje dotyczące lokalizacji. 19. Podaj dane dla połączenia z bazą danych: Host: localhost Database Name: magentowww User Name: magentowww User Password: magwww_student Tables Prefix pozostaw puste pole (!) Pozostałe opcje pozostaw bez zmian. Wybierz przycisk Continue. Poczekaj na utworzenie i wypełnienie schematu bazy danych. 20. Kolejnym krokiem jest zdefiniowane najważniejszego użytkownika administratora sklepu. Dla spójności i uniknięcia np. zapomnienia hasła, ustaw nazwę użytkownika na admin, a jego hasło na adminstudent1.
21. Kliknij przycisk Continue. Zapisz wygenerowany klucz szyfrowania w bezpiecznym miejscu. Sklep został zainstalowany. Wejdź na stronę http://localhost/magento i sprawdź jak wygląda. 22. Niektóre funkcje Magento wymagają cyklicznego uruchamiania pewnych procesów. Z poziomu użytkownika root wydaj polecenie: crontab -u www-data e W otwartym do edycji pliku zamieść na końcu wiersz * * * * * /bin/sh /var/www/magento/cron.sh Zamknij edytor (CTRL+X, T). 23. Przejdź do strony http://localhost/magento/index.php/admin/ i zaloguj się na konto użytkownika admin z hasłem adminstudent1. Zamknij powiadomienie o konieczności ustawienia telefonów. Jak widać na głównym ekrani/e administracyjny, po prawej stronie znajduje się miejsce na wykres dotyczący zamówień. Zmień zakres wykresu na dwa lata (select Range: 2YTD). Jeżeli zamiast wykresu pojawił się łańcuch znaków wykonaj następujące działanie. Z wiersza poleceń uruchom sudo nano app/design/adminhtml/default/default/template/dashboard/graph.phtml W edytorze znajdź (CTRL+W) dwa wystąpienia funkcji getcharturl i zmodyfikuj je tak, by był w nich przekazywany jeden parametr o wartości true (getcharturl(true)). Zapisz zmiany (CTRL+X, T). 24. Przejdź do strony sklepu i załóż konto klienta. Sam(a) określ dane do tego konta. Zakładanie konta jest dostępne przez Account Register.. Przeglądnij katalog produktów i wybierz jeden z nich. Dodaj go do koszyka, a następnie złóż zamówienie. Ponownie sam(a) określ brakujące informacje np. o telefonie klienta, sposobie dostawy itp. 25. Wróc do panelu administracyjnego. Przejdź do zakładki Dashboard, czyli głównego okna panelu administracyjnego. Zauważ, że zamiast wykresu pojawia się napis no data foud, a kwoty poniżej wykresu są równe 0. Pierwsze jest spowodowane tym, że nie zrealizowano zamówienia. Drugie natomiast tym, że nie zostały odświeżone statystyki. Przeznacz 15-20 minut na ogólne zapoznanie się z panelem administracyjnym. Postaraj się w tym czasie zaakceptować zamówienie złożone na stronie sklepu (wysłanie towaru i wystawienie faktury w Sales Order). Sprawdź zawartość głównego ekranu panelu administracyjnego. Jeżeli nadal kowota dla Revenue jest równa 0, przejdź do zakładki Reports i wybierz polecenie Refresh Statistics. Zaznacz Orders i wybierz Submit. Jeszcze raz sprawdź ekran główny panelu administracyjnego.
Nowy sklep 26. Jak widać panel sterowania i wszystkie jego elementy są w języku angielskim. Dla ułatwienia można zainstalować polską wersję językową. W tym celu skopiuj rozpakowane tłumaczenia do katalogu magento sudo cp -r /home/ziwee/downloads/magento-translation-pl_pl-master/pl_pl /var/www/magento/app/locale 27. Przejdź do zakładki Privileges. Zaznacz użytkownika magentowww. Zaznacz również usunięcie bazy danych powiązanej z tym użytkownikiem (Drop the databases thet have the same names as the users). Wybierz przycisk Go w panelu Remove selected users. 28. Otwórz terminal, wejdź na konto użytkownika root. Wydaj polecenie usunięcia aktualnej instalacji Magento rm r /var/www/magento 29. Wykonaj ponownie działania opisane w krokach od 7 do 11 oraz 14. Wykonaj ponownie działania opisane w krokach od 17 do 21 i zaloguj się do panelu administracyjnego. 30. Pamięć cache jest intensywnie używana przez Magento dla szybszego wysyłania odpowiedzi do użytkownika. W ogólności mechanizm ten powinien być włączony, jednak podczas wprowadzania zmian warto go wyłączyć, by bez ciągłego odświeżania pamięci cache obserwować zmiany na stronie. Zaloguj się do panelu administracyjnego i przejdź do zakładki System Cache Management. Zaznacz wszystkie pozycje na liście (Select All), a następnie wybierz akcję Disable z listy po prawej stronie. Kliknij przycisk Submit. Efekt powinien być następujący: 31. Przejdź do zakładki System->Manage Stores. Jak widać, domyślnie dostępna jest jedna witryna (Main Website), jeden sklep (Main Website Store) oraz jeden widok sklepu (Default Store View). O ile jedna witryna i jeden sklep odpowiadają naszym potrzebom, chcemy dwa widoki sklepu dla obsługi dwóch języków. Kliknij na dostępny widok sklepu. Zmień jego nazwę na Polski. Wybierz przycisk Save Store View. 32. Dodaj nowy widok sklepu dla klientów posługujących się językiem angielskim. W tym celu wybierz przycisk Create Store View. Tworzony widok sklepu powinien być widokiem dla sklepu Main Website Store. Jako nazwę wprowadź English. Kod widoku sklepu ustaw na english. Parametr określający dostępność widoku dla
klientów (Status) ustaw na Enabled. Ostatni parametr określa porządek widoków sklepu po stronie klienta. Może ustawić wartość tego parametru na 1. 33. Kolejnym elementem jest ustawienie odpowiedniego języka dla każdej ze stron (a konkretnie ustawienie lokalizacji). Przejdź do zakładki System Configuration. Po lewej stronie znajdziesz listę rozwijaną z etykietą Current Configuration Scope. Zgodnie z nazwą wskazuje ona, na jakim poziomie, dla jakiej witryny/sklepu/widoku pokazywane i edytowane są parametry. Zakres parametrów dostępny jest poprzez menu boczne znajdujące się poniżej. Upewnij się, że aktualny zakres konfiguracji jest ustawiony na Default Config. Przejdz do ustawień General. Rozwiń element Countries Options i wybierz z listy Default Country pozycję Polska. 34. Rozwiń element Store Information i wypełnij dane o sklepie (nazwa, telefon, kraj, adres) użyj wymyślonych przez siebie danych. Zapisz zmiany klikając na przycisk Save Config. 35. Ponieważ domyślnym językiem został wybrany j. polski, dla anglojęzycznej wersji sklepu trzeba ustawić odpowiednią lokalizację. Ustaw zasięg konfiguracji (Current Configuration Scope) na English. Przejdź do ustawień General i rozwiń element Locale options. Odznacz opcję dziedziczenia z ustawień witryny i wybierz język angielski (Stany Zjednoczone). Zapisz konfigurację (przycisk Save Config). 36. Sprawdź na stronie dla klientów, czy jest możliwe przełączanie się pomiędzy wersjami angielską i polską sklepu. Czy są jakieś różnice w wyglądzie pomiędzy tymi wersjami? Czy język obu wersji jest różny? 37. Zarówno strona polska, jak i angielska sklepu są w j. angielskim. Wynika to z braku plików tłumaczeń w naszej instalacji Magento. Tłumaczenia można znaleźć na różnych stronach poświęconych tematyce Magento, także w Magento-Connect. Jedno z nich znajduje się w katalogu /home/ziwee/documents/magento- Translation-pl_PL-master (było spakowane w dostarczonym pliku zip). Wykonaj poniższe polecenia (z poziomu root a) by skopiować dostarczone pliki we właściwe miejsce i ustawić odpowiednie uprawnienia. cp -r /home/ziwee/downloads/magento-translation-pl_pl-master/pl_pl/ /var/www/magento/app/locale/ cd /var/www/magento/app/locale chown www-data -R. find. -type f -exec chmod 600 {} \; find. -type d -exec chmod 700 {} \; 38. Ponownie sprawdź wygląd dwóch wersji językowych sklepu. Jak widać, większość elementów została przetłumaczona, jednak nie wszystkie. Część z tych elementów to zawartość statyczna, określona m.in. w konfiguracji sklepu. Powróć do panelu administracyjnego. Przełącz się na zakładkę Dashboard. Zauważ, że język w panelu uległ zmianie. Zainstalowane tłumaczenia zawiera zarówno tłumaczenia pojęć na stronach dla klientów, jak i na stronach dla pracowników/administratorów. Dla uniknięcia nieporozumień od tego momentu podawane będą polskie nazwy elementów panelu administracyjnego (o ile zostały przetłumaczone). 39. Otwórz zakładkę CMS Strony. W tabelce znajdziesz informacje o statycznych stronach takich jak About Us, Privacy Policy etc. Kliknij na wiersz opisujący stronę Home page. Zmień tytuł strony na Strona główna. Jako widok sklepu wybierz Polski. Korzystając z menu po lewej stronie wybierz zakładkę Zawartość. Zmień napis Home Page na Witamy w naszym sklepie. Kliknij przycisk Zapisz stronę. W tym momencie strona główna będzie się wyświetlała tylko dla polskiej wersji. Dodaj nową stronę główną i przypisz ją dla języka angielskiego. Użyj w tym celu klucza (klucz URL) z wartością home dla nowo dodanej strony. Postaraj się o spójny wygląd obu wersji strony. 40. Jak już wcześniej widzieliśmy, tłumaczenia na języki inne niż angielski mogą okazać się niepełne. W takim wypadku, jeśli programista wie że nieprzetłumaczony jest element platformy (a nie np. tytuł strony napisany przez użytkownika), może w szybki sposób dodać tłumaczenie w następujący sposób. Należy rozwinąć zakładkę System Konfiguracja, po lewej wybrać Zaawansowane Programista i rozwinąć grupę Tłumaczenie liniowe. Jeśli włączone zostanie tłumaczenie liniowe dla sklepu lub panelu administracyjnego i konfiguracja zostanie zapisana, po odświeżeniu sklepu, elementy które można tłumaczyć liniowo zostaną otoczone czerwoną obwódką. Kliknięcie na taki element (symbol książki) otwiera okno tłumaczenia.
41. Ćwiczenie: Znajdź na stronach sklepu w języku polskim nieprzetłumaczone elementy i dodaj własne tłumaczenia. Wyłącz tłumaczenie liniowe. 42. Ostatnim elementem tego ćwiczenia będzie dodanie własnego motywu. Motyw taki można wykonać samodzielnie. W internecie można znaleźć również gotowe motywy zarówno darmowe, jak i płatne. My wykorzystamy darmowy motyw. Znajdował się on w pliku magento_all.zip. Skopiuj pliki motywu do odpowiednich katalogów Magento i ustaw uprawnienia: cp -r /home/ziwee/downloads/electronics/* /var/www/magento/ cd /var/www/magento/ chown www-data -R. find. -type f -exec chmod 600 {} \; find. -type d -exec chmod 700 {} \; 43. Przejdx do panelu administracyjnego i wybierz zakładkę System Konfiguracja. Z bocznego menu w sekcji OGÓLNE wybierz pozycję Wygląd. Rozwiń element Paczka i zmień nazwę obecnego pakietu z rwe na default. Rozwiń element Motywy. Wprowadź nazwę motywu electronics do wszystkich pól. Zapisz konfigurację i sprawdź wygląd sklepu.