| [ Index ] |
PHP Cross Reference of WordPress Trunk (Updated Daily) |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Discussion settings administration panel. 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 /** WordPress Administration Bootstrap */ 9 require_once __DIR__ . '/admin.php'; 10 11 if ( ! current_user_can( 'manage_options' ) ) { 12 wp_die( __( 'Sorry, you are not allowed to manage options for this site.' ) ); 13 } 14 15 // Used in the HTML title tag. 16 $title = __( 'Discussion Settings' ); 17 $parent_file = 'options-general.php'; 18 19 add_action( 'admin_print_footer_scripts', 'options_discussion_add_js' ); 20 21 get_current_screen()->add_help_tab( 22 array( 23 'id' => 'overview', 24 'title' => __( 'Overview' ), 25 'content' => '<p>' . __( 'This screen provides many options for controlling the management and display of comments and links to your posts/pages. So many, in fact, they will not all fit here! :) Use the documentation links to get information on what each discussion setting does.' ) . '</p>' . 26 '<p>' . __( 'You must click the Save Changes button at the bottom of the screen for new settings to take effect.' ) . '</p>', 27 ) 28 ); 29 30 get_current_screen()->set_help_sidebar( 31 '<p><strong>' . __( 'For more information:' ) . '</strong></p>' . 32 '<p>' . __( '<a href="https://wordpress.org/documentation/article/settings-discussion-screen/">Documentation on Discussion Settings</a>' ) . '</p>' . 33 '<p>' . __( '<a href="https://wordpress.org/support/forums/">Support forums</a>' ) . '</p>' 34 ); 35 36 require_once ABSPATH . 'wp-admin/admin-header.php'; 37 ?> 38 39 <div class="wrap"> 40 <h1><?php echo esc_html( $title ); ?></h1> 41 42 <form method="post" action="options.php"> 43 <?php settings_fields( 'discussion' ); ?> 44 45 <table class="form-table indent-children" role="presentation"> 46 <?php $default_post_settings_title = __( 'Default post settings' ); ?> 47 <tr> 48 <th scope="row"><?php echo $default_post_settings_title; ?></th> 49 <td><fieldset><legend class="screen-reader-text"><span><?php echo $default_post_settings_title; ?></span></legend> 50 <label for="default_pingback_flag"> 51 <input name="default_pingback_flag" type="checkbox" id="default_pingback_flag" value="1" <?php checked( '1', get_option( 'default_pingback_flag' ) ); ?> /> 52 <?php _e( 'Attempt to notify any blogs linked to from the post' ); ?></label> 53 <br /> 54 <label for="default_ping_status"> 55 <input name="default_ping_status" type="checkbox" id="default_ping_status" value="open" <?php checked( 'open', get_option( 'default_ping_status' ) ); ?> /> 56 <?php _e( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new posts' ); ?></label> 57 <br /> 58 <label for="default_comment_status"> 59 <input name="default_comment_status" type="checkbox" id="default_comment_status" value="open" <?php checked( 'open', get_option( 'default_comment_status' ) ); ?> /> 60 <?php _e( 'Allow people to submit comments on new posts' ); ?></label> 61 <br /> 62 <p class="description"><?php _e( 'Individual posts may override these settings. Changes here will only be applied to new posts.' ); ?></p> 63 </fieldset></td> 64 </tr> 65 <?php $other_comment_settings_title = __( 'Other comment settings' ); ?> 66 <tr> 67 <th scope="row"><?php echo $other_comment_settings_title; ?></th> 68 <td><fieldset><legend class="screen-reader-text"><span><?php echo $other_comment_settings_title; ?></span></legend> 69 <label for="require_name_email"><input type="checkbox" name="require_name_email" id="require_name_email" value="1" <?php checked( '1', get_option( 'require_name_email' ) ); ?> /> <?php _e( 'Comment author must fill out name and email' ); ?></label> 70 <br /> 71 <label for="comment_registration"> 72 <input name="comment_registration" type="checkbox" id="comment_registration" value="1" <?php checked( '1', get_option( 'comment_registration' ) ); ?> /> 73 <?php _e( 'Users must be registered and logged in to comment' ); ?> 74 <?php 75 if ( ! get_option( 'users_can_register' ) && is_multisite() ) { 76 echo ' ' . __( '(Signup has been disabled. Only members of this site can comment.)' ); 77 } 78 ?> 79 </label> 80 <br /> 81 <input name="close_comments_for_old_posts" type="checkbox" id="close_comments_for_old_posts" value="1" <?php checked( '1', get_option( 'close_comments_for_old_posts' ) ); ?> /> <label for="close_comments_for_old_posts"><?php _e( 'Automatically close comments on old posts' ); ?></label> 82 <ul> 83 <li> 84 <label for="close_comments_days_old"><?php _e( 'Close comments when post is how many days old' ); ?></label> 85 <input name="close_comments_days_old" type="number" step="1" min="0" id="close_comments_days_old" value="<?php echo esc_attr( get_option( 'close_comments_days_old' ) ); ?>" class="small-text" /> 86 </li> 87 </ul> 88 89 <input name="show_comments_cookies_opt_in" type="checkbox" id="show_comments_cookies_opt_in" value="1" <?php checked( '1', get_option( 'show_comments_cookies_opt_in' ) ); ?> /> 90 <label for="show_comments_cookies_opt_in"><?php _e( 'Show comments cookies opt-in checkbox, allowing comment author cookies to be set' ); ?></label> 91 <br /> 92 <input name="thread_comments" type="checkbox" id="thread_comments" value="1" <?php checked( '1', get_option( 'thread_comments' ) ); ?> /> 93 <label for="thread_comments"><?php _e( 'Enable threaded (nested) comments' ); ?></label> 94 95 <?php 96 /** 97 * Filters the maximum depth of threaded/nested comments. 98 * 99 * @since 2.7.0 100 * 101 * @param int $max_depth The maximum depth of threaded comments. Default 10. 102 */ 103 $maxdeep = (int) apply_filters( 'thread_comments_depth_max', 10 ); 104 105 $thread_comments_depth = '<select name="thread_comments_depth" id="thread_comments_depth">'; 106 for ( $i = 2; $i <= $maxdeep; $i++ ) { 107 $thread_comments_depth .= "<option value='" . esc_attr( $i ) . "'"; 108 if ( (int) get_option( 'thread_comments_depth' ) === $i ) { 109 $thread_comments_depth .= " selected='selected'"; 110 } 111 $thread_comments_depth .= ">$i</option>"; 112 } 113 $thread_comments_depth .= '</select>'; 114 ?> 115 <ul> 116 <li> 117 <label for="thread_comments_depth"><?php _e( 'Number of levels for threaded (nested) comments' ); ?></label> 118 <?php echo $thread_comments_depth; ?> 119 </li> 120 </ul> 121 </fieldset></td> 122 </tr> 123 124 <?php $comment_pagination_title = __( 'Comment Pagination' ); ?> 125 <tr> 126 <th scope="row"><?php echo $comment_pagination_title; ?></th> 127 <td><fieldset><legend class="screen-reader-text"><span><?php echo $comment_pagination_title; ?></span></legend> 128 <input name="page_comments" type="checkbox" id="page_comments" value="1" <?php checked( '1', get_option( 'page_comments' ) ); ?> /> 129 <label for="page_comments"><?php _e( 'Break comments into pages' ); ?></label> 130 <ul> 131 <li> 132 <label for="comments_per_page"><?php _e( 'Top level comments per page' ); ?></label> 133 <input name="comments_per_page" type="number" step="1" min="0" id="comments_per_page" value="<?php echo esc_attr( get_option( 'comments_per_page' ) ); ?>" class="small-text" /> 134 </li> 135 <li> 136 <label for="default_comments_page"><?php _e( 'Comments page to display by default' ); ?></label> 137 <select name="default_comments_page" id="default_comments_page"> 138 <option value="newest" <?php selected( 'newest', get_option( 'default_comments_page' ) ); ?>><?php _e( 'last page' ); ?></option> 139 <option value="oldest" <?php selected( 'oldest', get_option( 'default_comments_page' ) ); ?>><?php _e( 'first page' ); ?></option> 140 </select> 141 </li> 142 <li> 143 <label for="comment_order"><?php _e( 'Comments to display at the top of each page' ); ?></label> 144 <select name="comment_order" id="comment_order"> 145 <option value="asc" <?php selected( 'asc', get_option( 'comment_order' ) ); ?>><?php _e( 'older' ); ?></option> 146 <option value="desc" <?php selected( 'desc', get_option( 'comment_order' ) ); ?>><?php _e( 'newer' ); ?></option> 147 </select> 148 </li> 149 </ul> 150 </fieldset></td> 151 </tr> 152 <?php $email_me_whenever_title = __( 'Email me whenever' ); ?> 153 <tr> 154 <th scope="row"><?php echo $email_me_whenever_title; ?></th> 155 <td><fieldset><legend class="screen-reader-text"><span><?php echo $email_me_whenever_title; ?></span></legend> 156 <label for="comments_notify"> 157 <input name="comments_notify" type="checkbox" id="comments_notify" value="1" <?php checked( '1', get_option( 'comments_notify' ) ); ?> /> 158 <?php _e( 'Anyone posts a comment' ); ?> </label> 159 <br /> 160 <label for="moderation_notify"> 161 <input name="moderation_notify" type="checkbox" id="moderation_notify" value="1" <?php checked( '1', get_option( 'moderation_notify' ) ); ?> /> 162 <?php _e( 'A comment is held for moderation' ); ?> </label> 163 </fieldset></td> 164 </tr> 165 <?php $before_comment_appears_title = __( 'Before a comment appears' ); ?> 166 <tr> 167 <th scope="row"><?php echo $before_comment_appears_title; ?></th> 168 <td><fieldset><legend class="screen-reader-text"><span><?php echo $before_comment_appears_title; ?></span></legend> 169 <label for="comment_moderation"> 170 <input name="comment_moderation" type="checkbox" id="comment_moderation" value="1" <?php checked( '1', get_option( 'comment_moderation' ) ); ?> /> 171 <?php _e( 'Comment must be manually approved' ); ?> </label> 172 <br /> 173 <label for="comment_previously_approved"><input type="checkbox" name="comment_previously_approved" id="comment_previously_approved" value="1" <?php checked( '1', get_option( 'comment_previously_approved' ) ); ?> /> <?php _e( 'Comment author must have a previously approved comment' ); ?></label> 174 </fieldset></td> 175 </tr> 176 <?php $comment_moderation_title = __( 'Comment Moderation' ); ?> 177 <tr> 178 <th scope="row"><?php echo $comment_moderation_title; ?></th> 179 <td><fieldset><legend class="screen-reader-text"><span><?php echo $comment_moderation_title; ?></span></legend> 180 <p><label for="comment_max_links"> 181 <?php 182 printf( 183 /* translators: %s: Number of links. */ 184 __( 'Hold a comment in the queue if it contains %s or more links. (A common characteristic of comment spam is a large number of hyperlinks.)' ), 185 '<input name="comment_max_links" type="number" step="1" min="0" id="comment_max_links" value="' . esc_attr( get_option( 'comment_max_links' ) ) . '" class="small-text" />' 186 ); 187 ?> 188 </label></p> 189 190 <p><label for="moderation_keys"><?php _e( 'When a comment contains any of these words in its content, author name, URL, email, IP address, or browser’s user agent string, it will be held in the <a href="edit-comments.php?comment_status=moderated">moderation queue</a>. One word or IP address per line. It will match inside words, so “press” will match “WordPress”.' ); ?></label></p> 191 <p> 192 <textarea name="moderation_keys" rows="10" cols="50" id="moderation_keys" class="large-text code"><?php echo esc_textarea( get_option( 'moderation_keys' ) ); ?></textarea> 193 </p> 194 </fieldset></td> 195 </tr> 196 <?php $disallowed_comment_keys_title = __( 'Disallowed Comment Keys' ); ?> 197 <tr> 198 <th scope="row"><?php echo $disallowed_comment_keys_title; ?></th> 199 <td><fieldset><legend class="screen-reader-text"><span><?php echo $disallowed_comment_keys_title; ?></span></legend> 200 <p><label for="disallowed_keys"><?php _e( 'When a comment contains any of these words in its content, author name, URL, email, IP address, or browser’s user agent string, it will be put in the Trash. One word or IP address per line. It will match inside words, so “press” will match “WordPress”.' ); ?></label></p> 201 <p> 202 <textarea name="disallowed_keys" rows="10" cols="50" id="disallowed_keys" class="large-text code"><?php echo esc_textarea( get_option( 'disallowed_keys' ) ); ?></textarea> 203 </p> 204 </fieldset></td> 205 </tr> 206 <?php do_settings_fields( 'discussion', 'default' ); ?> 207 </table> 208 209 <h2 class="title"><?php _e( 'Avatars' ); ?></h2> 210 211 <p><?php _e( 'An avatar is an image that can be associated with a user across multiple websites. In this area, you can choose to display avatars of users who interact with the site.' ); ?></p> 212 213 <?php 214 // The above would be a good place to link to the documentation on the Gravatar functions, for putting it in themes. Anything like that? 215 216 $show_avatars = get_option( 'show_avatars' ); 217 $show_avatars_class = ''; 218 if ( ! $show_avatars ) { 219 $show_avatars_class = ' hide-if-js'; 220 } 221 ?> 222 223 <table class="form-table" role="presentation"> 224 <tr> 225 <th scope="row"><?php _e( 'Avatar Display' ); ?></th> 226 <td> 227 <label for="show_avatars"> 228 <input type="checkbox" id="show_avatars" name="show_avatars" value="1" <?php checked( $show_avatars, 1 ); ?> /> 229 <?php _e( 'Show Avatars' ); ?> 230 </label> 231 </td> 232 </tr> 233 <?php $maximum_rating_title = __( 'Maximum Rating' ); ?> 234 <tr class="avatar-settings<?php echo $show_avatars_class; ?>"> 235 <th scope="row"><?php echo $maximum_rating_title; ?></th> 236 <td><fieldset><legend class="screen-reader-text"><span><?php echo $maximum_rating_title; ?></span></legend> 237 238 <?php 239 $ratings = array( 240 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 241 'G' => __( 'G — Suitable for all audiences' ), 242 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 243 'PG' => __( 'PG — Possibly offensive, usually for audiences 13 and above' ), 244 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 245 'R' => __( 'R — Intended for adult audiences above 17' ), 246 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 247 'X' => __( 'X — Even more mature than above' ), 248 ); 249 foreach ( $ratings as $key => $rating ) : 250 $selected = ( get_option( 'avatar_rating' ) === $key ) ? 'checked="checked"' : ''; 251 echo "\n\t<label><input type='radio' name='avatar_rating' value='" . esc_attr( $key ) . "' $selected/> $rating</label><br />"; 252 endforeach; 253 ?> 254 255 </fieldset></td> 256 </tr> 257 <?php $default_avatar_title = __( 'Default Avatar' ); ?> 258 <tr class="avatar-settings<?php echo $show_avatars_class; ?>"> 259 <th scope="row"><?php echo $default_avatar_title; ?></th> 260 <td class="defaultavatarpicker"><fieldset><legend class="screen-reader-text"><span><?php echo $default_avatar_title; ?></span></legend> 261 262 <p> 263 <?php _e( 'For users without a custom avatar of their own, you can either display a generic logo or a generated one based on their email address.' ); ?><br /> 264 </p> 265 266 <?php 267 $avatar_defaults = array( 268 'mystery' => __( 'Mystery Person' ), 269 'blank' => __( 'Blank' ), 270 'gravatar_default' => __( 'Gravatar Logo' ), 271 'identicon' => __( 'Identicon (Generated)' ), 272 'wavatar' => __( 'Wavatar (Generated)' ), 273 'monsterid' => __( 'MonsterID (Generated)' ), 274 'retro' => __( 'Retro (Generated)' ), 275 'robohash' => __( 'RoboHash (Generated)' ), 276 'initials' => __( 'Initials (Generated)' ), 277 'color' => __( 'Color (Generated)' ), 278 ); 279 /** 280 * Filters the default avatars. 281 * 282 * Avatars are stored in key/value pairs, where the key is option value, 283 * and the name is the displayed avatar name. 284 * 285 * @since 2.6.0 286 * 287 * @param string[] $avatar_defaults Associative array of default avatars. 288 */ 289 $avatar_defaults = apply_filters( 'avatar_defaults', $avatar_defaults ); 290 $default = get_option( 'avatar_default', 'mystery' ); 291 $avatar_list = ''; 292 293 // Force avatars on to display these choices. 294 add_filter( 'pre_option_show_avatars', '__return_true', 100 ); 295 296 foreach ( $avatar_defaults as $default_key => $default_name ) { 297 $selected = ( $default === $default_key ) ? 'checked="checked" ' : ''; 298 $avatar_list .= "\n\t<label><input type='radio' name='avatar_default' id='avatar_{$default_key}' value='" . esc_attr( $default_key ) . "' {$selected}/> "; 299 $avatar_list .= get_avatar( $user_email, 32, $default_key, '', array( 'force_default' => true ) ); 300 $avatar_list .= ' ' . $default_name . '</label>'; 301 $avatar_list .= '<br />'; 302 } 303 304 remove_filter( 'pre_option_show_avatars', '__return_true', 100 ); 305 306 /** 307 * Filters the HTML output of the default avatar list. 308 * 309 * @since 2.6.0 310 * 311 * @param string $avatar_list HTML markup of the avatar list. 312 */ 313 echo apply_filters( 'default_avatar_select', $avatar_list ); 314 ?> 315 316 </fieldset></td> 317 </tr> 318 <?php do_settings_fields( 'discussion', 'avatars' ); ?> 319 </table> 320 321 <?php do_settings_sections( 'discussion' ); ?> 322 323 <?php submit_button(); ?> 324 </form> 325 </div> 326 327 <?php require_once ABSPATH . 'wp-admin/admin-footer.php'; ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated : Fri Oct 10 08:20:03 2025 | Cross-referenced by PHPXref |