跳转到主要内容

Plone的Volto集成插件

项目描述

kitconcept https://github.com/kitconcept/kitconcept.volto/workflows/Basic%20tests/badge.svg

kitconcept.volto 是一个辅助包,用于设置 Plone 站点以与 Volto 一起使用。它安装了几个便利包、Plone 配置和补丁,以准备 Plone 支持所有 Volto 功能。将其放入您的 buildout 中,然后安装它。它在 Volto 本身开发中用于测试。

如果您愿意,可以将其作为您自己的集成包的基础。

使用方法

https://github.com/plone/volto/blob/master/api/base.cfg#L13

以及 plonesite 食谱

https://github.com/plone/volto/blob/master/api/base.cfg#L13

兼容性

Volto需要特定版本的kitconcept.volto和plone.restapi。

kitconcept.volto

plone.restapi

1.x

6.0.0及以下版本

2.x

7.0.0及以上版本

plone.restapi 7.0.0已包含在Plone 5.3.4(及更高版本)中。

您仍然可以在p.restapi 7.0.0基于的安装中使用2.x,但包含的转换将无法工作。Volto仅支持最新的plone.restapi分支,因此建议在您的Volto项目中始终使用最新版本。

功能

kitconcept.volto提供以下功能

示例主页和Plone站点块支持

它包含一个hack,使Plone站点块启用的Volto块和某些示例内容。您只需使用该hack即可在您的站点上启用块。

您可以在Volto演示中看到它的工作情况:[https://volto.kitconcept.com](https://volto.kitconcept.com)

安装提供的配置文件以默认安装

kitconcept.volto:default-homepage

例如,在您的GS metadata.xml中,与其他依赖项一起

<metadata>
<version>1000</version>
<dependencies>
  <dependency>kitconcept.volto:default-homepage</dependency>
</dependencies>
</metadata>

Volto块支持

它默认在Document内容类型上启用Volto块行为,启用该内容类型的Volto编辑器。

只需使用相同的模式即可启用您自己的内容类型以拥有块。

文档内容类型

Richtext目录行为已被从Document行为中删除,因为如果它们在表单中显示,则会使用户感到困惑。两者都已被编辑器中的块取代。

CORS配置文件

kitconcept.volto模块中也提供了一个快速助手,用于启用开发配置中的CORS。因此,您可以在开发时调用

<include package="kitconcept.volto.cors" />

您的ZCML。

根据需要启用它,因为如果您的生产网站启用了CORS,则被认为是安全问题。

计划在未来的Volto中添加一个到后端的开发代理。将在下一个sprint中解决这个问题。

ZLog补丁

通过古老的ZLog将p.restapi低级错误路由,并且启用了plone_error,这使得由于所有错误都标记了UUID,因此难以跟踪。特别是如果使用像Sentry这样的助手。此补丁删除了UUID,因此相同的错误将一起分类。计划在下一个sprint中解决这个问题。

Plone subject字段的补丁修复

由于Plone默认Dexterity subjects字段的特殊字符的序列化问题,存在一些问题,必须解决才能使其与Volto(以及其他不是Plone的系统)正常工作。这个问题将在未来的sprint中在核心中修复。

预览图片行为

预览图片行为使内容类型提供预览图片字段,Volto视图可以从中提取预览图片。这对于列表(例如,列表块自定义)和摘要元素(例如,[volto-blocks-grid](https://github.com/kitconcept/volto-blocks-grid)等摘要块)特别有用。

“volto.preview_image”行为可以在内容类型的通用设置XML定义中启用(例如,“/profiles/default/types/MyContentType.xml”)

<?xml version="1.0" encoding="UTF-8" ?>
<object i18n:domain="fzj.internet" meta_type="Dexterity FTI" name="MyContentType"
  xmlns:i18n="http://xml.zope.org/namespaces/i18n">

  ...

  <!-- Enabled behaviors -->
  <property name="behaviors" purge="false">
    ...
    <element value="volto.preview_image" />
  </property>
  ...
</object>

标题标题行为

标题标题使内容类型提供标题字段,Volto可以在摘要和类似元素中使用它。

可以在内容类型的通用设置XML定义中启用“volto.head_title”行为(例如,“/profiles/default/types/MyContentType.xml”)。

<?xml version="1.0" encoding="UTF-8" ?>
<object i18n:domain="fzj.internet" meta_type="Dexterity FTI" name="MyContentType"
  xmlns:i18n="http://xml.zope.org/namespaces/i18n">

  ...

  <!-- Enabled behaviors -->
  <property name="behaviors" purge="false">
    ...
    <element value="volto.head_title" />
  </property>
  ...
</object>

Volto块启用了LRF。

支持LRF(语言根文件夹)的多语言。在安装此软件包之前安装PAM,并将在每种启用的语言中创建演示主页。目前仅支持EN/DE。

图像缩放

此软件包在Plone中引入了新的Plone图像缩放,并重新定义了几个现有的缩放。这些与Volto布局和网格系统配合得很好。

icon 32:32
tile 64:64
thumb 128:128
mini 200:65536
preview 400:65536
teaser 600:65536
large 800:65536
larger 1000:65536
great 1200:65536
huge 1600:65536

此更改具有主观性,可能与您之前定义的缩放冲突,因此请确保在应用此更改后应用您的插件配置文件。

版本兼容性

自2020年3月5日起,kitconcept.voltodemo已被此软件包弃用。

贡献者

更改日志

2.5.3 (2021-09-13)

  • 修复docker镜像中多语言修复的guard条件。[sneridagh]

2.5.2 (2021-09-13)

  • 修复docker镜像中的多语言修复,guard似乎不起作用,由于某种原因,块和块布局尚未设置。(sneridagh)

2.5.1 (2021-09-12)

  • 通过在GS配置文件中简化对Plone站点的定义,使其更通用。这解决了在Plone 6中使用DX站点根时应用错误的问题。[sneridagh]

2.5.0 (2021-09-12)

  • 通过显式包含对configure.zcml的依赖项来支持基于pip的Plone安装。[ericof]

  • 将Lock-Token添加到默认CORS allow_headers中。[avoinea]

  • 如果已设置,则在默认主页中(如果启用了PAM)添加guard以防止覆盖块。[sneridagh]

2.4.0 (2021-07-19)

  • 修复“导航标题”的德语翻译(“Navigation titel” -> “Navigationstitel”)[timo]

  • 修复并完成从Volto 12到Volto 13的升级步骤[sneridagh]

  • 添加辅助脚本[sneridagh]

  • 将preview_image添加到转换中[sneridagh]

  • 添加headtitle行为[sneridagh]

  • 为setuphandlers disablecontenttype添加guard[sneridagh]

  • 修复审计脚本[sneridagh]

  • volto-blocks-grid的自定义转换添加子块支持[sneridagh]

2.3.0 (2021-05-19)

  • 添加升级步骤功能

  • 添加从Volto 12到Volto 13的升级步骤[sneridagh]

2.2.1 (2021-04-21)

  • 更好的多语言配置文件[sneridagh]

2.2.0 (2021-04-21)

  • 为Cypress测试添加多语言测试修复件[sneridagh]

2.1.3 (2021-03-26)

  • requests添加为依赖项[sneridagh]

2.1.2 (2021-03-07)

  • 为演示站点添加演示主页[sneridagh]

2.1.1 (2021-03-06)

  • 添加演示站点配置文件[sneridagh]

2.1.0 (2021-02-23)

  • 从types_use_view_action_in_listings中删除图像和文件,因为在Volto中根本不使用它们。[sneridagh]

2.0.0 (2021-02-20)

  • (破坏性更改)在registry.xml通用Setup配置文件中定义已知与Volto图像缩放配合良好的缩放。当安装此插件或应用配置文件时,它将覆盖您的Plone站点中的现有缩放。如果您正在使用特定于项目的缩放,请确保在安装此插件配置文件之后安装它们。

    这些缩放已在实际生产项目中经过测试,与Volto的布局和响应式视口配合良好。[timo, sneridagh]

1.7.2 (2021-01-26)

  • 尚未进行任何更改。

1.7.1 (2021-01-25)

  • 修复第一级选项卡并添加nav_title到它们[sneridagh]

1.7.0 (2021-01-21)

  • breadcrumbs_view覆盖添加到包括nav_title中[sneridagh]

1.6.0 (2021-01-14)

  • preview_image添加索引器,它允许Volto对象浏览器小部件访问它[sneridagh]

1.5.2 (2020-12-14)

  • 缺少翻译的ZCML[sneridagh]

1.5.1 (2020-12-14)

  • 添加zest.pocompile[sneridagh]

  • 添加缺少的.m[sneridagh]

1.5.0 (2020-12-09)

  • 修复德语中的默认地区[sneridagh]

1.4.0 (2020-07-29)

  • 将volto.preview_image行为添加到页面类型。[timo]

1.3.2 (2020-05-17)

  • 确保enable_pam辅助程序执行其工作。[sneridagh]

1.3.1 (2020-05-12)

  • 修复LRF全局允许并确保默认行为[sneridagh]

1.3.0 (2020-05-11)

  • 添加注册导航设置以不在导航中显示当前项[sneridagh]

  • 添加新的enable_pam setuphandlers辅助程序[sneridagh]

  • 新增 enable_pam_consistency setuphandlers 辅助功能 [sneridagh]

1.2.0 (2020-04-17)

  • 恢复事件类型,因为现在在 Volto 中完全工作 [sneridagh]

  • 修复行为名称中的错别字 navttitle -> navtitle [sneridagh]

1.1.0 (2020-03-10)

  • Image 内容类型添加特定的 IImageScaleFactory,以修复 SVG 处理 [sneridagh]

1.0.1 (2020-03-08)

  • 更新默认主页中的版本号 [sneridagh]

1.0.0 (2020-03-06)

  • 添加 Zope 日志补丁 [sneridagh]

  • 添加 nav_title 和 preview_image 行为 [sneridagh]

  • 使用未编码的主题值作为标记的版本覆盖 plone.app.vocabularies.Keywords [csenger]

  • 从文档类型中删除版本控制行为 [timo]

  • 回滚 kitconcept.voltodemo 中的所有功能 [sneridagh]

  • 修补 Products.CMFPlone 中的密码重置工具,使其在通过 REST 请求时使用可选的 volto_domain 发送电子邮件 [fredvd]

  • 添加带有 frontend_domain 字段的 Volto 设置控制面板 [fredvd]

  • 用于演示的首页配置文件 [sneridagh]

  • CORS 配置文件 [sneridagh]

  • 启用 Volto 块对文档和 LRF 的支持 [sneridagh]

  • 初始发布。 [kitconcept]

项目详情


下载文件

下载适用于您的平台的文件。如果您不确定选择哪一个,请了解更多关于 安装软件包 的信息。

源分发

kitconcept.volto-2.5.3.tar.gz (49.8 kB 查看哈希值)

上传时间

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面