Me(e)t Magento Polska - było warto

Minął już tydzień od powrotu ekipy Baobazu z pierwszego spotkania MeetMagento w Polsce, emocje trochę opadły, ale wciąż uważamy - warto było!

Baobaz na Meet Magento 2012 w Warszawie

Społeczność Magento

Na pierwszym Meet Magento Polska pojawiło się około setki uczestników z całej Europy. Thomas Fleck, z NetResearch, pięknie ubrał to w słowa - Przyjechałem do Polski z Niemiec, by wysłuchać prezentacji szwajcarskiej firmy, w języku angielskim, na temat doświadczeń z implementacją Magento w Ghanie.

Różnorodność doświadczeń uczestników sprzyjała wymianie wiedzy w przerwach między prezentacjami. Dyskusje toczono także w trakcie After Party w klubie Panorama na 40 piętrze hotelu Mariott. A ponadto - w jakich innych okolicznościach moglibyśmy mieć okazję spotkać na raz kilku z byłych członków Magento Core Team i zadać im pytania, które od dawna zadawaliśmy sobie integrując Magento? Oppa Gagnam Style bros! :)

Doświadczeni prezenterzy

Meet Magento było okazją do wysłuchania 22 prezentacji 23 prelegentów (w tym Piotra Kamińskiego, Damiana Luszczymak, Ivana Chepurnyi i Vinai Kopp), którzy podzielili się zarówno swoimi doświadczeniami z integracją Magento jak i rozwiązaniami dla rynku e-commerce (bramki płatności, obsługa korespondencji e-mail). Dzięki obecności przedstawicieli Magento można było też wysłuchać jak Magento rozwijało się w ostatnich latach, na czym polega certyfikacja programistów Magento oraz co dzieje się w temacie Magento 2.0.

Dla tych którzy z niecierpliwością czekają na nową inkarnację Magento wiadomość jest dobra i zła zarazem. Magento dokłada starań by nowa wersja była sprawdzona testami jednostkowymi, funkcjonalnymi i wydajnościowymi, a także w pełni udokumentowana. Oznacza to jednak, że prawdopodobnie Magento 2.0 nie pojawi się wcześniej niż za rok, bowiem zachodzące zmiany wciąż dotykają rdzenia systemu. W między czasie możemy liczyć na kolejne wydania typu Service Pack dla Magento 1.x, które ma być utrzymywane jeszcze przez kilka lat po wydaniu Magento 2.0.

Organizacja

Wielkie gratulacje należą się organizatorom z ekipy Snowdog.pl - Kubie Zwolińskiemu i Marcie Molińskiej - która, mimo że debiutowała w tej roli, przygotowała to wydarzenie w profesjonalny i niezmiernie sympatyczny sposób. Od samego wejścia do hotelu uprzejme dziewczyny w pomarańczowych koszulkach z logo wydarzenia kierowały uczestników na odpowiednie piętro do odpowiedniej sali. Prezentacje w języku polskim były symultanicznie tłumaczone na jezyk angielski i, w takiej też formie, były dostępne w streamie.

Świetna robota! Z niecierpliwością, i na przekór Majom, czekamy na kolejną edycję Meet Magento w 2013 roku!

Bardzo cieszymy się, że mogliśmy jako sponsor wspomóc organizację tego wydarzenia i dziękujemy audytorium, które bardzo ciepło przyjęło naszą prezentację.

Baobaz na Meet Magento Polska

Po raz pierwszy w Polsce społeczność Magento ma okazję spotkać się w jednym miejscu i podzielić doświadczeniami z najdynamiczniej rozwijającym się systemem e-commerce na świecie na konferencji Meet Magento Polska, która odbędzie się w Warszawie w dniach 23-24 listopada (program).

Meet Magento Polska

Baobaz dołączył do tego przedsięwzięcia jako jeden z partnerów, nie zabraknie nas też wśród prelegentów. Autorami prezentacji o przewrotnym tytule "Ale u mnie działa... - czyli repozytoria kodu i automatyczna publikacja w projektach Magento" są posiadacze certyfikatu Magento Certified Developer Plus - Maciej Krasuski i Kamil Węgrzynowicz.

Wszystkich zachęcamy do udziału i spotkania z nami w Warszawie!

Baobaz na Future3

Future3

Już jutro, 23 października, zapraszamy na konferencję Future3 do AmberExpo, gdzie będziecie mogli nas spotkać przy stoisku nr 30 oraz w trakcie krótkiej prezentacji o godzinie 15:56.

Wszystkich uczestników zapraszamy do naszego stoiska, gdzie każdy programista będzie mógł zmierzyć się z krótkim testem wiedzy z programowania w PHP. Wśród osób z największą liczbą poprawnych odpowiedzi zostaną rozlosowane nagrody książkowe.

Zespół Baobaz Polska się rozrasta

I na tym nie koniec, bo rekrutacja wciąż trwa!
Zespół Baobaz Polska

Konfiguracja Magento do pracy z wieloma stronami lub sklepami

Istnieje wiele poradników w których napisano jak skonfigurować Magento do pracy z wieloma sklepami, tak by różne domeny wskazywały na wybrane sklepy. Począwszy od wydań Magento CE 1.4.0.0-alpha2 i Magento EE 1.6.0.0 stało się to wiele prostsze w wykonaniu.

Magento ewoluuje

Rozwiązania stosowane w poprzednich wersjach wymagały od programisty modyfikacji zawartości pliku index.php, jeżeli chciał obsłużyć wyświetlanie różnych sklepów zależnie od domeny. Nowy plik index.php zawiera następujący kod:

$mageRunCode = isset($_SERVER['MAGE_RUN_CODE']) ? $_SERVER['MAGE_RUN_CODE'] : '';
$mageRunType = isset($_SERVER['MAGE_RUN_TYPE']) ? $_SERVER['MAGE_RUN_TYPE'] : 'store';

Mage::run($mageRunCode, $mageRunType);

Sprawdza on dwie zmienne środowiskowe i używa ich uruchamiając Magento. Jakie możliwości to nam daje? Możemy teraz ustawić który sklep ma działać pod daną domeną bezpośrednio w definicji wirtualnego hosta a nawet w pliku .htaccess.

Rozwiązanie z użyciem VirtualHost

Aby czerpać z korzyści powyższego kawałka kodu wystarczy dodać następujące linie wewnątrz definicji wirtualnego hosta:

SetEnv MAGE_RUN_CODE "base" # wstaw tu kod strony lub sklepu
SetEnv MAGE_RUN_TYPE "website" # wstaw tu 'website' lub 'store'

Rozwiązanie z użyciem .htaccess

Jeżeli nie masz dostępu do definicji wirtualnego hosta, możesz wciąż wykorzystać w tym celu plik .htaccess, umieszczając w nim następujące linie:

SetEnvIf Host .*yourhost.* MAGE_RUN_CODE=base
SetEnvIf Host .*yourhost.* MAGE_RUN_TYPE=website

Gdzie .*yourhost.* jest wyrażeniem regularnym wychwutującym domenę dla której chcesz ustawić zmienną środowiskową.

Masz zatem teraz możliwość skonfigurować Magento do pracy z wieloma sklepami bez konieczności mieszania w rdzeniu Magento. Powodzenia.

Opcje backoffice (Panelu Admina) w Magento - [Część 2]

Gdy już pomówiliśmy o opcjach "Panelu Admina" w Magento (Opcje backoffice (Panelu Admina) w Magento - [Część 1]), przejdźmy wreszcie do praktyki. W poprzedniej części pojawiła się informacja o tym, że możesz dodać do menu własne elementy. Ta możliwość przydaje się, gdy dopisujesz moduły i chcesz nimi zarządzać - oczywiście możesz stworzyć nowy element menu po to, by zmieniać ustawienia już istniejących funkcjonalności. Zatem - do dzieła ;)

Przede wszystki potrzebujemy nowego modułu. Możesz skorzystać z tego, który dołączyłam, to moduł napisany specjalnie do zaprezentowania tego, co opiszę. Będzie wyświetlał aktualny czas na podstawie wybranego przez ciebie formatu. Powinien być poprawnym argumentem funkcji date() w PHP.

Dodanie elementu następuje w pliku config.xml. Potrzebujemy d tego następujących linii:

<adminhtml>
    <menu>
        <example translate="title" module="adminhtml">
            <title>Set Time Format</title>
            <sort_order>60</sort_order>
            <children>
                <set_time>
                    <title>Set It!</title>
                    <action>example/index</action>
                </set_time>
            </children>
        </example>
    </menu>
</adminhtml>

Ten kod utworzy element menu o tytule Set Time Format z podmenu Set It!, które będzie prowadzić do modułu o identyfikatorze example, kontrolera index, akcji index. To wszystko, co jest potrzebne. Sprawdź efekt w Panelu Admina - 'Set Time Format' powinno pojawić się pomiędzy Catalog i Customers. Jeśli tak nie jest - wyczyść cache.

Dane przechowuję wspólnie z ustawieniami konfiguracyjnymi Magento. Nie jest to dobre rozwiązanie w przypadku profesjonalnego projektu, jednak zdecydowałam się na nie, aby nie tworzyć więcej kodu, niż było to konieczne.

Element zarządzający ustawieniami można dodać również na stronie System->Configuration. Wymaga to nieco innego podejścia, które zostanie opisane w części 3.

Magento - moduł tłumaczeń

Jedną z najlepszych rzeczy w magento jest możliwość łatwego dodawania nowych wersji językowych do strony. Robi się to używając plików CSV. Dla każdego języka mamy jeden plik na jeden moduł. Dla najpopularniejszych języków gotowe tłumaczenia dostępne są za darmo jako moduły Magento w systemie magento connect.

A co jeśli chcemy zmienić jakieś tłumaczenie i nie zgubić zmian po uaktualnieniu magento i modułów z tłumaczeniami? Lub jeśli chcemy mieć jakieś teksty tłumaczone poza kontekstem jednego modułu? Lub po prostu mieć wykaz wszystkich tekstów które zostały przez nas dodane a nie ma ich w "gołym" magento? Możemy stworzyć swój własny prosty moduł tłumaczeń.

Wystarczy stworzyć 2 pliki:

  • etc/config.xml
     <?xml version="1.0"?>
     <config>
            <modules>
                    <baobaz_translations>
                            <version>0.1.0</version>
                    </baobaz_translations>
            </modules>
           
            <global>
                    <helpers>
        <translations>
        <class>Baobaz_Translations_Helper</class>
        </translations>
        </helpers>
            </global>
           
            <frontend>
        <translate>
        <modules>
                                    <baobaz_translations>
                                            <files>
                                                    <default>Baobaz_Translations.csv</default>
                                            </files>
                                    </baobaz_translations>
                            </modules>
        </translate>
        </frontend>
     
     </config>
     
  • oraz helper/data.php:
    class Baobaz_Translations_Helper_Data extends Mage_Core_Helper_Abstract
    {

    }

 

I to wszystko... Moduł trzeba włączyć (w etc/modules) i wszystko będzie działać.

w app/locale/fr_fr/ tworzymy plik Baobaz_Translations.csv a w nim wstawiamy wszystkie przetłumaczone teksty.

Następnie wszędzie w projekcie - niezależnie od tego czy jest to szablon, blok czy kontroler możemy użyć składni:

echo Mage::helper('translations')->__('tekst do tłumaczenia');

Tak, to jesttak proste.

Prototype i jQuery w Magento

Jak wiemy, standardowa instalacja Magento dostarczana jest z javascriptową biblioteką Prototype. Razem z odpowiedzialną za efekty script.aculo.us składa się na potężne narzędzie ułatwiające tworzenie różnego rodzaju funkcjonalności działających po stronie przeglądarki. Na tym jednak nie koniec - Prototype dostarcza również framework do obsługi modnej i przydatnej technologii Ajax, dzięki czemu tworzenie ajaxowych zapytań staje się niebywale proste. Funkcjonalność Prototype'a wykorzystywana jest w wielu szablonach Magento, między innymi do pokazywania/ukrywania bloków zależnie od wyboru użytkownika, tudzież do wyświetlania komunikatów o błędzie z eleganckim efektem "fade".

Jednakże nie jest to jedyna javascriptowa biblioteka oferująca tak przydatny zestaw funkcji. Wśród innych popularnych bibliotek wyróżnić można jQuery - niewielką objętościowo (skompresowana zajmuje 19KB), prostą w użyciu i do tego, przyznaję, moją ulubioną. Stworzona w 2006, błyskawicznie zyskała sobie grono użytkowników, którzy opracowali do niej mnóstwo rozszerzających jej funkcjonalność wtyczek.

Zastanówmy się jednak, czy to dobry pomysł by wykorzystywać obie te biblioteki jednocześnie w jednym projekcie Magento? Moim zdaniem nie, przynajmniej w większości przypadków. Dlaczego? Jest kilka głównych powodów:

  • Obydwie dostarczają podobną funkcjonalność, w związku z czym praktycznie nie ma rzeczy, którą da się osiągnąć w jednej, a w drugiej byłoby to niemożliwe
  • Więcej dołączonych plików .js oznacza wolniejsze ładowanie się stron i słabszą wydajność
  • Biblioteki te używają czasem tej samej notacji, co może prowadzić do konfliktów

Niemniej jednak w pewnych przypadkach dołączenie jQuery do funkcjonalności sklepu w Magento może być konieczne. Na przykład w sytuacji gdy potrzebujemy biblioteki dostarczającej nam konkretnej funkcjonalności, a biblioteka ta jest stworzona jako wtyczka do jQuery. Jak więc sprawić by Prototype i jQuery działały razem bez żadnych konfliktów?

Po pierwsze, należy ściągnąć najnowszą wersję jQuery (póki co ostatnia wersja to 1.3.2) i zapisać ją w folderze /js/jquery. Następnie trzeba dołączyć ją do wszystkich stron Magento - najbardziej logicznym sposobem, by tego dokonać, jest wstawienie poniższego kodu w pliku /app/design/frontend/.../.../layout/page.xml, w sekcji <block type="page/html_head">:

<action method="addJs"><script>jquery/jquery-1.3.2.min.js</script></action>

Nadeszła pora na poradzenie sobie z konfliktami z Prototype - obie biblioteki używają notacji $ (w jQuery jest to skrót do jQuery, podczas gdy w Prototype służy ona za alias do funkcji getElementById. Na szczęście twórcy jQuery wpadli na to, by stworzyć mechanizm do przeciążania funkcji $: jQuery.noConflict(). Można zatem umieścić poniższą linijkę na końcu pliku jquery-1.3.2.min.js:

var $j = jQuery.noConflict();

Od tej chwili należy używać funkcji $j wszędzie tam, gdzie do tej pory używana była $ (cały czas można również stosować jQuery). Pamiętajcie więc o zastąpieniu wszystkich wystąpień funkcji $ we wtyczkach do jQuery (o ile nie zostało to już domyślnie zaimplementowane przez autorów wtyczki).

W tym miejscu normalnie zakończylibyśmy nasze rozważania, gdyby nie jedna przeglądarka, która wciąż, mimo wprowadzonych przez nas rozwiązań, ma problemy ze wspólnym działaniem Prototype i jQuery. I nie, nie jest to Internet Explorer ;) Co zaskakujące, to Firefox 2. Przeglądarka ta wyrzuca mało zrozumiałe błędy, po których przestaje wykonywać załączony JavaScript. Oczywiście, od dawna są już dostępne nowsze wersje Firefoxa, w których po tym problemie nie ma już śladu, ale ciągle jest przecież jakaś drobna część internautów, którzy używają Firefoxa 2 i być może koniecznie chcą wydać pieniądze w Waszym sklepie ;)

Istnieje na szczęście prosty sposób na rozwiązanie tego problemu: trzeba umieścić instrukcję dołączającą jQuery przed dołączeniem Prototype. A zatem należy postąpić następująco w pliku page.xml:

<action method="addJs"><script>jquery/jquery-1.3.2.min.js</script></action>
<action method="addJs"><script>prototype/prototype.js</script></action>

Od tej chwili o wszelkich konfliktach możecie zapomnieć, a owe dwie wspaniałe biblioteki będą ze sobą idealnie współpracowały.

Dodawawanie tłumaczeń w Magento

Tłumaczenia pomiędzy językami są całkiem proste do zrealizowania w Magento. Dla doświadczonego programisty PHP, który pracował już z frameworkami, nie ma nawet o czym wspominać. Jednak osoba, która stawia pierwsze kroki w budowaniu wielojęzycznej aplikacji. może potrzebować kilku słów wprowadzenia. Teksty, które przeznaczone są do tłumaczenia, przechowywane są w plikach CSV, w katalogu /app/locale/[kod_jezyka]. Część ścieżki oznaczona jako [kod_jezyka] to na przykład 'pl_PL'.

Przyjrzyjmy się teraz zawartości któregoś z tych plików - każdy z nich ma tę samą strukturę. Linie w każdym pliku zawierają dwa teksty oddzielone przecinkiem: jeden w twoim domyślnym języku i jeden w języku docelowym. Aby móc używać tych plików - nazywanych też słownikami - trzeba zadeklarować je w pliku konfiguracyjnym danego modułu (config.xml). Poniższy kod musi zostać umieszczony wewnątrz znacznika frontendu lub admina - zależnie od tego, dla której części sklepu przeznaczone są tłumaczenia.

<translate>
        <modules>
                <nazwafirmy_nazwamodulu>
                        <files>                 <default>NazwaFirmy_NazwaModulu.csv</default>
                        </files>
                </nazwafirmy_nazwamodulu>
        </modules>
</translate>

To wszystko ;) Teraz, aby użyć tekstu, który ma zostać przetłumaczony, napisz:

echo $this->__('tekst do przetłumaczenia');

Magento sprawdzi czy w słownikach znajduje się tekst o treści 'tekst do przetłumaczenia' i wyświetli odpowiadające mu tłumaczenie w języku aktualnego sklepu.

Opcje backoffice (Panelu Admina) w Magento - [Część 1]

Jeśli rozpoczynasz dopiero swoją przygodę z Magento, możesz być przerażony ilością opcji, którą oferuje ci backoffice (nazywany też "Panelem Admina"). Po typowej instalacji dostępne są: Dashboard, Sales, Catalog, Customers, Promotions, Newsletter, CMS, Reports, and System (jeśli nie wszystkie z nich widzisz, upewnij się, że jesteś zalogowany z uprawnieniami administratora). W dalszych częściach omówimy też dodawanie własnych elementów menu. Wszystkie z tych elementów, które widzisz, zawierają podmenu - wyjątkiem jest tylko Dashboard. Czas, aby przyjrzeć się niektórym z nich.

Dashboard to strona domyślna "Panelu Admina". Możesz na niej zobaczyć zestawienie najważniejszych informacji na temat wybranego sklepu - dane najnowszych zamównień, najnowsze zamówienia z wybranego zakresu czasu, kwotę zamówień z wybranego zakresu czasu, najlepiej sprzedające się produkty, produkty najczęściej oglądane, nowych klientów... Jest to zatem właśnie to, czego można się spodziewać po domyślnej stronie "Panelu Admina". Sales umożliwia ci zarządzanie zamówieniami (Orders), fakturami (Invoices), dostawami (Shipments) i podatkami nakładanymi na produkty (Tax). Właśnie tu możesz przyjrzeć się lub modyfikować zamówienia, składane przez twoich klientów. Możesz je przeglądać, odwoływać, wstrzymywać i drukować. Czego trudniej się domyślić, ta sekcja zawiera także możliwość ustalenia warunków sprzedaży (Terms and Conditions).

Kolejny element menu to System. Zawiera kilka opcji wartych zapamiętania. Tools pozwoli ci na wykonanie kopii zapasowej. Chyba nie trzeba nikogo przekonywać, że warto korzystać z tej opcji ;) Jest tu też Cache Management, czyli zarządzanie pamięcią podręczną. A na końcu - konfiguracja (Configuration). Zajrzyj do zakładki określającej wygląd twojego sklepu (Design). Tutaj wybierasz skórkę dla sklepu(skin), rozmieszczenie elementów (layout) i domyślny motyw graficzny (theme). Magento wybierze motyw domyślny wtedy, gdy nie znajdzie tego, który wybierzesz. Możesz też wybrać znak wodny dla obrazków używanych w sklepie. No i w końcu - ustawienie, którego używam najczęściej.

Zajrzyj do zakładki Developer, wewnątrz Configuration. Wybierz swój sklep jako zakres konfiguracyjny (Current Configuration Scope) w polu po lewej. Zauważysz, że sekcja Debug będzie teraz zawierać pola Wskazówki dla ścieżek szablonów (Template Path Hints), and Dodaj do wskazówek nazwę bloku (Add Block Names to Hints). Odznacz Użyj strony web(Use website) i ustaw oba na Yes. Teraz wróć do frontoffice i odśwież stronę (upewnij się, że znajdujesz się w tym sklepie, który wybrałeś w Configuration Scope e Panelu Admina). Otrzymasz nazwy szablonów (template'ów), użytych do wyświetlenia strony, razem z odpowiadającymi im nazwami bloków. Przerywane linie wyznaczają granice szablonów. Wierz mi - warto zapamiętać tę opcję ;)