Drupalの関数（drupal_get_form）を利用してFormAPIで作成したフォームを任意の場所でPHPに呼び出されることができます

やりたいこと：FormAPIよい定義されたフォームを必要な時にphpコードより呼び出したいです

• 環境：Drupal7.54
• FormAPIでフォームを定義すると、通常はhook_menuよりページとして呼び出されます（一般的な使い方）
• Drupalのモジュールを改造するときに、HTMLタグでフォームを作成するより、FormAPIでフォームを生成するのは楽で、修正にも簡単でできます

関数：drupal_get_formでFormAPIより定義したフォームを簡単に呼び出し、レンダリングすることができます

• 例：Panelsでページを構成するときに、PanelsPHPを利用してフォームを作成したいです
  
• カスタムモジュールのどこか（module_load_includeでフォーム定義のファイルをロード）にフォームが定義すれば呼び出すことができます

    module_load_include('inc', 'node', 'node.pages');  // フォームの定義場所指定    
    $form = drupal_get_form('text_module_form');
    print drupal_render( $form );

   

やりたいこと：Drupalのフォーム（FormAPI）でajaxを実装して各フォーム要素を動的に制御したいです

• 環境：Drupal7.54
• フォーム（FormAPI）で各要素の表示/非表示などの制御が簡単にできます（Drupalのフォーム(Form API)の「#states」で各フォーム要素の動作制御が可能）。
  • フォームを作成時にJavascriptを意識しなくてよい
  • 事前にフォームの要素を用意して表示/非表示のようなお動作制御
  • データ取得するなどの動作制御はできません
• ajaxで高等な動作（データ取得など）制御ができるので、FormAPIもこれ基盤を用意して、簡単に実装できます。

FormAPIで「#ajax」の記述（ポイント：callback、wrapper）だけで良いのでJavascriptの意識必要はありません

• FormAPIがajaxのインターフェースを用意しています。Form記述で「#ajax」要素を追加すれば、Javascriptなどのコーティングはいらないです
  • callbak：ajaxのリクエストが来た時に呼び出される関数
  • wrapper：ajaxのサーバー処理完了後に結果を画面に表示させる場所の指定
• 簡単の例:テキスト入力フォームを生成して、入力したメッセージを画面のどこかに再表示させるajax処理
  
• ajaxの記述はFormAPIの実装時に追加します。

  /**
   *  Implementation of hook_menu()
   *  新規フォームを表示するページのメニュー設定
   */
  function my_module_name_menu() {
    $items['test/form'] = array(
        'title' => 'Ajaxテスト',
        'page callback' => 'drupal_get_form',
        'page arguments' => array('my_sample_form'),
        'access arguments' => array('access content'),
    );
  }
  
  /**
   * フォームの各要素の記述
   */
  function my_sample_form($form, &$form_state){
    // メッセージ入力フィールド
    $form['message'] = array(
        '#type' => 'textfield',
        '#title' => t('メッセージを入力'),
    );
  
    // 入力されたメッセージをajaxで表示する場所
    $form['msg_wrapper'] = array(
        '#type' => 'markup',
        '#markup' => "",
        '#prefix' => '<div id="msg-wrapper">',
        '#suffix' => '</div>',
    );
  
    // サブミットボタン
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => '送信',
        '#ajax' => array(
            'callback' => 'test_sample_form_ajax_callback',
            'wrapper' => 'msg-wrapper',
            'effect' => 'fade',
        ),
    );
  
    return $form;
  }
  
  /**
   * ajaxに呼び出される関数
   */
  function test_sample_form_ajax_callback($form, $form_state) {
    // 入力されたメッセージを指定した場所にセット
    $form['msg_wrapper']['#markup'] = '入力されたメッセージ：' .
                check_plain($form_state['values']['message']) ;
    // 置換する部品を返す
    return $form['msg_wrapper'] ;
  }

  
   

やりたいこと：FormAPIよい定義されたフォームを必要な時にphpコードより呼び出したいです

• 環境：Drupal7.54
• FormAPIでフォームを定義すると、通常はhook_menuよりページとして呼び出されます（一般的な使い方）
• Drupalのモジュールを改造するときに、HTMLタグでフォームを作成するより、FormAPIでフォームを生成するのは楽で、修正にも簡単でできます

関数：drupal_get_formでFormAPIより定義したフォームを簡単に呼び出し、レンダリングすることができます

• 例：Panelsでページを構成するときに、PanelsPHPを利用してフォームを作成したいです
  
• カスタムモジュールのどこか（module_load_includeでフォーム定義のファイルをロード）にフォームが定義すれば呼び出すことができます

    module_load_include('inc', 'node', 'node.pages');  // フォームの定義場所指定    
    $form = drupal_get_form('text_module_form');
    print drupal_render( $form );

   

やりたいこと：FormAPIよい定義されたフォームを必要な時にphpコードより呼び出したいです

• 環境：Drupal7.54
• FormAPIでフォームを定義すると、通常はhook_menuよりページとして呼び出されます（一般的な使い方）
• Drupalのモジュールを改造するときに、HTMLタグでフォームを作成するより、FormAPIでフォームを生成するのは楽で、修正にも簡単でできます

関数：drupal_get_formでFormAPIより定義したフォームを簡単に呼び出し、レンダリングすることができます

• 例：Panelsでページを構成するときに、PanelsPHPを利用してフォームを作成したいです
  
• カスタムモジュールのどこか（module_load_includeでフォーム定義のファイルをロード）にフォームが定義すれば呼び出すことができます

    module_load_include('inc', 'node', 'node.pages');  // フォームの定義場所指定    
    $form = drupal_get_form('text_module_form');
    print drupal_render( $form );

   

やりたいこと：DrupalのAJAXでマルチステップフォームを作成したいです

• 背景：Drupal7.54、FormAPIのAJAXを利用して、マルチステップフォームの作成
• FormAPIでマルチステップフォームの作成ができます（DrupalのFormAPIでマルチステップフォーム作成の基本 ）
• マルチステップフォームの作成には、AJAXの方が有利です
  • フォームHTMLの部分を置換すればよいので、全体的なページの更新必要はありません（パフォーマンスが良い）
  • AJAXがサーバーサイトとの交信URLが隠されています
  • DrupalのAJAXフレームワークを直接の利用で、簡単に実現できます（各ステップのフォームを直接に指定することができ、考え方が明確的）

DrupalのAJAXのdrupal_command_replace関数でフォームを置換してマルチステップフォームを作成します

• DrupalのAJAXの利用は:Drupalのフォーム（FromAPI）でのajaxの実装 を参考してください
• 各ステップのフォームがAJAXのコールバック関数内で定義しますので、FormAPIの実装方法より明確的になります
  
• AJAXで実装したマルチステップフォーム（ステップ１とステップ２の交替表示）例

  /**
   *  メニューでURLの定義
   */
  function your_module_menu() {
    $items['form/multiple-step'] = array(
        'title' => t('Multiple Step Form Test'),
        'page callback' => 'drupal_get_form',
        'page arguments' => array('page_one_form'),
        'access arguments' => array('access content'),
    );
    return $items;
  }
  
  /**
   *  ステップ１ フォームの定義
   */
  function page_one_form( $form, &$form_state ){
  
    $form['message_field'] = array(
        '#type' => 'markup',
        '#markup' => 'Form Step 1',
    );
    // サブミットボタン
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => '送信',
  	  '#ajax' => array(
          'callback' => 'card_1_ajax_callback',
        ),
    );
  
    return $form;}
  }
  
  /**
   *  ステップ２ フォームの定義
   */
  function page_two_form( $form, &$form_state ){
  
    $form['test_form']=array(
        '#type' => 'item',
        '#title' => 'Multiple Step Form',
        '#markup' => '<p>Step ２</p>',
    );
    $form['submit'] = array(
        '#type' => 'submit',
        '#value' => '送信',
  	  '#ajax' => array(
          'callback' => 'card_2_ajax_callback',
        ),
    );
  
    return $form;
  }
  
  /**
   *  ステップ１のコールバック関数
   */
  function card_1_ajax_callback($form, &$form_state){
  　// 次のステップのフォームの用意
    $form =  drupal_rebuild_form( 'card_two_form', $form_state );
  　// フォームのHTML部分の置換コマンド用意
    $commands[]=ajax_command_replace( '#block-system-main',
  		'<section class="block block-system clearfix" 
  				　id="block-system-main">'.render($form).'</section>' );
  
    return array('#type' => 'ajax', '#commands' => $commands);
  }
  
  /**
   *  ステップ２のコールバック関数
   */
  function card_2_ajax_callback($form, &$form_state){
  　// 次のステップのフォームの用意
    $form =  drupal_rebuild_form( 'card_one_form', $form_state );
  　// フォームのHTML部分の置換コマンド用意
    $commands[]=ajax_command_replace( '#block-system-main','<section class="block block-system clearfix" id="block-system-main">'.render($form).'</section>' );
  
    return array('#type' => 'ajax', '#commands' => $commands);
  }
  

   

Drupalのhook_menu()がカスタムページ作成時によく使用されます

• Drupalのサイトにページを追加する手段はいろいろあります
• モジュールでページを追加し、メニューをGUIで設定することができます
  • モジュール（Views）で検索結果をページとして表示することができます（主に表示系のページ、入力フォームはなし）
  • モジュール（Panels）で各種要素を集めてページを作成します（主に表示系のページ、入力フォームなし）
  • モジュール（Web Form）でコンタクト/アンケートなどのフォームページを作成（フォーム系、入力して、データをサーバーに送信して保存）
• プログラミングでページを作成する場合にhook_menu()を実装する必要があります
  • hook_menu()を実装時に、いろいろなパラメーター設定が紛らわしくて、注意する必要があります
  • Drupalのhook_menuでのURL設定にワイドカードの利用
  • Drupalのhook_menuでのユーザーロール別アクセス権限管理
  • 今回は、「page callback」パラメーターを詳細を説明します

Drupalのhook_menu()のパラメーター「page callback」が直接にページの呼び出しと「drupal_get_form」を介してページを呼び出す

• ここは、ajaxで動作するチェックボックスを例として上げます
  • チェックボックスをクリックすると、ajaxでサーバーと交信する

    function ajax_add_to_my_vocabulary($form,&$form_state, $entity){
    
        global $user ;
    
        //  データがすでに存在するか否かのチェック
        $my_voca_result = db_query("SELECT entity_id FROM my_ch_vocabulary WHERE vid=".$entity->vid . " AND uid=".$user->uid)->fetchAll();
        //   ajaxコールバック時に使用するパラメーター
        $form_state['has_my_voca_result'] = count($my_voca_result)>0 ? true:false ;
        $form_state['ch_vocabulary'] = $entity ;  
    
        //　ajaxのチェックボックスフォーム定義
        $form['ch_voca_form']=array(
            '#type' => 'checkbox',
            '#disabled' => $user->uid == 0 ? true : false ,
            '#title' => count($my_voca_result)>0 ? t('<span id="ch-voca-check-op-'.$vid.'">Remove</span>') : t('<span id="ch-voca-check-op-'.$entity->vid.'">Add</span>'),
            '#default_value' => count($my_voca_result)>0 ? 1 : 0,
            '#ajax' => array(
                'callback' => 'add_to_my_vocabulary_callback',
                'wrapper' => 'ch-voca-check-op-'.$entity->vid,
                'method' => 'replace',
                'effect' => 'fade',
            ),
        );
        return $form ;
    }
    
    // ajaxのコールバック関数
    function add_to_my_vocabulary_in_views($form, $form_state){
    
        global $user;
    
        $entity = $form_state['ch_vocabulary'] ;
    
        // DBにデータがある場合に削除処理
        if( $form_state['has_my_voca_result'] ) {
            db_delete( 'my_ch_vocabulary' )->condition( 'vid', $entity->vid )->condition('uid', $user->uid )->execute();
            //  チェックボックスのラベルを「Add」に変更
            return t('<span id="ch-voca-check-op-'.$vid.'">Add</span>');
        }
    
        //　データがなければ、ch_vocabuaryをmy_vocabuaryにコピー
        $my_voca = entity_create('my_ch_vocabulary', array('vid'=>$entity->vid));
        $my_voca_wrapper = entity_metadata_wrapper( 'my_ch_vocabulary', $my_voca );
        $my_voca_wrapper->vocabulary->set( $ch_voca->vocabulary ) ;
        ....   //各種フィールド、プロパティのセット
        $my_voca_wrapper->save();   //　コピーされたデータの保存
    
        //  チェックボックスのラベルを「Remove」に変更
        return  t('<span id="ch-voca-check-op-'.$vid.'">Remove</span>');
    }

• hook_menu()が直接にajaxのチェックボックスフォームを呼び出す場合、ajaxの動作しません

  YOUR_MODULE_NAME_menu(){
    $items['your/path/%entity'] = array(
          'title' => 'Copy and Remove',
          'page callback' => 'ajax_add_to_my_vocabulary',
          'page arguments' => array(array(), array(), 2) ,
          'access arguments' => array('create my vocabulary'),
    );
  }

  • ajaxのチェックボックスフォーム「ajax_add_to_my_vocabulary」が表示されますが、<form>要素がなくて、ajaxの動作はしません
    
• hook_menu()が"drupal_get_form"を介してにajaxのチェックボックスフォームを呼び出す場合、ajaxの動作は正常です

  YOUR_MODULE_NAME_menu(){
   　$items['your/path/%entity'] = array(
  　　　'title' => 'Copy and Remove', 
  　　　'page callback' => 'drupal_get_form', 
  　　　'page arguments' => array('ajax_add_to_my_vocabulary', 2) , 
  　　　'access arguments' => array('create my vocabulary'), 
  　　); 
  }

  • 作成されたフォームに"<form>"要素およびajaxの要素が含まれているのでajaxが正常に動作します
    

結論：表示系ページは直接に呼び出し、入力フォーム系は"drupal_get_form"を介して呼び出す

• hook_menu()を実装時に、呼び出すページの性質によりページの呼び出す方法を決めます
  • 表示系ページ（データ更新なし）の場合は直接に呼び出せばよいです
  • 入力フォーム系のページは"drupal_get_form"を介して呼び出します
• 表示系か、フォーム系かを区別せず、いつも"drupal_get_form"を介して呼び出しても構わないです
• "drupal_get_form"がフォーム構築のプロセスが含まているので、フォームの要素構築するには必要です
  • drupa_get_form, drupal_prepare_form, drupal_retrieve_formの違い
  • これを使用する場合少し（どのぐらいは測定していないが）遅いかもしれないです