Drupal 7 Module Development

Chapter 12
Here, the task that sets up the database is altered, telling it to call a different function
using the function key for the task.
function store_database_settings_form($form, &$form_state, &$install_
state) {
// Retrieve the default form.
$default_form = install_settings_form($form, &$form_state,
&$install_state);
$default_form['basic_options']['database']['#description'] .= st('
If you choose use SQLite please provide an absolute path outside of
the webroot directory.');
return $default_form;
}
In this task callback function, we retrieve the default form provided by Drupal,
alter it, and use that form. Since we are using a different form callback, we need to
provide _validate and _submit handlers to process the information submitted in
the form. The following two functions wrap the _validate and _submit functions
used for install_settings_form():
/**
* Form API validate for store_database_settings_form form.
*/
function store_database_settings_form_validate($form, &$form_state) {
install_settings_form_validate($form, &$form_state);
}
/**
* Form API submit for store_database_settings_form form.
*/
function store_database_settings_form_submit($form, &$form_state) {
install_settings_form_submit($form, &$form_state);
}
Configuring blocks
Out of the box, Drupal does not have any blocks configured to be displayed.
An installation profile will need to enable and configure any blocks it wants
displayed. In this case we will use hook_install() in a store.install file as
part of our install. When the modules for the profile are installed, the function
store_install() will run, configuring the blocks. The following is a basic
store_install() function enabling three blocks in the Bartik theme:
function store_install() {
// Enable some standard blocks.
$values = array(
array(
[ 355 ]