Blog/ How to add custom theme settings for Drupal 7

Drupal gives us the ability to change theme settings from the administrative pages. Apart from the Global settings form, each theme has its own settings page.

Navigate to "Appearance" -> "Your theme" > "Settings"

This page has the "Logo Image Settings" and "Shortcut Icon Settings".

You can also add your own fields to this form.

Drupal 7 provides a more easier and flexible way to add your custom settings in the theme settings.

You just need to create a "theme-settings.php" file in your theme folder and write a THEMENAME_form_system_theme_settings_alter(&$form, $form_state) function.

For example, let us add breadcrumb settings to the theme settings.

function MYTHEME_form_system_theme_settings_alter(&$form, $form_state) {
  $form['breadcrumb'] = array(
    '#type' => 'fieldset',
    '#title' => t('Breadcrumb Settings'),
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
  );

  // Breadcrumb elements
  $form['breadcrumb']['breadcrumb_title'] = array(
    '#type' => 'select',
    '#title' => t('Breadcrumb title'),
    '#description' => t('Do you want to show the title of the page in the breadcrumb?'),
    '#options' => array(
      0 => t('No'),
      1 => t('Yes'),
    ),
    '#default_value' => theme_get_setting('breadcrumb_title'),
  );
}

Check http://api.drupal.org/api/drupal/7 for complete API reference

theme_get_setting('breadcrumb_title'); 

function MYTHEME_breadcrumb($variables) {
  $breadcrumb = $variables['breadcrumb'];
  if (!empty($breadcrumb)) {
    $output = '<'.OUTTAG.' class="element-invisible">' . t('You are here') . '<!--{cke_protected}{C}%3C!%2D%2D'.OUTTAG.'%2D%2D%3E-->';

    if (theme_get_setting('breadcrumb_title') == 1) { // show the title setting
      $breadcrumb[] = drupal_get_title();
    }

    $output .= '. implode(' » ', $breadcrumb);
    return $output;
  }
}

 settings['breadcrumb_title'] = 1

1. Create a "theme-settings.php" in your theme folder
2. Add the following code for the breadcrumb settings
3. You can check the form in your theme settings page. It will look like this.
4. You can write the PHP call in any of the .php files in your theme folder.

Related Articles:

• How to create a sub-theme in Drupal 7
• How to override theme functions in Drupal 7