system_settings_form

Versions
4.6: system_settings_form($form)
4.7: system_settings_form($form_id, $form)
5 – 6: system_settings_form($form)
7: system_settings_form($form, $automatic_defaults = TRUE)

Add default buttons to a form and set its prefix.

Parameters

$form An associative array containing the structure of the form.

$automatic_defaults Automatically load the saved values for each field from the system variables (defaults to TRUE).

Return value

The form structure.

▸ 22 functions call system_settings_form()

▾ 22 functions call system_settings_form()

book_admin_settings in modules/book/book.admin.inc: Builds and returns the book settings form.
example_element_demo_form in developer/examples/example_element.module: This is a simple form to demonstrate how to use the phonenumber element we've defined.
forum_admin_settings in modules/forum/forum.admin.inc: Form builder for the forum settings page.
locale_language_providers_session_form in includes/locale.inc: The URL language provider configuration form.
locale_language_providers_url_form in includes/locale.inc: The URL language provider configuration form.
search_admin_settings in modules/search/search.admin.inc: Menu callback; displays the search module settings page.
simpletest_settings_form in modules/simpletest/simpletest.pages.inc: Provides settings form for SimpleTest variables.
statistics_settings_form in modules/statistics/statistics.admin.inc: Form builder; Configure access logging.
system_clean_url_settings in modules/system/system.admin.inc: Form builder; Configure clean URL settings.
system_date_time_settings in modules/system/system.admin.inc: Form builder; Configure the site date and time settings.
system_file_system_settings in modules/system/system.admin.inc: Form builder; Configure the site file handling.
system_image_toolkit_settings in modules/system/system.admin.inc: Form builder; Configure site image toolkit usage.
system_logging_settings in modules/system/system.admin.inc: Form builder; Configure error reporting settings.
system_performance_settings in modules/system/system.admin.inc: Form builder; Configure site performance settings.
system_regional_settings in modules/system/system.admin.inc: Form builder; Configure the site regional settings.
system_rss_feeds_settings in modules/system/system.admin.inc: Form builder; Configure how the site handles RSS feeds.
system_site_information_settings in modules/system/system.admin.inc: Form builder; The general site information form.
system_site_maintenance_mode in modules/system/system.admin.inc: Form builder; Configure the site's maintenance status.
system_theme_settings in modules/system/system.admin.inc: Form builder; display theme configuration for entire site and individual themes.
update_settings in modules/update/update.settings.inc: Form builder for the update settings tab.
upload_admin_settings in modules/upload/upload.admin.inc: Menu callback for the upload settings form.
user_admin_settings in modules/user/user.admin.inc: Form builder; Configure user settings for this site.

Code

modules/system/system.module, line 2432

<?php
function system_settings_form($form, $automatic_defaults = TRUE) {
  $form['buttons']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration') );

  if ($automatic_defaults) {
    $form = _system_settings_form_automatic_defaults($form);
  }

  if (!empty($_POST) && form_get_errors()) {
    drupal_set_message(t('The settings have not been saved because of the errors.'), 'error');
  }
  $form['#submit'][] = 'system_settings_form_submit';
  // By default, render the form using theme_system_settings_form().
  if (!isset($form['#theme'])) {
    $form['#theme'] = 'system_settings_form';
  }
  return $form;
}
?>