supseven / canonical-files
为文件添加规范URL头部的扩展
v2.0.5
2024-06-05 14:04 UTC
Requires
- php: ^8.2
- typo3/cms-backend: ^12.4
- typo3/cms-core: ^12.4
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.14.1
- phpunit/phpunit: ^10.5
- typo3/testing-framework: ^8.0
README
此TYPO3扩展将规范URL头部添加到文件(图片、PDF...),具体取决于文件存储的位置。存储可以链接到特定网站(相应网站配置),因此该存储中所有文件都将附带一个附加的规范头部,指向相应网站的域名。
例如,一个TYPO3实例为两个域名 example.at 和 example.de 服务,分别定义了两个文件存储,分别为 storage-at
和 storage-de
。然后,在域名 example.at 上提供的文件(实际上位于 storage-de
),将附带规范头部 https://example.de/fileadmin/....
安装
通过以下方式将包添加到您的 composer.json 文件中
composer require supseven/canonical-files
该扩展将 tx_canonical_files_site_identifier
字段添加到 sys_file_storage
表中。如有必要,请比较数据库(数据库迁移)。
配置
为每个可用的网站配置(如果适用)添加文件存储,并在“规范文件”标签页中相应地设置“网站”字段。存储在此类文件存储中的所有文件都将获得该网站配置的基准或基准变体作为规范头部。
为了实现这一点,文件必须通过TYPO3路由:将以下行添加到您的项目的 .htaccess 文件中(根据需要进行修改)
RewriteCond %{REQUEST_URI} ^/fileadmin
RewriteCond %{REQUEST_FILENAME} \.(pdf|doc|docx|xls|xlsx|ppt|pptx)$
RewriteRule ^.*$ %{ENV:CWD}index.php [QSA,L]
可选
阻止编辑器从后端表单中的文件引用字段直接上传文件是有意义的。将此添加到您的 TSconfig 中以全局应用
setup.override {
edit_docModuleUpload = 0
}
setup.fields.edit_docModuleUpload.disabled = 1
法律
许可协议
本软件包根据GPL v3许可协议提供。有关详细信息,请参阅文件 LICENSE 或 https://gnu.ac.cn/licenses/gpl-3.0。