checked( mixed $checked, mixed $current = true, bool $display = true ): string

User Contributed Notes

1. Skip to note 4 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 5You must log in to vote on the helpfulness of this note

   Example

   <?php // Get an array of options from the database. $options = get_option( 'slug_option' ); // Get the value of this option. $checked = $options['self-destruct']; // The value to compare with (the value of the checkbox below). $current = 1; // True by default, just here to make things clear. $echo = true; ?> <input name="slug-option[self-destruct]" value="1"	<?php checked( $checked, $current, $echo ); ?>/>

   Testing the value with if():

   <input type='checkbox' name='options[postlink]' value='1'	<?php if ( 1 == $options['postlink'] ) echo 'checked="checked"'; ?> />

   Using checked() instead:

   <input type="checkbox" name="options[postlink]" value="1"	<?php checked( $options['postlink'], 1 ); ?> />
2. Skip to note 5 content

   Anonymous User 5 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   Note that checking for

   checked()

   may/is not enough!

   Options are not saved if left empty (in the checkbox case == unchecked).

   Thus, before checked( $options['option_name'], 1 ); we should also check if the option is actually set, with something like:

   $options = get_option( 'wpdocs_option_array' ); if ( ! isset( $options['option'] ) ) { $options['option'] = 0; }
3. Skip to note 6 content

   sandeepjainlive 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   For multiselect checkbox use array in checked function instead of simple value.

   <?php $postlink = get_post_meta( $post->ID, 'postlink', true ); ?> <input type="checkbox" name="postlink[]" value="1" <?php checked(in_array( 1, $postlink ), 1); ?> /> <input type="checkbox" name="postlink[]" value="2" <?php checked(in_array( 2, $postlink ), 1); ?> /> <input type="checkbox" name="postlink[]" value="3" <?php checked(in_array( 3, $postlink ), 1); ?> />