image.api.php

Same filename in other branches
  1. 7.x modules/image/image.api.php
  2. 9 core/modules/image/image.api.php
  3. 8.9.x core/modules/image/image.api.php
  4. 10 core/modules/image/image.api.php

Hooks related to image styles and effects.

File

core/modules/image/image.api.php

View source
<?php


/**
 * @file
 * Hooks related to image styles and effects.
 */

/**
 * @addtogroup hooks
 * @{
 */

/**
 * Alter the information provided in \Drupal\image\Annotation\ImageEffect.
 *
 * @param $effects
 *   The array of image effects, keyed on the machine-readable effect name.
 */
function hook_image_effect_info_alter(&$effects) {
    // Override the Image module's 'Scale and Crop' effect label.
    $effects['image_scale_and_crop']['label'] = t('Bangers and Mash');
}

/**
 * Respond to image style flushing.
 *
 * This hook enables modules to take effect when a style is being flushed (all
 * images are being deleted from the server and regenerated). Any
 * module-specific caches that contain information related to the style should
 * be cleared using this hook. This hook is called whenever a style is updated,
 * deleted, or any effect associated with the style is update or deleted.
 *
 * @param \Drupal\image\ImageStyleInterface $style
 *   The image style object that is being flushed.
 * @param string|null $path
 *   (optional) The original image path or URI. If it's supplied, only this
 *   image derivative will be flushed.
 */
function hook_image_style_flush($style, $path = NULL) {
    // Empty cached data that contains information about the style.
    \Drupal::cache('my_module')->deleteAll();
}

/**
 * @} End of "addtogroup hooks".
 */

Functions

Title Deprecated Summary
hook_image_effect_info_alter Alter the information provided in \Drupal\image\Annotation\ImageEffect.
hook_image_style_flush Respond to image style flushing.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.