README

OpenEuropa 列表页面组件允许创建和管理具有可配置选项的列表页面。列表页面使用搜索API查询，允许配置不同的查询选项，如对所有索引内容包进行分类过滤。要使搜索API索引可供列表页面使用，应在其设置页面中配置关联的列表页面选项。

子模块

OpenEuropa 列表页面内容类型

提供了一种启动内容类型，可以作为列表页面使用。 更多信息。

OpenEuropa 列表页面链接列表源

与OpenEuropa链接列表集成。 更多信息。

OpenEuropa 列表页面地址

提供处理地址的Facets处理器。 更多信息。

开发设置

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

• 安装Composer依赖项

composer install

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

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

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

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

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

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

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

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

使用Docker Compose

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

Docker提供了必要的服务和工具，如Web服务器和数据库服务器，以便在本地主机配置不受影响的情况下运行站点。

要求

• Docker
• Docker Compose

配置

默认情况下，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 测试出现假阴性。

要从浏览器启动步骤调试，请使用浏览器扩展或类似以下链接生成的书签工具设置正确的 Cookie： https://www.jetbrains.com/phpstorm/marklets/。

贡献

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

版本控制

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