Form Workflow Illustration

Drupal 5.x · Drupal 6.x

This workflow actually includes some of the nodeapi hooks as well as FAPI workflow to help illustrate the places where form elements can be manipulated.

Attachment	Size
fapi_workflow_reworked_lin_tall.gif	45.57 KB

» Login or register to post comments

This workflow leaves off

merlinofchaos - August 18, 2007 - 18:01

This workflow leaves off what happens after Save. In the normal workflow, it does a drupal_goto (back to the page you're looking on).

-- Merlin

[Point the finger: Assign Blame!]
[Read my writing: ehalseymiles.com]
[Read my Coding blog: Angry Donuts]

Hi Merlin, Thanks for the

jp.stacey - September 2, 2007 - 20:43

Hi Merlin,

Thanks for the feedback. Does the drupal_goto() call the same URL as was originally visited, by default? Is there any control over that with a FAPI property?

I'll check with KarenS what to do, as she has documentation-fu.

Cheers,
J-P

Yes, and there are ways to

merlinofchaos - September 7, 2007 - 18:52

Yes, and there are ways to control it:

The submit function can return the destination to go to

$form['#redirect'] -- set to the destination or to NULL to disable redirects

-- Merlin

[Read my writing: ehalseymiles.com]
[Read my Coding blog: Angry Donuts]

what about hook_prepare?

jakeg - September 19, 2007 - 09:05

This seems great (just printed off a copy) but it seems to be missing hook_prepare, no?

Jake
---
School and university yearbooks

great chart. one note:

ax - January 10, 2008 - 22:19

great chart. one note: drupal_retrieve_form($form_id) doesn't necessarily call hook_form(), but any form building function like $form_id. or, if that doesn't exist, a result of hook_forms():

<?php
function drupal_retrieve_form($form_id) {
  // ...
  // We first check to see if there's a function named after the $form_id.
  // If there is, we simply pass the arguments on to it to get the form.
  if (!function_exists($form_id)) {
    // In cases where many form_ids need to share a central builder function,
    // such as the node editing form, modules can implement hook_forms(). It
    // maps one or more form_ids to the correct builder functions.
    //
    // We cache the results of that hook to save time, but that only works
    // for modules that know all their form_ids in advance. (A module that
    // adds a small 'rate this comment' form to each comment in a list
    // would need a unique form_id for each one, for example.)
    //
    // So, we call the hook if $forms isn't yet populated, OR if it doesn't
    // yet have an entry for the requested form_id.
    if (!isset($forms) || !isset($forms[$form_id])) {
      $forms = module_invoke_all('forms', $saved_args);
    }
    $form_definition = $forms[$form_id];
    if (isset($form_definition['callback arguments'])) {
      $args = array_merge($form_definition['callback arguments'], $args);
    }
    if (isset($form_definition['callback'])) {
      $callback = $form_definition['callback'];
    }
  }
  // If $callback was returned by a hook_forms() implementation, call it.
  // Otherwise, call the function named after the form id.
  $form = call_user_func_array(isset($callback) ? $callback : $form_id, $args);
  // ...
}
?>

Form Workflow Illustration

This workflow leaves off

Hi Merlin, Thanks for the

Yes, and there are ways to

what about hook_prepare?

great chart. one note:

Developing for Drupal

Handbook license

Quick links

User login

Search downloads

Contributor links