comparison core/lib/Drupal/Core/Render/theme.api.php @ 12:7a779792577d

Update Drupal core to v8.4.5 (via Composer)

  * '#theme' => 'node__article' is called, then hook_theme_suggestions_node()
  * will be invoked, not hook_theme_suggestions_node__article(). The specific
  * hook called (in this case 'node__article') is available in
  * $variables['theme_hook_original'].
  *
+ * Implementations of this hook must be placed in *.module or *.theme files, or
+ * must otherwise make sure that the hook implementation is available at
+ * any given time.
+ *
  * @todo Add @code sample.
  *
  * @param array $variables
  *   An array of variables passed to the theme hook. Note that this hook is
  *   invoked before any preprocessing.

  * HOOK is the least-specific version of the hook being called. For example, if
  * '#theme' => 'node__article' is called, then node_theme_suggestions_node()
  * will be invoked, not node_theme_suggestions_node__article(). The specific
  * hook called (in this case 'node__article') is available in
  * $variables['theme_hook_original'].
+ *
+ * Implementations of this hook must be placed in *.module or *.theme files, or
+ * must otherwise make sure that the hook implementation is available at
+ * any given time.
  *
  * @todo Add @code sample.
  *
  * @param array $suggestions
  *   An array of theme suggestions.