openeuropa/oe_paragraphs

基于ECL组件提供一系列段落类型的Drupal模块。

维护者

详细信息

github.com/openeuropa/oe_paragraphs

源代码

问题

安装数量: 105,265

依赖项: 4

建议者: 0

安全性: 0

星标: 4

关注者: 18

分支: 5

开放问题: 10

类型：drupal-module

1.23.3 2024-08-09 14:59 UTC

Requires

Requires (Dev)

Suggests

EUPL-1.2 4ec02467e63c2c3fc00a778ea7613b64231c1dba

This package is auto-updated.

Last update: 2024-09-09 15:06:21 UTC

README

Build Status Packagist

本模块提供了一些基于欧洲委员会组件库（ECL）的段落类型。这些类型旨在用于欧洲委员会各个网站的首页。

目录

安装

推荐通过Composer安装OpenEuropa身份验证模块。

composer require openeuropa/oe_paragraphs

启用模块

为了在项目中启用模块，请运行以下命令

./vendor/bin/drush en oe_paragraphs

段落

模块提供了以下段落类型

  • 手风琴：手风琴段落是一系列可折叠的项目，包含图标、标题和长文本必填字段。
  • 手风琴项：手风琴项段落是一个单独的手风琴，包含图标、标题和长文本必填字段。它专门用于与“手风琴”段落一起使用。
  • 内容行：内容行段落允许编辑器将多个段落分组在一起。可选地显示页面内的导航。
  • 上下文导航：上下文导航段落允许编辑器添加多个链接，帮助用户导航页面。可以使用可用字段配置链接、它们的可见性限制和导航标签。
  • 文档：文档段落允许编辑器渲染文档。
  • 链接块：链接块段落显示链接列表，可选标题。例如，与下拉组件一起使用。
  • 列表项：列表项段落显示内容摘要。列表项有以下变体：默认、日期项、突出显示和缩略图带主图或辅图。
  • 列表项块：列表项块段落允许编辑器将多个列表项段落分组为一列、两列或三列。可选添加到块中的链接。
  • 引用：引用段落允许编辑器添加引用及其归属。
  • 富文本：富文本段落添加可选标题字段和长文本字段。
  • 事实与数据：事实与数据段落用于通过统计数据使用户更容易视觉表示事实。
  • 事实：单个事实项，专门用于与“事实与数据”段落类型一起使用。
  • 社交媒体关注：社交媒体关注段落允许编辑器添加社交媒体链接列表。

此项目还包含可选的子模块，提供可选的段落类型。有关更多信息，请检查./modules目录。

横幅

允许编辑器创建横幅，显示突出信息及其相关操作。要获取此段落类型，请启用OpenEuropa Paragraphs横幅子模块。

轮播图

此段落允许编辑器创建类似横幅的轮播项目，具有多个幻灯片。要获取此段落类型，请启用OpenEuropa段落轮播子模块。

图表

允许编辑器创建显示Webtools图表媒体实体的段落。要获取此段落类型，请启用OpenEuropa段落图表子模块。

描述列表

允许编辑器创建带有标题的HTML描述列表的段落。要获取此段落类型，请启用OpenEuropa段落描述列表子模块。

Iframe

允许编辑器创建显示Iframe媒体实体的段落。要获取此段落类型，请启用OpenEuropa段落Iframe子模块。

地图

允许编辑器创建显示Webtools地图媒体实体的段落。要获取此段落类型，请启用OpenEuropa段落地图子模块。

带特色媒体的文本

允许编辑器创建包含标题和右侧特色媒体（如有）的丰富文本的段落。要获取此段落类型，请启用OpenEuropa带特色媒体文本段落子模块。

社交动态

允许编辑器创建显示Webtools社交动态媒体实体的段落。要获取此段落类型，请启用OpenEuropa段落社交动态子模块。

时间轴

允许编辑器创建在时间轴上可视地显示并发和/或顺序项目的段落。要获取此段落类型，请启用OpenEuropa段落时间轴子模块。

开发环境设置

您可以通过以下步骤构建测试站点。

  • 安装所有composer依赖项
composer install

  • 通过将runner.yml.dist复制到runner.yml并更改相关值来定制构建设置。

  • 运行以下命令安装测试站点：

./vendor/bin/run drupal:site-install

您的测试站点将在./build下可用。

请注意：项目文件和目录通过使用OpenEuropa任务运行器的Drupal项目符号链接命令在测试站点内部进行符号链接。

如果您在项目根目录中添加了新文件或目录，您需要重新运行drupal:site-setup以确保它们被正确符号链接。

如果您不想重新运行完整的站点设置，可以简单地运行：

$ ./vendor/bin/run drupal:symlink-project

使用Docker Compose

或者，您可以使用提供的配置使用Docker和Docker Compose构建开发站点。

Docker提供了必要的服务和技术，如Web服务器和数据库服务器，以便无论您的本地主机配置如何，都可以使站点运行。

要求

配置

默认情况下，Docker Compose读取两个文件，一个是docker-compose.yml，另一个是可选的docker-compose.override.yml文件。按照惯例，docker-compose.yml包含您的基本配置，并默认提供。重写文件，顾名思义，可以包含现有服务或全新服务的配置重写。如果服务在两个文件中都定义了，Docker Compose将合并配置。

有关Docker Compose扩展机制的更多信息，请参阅官方Docker Compose文档。

用法

要开始，请运行

docker-compose up

建议不要使docker-compose成为守护进程，这样您可以在完成工作后快速将其关闭（CTRL+C）。但是，如果您想使其成为守护进程，您必须添加标志-d

docker-compose up -d

然后

docker-compose exec web composer install
docker-compose exec web ./vendor/bin/run drupal:site-install

使用默认配置，开发站点的文件应位于build目录中，开发站点应位于：http://127.0.0.1:8080/build。

运行测试

要运行grumphp检查

docker-compose exec web ./vendor/bin/grumphp run

要运行phpunit测试

docker-compose exec web ./vendor/bin/phpunit

要运行behat测试

docker-compose exec web ./vendor/bin/behat

步骤调试

要启用命令行中的逐步调试，请将任何值传递给容器的XDEBUG_SESSION环境变量。

docker-compose exec -e XDEBUG_SESSION=1 web <your command>

请注意，从XDebug 3开始，如果设置了该变量但客户端没有监听调试连接，则会在控制台输出连接错误消息。该错误消息将导致PHPUnit测试出现假阴性。

要从浏览器启动逐步调试，请使用浏览器扩展或像在https://www.jetbrains.com/phpstorm/marklets/生成的书签来设置正确的cookie。

贡献

有关我们的行为准则和向我们提交pull请求的流程的详细信息，请参阅完整文档。

版本管理

我们使用SemVer进行版本控制。有关可用版本，请参阅本存储库的标签。