README

此扩展提供连接TYPO3实例到Manja数字资产管理所必需的接口。

包含Manja API 4.0

需求

TYPO3 CMS 11.5
PHP >= 7.4

许可

此TYPO3扩展受GPL版本2或任何后续版本的许可。

安装

通过Composer安装

扩展将在 packagist 上可用，您可以通过composer要求它。

composer require manja/typo3-storage-connector

安装后添加数据库更改

composer exec typo3cms database:update

添加文件存储

要连接Manja数字资产管理与TYPO3，您需要在根级别创建一个新的文件存储。

添加新的文件存储

为新文件存储命名，并选择 Manja数字资产管理 作为驱动程序，这将打开更多字段以设置您的文件存储。

添加文件存储驱动程序

使用“常规”选项卡中提供的凭据设置您的文件存储，至少包括 host、port、username、password、client id 和 tree id。

对于 timeout、stream timeout、use SSL 和 use session 的设置具有默认值，可进行修改。

默认情况下，Is default storage 复选框未启用。
通常，文件夹 fileadmin 是自动创建的默认存储。

默认情况下启用 Automaticly extract metadata after upload 复选框。

输入 Folder for manipulated and temporary images etc. 以指定处理文件的临时文件夹。输入的值需要采用以下形式 {storageId}:/{path/to/folder}，其中 {storageId} 必须是可写存储的ID。如果您留空或设置错误值，将显示警告并使用默认值 0:/typo3temp/assets/_processed_manja。任何在修改版本（裁剪、调整大小等）中使用的来自Manja服务器的文件都将自动由TYPO3存储在此文件夹中。

添加文件存储设置

在 访问能力 选项卡中的 is writable 复选框没有影响，因为此文件存储驱动程序不支持通过TYPO3后端修改Manja服务器上的文件。

配置元数据映射

如果从Manja服务器加载任何文档到TYPO3，扩展也会下载文档的基本元数据字段并将它们写入TYPO3数据库。字段映射具有默认配置，您可能希望在 元数据 选项卡中更改此配置。
配置元数据映射

为编辑器添加文件挂载和访问权限

对于后端编辑器（如果您有的话），您通常需要添加文件挂载以访问文件存储中的此类文件夹。
因此，您应在TYPO3根级别创建一个新的文件挂载条目。

添加新的文件挂载

输入标签名称，并从列表中选择您创建的新文件存储。

添加文件挂载驱动程序

为文件挂载添加设置，并选择在Manja服务器上存在的文件夹，以授予编辑器访问权限。第一个条目 / 是根级别及其所有子文件夹。

添加文件挂载设置

将您新建的文件挂载添加到后端编辑器的访问设置中，可以分别或按组在根级别进行编辑。

添加文件挂载到编辑器

在Manja服务器上访问文件和文件夹

在TYPO3后端模块 文件列表 中，编辑器可以访问所有已配置的文件挂载及其子文件夹。

首次从Manja服务器选择文件夹时，如果您的个人资料中选择了显示缩略图，加载服务器上的图像并生成TYPO3后端中的预览缩略图将需要额外时间。

后端模块文件列表

这样的文件和文件夹也可以在 文件浏览器 中访问，当编辑器想要将媒体文件添加或选择到任何内容元素中时，该浏览器会弹出。

通过TYPO3只能读取来自Manja服务器的文件和文件夹，不能编辑 - 因此所有文件夹都有一个锁定的符号。

默认情况下，在 文件列表 和 文件浏览器 中搜索仅按文件名搜索。要按更多信息搜索和排序，您需要为您的TYPO3安装安装第三方扩展。

变更日志

2.0.0

重大更改

[任务] 移除对TYPO3 < 8.7和PHP < 7.2的支持

其他更改

[功能] 将metaData映射添加到驱动器配置
[修复] 修复与_processed文件夹的问题

开发

Manja数字资产管理

IT服务Robert Frunzke www.manjadigital.de

开发者

Robert Frunzke mail@manjadigital.de Martin Hoff m.hoff@manjadigital.de Falk Röder mail@falk-roeder.de
Jörg Kummer service@enobe.de

Git仓库

开发期间在gitlab上的私有仓库。
manjadigital计划一个公共仓库。

manja / typo3-storage-connector

维护者

详细信息