README

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

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

安装

要求

• TYPO3
  • TYPO3 12 LTS: dev-master + 2.0.0
  • TYPO3 10/11 LTS: 1.0.0
• EXT:redirects

设置

像其他扩展一样安装

• Composer: composer require georgringer/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: 如果设置，则不会添加重定向

导入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

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

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

以下选项可用

• --dry-run: 如果设置，则不会添加重定向
• --external-domains: 提供逗号分隔的外部域名列表
• --delete-file: 如果设置，则在导入（成功或失败）后删除CSV文件

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

导出重定向

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

使用以下CLI命令

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

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