7.x block.api.php hook_block_cid_parts_alter(&$cid_parts, $block)

Act on block cache ID (cid) parts before the cid is generated.

This hook allows you to add, remove or modify the custom keys used to generate a block cache ID (by default, these keys are set to the block module and delta). These keys will be combined with the standard ones provided by drupal_render_cid_parts() to generate the final block cache ID.

To change the cache granularity used by drupal_render_cid_parts(), this hook cannot be used; instead, set the 'cache' key in the block's definition in hook_block_info().

@params $cid_parts An array of elements used to build the cid.


$block: The block object being acted on.

See also


Related topics

1 invocation of hook_block_cid_parts_alter()
_block_get_cache_id in modules/block/block.module
Assemble the cache_id to use for a given block.


modules/block/block.api.php, line 385
Hooks provided by the Block module.


function hook_block_cid_parts_alter(&$cid_parts, $block) {
  global $user;

  // This example shows how to cache a block based on the user's timezone.
  $cid_parts[] = $user->timezone;