README

关于

将完整的前端编辑体验带入 CustomCatalog。

功能

• 支持所有属性，包括图片、文件、标签，甚至画廊选择
• 流畅且易于集成到任何运行中的 CustomCatalog。使用 ->widget() 方法为字段/属性提供功能
• 直接集成到列表、阅读器模块和模板
• 所有熟悉的后端功能均可使用，例如：复制、删除、切换可见性（绿色眼睛）、剪切和粘贴等。
• 多编辑功能（多删除、复制和粘贴、覆盖、编辑）
• 子表支持
• 成员组和单个成员的访问级别
• 深度权限系统，可限制整个表、条目或单个属性
• 无需后端登录。甚至可以直接在前端使用弹出窗口或 TinyMCE
• 对条目的完整 Contao 版本支持

演示

cc.feedit.premium-contao-themes.com

安装

将模块文件夹复制到 /system/modules 并更新数据库。您可能还需要清除内部缓存。该插件带来了两个新的模板

• mod_customcatalogedit.html5
• customcatalog_default_edit.html5

安装 Contao 4.4.x

将模块文件夹复制到 /system/modules 并更新数据库。手动清除内部缓存（var/cache）。模块安装后，在首次加载时将在 /app/config 文件夹中创建 config.yml（或附加到现有配置）

• 如果文件未自动创建，请将此扩展附带的自定义 config.yml 文件复制到 /app/config 文件夹中（或附加您的 config.yml）

• 如果您已经使用 config.yml，请附加以下配置

# contao.picker.builder::customcatalog_frontedit
services:
   contao.picker.builder:
      class: PCT\Contao\Picker\PickerBuilder
      arguments:
            - '@knp_menu.factory'
            - '@router'
            - '@request_stack'

# contao.picker.page_provider::customcatalog_frontedit
services:
   contao.picker.page_provider:
      class: PCT\Contao\Picker\PagePickerProvider

# contao.picker.file_provider::customcatalog_frontedit
services:
   contao.picker.file_provider:
      class: PCT\Contao\Picker\FilePickerProvider

卸载

• 删除模块文件夹并清除缓存。
• Contao 4.4.x：删除 config.yml 文件或从您的自定义 config.yml 中删除配置块

激活 CustomElement 插件

导航到 "我的内容元素" / "Meine Inhaltselemente" > 插件管理并启用新插件。

用法

该插件为您的 CustomCatalog 模板带来了两种新的方法。

• $entry->editable();
• $entry->field('myAttribute')->widget();
• $entry->field('myFilesAttribute')->uploadWidget( $arrSettings );

editable() 方法可调用 CustomCatalog RowTemplate 对象（每个条目都是其中之一），检查当前用户是否可以编辑条目。widget() 方法可调用 CustomCatalog TemplateAttribute（cc 模板文件中的任何属性都是其中之一），生成属性表单字段。

参见 customcatalog_default_edit.html5 模板

要求

需要 pct_customelements 别名 CustomElements 模块版本 1.6.0（或更高版本）和 CustomCatalog 版本 1.4.0（或更高版本）。最佳体验是使用最新版本！

上传小部件的可选设置

$arrSettings['uploadFolder']（字符串）设置 Contao 文件夹内的路径。文件文件夹本身受限制（默认：$GLOBALS['PCT_CUSTOMCATALOG_FRONTEDIT']['defaultUploadFolder'] = files/uploads，在 config.php 中定义）

$arrSettings['useHomeDir']（布尔值）上传到前端成员文件夹（覆盖上传文件夹路径）

$arrSettings['doNotOverwrite']（布尔值）覆盖文件或不覆盖（默认：true）

$arrSettings['extensions'] (数组或字符串) 允许上传的文件扩展名数组或逗号分隔列表（默认：Contaos系统设置扩展名列表）

$arrSettings['createUploadFolder'] (布尔值) 如果设置为true，将在不存在的情况下创建上传文件夹（默认：false）