Drupal 7 Module Development

Chapter 11
Pretty cool right? However, sometimes it would be nice to be able to ship some
preconfigured image styles with your module. For instance, a popular Drupal
contributed module is the Pirate module, which translates your entire website to
pirate-speak on Talk Like A Pirate Day. It might be cool for the Pirate module to
be able to ship a totally preconfigured image style that adds the YAR! watermark
to images. Rather than having to create this image style themselves, administrators
could simply install the module and it would be all set up for them. Not only that,
but because this style is in code, it is more easily deployable between development
environments. Thankfully, this is quite easy to do and will provide our final
demonstration of Drupal 7's Image API.
Creating image styles from a module
At this point in your Drupal experience, you can probably guess what is involved
in creating an image style in your module—a hook and an associative array. The
hook is hook_image_default_styles() and the array is a simple definition of the
components of your style.
For those familiar with views in Drupal 6, this is very similar to exporting
views to code using hook_views_default_view().
/**
* Implements hook_image_default_styles().
*/
function watermark_image_default_styles() {
$styles = array();
$styles['yar'] = array(
'effects' => array(
array(
'name' => 'watermark',
'data' => array(
'text_color' => '#000000',
'text' => 'YAR!'
),
'weight' => 0,
),
),
);
return $styles;
}
[ 339 ]