DRUPAL*DRUPAL

D.I.Y. kit テーマの diykit/theme-settings.php ファイル内で定義している、テーマ設定関数（phptemplate_settings）とスキンリストを取得するための関数（diykit_skinlist）について、いくつかのパートに区分してまとめています。

テーマ設定関数

テーマ設定関数内にフォームを定義することで、テーマの設定ページにテーマ固有の設定フォームを表示し、その設定値をテーマで使用することができるようになります。
D.I.Y. kit で使うことができるテーマ設定関数名は、phptemplate_settings または diykit_settings となります。

※ 以下のコードは、phptemplate_settings 関数の一部を抜き出したもので、完全なコードではありません。

デフォルト値の設定とマージ

テーマ固有の設定フォームを定義した場合、各フォームのデフォルト値を定義しておく必要があります。
D.I.Y. kit では、各フォームのデフォルト値は info ファイルに記述していますので、デフォルト値の設定とマージは、次のようなコードになっています。

このコードを一般的な記述方法で表すと、次のようになります。

※ この方法の場合、template.php にも同様の $defaults 配列を記述する必要があります。

フォームの定義

D.I.Y. kit で定義しているテーマ固有の設定フォームとそのコードは、次の通りです。
各フォームを「スキンデザイン」「レイアウトデザイン」「その他の設定」の 3つのグループに整理して表示するために、フィールドセットを利用しています。

• スキンデザイン（フィールドセット）
  
  $form['diykit_skins'] = array(
    '#type' => 'fieldset',
    '#title' => t('Skin design'),
    '#description' => t('Select the skin.'),
    '#collapsible' => TRUE,
    '#collapsed' => FALSE,
    '#attributes' => array(
      'class' => 'fieldset-skins',
    ),
  );
• 各スキンのスクリーンショット（ラジオボタン）
  
  $form['diykit_skins']['diykit_skin'] = array(
    '#type' => 'radios',
    '#default_value' => $settings['diykit_skin'],
    '#options' => diykit_skinlist('screenshot'),
  );
• レイアウトデザイン（フィールドセット）
  
  $form['diykit_layouts'] = array(
    '#type' => 'fieldset',
    '#title' => t('Layout design'),
    '#description' => t('Select the page layout type and the layout type of columns position.'),
    '#collapsible' => TRUE,
    '#collapsed' => FALSE,
    '#attributes' => array(
      'class' => 'fieldset-layouts',
    ),
  );
• ページレイアウト（選択リスト）
  
  $form['diykit_layouts']['diykit_layout'] = array(
    '#type' => 'select',
    '#title' => t('Page layout'),
    '#default_value' => $settings['diykit_layout'],
    '#options' => array(
      'fixed' => t('Fixed'),
      'liquid' => t('Liquid'),
      'flexible' => t('Flexible'),
    ),
  );
• カラムレイアウト（選択リスト）
  
  $form['diykit_layouts']['diykit_column'] = array(
    '#type' => 'select',
    '#title' => t('Column layout'),
    '#default_value' => $settings['diykit_column'],
    '#options' => array(
      'portal' => t('Portal'),
      'news' => t('News'),
    ),
  );
• その他の設定（フィールドセット）
  
  $form['diykit_options'] = array(
    '#type' => 'fieldset',
    '#title' => t('Other settings'),
    '#collapsible' => TRUE,
    '#collapsed' => FALSE,
    '#attributes' => array(
      'class' => 'fieldset-options',
    ),
  );
• パンくずリストへページタイトルを設定（チェックボックス）
  
  $form['diykit_options']['diykit_breadcrumb'] = array(
    '#type' => 'checkbox',
    '#title' => t('Display the title in a list of breadcrumbs?'),
    '#default_value' => $settings['diykit_breadcrumb'],
  );

• フィールドセットは、いくつかのフォームをグループ化して表示するためのコントロールです。
• ラジオボタンは、複数の選択項目の中から該当するものを一つだけ選択するためのコントロールです。
• 選択リストは、複数の選択項目の中から該当するものを一つまたは複数選択するためのコントロールです。

スキンリスト取得関数

D.I.Y. kit では、各スキンのスクリーンショットを表示するラジオボタンの内容に、[code]'#options' => diykit_skinlist('screenshot')[/code] と、スキンリストを取得するための diykit_skinlist 関数を定義しています。
そのため、theme-settings.php ファイル内では diykit_skinlist 関数の定義も行っています。

この関数は、diykit/skin ディレクトリ内に存在するディレクトリを自動的に取得して、そのリストを返すための関数です。
関数のパラメータに "screenshot" をセットした場合で、かつ、diykit/skin/skinName/screenshot.png ファイルが存在する場合には、スキン名だけでなく、スクリーンショットも表示されます。

[参考]

theme-settings.php ファイル | DRUPAL*DRUPAL