: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
** A base module for [checkbox], [checkbox*], and [radio]
add_action( 'wpcf7_init', 'wpcf7_add_form_tag_checkbox', 10, 0 );
function wpcf7_add_form_tag_checkbox() {
wpcf7_add_form_tag( array( 'checkbox', 'checkbox*', 'radio' ),
'wpcf7_checkbox_form_tag_handler',
'selectable-values' => true,
'multiple-controls-container' => true,
function wpcf7_checkbox_form_tag_handler( $tag ) {
if ( empty( $tag->name ) ) {
$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' );
$free_text = $tag->has_option( 'free_text' );
if ( 'checkbox' == $tag->basetype ) {
$multiple = ! $exclusive;
$class .= ' wpcf7-exclusive-checkbox';
$atts['class'] = $tag->get_class_option( $class );
$atts['id'] = $tag->get_id_option();
if ( $validation_error ) {
$atts['aria-describedby'] = wpcf7_get_validation_error_reference(
$tabindex = $tag->get_option( 'tabindex', 'signed_int', true );
if ( false !== $tabindex ) {
$tabindex = (int) $tabindex;
if ( $data = (array) $tag->get_data_option() ) {
$tag->values = array_merge(
array_slice( $tag->values, 0, -1 ),
array_slice( $tag->values, -1 )
$tag->labels = array_merge(
array_slice( $tag->labels, 0, -1 ),
array_slice( $tag->labels, -1 )
$tag->values = array_merge( $tag->values, array_values( $data ) );
$tag->labels = array_merge( $tag->labels, array_values( $data ) );
$default_choice = $tag->get_default_option( null, array(
$hangover = wpcf7_get_hangover( $tag->name, $multiple ? array() : '' );
foreach ( $values as $key => $value ) {
$checked = in_array( $value, (array) $hangover, true );
$checked = in_array( $value, (array) $default_choice, true );
if ( isset( $labels[$key] ) ) {
'type' => $tag->basetype,
'name' => $tag->name . ( $multiple ? '[]' : '' ),
$item_atts = wpcf7_format_atts( $item_atts );
if ( $label_first ) { // put label first, input last
'<span class="wpcf7-list-item-label">%1$s</span><input %2$s />',
'<input %2$s /><span class="wpcf7-list-item-label">%1$s</span>',
if ( $use_label_element ) {
$item = '<label>' . $item . '</label>';
if ( false !== $tabindex and 0 < $tabindex ) {
$class = 'wpcf7-list-item';
if ( count( $values ) == $count ) { // last round
$free_text_name = sprintf( '_wpcf7_free_text_%s', $tag->name );
'name' => $free_text_name,
'class' => 'wpcf7-free-text',
and isset( $_POST[$free_text_name] ) ) {
$free_text_atts['value'] = wp_unslash( $_POST[$free_text_name] );
$free_text_atts = wpcf7_format_atts( $free_text_atts );
$item .= sprintf( ' <input type="text" %s />', $free_text_atts );
$class .= ' has-free-text';
$item = '<span class="' . esc_attr( $class ) . '">' . $item . '</span>';
'<span class="wpcf7-form-control-wrap" data-name="%1$s"><span %2$s>%3$s</span>%4$s</span>',
wpcf7_format_atts( $atts ),
'wpcf7_swv_create_schema',
'wpcf7_swv_add_checkbox_rules',
function wpcf7_swv_add_checkbox_rules( $schema, $contact_form ) {
$tags = $contact_form->scan_form_tags( array(
'basetype' => array( 'checkbox', 'radio' ),
foreach ( $tags as $tag ) {
if ( $tag->is_required() or 'radio' === $tag->type ) {
wpcf7_swv_create_rule( 'required', array(
'error' => wpcf7_get_message( 'invalid_required' ),
if ( 'radio' === $tag->type or $tag->has_option( 'exclusive' ) ) {
wpcf7_swv_create_rule( 'maxitems', array(
'error' => $contact_form->filter_message(
__( "Too many items are selected.", 'contact-form-7' )
'wpcf7_swv_create_schema',
'wpcf7_swv_add_checkbox_enum_rules',
function wpcf7_swv_add_checkbox_enum_rules( $schema, $contact_form ) {
$tags = $contact_form->scan_form_tags( array(
'basetype' => array( 'checkbox', 'radio' ),
function ( $values, $tag ) {
if ( $tag->has_option( 'free_text' ) ) {
$values[$tag->name] = 'free_text';
isset( $values[$tag->name] ) and
! is_array( $values[$tag->name] ) // Maybe 'free_text'
if ( ! isset( $values[$tag->name] ) ) {
$values[$tag->name] = array();
$tag_values = array_merge(
(array) $tag->get_data_option()
$values[$tag->name] = array_merge(
foreach ( $values as $field => $field_values ) {
if ( ! is_array( $field_values ) ) { // Maybe 'free_text'
$field_values = array_map(
static function ( $value ) {
return html_entity_decode(
$field_values = array_filter(
array_unique( $field_values ),
static function ( $value ) {
wpcf7_swv_create_rule( 'enum', array(
'accept' => array_values( $field_values ),
'error' => $contact_form->filter_message(
__( "Undefined value was submitted through this field.", 'contact-form-7' )
add_filter( 'wpcf7_posted_data_checkbox',
'wpcf7_posted_data_checkbox',
add_filter( 'wpcf7_posted_data_checkbox*',
'wpcf7_posted_data_checkbox',
add_filter( 'wpcf7_posted_data_radio',
'wpcf7_posted_data_checkbox',
function wpcf7_posted_data_checkbox( $value, $value_orig, $form_tag ) {
if ( $form_tag->has_option( 'free_text' ) ) {
$free_text_name = sprintf( '_wpcf7_free_text_%s', $form_tag->name );
$free_text = wp_unslash( $_POST[$free_text_name] ?? '' );
$last_val = array_pop( $value );
if ( isset( $last_val ) ) {
$last_val = sprintf( '%s %s', $last_val, $free_text );
$value[] = trim( $last_val );
add_action( 'wpcf7_admin_init',
'wpcf7_add_tag_generator_checkbox_and_radio', 30, 0 );
function wpcf7_add_tag_generator_checkbox_and_radio() {
$tag_generator = WPCF7_TagGenerator::get_instance();
$tag_generator->add( 'checkbox', __( 'checkboxes', 'contact-form-7' ),
'wpcf7_tag_generator_checkbox' );
$tag_generator->add( 'radio', __( 'radio buttons', 'contact-form-7' ),
'wpcf7_tag_generator_checkbox' );
function wpcf7_tag_generator_checkbox( $contact_form, $args = '' ) {
$args = wp_parse_args( $args, array() );
if ( 'radio' != $type ) {
if ( 'checkbox' == $type ) {
$description = __( "Generate a form-tag for a group of checkboxes. For more details, see %s.", 'contact-form-7' );
} elseif ( 'radio' == $type ) {
$description = __( "Generate a form-tag for a group of radio buttons. For more details, see %s.", 'contact-form-7' );
$desc_link = wpcf7_link( __( 'https://contactform7.com/checkboxes-radio-buttons-and-menus/', 'contact-form-7' ), __( 'Checkboxes, radio buttons and menus', 'contact-form-7' ) );
<div class="control-box">
<legend><?php echo sprintf( esc_html( $description ), $desc_link ); ?></legend>
<table class="form-table">
<?php if ( 'checkbox' == $type ) : ?>
<th scope="row"><?php echo esc_html( __( 'Field type', 'contact-form-7' ) ); ?></th>
<legend class="screen-reader-text"><?php echo esc_html( __( 'Field type', 'contact-form-7' ) ); ?></legend>
<label><input type="checkbox" name="required" /> <?php echo esc_html( __( 'Required field', 'contact-form-7' ) ); ?></label>
<th scope="row"><label for="<?php echo esc_attr( $args['content'] . '-name' ); ?>"><?php echo esc_html( __( 'Name', 'contact-form-7' ) ); ?></label></th>
<td><input type="text" name="name" class="tg-name oneline" id="<?php echo esc_attr( $args['content'] . '-name' ); ?>" /></td>
<th scope="row"><?php echo esc_html( __( 'Options', 'contact-form-7' ) ); ?></th>
<legend class="screen-reader-text"><?php echo esc_html( __( 'Options', 'contact-form-7' ) ); ?></legend>
<textarea name="values" class="values" id="<?php echo esc_attr( $args['content'] . '-values' ); ?>"></textarea>
<label for="<?php echo esc_attr( $args['content'] . '-values' ); ?>"><span class="description"><?php echo esc_html( __( "One option per line.", 'contact-form-7' ) ); ?></span></label><br />
<label><input type="checkbox" name="label_first" class="option" /> <?php echo esc_html( __( 'Put a label first, a checkbox last', 'contact-form-7' ) ); ?></label><br />
<label><input type="checkbox" name="use_label_element" class="option" checked="checked" /> <?php echo esc_html( __( 'Wrap each item with label element', 'contact-form-7' ) ); ?></label>
<?php if ( 'checkbox' == $type ) : ?>
<br /><label><input type="checkbox" name="exclusive" class="option" /> <?php echo esc_html( __( 'Make checkboxes exclusive', 'contact-form-7' ) ); ?></label>
<th scope="row"><label for="<?php echo esc_attr( $args['content'] . '-id' ); ?>"><?php echo esc_html( __( 'Id attribute', 'contact-form-7' ) ); ?></label></th>
<td><input type="text" name="id" class="idvalue oneline option" id="<?php echo esc_attr( $args['content'] . '-id' ); ?>" /></td>
<th scope="row"><label for="<?php echo esc_attr( $args['content'] . '-class' ); ?>"><?php echo esc_html( __( 'Class attribute', 'contact-form-7' ) ); ?></label></th>
<td><input type="text" name="class" class="classvalue oneline option" id="<?php echo esc_attr( $args['content'] . '-class' ); ?>" /></td>
<input type="text" name="<?php echo $type; ?>" class="tag code" readonly="readonly" onfocus="this.select()" />
<input type="button" class="button button-primary insert-tag" value="<?php echo esc_attr( __( 'Insert Tag', 'contact-form-7' ) ); ?>" />
<p class="description mail-tag"><label for="<?php echo esc_attr( $args['content'] . '-mailtag' ); ?>"><?php echo sprintf( esc_html( __( "To use the value input through this field in a mail field, you need to insert the corresponding mail-tag (%s) into the field on the Mail tab.", 'contact-form-7' ) ), '<strong><span class="mail-tag"></span></strong>' ); ?><input type="text" class="mail-tag code hidden" readonly="readonly" id="<?php echo esc_attr( $args['content'] . '-mailtag' ); ?>" /></label></p>