LoginSignup
9
5

More than 5 years have passed since last update.

@noqua

[WordPress]Contact Form 7 に独自タグでチェックボックスを追加【特定カテゴリー編】

Last updated at Posted at 2018-04-26

前回の記事でContact Form 7に独自チェックボックスを追加する方法を書きました。
前回は 固定ページ を動的にチェックボックス化しましたが、同じ要領で今回は 特定カテゴリー記事 をチェックボックス化するコードの紹介になります。

仕様

  • Contact Form 7の設定画面で独自タグ [cat_list] を利用
    独自タグ使用イメージ

  • 特定カテゴリーに属する記事のタイトルがチェックボックスとなる
    カテゴリー選択イメージ

    フォーム表示イメージ

  • Contact Form 7標準のチェックボックス同様、以下のオプションも選択できる

    • 必須項目
    • 名前
    • ラベルを前に、チェックボックスを後に配置する
    • 個々の項目を label 要素で囲む
    • チェックボックスを排他化する
    • ID属性
    • クラス属性 チェックボックスのオプションイメージ

検証バージョン

  • WordPress : 4.9.4
  • Contact Form 7 : 5.0.1

実装

前回同様、 function.php に関数を書いていきます。

function.php

function.php
// Contact Form 7 に独自チェックリストを追加
add_action( 'wpcf7_init', 'wpcf7_add_form_tag_catlist' );

// 独自タグ[cat_list]を定義（末尾*は必須項目用）
function wpcf7_add_form_tag_catlist() {
    wpcf7_add_form_tag( array( 'cat_list', 'cat_list*' ),
        'wpcf7_pagelist_form_tag_handler', // 下で設定する関数名が入る
        array(
            'name-attr' => true,
            'selectable-values' => true,
            'multiple-controls-container' => true,
        )
    );
}

// 独自タグの内容を定義する関数
function wpcf7_pagelist_form_tag_handler( $tag ) {
    if ( empty( $tag->name ) ) {
        return '';
    }

    $validation_error = wpcf7_get_validation_error( $tag->name );
    $class = wpcf7_form_controls_class( $tag->type );

    if ( $validation_error ) {
        $class .= ' wpcf7-not-valid';
    }

    // オプションの設定
    $label_first        = $tag->has_option( 'label_first' );
    $use_label_element  = $tag->has_option( 'use_label_element' );
    $exclusive          = $tag->has_option( 'exclusive' );
    $multiple           = false;

    if ( 'cat_list' == $tag->basetype ) {
        $multiple = ! $exclusive;
    }

    if ( $exclusive ) {
        $class .= ' wpcf7-exclusive-checkbox';
    }

    $atts = array();

    $atts['class']  = $tag->get_class_option( $class );
    $atts['id']     = $tag->get_id_option();

    $tabindex = $tag->get_option( 'tabindex', 'signed_int', true );

    if ( false !== $tabindex ) {
        $tabindex = (int) $tabindex;
    }

    // カテゴリーを指定するプロパティ
    // cat_id:xxxx でIDから指定
    $cat_id = ''; // default
    $cat_id = ( $cat_id = $tag->get_option('cat_id', '', true ))? esc_attr($cat_id) : '';

    // cat_slug:xxxx でスラッグから指定
    $cat_slug = ( $cat_slug = $tag->get_option('cat_slug', '', true ))? esc_attr($cat_slug) : '';
    if($cat_slug) {
        $category = get_category_by_slug($cat_slug);
        $cat_id = $category -> term_id;
    }

    // カテゴリーの記事を取得
    $cat_posts = 'numberposts=-1&category='.$cat_id.'&order=ASC&orderby=menu_order';
    $posts = get_posts($cat_posts); global $post;

    $html = '';
    $count = 0;

    $hangover = wpcf7_get_hangover( $tag->name, $multiple ? array() : '' );

    // 表示の設定
    foreach($posts as $post) {
        $class = 'wpcf7-list-item';

        $checked    = false;
        $key        = $count;
        $value      = get_the_title();
        $label      = get_the_title();

        if ( $hangover ) {
            if ( $multiple ) {
                $checked = in_array( $value, (array) $hangover, true );
            } else {
                $checked = ( $hangover === $value );
            }
        } else {
            $checked = in_array( $count + 1, (array) $defaults );
        }

        $item_atts = array(
            'type'      => 'checkbox',
            'name'      => $tag -> name . ( $multiple ? '[]' : '' ),
            'value'     => $value,
            'checked'   => $checked ? 'checked' : '',
            'tabindex'  => false !== $tabindex ? $tabindex : '',
        );

        $item_atts = wpcf7_format_atts( $item_atts );

        if ( $label_first ) { // put label first, input last
            $item = sprintf(
                '<span class="wpcf7-list-item-label">%1$s</span><input %2$s />',
                esc_html( $label ), $item_atts );
        } else {
            $item = sprintf(
                '<input %2$s /><span class="wpcf7-list-item-label">%1$s</span>',
                esc_html( $label ), $item_atts );
        }

        if ( $use_label_element ) {
            $item = '<label>' . $item . '</label>';
        }

        if ( false !== $tabindex && 0 < $tabindex ) {
            $tabindex += 1;
        }

        $count += 1;

        if ( 1 == $count ) {
            $class .= ' first';
        }

        if ( count( $children ) == $count ) { // last round
            $class .= ' last';
        }

        $item = '<span class="' . esc_attr( $class ) . '">' . $item . '</span>';
        $html .= $item;
    } // foreach

    $atts = wpcf7_format_atts( $atts );

    $html = sprintf(
        '<span class="wpcf7-form-control-wrap %1$s"><span %2$s>%3$s</span>%4$s</span>',
        sanitize_html_class( $tag->name ), $atts, $html, $validation_error );

    // postをリセット
    wp_reset_postdata();

    return $html;
}

// バリデートの設定
add_filter( 'wpcf7_validate_cat_list', 'wpcf7_cat_list_validation_filter', 10, 2 );
add_filter( 'wpcf7_validate_cat_list*', 'wpcf7_cat_list_validation_filter', 10, 2 );

function wpcf7_cat_list_validation_filter( $result, $tag ) {
    $type = $tag->type;
    $name = $tag->name;
    $is_required = $tag->is_required() || 'cat_list*' == $type; // 'cat_list*' は独自タグ
    $value = isset( $_POST[$name] ) ? (array) $_POST[$name] : array();

    if ( $is_required && empty( $value ) ) {
        $result->invalidate( $tag, wpcf7_get_message( 'invalid_required' ) );
    }

    return $result;
}

Contact Form 7設定画面

今回追加したチェックボックスを生成する独自タグは [cat_list] となります。

  • 必須項目にする場合は末尾に　　を加える [cat_list]
  • カテゴリーIDもしくはスラッグを指定 （※いずれか必須）
    • IDを指定する場合は cat_id:カテゴリーID
    • スラッグで指定する場合は cat_slug:カテゴリースラッグ と書きます。※カテゴリースラッグは日本語だと動きません。
[cat_list* cat_id:2] // IDで指定する場合
[cat_list* cat_slug:スラッグ] // スラッグで指定する場合

さらにContact Form 7の標準チェックボックス同様、以下のオプションが指定出来ます。
書き方はContact Form 7の仕様ページを参考にしてください。

  • 名前（inputのname値）
  • ラベルを前に、チェックボックスを後に配置する label_first
  • 個々の項目を label 要素で囲む use_label_element
  • チェックボックスを排他化する exclusive
  • ID属性 id:hoge
  • クラス属性 class:foo

※チェックボックスの項目は タグでは指定出来ません。

独自タグの書き方例

[cat_list* seminar use_label_element cat_id:2]

Contact Form 7の設定画面

フォームの表示イメージ

フォーム表示イメージ

バリデーションも動きます。

セレクトボックスやテキストボックス等を独自タグにする方法はいくつか見つかるのですが、チェックボックスのように複数選択するもののカスタマイズ方法はあまり見かけないので、前回の固定ページに引き続きカテゴリー記事から追加する方法もまとめてみました。

以上になります。
参考になりましたら幸いです。

固定ページ（子ページ）をチェックボックス化する方法はこちら。

下記のページを参考にさせていただきました。ありがとうございます。

9
5
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
9
5