README

模块目的

该模块的目的是提供与 Borger.dk 内容（https://www.borger.dk）的集成，并将这些内容公开以在 Drupal 中使用。

工作原理

使用非官方的 PHP Borger.dk 库（https://github.com/ffwagency/borgerdk-php）从 Borger.dk SOAP webservice 导入 Borger.dk 内容。

由于库与 Drupal 8 不兼容，并且缺少重要功能（例如导入英文文章），在安装过程中使用分支（https://github.com/bellcom/borgerdk-php）替代。

同步通过 Migrate API 处理，这是 Drupal 8 内核功能的一部分。

内容导入后，可以使用此模块提供的 os2web_borgerdk_article_reference 类型字段从任何可字段的实体引用。

Migrate API 还会负责更新更改的 Borger.dk 内容，以及删除过时的 Borger.dk 内容（存在于安装中但不再存在于 Borger.dk 中的内容）。在删除过时内容之前，将向 Borger.dk 设置页面 admin/config/content/os2web-borgerdk 中提供的电子邮件发送通知电子邮件。

其他设置

设置可在 admin/config/content/os2web-borgerdk 下找到

为所选市镇检索内容 - 如果导入的内容需要针对特定市镇，请指定一个市镇。这将是一个传递给 Borger.dk SOAP webservice 的选项。
发送关于过时 Borger.dk 文章的通知 - 启用过时文章通知电子邮件。
电子邮件收件人 - 通知电子邮件的收件人 CSV 列表。
电子邮件主题 - 电子邮件主题。
电子邮件正文 - 电子邮件正文。

安装

该模块可通过 composer 下载。

composer require os2web/os2web_borgerdk
drush en os2web_borgerdk

更新

OS2Web Borger.dk 模块的更新过程类似于常规的 Drupal 8 模块。使用 Composer 内置命令列出具有更新可用的包

composer outdated os2web/os2web_borgerdk

导入过程

导入过程可以有两种方式

通过 Drush（推荐）
- 使用以下 Drush 命令开始迁移
```
drush migrate:import os2web_borgerdk_articles_import
```
  有关 Migrate API 的 Drush 命令的更多信息，请参阅迁移工具。
- 强烈建议在服务器上设置 cronjob 以定期运行此命令
通过管理界面
- 转到您的安装上的 admin/structure/migrate/manage/os2web_borgerdk/migrations
- 点击 执行
- 在下一页上也点击 执行（这样做将使用默认选项）。

模块翻译

模块的主要语言是英语，但完全支持丹麦语。

当扩展此模块时，请将您的翻译添加到位于 modules/contrib/os2web_borgerdk/translations/ 的相应 *.po 文件，并运行以下命令以更新翻译

drush locale-check
drush locale-update && drush cr

自动测试和代码质量

请参阅 OS2Web 测试和 CI 信息

贡献

项目已开放添加新功能和当然的bug修复。如果您有任何建议或在项目中发现了bug，非常欢迎您在GitHub仓库的问题跟踪器中创建问题。对于问题描述，我们期望您能提供关于您的功能请求或bug报告的清晰且充分的信息。

代码审查政策

请参阅OS2Web代码审查政策

Git命名规范

请参阅OS2Web Git命名规范

os2web / os2web_borgerdk

维护者

详细信息