README

这是Georg Ringer的redirect_generator的分支。

此扩展从CSV文件创建适当的重定向条目。

每个目标条目将通过路由配置进行匹配。如果目标是 http://demo.vm/company/contact，则将创建相关页面ID的重定向！

安装

要求

• TYPO3 10 || 11
• EXT:redirects

设置

与其他扩展一样安装

• Composer: composer require mxp/redirect-generator

配置

设置以下扩展配置选项以启用电子邮件通知

• notification_email: 以逗号分隔的电子邮件地址列表，用于发送导出和导入命令的通知电子邮件
• notification_level: 设置您想要接收的通知消息级别
  • 0 (错误): 仅接收错误消息
  • 1 (警告): 接收错误和警告消息
  • 2 (信息): 接收所有消息
• allow_empty_import_file: 如果为true，则空CSV文件将静默跳过导入，否则将引发错误

使用方法

添加单个重定向

使用以下CLI命令

./bin/typo3 redirect:add /any-url https://domain.tld/your-final-url

以下选项可用

• --status-code: 定义状态码，允许的是 301、302、303 和 307。
• --dry-run: 如果设置，则不会添加重定向
• --overwrite existing: 用给定的目标覆盖现有的源URL。在实际上覆盖某些内容时使用通知级别2（信息）

导入CSV

使用以下CLI命令

./bin/typo3 redirect:import <path-to-file.csv>

source;target;status_code
/fo/bar;http://t3-master.vm/examples/extensions/news;301
/fo/bar2;http://t3-master.vm/examples/extensions/news;307
/fo/bar3;http://t3-master.vm/exakqwkqkwmples/extensions/news;301

可以在EXT:redirect_generator/Resources/Private/Examples/ImportBasic.csv找到示例CSV文件

此外，还可以在CSV中添加一个额外的列external。它可以是0（false）或1（true）。如果为1，则目标被视为外部URL，而不是与TYPO3页面映射。

以下选项可用

• --dry-run: 如果设置，则不会添加重定向
• --external-domains: 提供一个以逗号分隔的外部域名列表
• --delete-file: 如果设置，则在导入成功或失败后删除CSV文件
• --overwrite existing: 用给定的目标覆盖现有的源URL。在实际上覆盖某些内容时使用通知级别2（信息）

此命令可以在计划程序中运行（选择执行控制台命令作为类）

导出重定向

将所有重定向导出为CSV。可选的选项--transform-target-url将目标URL转换为最终URL，例如t3://page?uid=1106。

使用以下CLI命令

./bin/typo3 redirect:export export.csv --transform-target-url

此命令可以在计划程序中运行（选择执行控制台命令作为类）