aimeos dla TYPO3: E-Commerce i sklep online

Kto potrzebuje sklepu w TYPO3, praktycznie nie ominie aimeos

Firmy, które już prowadzą witrynę TYPO3 i chcą uzupełnić ją o e-commerce, stają przed zasadniczym pytaniem: oddzielny system sklepowy (Shopware, Magento, WooCommerce) z interfejsem do CMS, czy natywny framework e-commerce wewnątrz TYPO3? aimeos to ta druga opcja i od ponad 10 lat najbardziej ugruntowany framework sklepowy TYPO3. Ponad 200 000 instalacji na całym świecie (stan: Packagist, 2026), aktywny rozwój i wsparcie dla TYPO3 v12 i v13 świadczą o stabilności.

Decydująca przewaga: treść i handel działają w tym samym systemie. Strony produktowe korzystają z elementów treści TYPO3, landing page mogą osadzać komponenty sklepowe, redaktorzy pracują w jednym interfejsie. Przy rozdzielonych systemach pojawiają się problemy z synchronizacją, podwójna pielęgnacja i niespójny design.

Typowe scenariusze zastosowań

Sklepy B2B ze złożoną logiką cenową. Firmy przemysłowe z cenami indywidualnymi dla klientów, rabatami ilościowymi, minimalnymi ilościami zamówień i workflow zatwierdzania. aimeos natywnie wspiera ceny grup klientów, pluginy cenowe i systemy reguł. Dystrybutor chemiczny z 8000 artykułami i 400 grupami klientów da się odwzorować bez hardkodowania każdej reguły cenowej.

Marketplace i scenariusze multi-vendor. aimeos może służyć jako backend marketplace, w którym wielu dostawców umieszcza swoje produkty. Każdy vendor zarządza swoim asortymentem, platforma przejmuje checkout, płatności i routing wysyłki. Framework wspiera konfiguracje multi-shop, w których różne storefronty korzystają z tego samego katalogu, ale pokazują różne asortymenty i ceny.

Internacjonalizacja od pierwszego dnia. Firmy z witrynami w ponad 5 językach i wieloma walutami korzystają z tego, że aimeos natywnie obsługuje multi-language i multi-currency. Nazwy produktów, opisy i metadane SEO można pielęgnować per język. Ceny można definiować per waluta lub przeliczać automatycznie.

Architektura techniczna

aimeos opiera się na własnej architekturze MVC (Manager, Controller, Client), która jest zintegrowana w TYPO3 jako rozszerzenie. Rdzeń jest niezależny od frameworka i działa również pod Laravel i Slim. Warstwa adapterów TYPO3 zapewnia, że pluginy aimeos są osadzane jako elementy treści TYPO3.

Katalog produktów wykorzystuje strukturę drzewiastą z dowolną głębokością zagnieżdżenia. Atrybuty (kolor, rozmiar, materiał) są zarządzane jako oddzielne encje i wyświetlane przez filtry fasetowe. Funkcja wyszukiwania domyślnie opiera się na pełnotekstowym wyszukiwaniu SQL, ale można ją przełączyć na Elasticsearch lub Solr.

Integracje płatności działają przez providerów usług: Stripe, PayPal, Mollie, Amazon Pay, Klarna i inne są dostępne jako pluginy. Każdy provider płatności jest obsługiwany przez ujednolicone API. Proces checkout jest zaimplementowany jako pipeline kroków i można go rozszerzać o własne etapy (np. weryfikacja wieku, zatwierdzenie B2B).

Cachowanie odbywa się na kilku poziomach: TYPO3 Page Cache dla statycznych stron, wewnętrzne cachowanie aimeos dla zapytań katalogowych i opcjonalnie Varnish lub Cloudflare jako reverse proxy. Przy katalogach z ponad 100 000 artykułami kluczowe jest zarządzanie indeksami: aimeos tworzy indeksy wyszukiwania i cenowe, które są aktualizowane inkrementalnie przy aktualizacjach produktów.

Częste problemy i rozwiązania

Spadki wydajności przy dużych katalogach. Sklepy z ponad 50 000 artykułami stają się wolne, gdy indeksy nie są aktualne lub cache katalogu został dezaktywowany. Rozwiązanie: php typo3/sysext/core/bin/typo3 aimeos:jobs jako cronjob (co 5 minut dla aktualizacji indeksów, co godzinę dla zadań porządkowych). Cache admin aimeos należy wyczyścić ręcznie po masowych importach.

Porzucenia w checkout z powodu błędów płatności. Częsta przyczyna: nieaktualne klucze API lub nieprawidłowe adresy URL webhook po zmianie domeny. Każdy provider płatności potrzebuje prawidłowego Notify-URL, przez który potwierdzenia płatności trafiają asynchronicznie. Rozwiązanie: sprawdzenie adresów URL webhook w panelu providera po każdej zmianie, przeprowadzenie zamówień testowych w trybie sandbox.

Konflikty z cachowaniem TYPO3. Strony aimeos z koszykiem lub loginem nie mogą trafiać do TYPO3 Page Cache. Rozwiązanie: oznaczenie odpowiednich stron jako USER_INT lub uruchomienie aimeos w trybie SPA (opartym na AJAX). Od aimeos 2024.x tryb SPA jest rekomendowany jako standard.

Migracja i kompatybilność wersji

aimeos w pełni wspiera TYPO3 v12 LTS, a TYPO3 v13 od aimeos 2024.x. Dla TYPO3 v11 dostępne są wydania maintenance, ale bez nowych funkcji.

Migracja z innych systemów sklepowych jest realistycznym scenariuszem. Ze Shopware, WooCommerce lub tt_products można przenieść produkty, kategorie, konta klientów i historię zamówień do aimeos. Gosign wykorzystuje do tego pipeline importu CSV/XML, w którym dane produktowe są transformowane i mapowane na strukturę aimeos. W zależności od jakości danych migracja sklepu z 5000 produktami trwa od 3 do 10 dni.

Kto przechodzi z tt_products, powinien zaplanować zmianę wraz z następną główną wersją TYPO3: tt_products jest od lat utrzymywany jedynie minimalnie i nie ma oficjalnej kompatybilności z TYPO3 v13.

Kolejna ścieżka migracji dotyczy firm, które dotychczas prowadziły oddzielny sklep Shopware lub Magento równolegle z witryną TYPO3. Połączenie w jeden system eliminuje złożoność interfejsów: brak synchronizacji REST-API dla danych produktowych, brak podwójnego zarządzania szablonami, brak oddzielnych wdrożeń. Wadą jest to, że aimeos nie pokrywa wszystkich funkcji dedykowanego systemu sklepowego (np. Shopware Flow Builder, Magento Page Builder). Kalkulacja opłaca się jednak dla firm, w których treść i handel są równoważne - nie tylko sklep się liczy, ale też magazyn, baza wiedzy i strony serwisowe.

Gosign doradza w każdym projekcie indywidualnie, czy aimeos to właściwy wybór, czy oddzielny system sklepowy z headless connection do TYPO3 stanowi lepszą architekturę. Decyzja zależy od trzech czynników: złożoności katalogu (warianty, konfiguratory, zestawy), wolumenu transakcji (poniżej lub powyżej 1000 zamówień dziennie) i istniejącej infrastruktury TYPO3 (rozszerzenia, szablony, workflow redakcyjne).