Drupal 7 Module Development

Chapter 6
This page will simply generate a bulleted list of menu items that are immediate
children of the current page being viewed. menu_get_item() returns the current
menu item while system_admin_menu_block(), despite its name, is a useful general
purpose function for getting the children of an arbitrary menu item.
There are two other points to note here:
• First, the link takes the localized_options key of the menu item as its own
options array. That way we allow the menu system to handle what attributes
the link should have, any interaction with the translation system, and so on.
• Second, we run the description through filter_xss_admin(). The function
will simply strip out HTML tags that are unsafe. The filter_xss() function
lets us define an arbitrary list of allowed tags, while filter_xss_admin() is
simply a wrapper that includes a fairly permissive set of allowed tags.
Adding new artwork
Now we need to provide a form to add our new artworks. We defined a menu
callback named artwork_add earlier, so let's define that callback.
function artwork_add($type) {
global $user;
}
$types = artwork_types();
$type = isset($type) ? str_replace('-', '_', $type) : NULL;
if (empty($types[$type])) {
return MENU_NOT_FOUND;
}
$artwork = entity_get_controller('artwork')->create($type);
drupal_set_title(t('Create @name', array('@name' =>
$types[$type]->name)), PASS_THROUGH);
return drupal_get_form($type . '_artwork_form', $artwork);
As before, we clean up the artwork type (bundle) name and then if there is no such
artwork type we return a 404 not found error page. Next we create a new, empty
artwork object, set a page title, and then display a form.
[ 167 ]