README

关于

此TYPO3扩展为TYPO3 >= 7.6提供灵活的内存列表

功能

概念 + 后端

• 通过typoscript配置，将通用记录类型添加到内存列表

插件 - 前端

• 插件，用于在前端显示内存列表
• 插件动作，通过ajax添加、删除和显示列表
• 可定制扩展/模板中的演示按钮以调用插件动作

集成

• 通过Composer安装

安装

当前发布的版本可在TYPO3扩展存储库（TER）或通过composer获取。因此，您可以使用

• 从TYPO3后端扩展管理器下载和安装扩展

或

• 从控制台执行composer require tieupmedia/hwt_memorylist

此外，您可以手动从github获取版本化的源代码并手动上传扩展。如果这样做，请将扩展文件夹命名为"hwt_memorylist"（不要保留git库名称）！

手动

创建内存列表

扩展附带一个内存列表插件，可显示当前列表。您可以使用插件内容元素将其插入到TYPO3中，或通过集中的TypoScript手动创建它。

创建添加/删除项的控制元素

内存列表旨在与ajax控件一起使用，以从列表中添加或删除项。因此，只需创建相关控件并使用ajaxjavascript初始化它们即可。

1) 创建控制元素

如果您插入内存列表插件，将默认显示一些演示控件。您可以通过常量编辑器或您的TS记录/文件中的TS常量plugin.tx_hwtmemorylist.settings.enableDemoTemplates轻松删除它们。

控件需要三个数据属性

• data-hwtmemorylist-model，其值为TS设置中定义的记录类型之一plugin.tx_hwtmemorylist.settingsrecordTypes
• data-hwtmemorylist-recordid，其值为要添加或删除的记录的uid
• data-hwtmemorylist-action，其值为'add'或'remove'以声明要执行的操作

示例

<a href="#" class="hwtmemorylist-ctrl" data-hwtmemorylist-model="AShortRecordIdentifier" data-hwtmemorylist-recordid="1" data-hwtmemorylist-action="add">

在'ListDemoItemControls'部分中查看更多示例。

2) 初始化Ajax

要初始化ajax调用，将元素绑定到hwtmemorylistCtrlInit()函数。

jQuery('.hwtmemorylist-ctrl').on('click', hwtmemorylistCtrlInit);

在此扩展包含的Ajax.js文件中，默认初始化具有css类'hwtmemorylist-ctrl'的元素。

如何配置内存列表的自定义记录

要为内存列表注册新的记录类型，请将其添加到TypoScript设置中的'recordTypes'。选择自定义记录标识符并在子属性中配置仓库类。

(仓库必须实现'findByUid'函数.)

plugin.tx_hwtmemorylist.settings {
    recordTypes {
        AShortRecordIdentifier {
            repository = Vendor\Extension\Domain\Repository\TheModelRepository
        }
    }
}

版本

• >= 0.0.4 for TYPO3 7.6 - 8.7
• >= 0.0.5 for TYPO3 7.6 - 9.x
• >= 0.2.0 for TYPO3 9.5 - 10.x

迁移

0.0.5 to 0.0.6 TypoScript密钥plugin.tx_hwtmemorylist.settings.list.recordtypes已移动到plugin.tx_hwtmemorylist.settings.recordTypes。