PHPackages aimeos/aimeos-typo3 - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. aimeos/aimeos-typo3 ActiveTypo3-cms-extension[Framework](/categories/framework) aimeos/aimeos-typo3 =================== Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects 25.10.4(2mo ago)1.5k91.2k↓21.4%732[1 PRs](https://github.com/aimeos/aimeos-typo3/pulls)4LGPL-3.0-or-laterPHPPHP ^8.1 Since Jul 19Pushed 3mo ago11 watchersCompare [ Source](https://github.com/aimeos/aimeos-typo3)[ Packagist](https://packagist.org/packages/aimeos/aimeos-typo3)[ Docs](https://aimeos.org/TYPO3)[ RSS](/packages/aimeos-aimeos-typo3/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (28)Versions (176)Used By (4)Security (1) [ ![Aimeos logo](https://camo.githubusercontent.com/e55b7a8426f14ba6040d604746b03b7e096af41ede8fead0ea817cbb8d60f998/68747470733a2f2f61696d656f732e6f72672f66696c6561646d696e2f74656d706c6174652f69636f6e732f6c6f676f2e706e67 "Aimeos")](https://aimeos.org/)Aimeos TYPO3 extension ====================== [](#aimeos-typo3-extension) [![Total Downloads](https://camo.githubusercontent.com/69bc18b83d898021241908d58b99def6609804e39d90b38f5dde977aa48b1ee2/68747470733a2f2f706f7365722e707567782e6f72672f61696d656f732f61696d656f732d7479706f332f642f746f74616c2e737667)](https://packagist.org/packages/aimeos/aimeos-typo3)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/848e41f8864ece3de29283fad86f40a7cc3f1921c5eb1a6f47eb7ed55c5966ca/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f61696d656f732f61696d656f732d7479706f332f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/aimeos/aimeos-typo3/?branch=master)[![License](https://camo.githubusercontent.com/37c51cd44bca8dbbe4069dfc4b0ba930d52e289f4c32ce415040c4d927cb3774/68747470733a2f2f706f7365722e707567782e6f72672f61696d656f732f61696d656f732d7479706f332f6c6963656e73652e737667)](https://packagist.org/packages/aimeos/aimeos-typo3) ⭐ Star us on GitHub — it motivates us a lot! [Aimeos](https://aimeos.org/TYPO3) 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. [![aimeos-frontend](https://user-images.githubusercontent.com/8647429/212348410-55cbaa00-722a-4a30-8b57-da9e173e0675.jpg)](https://user-images.githubusercontent.com/8647429/212348410-55cbaa00-722a-4a30-8b57-da9e173e0675.jpg) Table Of Contents ----------------- [](#table-of-contents) - [Installation](#installation) - [Composer](#composer) - [DDev or Colima](#ddev) - [TER](#ter-extension) - [TYPO3 setup](#typo3-setup) - [Database setup](#database-setup) - [Security](#security) - [Page setup](#page-setup) - [Download the Aimeos Page Tree t3d file](#download-the-aimeos-page-tree-t3d-file) - [Go to the Import View](#go-to-the-import-view) - [Upload the page tree file](#upload-the-page-tree-file) - [Go to the import view](#go-to-the-import-view) - [Import the page tree](#import-the-page-tree) - [SEO-friendly URLs](#seo-friendly-urls) - [License](#license) - [Links](#links) Installation ------------ [](#installation) This document is for the latest Aimeos TYPO3 **23.10 release and later**. - LTS release: 24.10 (TYPO3 12/13 LTS) - Old LTS release: 23.10 (TYPO3 12 LTS) ### Composer [](#composer) **Note:** composer 2.1+ is required! The latest TYPO3 version can be installed via composer. 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 ``` To install the TYPO3 base distribution first, execute this command: ``` composer create-project typo3/cms-base-distribution myshop # or install a specific TYPO3 version: composer create-project "typo3/cms-base-distribution:^13" myshop ``` It will install TYPO3 into the `./myshop/` directory. Change into the directory and install TYPO3 as usual: ``` cd ./myshop touch public/FIRST_INSTALL ``` Open the TYPO3 URL in your browser and follow the setup steps. Afterwards, install the Aimeos extension using: ``` composer req -W aimeos/aimeos-typo3:~24.10 ``` If composer complains that one or more packages can't be installed because the required minimum stability isn't met, add this to your `composer.json`: ``` "minimum-stability": "dev", "prefer-stable": true, ``` If you want a more or less working installation out of the box for new installations, you can install the Bootstrap package too: ``` composer req bk2k/bootstrap-package ``` ***Note***: Remember to create a root page and a root template, which includes the Bootstrap package templates! (See also below.) Finally, depending on your TYPO3 version, run the following 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:1` from the Aimeos setup command. If you experience any errors with the database, please check the [Database Setup](#database-setup) section below. ### DDev [](#ddev) *Note:* Installation instructions for TYPO3 with `ddev` or `Colima` can be found here: [TYPO3 with ddev or colima](https://ddev.readthedocs.io/en/latest/users/quickstart/) ### TER Extension [](#ter-extension) If you want to install Aimeos into a traditionally installed TYPO3 ("legacy installation"), the [Aimeos extension from the TER](https://typo3.org/extensions/repository/view/aimeos) is recommended. You can download and install it directly from the Extension Manager of your TYPO3 instance. - Log into the TYPO3 backend - Click on "Admin Tools::Extensions" in the left navigation - Click the icon with the little plus sign left from the Aimeos list entry [![Install Aimeos TYPO3 extension](https://user-images.githubusercontent.com/213803/211545083-d0820b63-26f2-453e-877f-ecd5ec128713.jpg)](https://user-images.githubusercontent.com/213803/211545083-d0820b63-26f2-453e-877f-ecd5ec128713.jpg) Afterwards, you have to execute the update script of the extension to create the required database structure: - Click on "Admin Tools::Upgrade" - Click "Run Upgrade Wizard" in the "Upgrade Wizard" tile - Click "Execute" [![Execute update script](https://user-images.githubusercontent.com/213803/211545122-8fd94abd-78b2-47ad-ad3c-1ef1b9c052b4.jpg)](https://user-images.githubusercontent.com/213803/211545122-8fd94abd-78b2-47ad-ad3c-1ef1b9c052b4.jpg) #### Aimeos Distribution [](#aimeos-distribution) For new TYPO3 installations, there is a 1-click [Aimeos distribution](https://typo3.org/extensions/repository/view/aimeos_dist) 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. TYPO3 Setup ----------- [](#typo3-setup) Setup TYPO3 by creating a `FIRST_INSTALL` file in the `./public` directory: ``` touch public/FIRST_INSTALL ``` Open the URL of your installation in the browser and follow the steps in the TYPO3 setup scripts. ### Security [](#security) 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 `cookieSameSite` to `None` in your `./typo3conf/LocalConfiguration.php` or `./config/system/settings.php`: ``` 'FE' => [ 'cookieSameSite' => 'None' ] ``` Site Setup ---------- [](#site-setup) TYPO3 10+ requires a site configuration which you have to add in "Site Management" > "Sites" available in the left navigation. When creating a root page (a page with a globe icon), a basic site configuration is automatically created (see below at [Go to the Import View](#go-to-the-import-view)). Page Setup ---------- [](#page-setup) ### Download the Aimeos Page Tree t3d file [](#download-the-aimeos-page-tree-t3d-file) The page setup for an Aimeos web shop is easy, if you import the example page tree for TYPO3 10/11. You can download the version you need from here: - [24.10+ page tree](https://aimeos.org/fileadmin/download/Aimeos-pages_2024.10-2.t3d) and later - [23.10 page tree](https://aimeos.org/fileadmin/download/Aimeos-pages_2023.04.t3d) **Note:** The Aimeos layout expects [Bootstrap](https://getbootstrap.com) providing the grid layout! In order to upload and install the file, follow the following steps: ### Go to the Import View [](#go-to-the-import-view) **Note:** It is recommended to import the Aimeos page tree to a page that is defined as "root page". To create a root page, simply create a new page and, in the "Edit page properties", activate the "Use as Root Page" option under "Behaviour". The icon of the root page will change to a globe. This will also create a basic site configuration. Don't forget to also create a typoscript root template and include the bootstrap templates with it! [![Create a root page](https://user-images.githubusercontent.com/213803/211549273-1d3883dd-710c-4e27-8dbb-3de6e45680d7.jpg)](https://user-images.githubusercontent.com/213803/211549273-1d3883dd-710c-4e27-8dbb-3de6e45680d7.jpg) - In "Web::Page", right-click on the root page (the one with the globe) - Click on "More options..." - Click on "Import" [![Go to the import view](https://user-images.githubusercontent.com/213803/211550212-df6daa73-74cd-459e-8d25-a56c413c175d.jpg)](https://user-images.githubusercontent.com/213803/211550212-df6daa73-74cd-459e-8d25-a56c413c175d.jpg) ### Upload the page tree file [](#upload-the-page-tree-file) - In the page import dialog - Select the "Upload" tab (2nd one) - Click on the "Select" dialog - Choose the T3D file you've downloaded - Press the "Upload files" button [![Upload the page tree file](https://user-images.githubusercontent.com/8647429/212347778-17238e05-7494-4413-adb3-a54b2b524e05.png)](https://user-images.githubusercontent.com/8647429/212347778-17238e05-7494-4413-adb3-a54b2b524e05.png) ### Import the page tree [](#import-the-page-tree) - In Import / Export view - Select the uploaded file from the drop-down menu - Click on the "Preview" button - The pages that will be imported are shown below - Click on the "Import" button that has appeared - Confirm to import the pages [![Import the uploaded page tree file](https://user-images.githubusercontent.com/8647429/212348040-c3e10b60-5579-4d1b-becc-72548826c6db.png)](https://user-images.githubusercontent.com/8647429/212348040-c3e10b60-5579-4d1b-becc-72548826c6db.png) Now you have a new page "Shop" in your page tree including all required sub-pages. ### SEO-friendly URLs [](#seo-friendly-urls) TYPO3 9.5 and later can create SEO friendly URLs if you add the rules to the site config: License ------- [](#license) The Aimeos TYPO3 extension is licensed under the terms of the GPL Open Source license and is available for free. Links ----- [](#links) - [Web site](https://aimeos.org/integrations/typo3-shop-extension/) - [Documentation](https://aimeos.org/docs/TYPO3) - [Forum](https://aimeos.org/help/typo3-extension-f16/) - [Issue tracker](https://github.com/aimeos/aimeos-typo3/issues) - [Source code](https://github.com/aimeos/aimeos-typo3) ### Health Score 72 — ExcellentBetter than 100% of packages Maintenance83 Actively maintained with recent releases Popularity59 Moderate usage in the ecosystem Community39 Small or concentrated contributor base Maturity91 Battle-tested with a long release history Bus Factor1 Top contributor holds 94.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~20 days Recently: every ~38 days Total 174 Last Release 61d ago Major Versions 24.10.5 → 25.4.12025-04-09 25.4.1 → 2025.04.x-dev2025-04-30 25.7.1 → 2025.07.x-dev2025-07-09 25.10.3 → 2024.10.x-dev2025-11-13 25.10.4 → 2025.10.x-dev2026-03-19 PHP version history (9 changes)16.7.0PHP >=5.3.2 17.4.1PHP >=5.4.0 19.1.0PHP >=5.5.0 18.10.8PHP >=5.6.0 20.4.1PHP >=7.2.0 21.10.1PHP ~7.2||^8.0.10 23.4.2PHP ^8.0.10 23.7.1PHP ^8.0.11 24.4.1PHP ^8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/ccdc84033584516c77fb6aa7f85dc7048f2fbcd08867fc6abf115d094bab5eef?d=identicon)[aimeos](/maintainers/aimeos) --- Top Contributors [![aimeos](https://avatars.githubusercontent.com/u/8647429?v=4)](https://github.com/aimeos "aimeos (1190 commits)")[![guelzow](https://avatars.githubusercontent.com/u/11192910?v=4)](https://github.com/guelzow "guelzow (14 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (10 commits)")[![gilbertsoft](https://avatars.githubusercontent.com/u/25326036?v=4)](https://github.com/gilbertsoft "gilbertsoft (8 commits)")[![rowild](https://avatars.githubusercontent.com/u/213803?v=4)](https://github.com/rowild "rowild (4 commits)")[![DavidHedden](https://avatars.githubusercontent.com/u/44436429?v=4)](https://github.com/DavidHedden "DavidHedden (3 commits)")[![nollm](https://avatars.githubusercontent.com/u/42864489?v=4)](https://github.com/nollm "nollm (3 commits)")[![jonaseberle](https://avatars.githubusercontent.com/u/1678001?v=4)](https://github.com/jonaseberle "jonaseberle (2 commits)")[![andreaskienast](https://avatars.githubusercontent.com/u/1787983?v=4)](https://github.com/andreaskienast "andreaskienast (2 commits)")[![claude27](https://avatars.githubusercontent.com/u/4347809?v=4)](https://github.com/claude27 "claude27 (2 commits)")[![DanielSiepmann](https://avatars.githubusercontent.com/u/354250?v=4)](https://github.com/DanielSiepmann "DanielSiepmann (2 commits)")[![heural](https://avatars.githubusercontent.com/u/25622396?v=4)](https://github.com/heural "heural (2 commits)")[![IchHabRecht](https://avatars.githubusercontent.com/u/1453345?v=4)](https://github.com/IchHabRecht "IchHabRecht (2 commits)")[![mterwei](https://avatars.githubusercontent.com/u/38031968?v=4)](https://github.com/mterwei "mterwei (2 commits)")[![nvindice](https://avatars.githubusercontent.com/u/18614852?v=4)](https://github.com/nvindice "nvindice (2 commits)")[![rhabacker](https://avatars.githubusercontent.com/u/602903?v=4)](https://github.com/rhabacker "rhabacker (2 commits)")[![stephankellermayr](https://avatars.githubusercontent.com/u/2480602?v=4)](https://github.com/stephankellermayr "stephankellermayr (2 commits)")[![yodaXX](https://avatars.githubusercontent.com/u/13272160?v=4)](https://github.com/yodaXX "yodaXX (1 commits)")[![pdanzinger](https://avatars.githubusercontent.com/u/11884180?v=4)](https://github.com/pdanzinger "pdanzinger (1 commits)")[![vanillajonathan](https://avatars.githubusercontent.com/u/10222521?v=4)](https://github.com/vanillajonathan "vanillajonathan (1 commits)") --- Tags aimeosb2be-commerceecommerceecommerce-platformjson-apimarketplaceperformancephpseoshoptypo3typo3-extensionvuevuejsshopecommercee-commerceb2btypo3aimeosportalmarket place ### Embed Badge ![Health badge](/badges/aimeos-aimeos-typo3/health.svg) ``` [![Health](https://phpackages.com/badges/aimeos-aimeos-typo3/health.svg)](https://phpackages.com/packages/aimeos-aimeos-typo3) ``` ### Alternatives [aimeos/aimeos-symfony Professional, full-featured and high performance Symfony e-commerce bundle for online shops and complex B2B projects 1.4k4.3k](/packages/aimeos-aimeos-symfony)[aimeos/aimeos-laravel Cloud native, API first Laravel eCommerce package with integrated AI for ultra-fast online shops, marketplaces and complex B2B projects 8.6k214.7k3](/packages/aimeos-aimeos-laravel)[aimeos/aimeos-core Full-featured e-commerce components for high performance online shops 4.5k346.9k48](/packages/aimeos-aimeos-core)[aimeos/ai-typo3 TYPO3 adapter for Aimeos e-commerce integration 95392.1k1](/packages/aimeos-ai-typo3)[aimeos/aimeos Aimeos ecommerce and shop system 5.3k108.1k](/packages/aimeos-aimeos)[aimeos/aimeos_dist Aimeos TYPO3 distribution for web shops, portals and market places 1.2k3.1k](/packages/aimeos-aimeos-dist) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)