Added “Display on“ options to Map element

Author: rimi-itk

modules/os2forms_webform_maps/README.md

@@ -14,3 +14,9 @@ the map. The data can be exported to PDF.
 ## Installation
 
 The module can be installed using the standard Drupal installation procedure.
+
+## Fetching GeoJSON using the API
+
+``` shell
+@todo
+```

modules/os2forms_webform_maps/os2forms_webform_maps.module

@@ -5,22 +5,6 @@
  * Module file for os2forms_webform_maps.
  */
 
-/**
- * Implements hook_theme().
- */
-function os2forms_webform_maps_theme() {
-  return [
-    'webform_element_base_html__webform_map_field' => [
-      'variables' => [
-        'element' => [],
-        'value' => NULL,
-        'webform_submission' => NULL,
-        'options' => [],
-      ],
-    ],
-  ];
-}
-
 /**
  * Implements hook_locale_translation_projects_alter().
  */
@@ -29,31 +13,3 @@ function os2forms_webform_maps_locale_translation_projects_alter(&$projects) {
   $path = $module_handler->getModule('os2forms_webform_maps')->getPath();
   $projects['os2forms_webform_maps']['info']['interface translation server pattern'] = $path . '/translations/%language.po';
 }
-
-/**
- * Implements hook_preprocess_webform_element_base_html__webform_map_field().
- */
-function os2forms_webform_maps_preprocess_webform_element_base_html__webform_map_field(array &$variables) {
-  // Decode the plain text value once.
-  $decoded_value = json_decode($variables['value']['#plain_text']);
-
-  // Use the decoded geojson property.
-  $variables['value']['#plain_text'] = $decoded_value->geojson;
-
-  // Load the webform element base HTML template.
-  \Drupal::moduleHandler()->loadInclude('webform', 'inc', 'includes/webform.theme.template');
-  template_preprocess_webform_element_base_html($variables);
-
-  // Generate a unique ID for the map image.
-  $map_image_id = 'map-image-' . $variables['element']['#webform_key'];
-
-  $variables['map_image'] = [
-    '#type' => 'html_tag',
-    '#tag' => 'img',
-    '#attributes' => [
-      'class' => ['handler-help-message'],
-      'id' => [$map_image_id],
-      'src' => $decoded_value->image ?? '',
-    ],
-  ];
-}

modules/os2forms_webform_maps/src/Plugin/WebformElement/WebformLeafletMapField.php

@@ -5,6 +5,7 @@
 use Drupal\Core\Form\FormStateInterface;
 use Drupal\leaflet\LeafletSettingsElementsTrait;
 use Drupal\webform\Plugin\WebformElementBase;
+use Drupal\webform\WebformSubmissionInterface;
 
 /**
  * Provides a 'webform_map_field' element.
@@ -70,6 +71,10 @@ public function defineDefaultProperties(): array {
       'circle_color' => '#3388FF',
       'rectangle_color' => '#3388FF',
 
+      // Display settings.
+      'display_image_on' => ['html', 'pdf'],
+      'display_geojson_on' => ['text', 'html'],
+
     ] + parent::defineDefaultProperties();
   }
 
@@ -344,7 +349,111 @@ public function form(array $form, FormStateInterface $form_state) {
       ],
     ];
 
+    $form['display_settings'] = [
+      '#type' => 'fieldset',
+      '#title' => $this->t('Display settings'),
+    ];
+    $form['display_settings']['display_settings_container'] = [
+      'display_image_on' => [
+        '#type' => 'checkboxes',
+        '#title' => $this->t('Display image on'),
+        '#options' => [
+          'html' => $this->t('HTML'),
+          'pdf' => $this->t('PDF'),
+        ],
+      ],
+
+      'display_geojson_on' => [
+        '#type' => 'checkboxes',
+        '#title' => $this->t('Display GeoJSON on'),
+        '#options' => [
+          'html' => $this->t('HTML'),
+          'pdf' => $this->t('PDF'),
+          'text' => $this->t('Text'),
+        ],
+      ],
+    ];
+
     return $form;
   }
 
+  /**
+   * {@inheritdoc}
+   */
+  protected function formatHtmlItem(array $element, WebformSubmissionInterface $webform_submission, array $options = []): array {
+    $value = $this->getMapValue($element, $webform_submission, $options);
+
+    $imageId = 'map-image-' . $this->getKey($element);
+
+    $build = [];
+
+    $viewMode = $options['view_mode'] ?? 'overview';
+    if ('table' === $viewMode) {
+      $viewMode = 'html';
+    }
+    if ('html' === $viewMode && $options['pdf']) {
+      $viewMode = 'pdf';
+    }
+
+    // @todo Is this (i.e. $element['#display_image_on']) really the way to get element configuration?
+    $showImageOn = array_filter((array) ($element['#display_image_on'] ?? NULL));
+    $includeImage = isset($showImageOn[$viewMode]);
+
+    $showGeoJsonOn = array_filter((array) ($element['#display_geojson_on'] ?? NULL));
+    $includeGeoJson = isset($showGeoJsonOn[$viewMode]);
+
+    if ($includeImage) {
+      $build['image'] = [
+        '#type' => 'html_tag',
+        '#tag' => 'img',
+        '#attributes' => [
+          'class' => ['handler-help-message'],
+          'id' => $imageId,
+          'src' => $value['image'],
+        ],
+      ];
+    }
+
+    if ($includeGeoJson) {
+      $build['geojson'] = [
+        '#markup' => $value['geojson'],
+      ];
+    }
+
+    return $build;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  protected function formatTextItem(array $element, WebformSubmissionInterface $webform_submission, array $options = []) {
+    $value = $this->getMapValue($element, $webform_submission, $options);
+
+    return $value['geojson'];
+  }
+
+  /**
+   * Get structured map value.
+   *
+   * @return array{
+   *   image: string,
+   *     geojson: string
+   *   }
+   */
+  private function getMapValue(array $element, WebformSubmissionInterface $webform_submission, array $options = []): array {
+    $value = $this->getValue($element, $webform_submission, $options);
+
+    try {
+      $data = json_decode($value, associative: TRUE, flags: JSON_THROW_ON_ERROR);
+    }
+    catch (\JsonException) {
+      $data = [];
+    }
+
+    return $data + [
+      'image' => '',
+      'geojson' => 'null',
+    ];
+  }
+
 }