config_pages.module in Config Pages 8

Module hooks.

File

config_pages.module

<?php

/**
 * @file
 * Module hooks.
 */
use Drupal\config_pages\Entity\ConfigPages;
use Drupal\config_pages\Entity\ConfigPagesType;
use Drupal\Core\Render\Element;

/**
 * @param string $type
 *  config_page type to get context.
 *
 * @return array
 *  Return current context based on groups.
 */
function config_pages_context_get($type) {
  $context = [];
  $type = ConfigPagesType::load($type);
  if (!$type) {
    return $context;
  }
  $context = $type
    ->getContextData();
  return $context;
}

/**
 *
 * Helper function.
 * Returns config page entity.
 *
 * @param string $type
 *   Config page type to load.
 *
 * @param string $context
 *   Context which should be used to load entity,
 *
 * @retun \Drupal\config_pages\Entity\ConfigPages.
 */
function config_pages_config($type, $context = NULL) {
  $config_page = ConfigPages::config($type, $context);
  return $config_page;
}

/**
 * Implements hook_form_FORM_ID_alter.
 */
function config_pages_form_field_storage_config_edit_form_alter(&$form, \Drupal\Core\Form\FormStateInterface $form_state, $form_id) {

  // Config pages is a specific type of entity so we want to remove it from select.
  $element =& $form['settings']['target_type'];
  foreach ($element['#options'] as $key => $val) {
    if (isset($element['#options'][$key]['config_pages'])) {
      unset($element['#options'][$key]['config_pages']);
    }
  }
}

/**
 * Implements hook_theme().
 */
function config_pages_theme() {
  return array(
    'config_pages' => [
      'render element' => 'elements',
    ],
  );
}

/**
 * Implements hook_theme_suggestions_HOOK().
 */
function config_pages_theme_suggestions_config_pages(array $variables) {
  $suggestions = [];
  $config_page = $variables['elements']['#config_pages'];
  $sanitized_view_mode = strtr($variables['elements']['#view_mode'], '.', '_');
  $suggestions[] = 'config_pages__' . $sanitized_view_mode;
  $suggestions[] = 'config_pages__' . $config_page
    ->bundle();
  $suggestions[] = 'config_pages__' . $config_page
    ->bundle() . '__' . $sanitized_view_mode;
  return $suggestions;
}

/**
 * Prepares variables for config page templates.
 *
 * Default template: config-pages.html.twig.
 *
 * @param array $variables
 *   An associative array containing:
 *   - elements: An array of elements to display in view mode.
 *   - config_pages: The config_pages object.
 *   - view_mode: View mode; e.g., 'full', 'teaser'...
 */
function template_preprocess_config_pages(&$variables) {
  $variables['view_mode'] = $variables['elements']['#view_mode'];
  $variables['config_pages'] = $variables['elements']['#config_pages'];

  // Helpful $content variable for templates.
  $variables += array(
    'content' => [],
  );
  foreach (Element::children($variables['elements']) as $key) {
    $variables['content'][$key] = $variables['elements'][$key];
  }
}

/**
 * Implements hook_menu_links_discovered_alter().
 */
function config_pages_menu_links_discovered_alter(&$links) {
  $config_pages_types = \Drupal::entityTypeManager()
    ->getStorage('config_pages_type')
    ->loadMultiple();
  foreach ($config_pages_types as $page_type) {
    $bundle = $page_type
      ->getOriginalId();
    $menu_path = $page_type->menu['path'];
    $title = $page_type
      ->label();
    $parent_route_name = config_pages_find_parent_route_name($menu_path);
    $links['config_pages.' . $bundle] = [
      'title' => t($title),
      'parent' => $parent_route_name,
      'route_name' => 'config_pages.' . $bundle,
    ];
  }
}

/**
 * @param string $path
 *    Get parent route name from path.
 *
 * @return mixed
 *    Route name or false.
 */
function config_pages_find_parent_route_name($path) {
  $parent_path = substr($path, 0, strrpos($path, '/'));
  return config_pages_get_route_name_from_path($parent_path);
}

/**
 * @param string $path
 *    Get route name from path.
 *
 * @return mixed
 *    Route name or false.
 */
function config_pages_get_route_name_from_path($path) {
  $route = \Drupal::service('path.validator')
    ->getUrlIfValid($path);
  return $route ? $route
    ->getRouteName() : FALSE;
}

Functions

Name	Description
config_pages_config	Helper function. Returns config page entity.
config_pages_context_get
config_pages_find_parent_route_name
config_pages_form_field_storage_config_edit_form_alter	Implements hook_form_FORM_ID_alter.
config_pages_get_route_name_from_path
config_pages_menu_links_discovered_alter	Implements hook_menu_links_discovered_alter().
config_pages_theme	Implements hook_theme().
config_pages_theme_suggestions_config_pages	Implements hook_theme_suggestions_HOOK().
template_preprocess_config_pages	Prepares variables for config page templates.