DrupalAPI.de

1. drupal
   1. drupal6
   2. drupal7 system.api.php

Map form_ids to builder functions.

This hook allows modules to build multiple forms from a single form "factory" function but each form will have a different form id for submission, validation, theming or alteration by other modules.

The callback arguments will be passed as parameters to the function. Callers of drupal_get_form() are also able to pass in parameters. These will be appended after those specified by hook_forms().

See node_forms() for an actual example of how multiple forms share a common building function.

Übergabeparameter

$form_id The unique string identifying the desired form.

$args An array containing the original arguments provided to drupal_get_form().

Rückgabewert

An array keyed by form id with callbacks and optional, callback arguments.

Verwandte Themen

Hooks

Allow modules to interact with the Drupal core.

Code

developer-docs/hooks/core.php, line 829

<?php
function hook_forms($form_id, $args) {
  $forms['mymodule_first_form'] = array(
    'callback' => 'mymodule_form_builder',
    'callback arguments' => array('some parameter'),
  );
  $forms['mymodule_second_form'] = array(
    'callback' => 'mymodule_form_builder',
  );
  return $forms;
}
?>