os2web / os2web_borgerdk
Imports content from Borger.dk.
Installs: 1 538
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 7
Forks: 0
Open Issues: 0
Type:drupal-module
Requires
- drupal/migrate_plus: ^4.2
- drupal/migrate_tools: ^4.5
- drupal/paragraphs: ^1.11
- ffwagency/borgerdk-php: dev-develop
This package is auto-updated.
Last update: 2024-10-29 14:29:42 UTC
README
Module purpose
The aim of this module is to provide integration with Borger.dk Content (https://www.borger.dk), and expose this content to be used in Drupal.
How does it work
Borger.dk content is being imported from Borger.dk SOAP webservice using an unofficial PHP Borger.dk library (https://github.com/ffwagency/borgerdk-php).
Since the library is not compatible with Drupal 8 and also misses important functionality (like importing the English language articles), it is substituted with a fork (https://github.com/bellcom/borgerdk-php) during install process.
Synchronization is handled via Migrate API, which is part of the Drupal 8 core functionality.
After the content is being imported, it can be references from any fieldable entity by using field of type os2web_borgerdk_article_reference, which is provided by this module.
The Migrate API will also take care of updating the changed Borger.dk content, as well as deleting the obsolete Borger.dk content (the content that is present in the installation but is no longer present in Borger.dk).
Before deleting the obsolete content, a notify email will be sent to the email provided in the Borger.dk settings page admin/config/content/os2web-borgerdk.
Additional settings
Settings are available under admin/config/content/os2web-borgerdk
- Fetch content for selected municipality - Specify a municipality if the imported content needs to be municipality specific. That will be an option passed to Borger.dk SOAP webservice.
- Send notification about obsolete Borger.dk articles - Enable the obsolete articles notify email.
- Recipient(s) of the email - CSV list of the recipient of the notification email.
- Email subject - Subject of the email.
- Email body - Body of the email.
Install
Module is available to download via composer.
composer require os2web/os2web_borgerdk
drush en os2web_borgerdk
Update
Updating process for OS2Web Borger.dk module is similar to usual Drupal 8 module. Use Composer's built-in command for listing packages that have updates available:
composer outdated os2web/os2web_borgerdk
Import process
The import process can be done in two ways:
-
Via Drush (recommended)
- Use the following Drush command to start the migration:
Read more about the Drush commands for Migrate API on Migrate tools.drush migrate:import os2web_borgerdk_articles_import - It is highly recommended to set up a cronjob on your server to do the run this command often
- Use the following Drush command to start the migration:
-
Via Admin UI
- Go to
admin/structure/migrate/manage/os2web_borgerdk/migrationson your installation - Click
Execute - Click
Executeon the next page as well (doing that will use default options).
- Go to
Module translation
Module's main language is English but Danish language is fully supported.
When extending this module add your translations to the corresponding *.po files located modules/contrib/os2web_borgerdk/translations/ and run the following to update translations:
drush locale-check
drush locale-update && drush cr
Automated testing and code quality
See OS2Web testing and CI information
Contribution
Project is opened for new features and os course bugfixes. If you have any suggestion or you found a bug in project, you are very welcome to create an issue in github repository issue tracker. For issue description there is expected that you will provide clear and sufficient information about your feature request or bug report.