README

Aimeos TYPO3 扩展

⭐ 在GitHub上为我们点星标 — 这对我们有很大激励！

Aimeos 是 TYPO3 的专业、功能全面且高性能的电子商务扩展！您可以在5分钟内将其安装到现有的TYPO3网站上，并根据您的需求进行适应、扩展、覆盖和自定义。

安装

本文件适用于最新的Aimeos TYPO3 22.10版本及更高版本。

LTS版本：23.10（TYPO3 12 LTS）
旧LTS版本：22.10（TYPO3 11 LTS）

Composer

注意：需要composer 2.1+！

可以通过composer安装最新版本的TYPO3。如果您想自动创建新的TYPO3安装或尝试最新的代码，这特别有用。如果composer包尚未可用，则需要首先安装它

php -r "readfile('https://getcomposer.org.cn/installer');" | php -- --filename=composer

要首先安装TYPO3基础分发版，请执行以下命令

composer create-project typo3/cms-base-distribution myshop
# or install a specific TYPO3 version:
composer create-project "typo3/cms-base-distribution:^12" myshop

它将在./myshop/目录中安装TYPO3。切换到该目录并按常规安装TYPO3

cd ./myshop
touch public/FIRST_INSTALL

在浏览器中打开TYPO3 URL，并按照设置步骤操作。之后，使用以下命令安装Aimeos扩展

composer req -W aimeos/aimeos-typo3:~23.7

如果composer抱怨由于所需的最低稳定性未满足，一个或多个包无法安装，请将以下内容添加到您的composer.json

"minimum-stability": "dev",
"prefer-stable": true,

如果您想在新安装中有一个更多或更少的即插即用的安装，您还可以安装Bootstrap包

composer req bk2k/bootstrap-package

注意：请记住创建一个根页面和一个根模板，该模板包括Bootstrap包模板！（也请参见下面。）

最后，根据您的TYPO3版本，从您的安装目录运行以下命令

对于TYPO3 11+

php ./vendor/bin/typo3 extension:setup
php ./vendor/bin/typo3 aimeos:setup --option=setup/default/demo:1

如果您不想添加Aimeos演示数据，应从Aimeos设置命令中删除--option=setup/default/demo:1。

对于TYPO3 10

php ./vendor/bin/typo3 extension:activate scheduler
php ./vendor/bin/typo3 extension:activate aimeos

如果您在数据库设置方面遇到任何错误，请检查下面的数据库设置部分。

请在“TER扩展”安装部分下面继续阅读！

DDev

注意：有关使用ddev或Colima安装TYPO3的说明，请参阅此处：使用ddev或colima的TYPO3

TER扩展

如果您想在传统安装的TYPO3中安装Aimeos（“旧安装”），建议使用来自TER的Aimeos扩展。您可以直接从您的TYPO3实例的扩展管理器下载和安装它。

登录到TYPO3后台
在左侧导航中单击“管理工具::扩展”
单击Aimeos列表条目左侧带有小加号的图标

之后，您必须执行扩展的更新脚本以创建所需的数据库结构。

点击“管理工具::升级”。
在“升级向导”磁贴中点击“运行升级向导”。
点击“执行”。

Aimeos Distribution

对于新的TYPO3安装，也提供了一个1点击的Aimeos发行版。在扩展管理器中选择Aimeos发行版，您将获得一个完全设置的商店系统，包括用于快速启动的演示数据。

TYPO3 设置

通过在 ./public 目录中创建一个 FIRST_INSTALL 文件来设置TYPO3。

touch public/FIRST_INSTALL

在浏览器中打开您的安装URL，并按照TYPO3设置脚本中的步骤操作。

数据库设置

如果您使用MySQL < 5.7.8，您必须使用 utf8 和 utf8_unicode_ci，因为这些MySQL版本无法处理由 utf8mb4（每个字符最多四字节）创建的长索引，您将遇到如下错误：

1071 Specified key was too long; max key length is 767 bytes

为了避免这种情况，请将您的数据库设置在 ./typo3conf/LocalConfiguration.php 中更改如下：

    'DB' => [
        'Connections' => [
            'Default' => [
                'tableoptions' => [
                    'charset' => 'utf8',
                    'collate' => 'utf8_unicode_ci',
                ],
                // ...
            ],
        ],
    ],

安全

由于 TYPO3 9.5.14+ 实现了 SameSite cookie处理 并限制了浏览器何时向您的站点发送cookie。当客户从外部支付提供商域重定向时，这是一个问题。然后，确认页面上没有可用会话。为了解决这个问题，您需要将配置选项 cookieSameSite 设置为 none 在您的 ./typo3conf/LocalConfiguration.php。

    'FE' => [
        'cookieSameSite' => 'none'
    ]

站点设置

TYPO3 10+ 需要站点配置，您需要在左侧导航中的“站点管理”>“站点”中添加它。在创建根页面（带有地球图标的面页）时，将自动创建基本站点配置（请参阅下面的转到导入视图）。

页面设置

下载Aimeos页面树t3d文件

如果您导入TYPO3 10/11的示例页面树，Aimeos网络商店的页面设置很简单。您可以从这里下载您需要的版本：

注意： Aimeos布局期望Bootstrap提供网格布局！

为了上传和安装文件，请按照以下步骤操作

转到导入视图

注意：建议将Aimeos页面树导入到定义为“根页面”的页面。要创建根页面，只需创建一个新的页面，在“编辑页面属性”中，在“行为”下激活“用作根页面”选项。根页面的图标将更改为地球。这还将创建基本站点配置。不要忘记还要创建一个typoscript根模板，并将其与bootstrap模板一起包含！

在“Web::Page”中，右键单击根页面（带有地球的那个）
点击“更多选项...”
点击“导入”

上传页面树文件

在页面导入对话框中
选择“上传”选项卡（第二个）
点击“选择”对话框
选择您下载的T3D文件
点击“上传文件”按钮

导入页面树

在导入/导出视图中
从下拉菜单中选择上传的文件
点击“预览”按钮
以下将显示要导入的页面
点击出现的“导入”按钮
确认导入页面

现在您在页面树中有一个新的“商店”页面，包括所有必要的子页面。

SEO友好的URL

如果您在站点配置中添加规则，TYPO3 9.5及更高版本可以创建SEO友好的URL：https://aimeos.org/docs/latest/typo3/setup/#seo-urls

许可证

Aimeos TYPO3扩展根据GPL开源许可证的条款进行许可，并且免费提供。

aimeos / aimeos-typo3

维护者

详细信息