TYPO3 e-commerce extension for professional, ultra fast online shops, complex B2B applications and #gigacommerce
:star: Star us on GitHub — it motivates us a lot!
Aimeos is THE professional, full-featured and high performance e-commerce extension for TYPO3! You can install it in your existing TYPO3 web site within 5 minutes and can adapt, extend, overwrite and customize anything to your needs.
This document is for the latest Aimeos TYPO3 21.10 release and later.
Note: composer 2.1+ is required!
The latest version can be installed via composer too. This is especially useful if you want to create new TYPO3 installations automatically or play with the latest code. You need to install the composer package first if it isn't already available:
php -r "readfile('https://getcomposer.org/installer');" | php -- --filename=composer
In order to tell install TYPO3, you have to execute
composer create-project typo3/cms-base-distribution myshop
This will install TYPO3 into the
Then, change to the
./mshop/directory and install the Aimeos extension for TYPO3 with:
composer req aimeos/aimeos-typo3:~21.10
This will install stable TYPO3 version and the latest Aimeos TYPO3 extension. If you want a more or less working installation out of the box for new installations, you should install the Bootstrap package too:
composer req bk2k/bootstrap-package
If you want to install Aimeos into your existing TYPO3 installation, the Aimeos extension from the TER is recommended. You can download and install it directly from the Extension Manager of your TYPO3 instance.
For new TYPO3 installations, there's a 1-click Aimeos distribution available too. Choose the Aimeos distribution from the list of available distributions in the Extension Manager and you will get a completely set up shop system including demo data for a quick start.
Setup TYPO3 as normal by creating a
FIRST_INSTALLfile in the
Open the URL of your installation in the browser and follow the steps in the TYPO3 setup scripts.
If you use MySQL < 5.7.8, you have to use
utf8_unicode_ciinstead because those MySQL versions can't handle the long indexes created by
utf8mb4(up to four bytes per character) and you will get errors like
1071 Specified key was too long; max key length is 767 bytes
To avoid that, change your database settings in your
'DB' => [ 'Connections' => [ 'Default' => [ 'tableoptions' => [ 'charset' => 'utf8', 'collate' => 'utf8_unicode_ci', ], // ... ], ], ],
Since TYPO3 9.5.14+ implements SameSite cookie handling and restricts when browsers send cookies to your site. This is a problem when customers are redirected from external payment provider domain. Then, there's no session available on the confirmation page. To circumvent that problem, you need to set the configuration option
'FE' => [ 'cookieSameSite' => 'none' ]
When using TYPO3 11, you have to run these commands from your installation directory:
php ./vendor/bin/typo3 extension:setup php ./vendor/bin/typo3 aimeos:setup --option=setup/default/demo:1
If you don't want to add the Aimeos demo data, you should remove
--option=setup/default/demo:1from the Aimeos setup command.
For TYPO3 10, these commands are required:
php ./vendor/bin/typo3 extension:activate scheduler php ./vendor/bin/typo3 extension:activate aimeos
Afterwards, you have to execute the update script of the extension to create the required database structure:
TYPO3 10+ requires a site configuration which you have to add in "Site Management" > "Sites" available in the left navigation.
The page setup for an Aimeos web shop is easy if you import the example page tree for TYPO3 10/11:
Note: The Aimeos layout expects Bootstrap providing the grid layout!
Now you have a new page "Shop" in your page tree including all required sub-pages.
TYPO3 9.5 and later can create SEO friendly URLs if you add the rules to the site config: https://aimeos.org/docs/latest/typo3/setup/#seo-urls
The Aimeos TYPO3 extension is licensed under the terms of the GPL Open Source license and is available for free.