aimeos für TYPO3: E-Commerce & Online-Shop

Wer einen Shop in TYPO3 braucht, kommt an aimeos kaum vorbei

Unternehmen, die bereits eine TYPO3-Website betreiben und E-Commerce ergänzen wollen, stehen vor einer Grundsatzfrage: separates Shopsystem (Shopware, Magento, WooCommerce) mit Schnittstelle zum CMS, oder ein natives E-Commerce-Framework innerhalb von TYPO3? aimeos ist die zweite Option und seit über 10 Jahren das etablierteste TYPO3-Shop-Framework. Über 200.000 Installationen weltweit (Stand: Packagist, 2026), aktive Entwicklung und Support für TYPO3 v12 und v13 sprechen für Stabilität.

Der entscheidende Vorteil: Content und Commerce laufen im selben System. Produktseiten nutzen TYPO3-Content-Elemente, Landingpages können Shop-Komponenten einbetten, Redakteure arbeiten in einer Oberfläche. Bei getrennten Systemen entstehen Synchronisationsprobleme, doppelte Pflege und inkonsistentes Design.

Typische Einsatzszenarien

B2B-Shops mit komplexer Preislogik. Industrieunternehmen mit kundenspezifischen Preisen, Staffelrabatten, Mindestbestellmengen und Freigabe-Workflows. aimeos unterstützt Kundengruppen-Preise, Preis-Plugins und Regelwerke nativ. Ein Chemie-Distributor mit 8.000 Artikeln und 400 Kundengruppen lässt sich damit abbilden, ohne dass jede Preisregel hardcodiert wird.

Marktplätze und Multi-Vendor-Szenarien. aimeos kann als Marktplatz-Backend dienen, bei dem mehrere Lieferanten ihre Produkte einstellen. Jeder Vendor verwaltet sein Sortiment, die Plattform übernimmt Checkout, Payment und Versand-Routing. Das Framework unterstützt Multi-Shop-Setups, bei denen verschiedene Storefronts auf denselben Katalog zugreifen, aber unterschiedliche Sortimente und Preise zeigen.

Internationalisierung ab Tag 1. Unternehmen mit Websites in 5+ Sprachen und mehreren Währungen profitieren davon, dass aimeos Multi-Language und Multi-Currency nativ mitbringt. Produktnamen, Beschreibungen und SEO-Metadaten lassen sich pro Sprache pflegen. Preise können pro Währung definiert oder automatisch umgerechnet werden.

Technische Architektur

aimeos basiert auf einer eigenen MVC-Architektur (Manager, Controller, Client), die in TYPO3 als Extension integriert wird. Der Kern ist Framework-agnostisch und läuft auch unter Laravel und Slim. Die TYPO3-Adapter-Schicht stellt sicher, dass aimeos-Plugins als TYPO3-Content-Elemente eingebettet werden.

Der Produktkatalog nutzt eine Baum-Struktur mit beliebig tiefer Verschachtelung. Attribute (Farbe, Grösse, Material) werden als eigene Entitäten verwaltet und über Facettenfilter ausgegeben. Die Suchfunktion basiert standardmässig auf SQL-Volltextsuche, lässt sich aber auf Elasticsearch oder Solr umstellen.

Payment-Integrationen laufen über Service-Provider: Stripe, PayPal, Mollie, Amazon Pay, Klarna und weitere sind als Plugins verfügbar. Jeder Payment-Provider wird über eine einheitliche API angesprochen. Der Checkout-Prozess ist als Step-Pipeline implementiert und um eigene Schritte erweiterbar (z.B. Altersverifikation, B2B-Freigabe).

Caching erfolgt auf mehreren Ebenen: TYPO3 Page Cache für statische Seiten, aimeos-internes Caching für Katalog-Abfragen und optional Varnish oder Cloudflare als Reverse Proxy. Bei Katalogen mit über 100.000 Artikeln ist das Index-Management entscheidend: aimeos erstellt Such- und Preis-Indizes, die bei Produkt-Updates inkrementell aktualisiert werden.

Häufige Probleme und Lösungen

Performance-Einbrüche bei grossen Katalogen. Shops mit 50.000+ Artikeln werden langsam, wenn die Indizes nicht aktuell sind oder der Katalog-Cache deaktiviert wurde. Lösung: php typo3/sysext/core/bin/typo3 aimeos:jobs als Cronjob (alle 5 Minuten für Index-Updates, stündlich für Aufräumjobs). Den aimeos-Admin-Cache nach Massenimporten manuell leeren.

Checkout-Abbrüche durch Payment-Fehler. Häufige Ursache: veraltete API-Keys oder falsche Webhook-URLs nach Domain-Umzug. Jeder Payment-Provider braucht eine korrekte Notify-URL, über die Zahlungsbestätigungen asynchron eintreffen. Lösung: Webhook-URLs im Payment-Provider-Dashboard nach jedem Umzug prüfen, Testbestellungen im Sandbox-Modus durchführen.

Konflikte mit TYPO3-Caching. aimeos-Seiten mit Warenkorb oder Login dürfen nicht im TYPO3 Page Cache landen. Lösung: Die relevanten Seiten als USER_INT markieren oder aimeos im SPA-Modus (AJAX-basiert) betreiben. Seit aimeos 2024.x wird der SPA-Modus als Standard empfohlen.

Migration und Versions-Kompatibilität

aimeos unterstützt TYPO3 v12 LTS vollständig und TYPO3 v13 seit aimeos 2024.x. Für TYPO3 v11 gibt es Maintenance-Releases, aber keine neuen Features.

Migration von anderen Shop-Systemen ist ein realistisches Szenario. Von Shopware, WooCommerce oder tt_products lassen sich Produkte, Kategorien, Kundenkonten und Bestellhistorie nach aimeos übertragen. Gosign nutzt dafür CSV/XML-Import-Pipelines, bei denen Produktdaten transformiert und in die aimeos-Struktur gemappt werden. Je nach Datenqualität dauert die Migration eines Shops mit 5.000 Produkten zwischen 3 und 10 Tagen.

Wer von tt_products kommt, sollte den Umstieg mit der nächsten TYPO3-Major-Version planen: tt_products wird seit Jahren nur noch minimal gepflegt und hat keine offizielle TYPO3 v13-Kompatibilität.

Ein weiterer Migrationspfad betrifft Unternehmen, die bisher einen separaten Shopware- oder Magento-Shop parallel zur TYPO3-Website betrieben haben. Die Zusammenführung in ein System eliminiert die Schnittstellen-Komplexität: keine REST-API-Synchronisation für Produktdaten, kein doppeltes Template-Management, keine getrennten Deployments. Der Nachteil: aimeos deckt nicht alle Features ab, die ein dediziertes Shopsystem bietet (z.B. Shopware Flow Builder, Magento Page Builder). Die Abwägung lohnt sich aber für Unternehmen, bei denen Content und Commerce gleichwertig sind, nicht nur der Shop zählt, sondern auch Magazin, Wissensdatenbank und Service-Seiten.

Gosign berät projektspezifisch, ob aimeos die richtige Wahl ist oder ob ein separates Shopsystem mit Headless-Anbindung an TYPO3 die bessere Architektur darstellt. Die Entscheidung hängt von drei Faktoren ab: Katalog-Komplexität (Varianten, Konfiguratoren, Bundles), Transaktionsvolumen (unter oder über 1.000 Bestellungen pro Tag) und vorhandene TYPO3-Infrastruktur (Extensions, Templates, Redaktions-Workflows).

Ein aimeos-Setup mit Produktkatalog, Warenkorb, Stripe- und PayPal-Payment, Versandkostenberechnung und Basis-Templates kalkuliert Gosign mit 15 bis 25 Entwicklungstagen. Custom-Themes, komplexe Preislogik oder Marktplatz-Features erhöhen den Aufwand entsprechend. Der laufende Betrieb erfordert regelmässige Updates (aimeos und Payment-Provider-Plugins) sowie Monitoring der Checkout-Performance und Conversion-Rate. Sicherheits-Patches für aimeos und die Payment-Plugins sollten innerhalb von 48 Stunden eingespielt werden, weil Shop-Systeme mit Zahlungsdaten ein bevorzugtes Angriffsziel sind.