oe_subscriptions.module

<?php

/**
 * @file
 * Subscriptions module.
 */

declare(strict_types=1);

use Drupal\Core\Form\FormStateInterface;
use Drupal\oe_subscriptions\Form\SettingsForm;

/**
 * Implements hook_theme().
 */
function oe_subscriptions_theme(array $existing, string $type, string $theme, string $path): array {
  return [
    'oe_subscriptions_no_subscriptions' => [
      'variables' => [],
    ],
    'oe_subscriptions_introduction' => [
      'variables' => [
        'text' => '',
      ],
    ],
    'oe_subscriptions_user_subscriptions_page' => [
      'render element' => 'elements',
    ],
  ];
}

/**
 * Prepares variables for the user subscriptions page template.
 *
 * @param array $variables
 *   An associative array containing:
 *   - elements: An associative array containing the content of the page.
 */
function template_preprocess_oe_subscriptions_user_subscriptions_page(array &$variables): void {
  $subscriptions_config = \Drupal::configFactory()->get(SettingsForm::CONFIG_NAME);
  $introduction_text = $subscriptions_config->get('introduction_text');

  if (empty($introduction_text['value'])) {
    return;
  }

  $variables['introduction'] = [
    '#type' => 'processed_text',
    '#text' => $introduction_text['value'],
    '#format' => $introduction_text['format'] ?? '',
  ];
}

/**
 * Implements hook_form_FORM_ID_alter() for the user subscriptions form.
 *
 * Wraps the user subscriptions form with the dedicated page template.
 * This is added in a hook so the standard form wrappers will be added normally,
 * and our wrapper only appended later on.
 */
function oe_subscriptions_form_oe_subscriptions_user_subscriptions_form_alter(array &$form, FormStateInterface $form_state, string $form_id): void {
  $form['#theme_wrappers']['oe_subscriptions_user_subscriptions_page'] = [
    '#attributes' => [],
  ];
}