DW-578: Added os2forms_selvbetjening module altering email handler form

.gitignore

@@ -60,6 +60,7 @@
 !/web/modules/custom/os2forms_rest_api
 !/web/modules/custom/os2forms_api_request_handler
 !/web/modules/custom/itkdev_footer
+!/web/modules/custom/os2forms_selvbetjening
 
 
 # Ignore directories generated by Composer

README.md

@@ -127,6 +127,18 @@ $config['os2forms_get_organized'] = [
 ];
 ```
 
+### Selvbetjening Module
+
+The `OS2Forms Selvbetjening` module updates the Webform Email Handler
+by adding a description to the message body section. The
+description should be configured in the `settings.local.php` file:
+
+```php
+$config['os2forms_selvbetjening']['email_body_description'] = "Brug enten standardsvaret eller definer dit eget svar. Se <a href=\"https://os2forms.os2.eu/mail-tekster\">OS2Forms Loop</a> for andre standarder og eksempler.";
+```
+
+If it is not, no description is added.
+
 ### Maestro
 
 We use the [Maestro module](https://www.drupal.org/project/maestro) to make workflows.

config/sync/webform.settings.yml

@@ -193,8 +193,8 @@ mail:
   default_sender_mail: ''
   default_sender_name: ''
   default_subject: '[webform_submission:source-title] (fra [site:name])'
-  default_body_text: "** Kvittering til udfylder\r\n\r\nIndhold:\r\nKære [webform_submission:values:navn] (OBS, erstat \"navn\" med det rigtige elements nøgle)\r\n\r\nDu har udfyldt formularen [webform_submission:webform], [webform_submission:created].\r\n\r\nDu har angivet følgende informationer:\r\n[webform_submission:values]\r\n\r\n\r\n** Orientering til medarbejder om udfyldelse af ny formular\r\n\r\nIndhold:\r\nOrientering om udfyldelse af formularen [webform_submission:webform].\r\n\r\nUdfyldt af [webform_submission:values:navn] [webform_submission:created]. (OBS, erstat \"navn\" med det rigtige elements nøgle)\r\nSagen kan tilgås på [webform_submission:os2forms_forloeb_execute_task]. (relevant ved flows)\r\n\r\nDer er angivet følgende informationer:\r\n[webform_submission:values]"
-  default_body_html: "** Kvittering til udfylder\r\n\r\nIndhold:\r\nKære [webform_submission:values:navn] (OBS, erstat \"navn\" med det rigtige elements nøgle)\r\n\r\nDu har udfyldt formularen [webform_submission:webform], [webform_submission:created].\r\n\r\nDu har angivet følgende informationer:\r\n[webform_submission:values]\r\n\r\n\r\n** Orientering til medarbejder om udfyldelse af ny formular\r\n\r\nIndhold:\r\nOrientering om udfyldelse af formularen [webform_submission:webform].\r\n\r\nUdfyldt af [webform_submission:values:navn] [webform_submission:created]. (OBS, erstat \"navn\" med det rigtige elements nøgle)\r\nSagen kan tilgås på [webform_submission:os2forms_forloeb_execute_task]. (relevant ved flows)\r\n\r\nDer er angivet følgende informationer:\r\n[webform_submission:values]"
+  default_body_text: "Kære borger\r\n\r\nDu har udfyldt formularen [webform_submission:webform], [webform_submission:created].\r\n\r\nDu har angivet følgende informationer:\r\n[webform_submission:values]"
+  default_body_html: "Kære borger\r\n\r\nDu har udfyldt formularen [webform_submission:webform], [webform_submission:created].\r\n\r\nDu har angivet følgende informationer:\r\n[webform_submission:values]"
   roles: {  }
 export:
   temp_directory: ''

web/modules/custom/os2forms_selvbetjening/os2forms_selvbetjening.info.yml

@@ -0,0 +1,8 @@
+name: 'OS2Forms Selvbetjening'
+type: module
+description: 'Provides changes to webform email handler.'
+package: 'OS2Forms'
+core: 8.x
+core_version_requirement: ^8 || ^9
+dependencies:
+  - 'webform:webform'

web/modules/custom/os2forms_selvbetjening/os2forms_selvbetjening.module

@@ -0,0 +1,18 @@
+<?php
+
+/**
+ * @file
+ * Module file for the os2forms_selvbetjening module.
+ */
+
+use Drupal\Core\Form\FormStateInterface;
+use Drupal\os2forms_selvbetjening\Helper\FormHelper;
+
+/**
+ * Implements hook_form_alter().
+ *
+ * Allows altering of forms.
+ */
+function os2forms_selvbetjening_form_alter(&$form, FormStateInterface $form_state, $form_id) {
+  Drupal::service(FormHelper::class)->formAlter($form, $form_state, $form_id);
+}

web/modules/custom/os2forms_selvbetjening/os2forms_selvbetjening.services.yml

@@ -0,0 +1,4 @@
+services:
+  Drupal\os2forms_selvbetjening\Helper\FormHelper:
+    arguments:
+      - '@config.factory'

web/modules/custom/os2forms_selvbetjening/src/Helper/FormHelper.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Drupal\os2forms_selvbetjening\Helper;
+
+use Drupal\Core\Config\ConfigFactoryInterface;
+use Drupal\Core\Form\FormStateInterface;
+
+/**
+ * Form Helper class, for altering forms.
+ */
+class FormHelper {
+
+  /**
+   * The ConfigFactoryInterface.
+   *
+   * @var \Drupal\Core\Config\ConfigFactoryInterface
+   */
+  private ConfigFactoryInterface $config;
+
+  /**
+   * Constructs a FormHelper.
+   */
+  public function __construct(ConfigFactoryInterface $config) {
+    $this->config = $config;
+  }
+
+  /**
+   * Allows altering of forms.
+   */
+  public function formAlter(&$form, FormStateInterface $form_state, $form_id) {
+
+    // Add description to the message body section of the email handler.
+    if ('webform_handler_form' === $form_id && 'email' === ($form['#webform_handler_plugin_id'] ?? NULL)) {
+
+      $config = $this->config->get('os2forms_selvbetjening');
+
+      if ($email_body_description = $config->get('email_body_description')) {
+        $form['settings']['message']['body']['#description'] = $email_body_description;
+      }
+    }
+  }
+
+}