README

这是一个Drupal模块，它是drupal核心联系表单的扩展，并定义了欧洲委员会的企业表单。

OpenEuropa 联系表单项目使用联系存储提供联系信息的存储，这些信息可以作为完整的实体存储。然后，这些消息可以自动导出为每个可用的联系表单。

用法

在联系表单添加/编辑页面上启用企业联系表单行为，允许定义表单字段、确认信息和电子邮件值。

权限

通过贡献的模块提供细粒度权限，用于处理联系表单和联系消息实体

• 查看联系消息
• 更新联系消息
• 删除联系消息
• 导出联系表单消息

开发环境配置

需求

• Virtuoso 7（三元组存储数据库）
• Docker
• Docker Compose

您可以通过以下步骤构建开发站点

• 安装Virtuoso。最简单的方法是使用OpenEuropa 三元存储开发Docker容器，该容器还预导入主欧洲词汇表。

• 安装Composer依赖项

composer install

在执行composer install后，会自动触发后命令钩子（drupal:site-setup）。这将将在测试站点中的正确目录中创建模块的符号链接，并在测试配置文件（如behat.yml.dist）中执行令牌替换。

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

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

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

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

* Install test site by running:

```bash
$ ./vendor/bin/run drupal:site-install

开发站点的Web根目录应位于build目录中。

使用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

与内容协作

项目包含以下 Task Runner 命令，用于与 RDF 存储中的内容协作，它们需要 Docker Compose 服务正在运行。

清除所有数据

$ docker-compose exec sparql ./vendor/bin/robo purge

或者，如果您可以在主机机器上运行命令

$ ./vendor/bin/run sparql:purge

导入默认数据

$ docker-compose exec sparql ./vendor/bin/robo import

或者，如果您可以在主机机器上运行命令

$ ./vendor/bin/run sparql:import

重置所有数据，即运行清除和导入

$ docker-compose exec sparql ./vendor/bin/robo purge
$ docker-compose exec sparql ./vendor/bin/robo import

或者，如果您可以在主机机器上运行命令

$ ./vendor/bin/run sparql:reset

步骤调试

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

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

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

要从浏览器中开始步骤调试，请使用浏览器扩展或书签工具（如通过 https://www.jetbrains.com/phpstorm/marklets/ 生成的）设置正确的cookie。

贡献

请阅读 完整的文档 了解我们的行为准则以及向我们提交拉取请求的流程。

版本控制

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