Home › API reference › core.php

hook_form_alter

  1. drupal
    1. 4.7
    2. 5
    3. 6
    4. 7 system.api.php
Versions
4.7 – 5 hook_form_alter($form_id, &$form)
6 – 7 hook_form_alter(&$form, &$form_state, $form_id)

Perform alterations before a form is rendered. One popular use of this hook is to add form elements to the node form.

Parameters

$form_id String representing the name of the form itself. Typically this is the name of the function that generated the form.

$form Nested array of form elements that comprise the form.

Return value

None.

Related topics

Hooks
Allow modules to interact with the Drupal core.

Code

developer/hooks/core.php, line 428

<?php
function hook_form_alter($form_id, &$form) {
  if (isset($form['type']) && $form['type']['#value'] . '_node_settings' == $form_id) {
    $form['workflow']['upload_' . $form['type']['#value']] = array(
      '#type' => 'radios', 
      '#title' => t('Attachments'), 
      '#default_value' => variable_get('upload_' . $form['type']['#value'], 1), 
      '#options' => array(t('Disabled'), t('Enabled')),
    );
  }
}
?>