README

目录

• 描述
• 安装
• 开发设置
• 贡献
• 版本控制

描述

OpenEuropa 企业块是一个 Drupal 扩展模块，用于包含欧洲委员会的企业块。

目前包含以下内容

• 欧洲委员会页脚：包含一组链接和参考，必须在所有欧洲委员会网站上显示。
• 欧洲联盟页脚：包含一组链接和参考，必须在所有欧洲联盟网站上显示。

当与 OpenEuropa 主题 组件（版本 2.x）一起使用时，这两个页脚块将获得适当的样式。

特定于站点的页脚链接

OpenEuropa 企业块还允许网站构建者显示一组特定于站点的链接在页脚中。这些链接可以是以下两种类型之一

• 通用链接，例如联系或法律免责声明链接。通用链接可以在以下页面管理：/admin/config/footer_link_general
• 社交媒体页脚链接，例如指向 Facebook 页面或 Twitter 账户的链接。社交媒体页脚链接可以在以下页面管理：/admin/config/footer_link_social

可以由具有 管理特定站点页脚链接 权限的角色管理特定于站点的链接。

安装

建议通过 Composer 安装 OpenEuropa 企业块模块。

composer require openeuropa/oe_corporate_blocks

强烈建议使用包含已安装的 OP 词汇表的 Virtuoso 的 Docker 镜像。为此，将镜像添加到您的 docker-compose.yml 文件中

  sparql:
    image: openeuropa/triple-store-dev
    environment:
    - SPARQL_UPDATE=true
    - DBA_PASSWORD=dba
    ports:
      - "8890:8890"

否则，请确保您已运行三重存储实例，并已导入 “企业实体”词汇表。

接下来，如果您正在使用任务运行器设置您的网站，请添加连接到三重存储的 runner.yml 配置。在 drupal 键下

  sparql:
    host: "sparql"
    port: "8890"

仍然在 runner.yml 中，添加创建连接到三重存储的 Drupal 设置的指令。在 drupal.settings.databases 键下

  sparql_default:
    default:
      prefix: ""
      host: ${drupal.sparql.host}
      port: ${drupal.sparql.port}
      namespace: 'Drupal\Driver\Database\sparql'
      driver: 'sparql'

然后您可以继续使用常规任务运行器命令来设置网站。

否则，请确保在您的网站 setting.php 文件中您有自己的三重存储实例的连接信息

$databases["sparql_default"] = array(
  'default' => array(
    'prefix' => '',
    'host' => 'your-triple-store-host',
    'port' => '8890',
    'namespace' => 'Drupal\\sparql_entity_storage\\Driver\\Database\\sparql',
    'driver' => 'sparql'
  )
);

启用模块

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

./vendor/bin/drush en oe_corporate_blocks

开发设置

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

• 安装 Composer 依赖项

composer install

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

请注意：测试站点内使用OpenEuropa Task Runner的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

从1.x升级到2.x

已移除站点切换器块。

贡献

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

版本控制

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