| [ 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" role="presentation"> 46 <tr> 47 <th scope="row"><?php _e( 'Default post settings' ); ?></th> 48 <td><fieldset><legend class="screen-reader-text"><span> 49 <?php 50 /* translators: Hidden accessibility text. */ 51 _e( 'Default post settings' ); 52 ?> 53 </span></legend> 54 <label for="default_pingback_flag"> 55 <input name="default_pingback_flag" type="checkbox" id="default_pingback_flag" value="1" <?php checked( '1', get_option( 'default_pingback_flag' ) ); ?> /> 56 <?php _e( 'Attempt to notify any blogs linked to from the post' ); ?></label> 57 <br /> 58 <label for="default_ping_status"> 59 <input name="default_ping_status" type="checkbox" id="default_ping_status" value="open" <?php checked( 'open', get_option( 'default_ping_status' ) ); ?> /> 60 <?php _e( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new posts' ); ?></label> 61 <br /> 62 <label for="default_comment_status"> 63 <input name="default_comment_status" type="checkbox" id="default_comment_status" value="open" <?php checked( 'open', get_option( 'default_comment_status' ) ); ?> /> 64 <?php _e( 'Allow people to submit comments on new posts' ); ?></label> 65 <br /> 66 <p class="description"><?php _e( 'Individual posts may override these settings. Changes here will only be applied to new posts.' ); ?></p> 67 </fieldset></td> 68 </tr> 69 <tr> 70 <th scope="row"><?php _e( 'Other comment settings' ); ?></th> 71 <td><fieldset><legend class="screen-reader-text"><span> 72 <?php 73 /* translators: Hidden accessibility text. */ 74 _e( 'Other comment settings' ); 75 ?> 76 </span></legend> 77 <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> 78 <br /> 79 <label for="comment_registration"> 80 <input name="comment_registration" type="checkbox" id="comment_registration" value="1" <?php checked( '1', get_option( 'comment_registration' ) ); ?> /> 81 <?php _e( 'Users must be registered and logged in to comment' ); ?> 82 <?php 83 if ( ! get_option( 'users_can_register' ) && is_multisite() ) { 84 echo ' ' . __( '(Signup has been disabled. Only members of this site can comment.)' ); 85 } 86 ?> 87 </label> 88 <br /> 89 90 <label for="close_comments_for_old_posts"> 91 <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' ) ); ?> /> 92 <?php 93 printf( 94 /* translators: %s: Number of days. */ 95 __( 'Automatically close comments on posts older than %s days' ), 96 '</label> <label for="close_comments_days_old"><input name="close_comments_days_old" type="number" min="0" step="1" id="close_comments_days_old" value="' . esc_attr( get_option( 'close_comments_days_old' ) ) . '" class="small-text" />' 97 ); 98 ?> 99 </label> 100 <br /> 101 102 <label for="show_comments_cookies_opt_in"> 103 <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' ) ); ?> /> 104 <?php _e( 'Show comments cookies opt-in checkbox, allowing comment author cookies to be set' ); ?> 105 </label> 106 <br /> 107 108 <label for="thread_comments"> 109 <input name="thread_comments" type="checkbox" id="thread_comments" value="1" <?php checked( '1', get_option( 'thread_comments' ) ); ?> /> 110 <?php 111 /** 112 * Filters the maximum depth of threaded/nested comments. 113 * 114 * @since 2.7.0 115 * 116 * @param int $max_depth The maximum depth of threaded comments. Default 10. 117 */ 118 $maxdeep = (int) apply_filters( 'thread_comments_depth_max', 10 ); 119 120 $thread_comments_depth = '</label> <label for="thread_comments_depth"><select name="thread_comments_depth" id="thread_comments_depth">'; 121 for ( $i = 2; $i <= $maxdeep; $i++ ) { 122 $thread_comments_depth .= "<option value='" . esc_attr( $i ) . "'"; 123 if ( (int) get_option( 'thread_comments_depth' ) === $i ) { 124 $thread_comments_depth .= " selected='selected'"; 125 } 126 $thread_comments_depth .= ">$i</option>"; 127 } 128 $thread_comments_depth .= '</select>'; 129 130 /* translators: %s: Number of levels. */ 131 printf( __( 'Enable threaded (nested) comments %s levels deep' ), $thread_comments_depth ); 132 133 ?> 134 </label> 135 <br /> 136 <label for="page_comments"> 137 <input name="page_comments" type="checkbox" id="page_comments" value="1" <?php checked( '1', get_option( 'page_comments' ) ); ?> /> 138 <?php 139 $default_comments_page = '</label> <label for="default_comments_page"><select name="default_comments_page" id="default_comments_page"><option value="newest"'; 140 if ( 'newest' === get_option( 'default_comments_page' ) ) { 141 $default_comments_page .= ' selected="selected"'; 142 } 143 $default_comments_page .= '>' . __( 'last' ) . '</option><option value="oldest"'; 144 if ( 'oldest' === get_option( 'default_comments_page' ) ) { 145 $default_comments_page .= ' selected="selected"'; 146 } 147 $default_comments_page .= '>' . __( 'first' ) . '</option></select>'; 148 printf( 149 /* translators: 1: Form field control for number of top level comments per page, 2: Form field control for the 'first' or 'last' page. */ 150 __( 'Break comments into pages with %1$s top level comments per page and the %2$s page displayed by default' ), 151 '</label> <label for="comments_per_page"><input name="comments_per_page" type="number" step="1" min="0" id="comments_per_page" value="' . esc_attr( get_option( 'comments_per_page' ) ) . '" class="small-text" />', 152 $default_comments_page 153 ); 154 ?> 155 </label> 156 <br /> 157 <label for="comment_order"> 158 <?php 159 160 $comment_order = '<select name="comment_order" id="comment_order"><option value="asc"'; 161 if ( 'asc' === get_option( 'comment_order' ) ) { 162 $comment_order .= ' selected="selected"'; 163 } 164 $comment_order .= '>' . __( 'older' ) . '</option><option value="desc"'; 165 if ( 'desc' === get_option( 'comment_order' ) ) { 166 $comment_order .= ' selected="selected"'; 167 } 168 $comment_order .= '>' . __( 'newer' ) . '</option></select>'; 169 170 /* translators: %s: Form field control for 'older' or 'newer' comments. */ 171 printf( __( 'Comments should be displayed with the %s comments at the top of each page' ), $comment_order ); 172 173 ?> 174 </label> 175 </fieldset></td> 176 </tr> 177 <tr> 178 <th scope="row"><?php _e( 'Email me whenever' ); ?></th> 179 <td><fieldset><legend class="screen-reader-text"><span> 180 <?php 181 /* translators: Hidden accessibility text. */ 182 _e( 'Email me whenever' ); 183 ?> 184 </span></legend> 185 <label for="comments_notify"> 186 <input name="comments_notify" type="checkbox" id="comments_notify" value="1" <?php checked( '1', get_option( 'comments_notify' ) ); ?> /> 187 <?php _e( 'Anyone posts a comment' ); ?> </label> 188 <br /> 189 <label for="moderation_notify"> 190 <input name="moderation_notify" type="checkbox" id="moderation_notify" value="1" <?php checked( '1', get_option( 'moderation_notify' ) ); ?> /> 191 <?php _e( 'A comment is held for moderation' ); ?> </label> 192 </fieldset></td> 193 </tr> 194 <tr> 195 <th scope="row"><?php _e( 'Before a comment appears' ); ?></th> 196 <td><fieldset><legend class="screen-reader-text"><span> 197 <?php 198 /* translators: Hidden accessibility text. */ 199 _e( 'Before a comment appears' ); 200 ?> 201 </span></legend> 202 <label for="comment_moderation"> 203 <input name="comment_moderation" type="checkbox" id="comment_moderation" value="1" <?php checked( '1', get_option( 'comment_moderation' ) ); ?> /> 204 <?php _e( 'Comment must be manually approved' ); ?> </label> 205 <br /> 206 <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> 207 </fieldset></td> 208 </tr> 209 <tr> 210 <th scope="row"><?php _e( 'Comment Moderation' ); ?></th> 211 <td><fieldset><legend class="screen-reader-text"><span> 212 <?php 213 /* translators: Hidden accessibility text. */ 214 _e( 'Comment Moderation' ); 215 ?> 216 </span></legend> 217 <p><label for="comment_max_links"> 218 <?php 219 printf( 220 /* translators: %s: Number of links. */ 221 __( '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.)' ), 222 '<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" />' 223 ); 224 ?> 225 </label></p> 226 227 <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> 228 <p> 229 <textarea name="moderation_keys" rows="10" cols="50" id="moderation_keys" class="large-text code"><?php echo esc_textarea( get_option( 'moderation_keys' ) ); ?></textarea> 230 </p> 231 </fieldset></td> 232 </tr> 233 <tr> 234 <th scope="row"><?php _e( 'Disallowed Comment Keys' ); ?></th> 235 <td><fieldset><legend class="screen-reader-text"><span> 236 <?php 237 /* translators: Hidden accessibility text. */ 238 _e( 'Disallowed Comment Keys' ); 239 ?> 240 </span></legend> 241 <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> 242 <p> 243 <textarea name="disallowed_keys" rows="10" cols="50" id="disallowed_keys" class="large-text code"><?php echo esc_textarea( get_option( 'disallowed_keys' ) ); ?></textarea> 244 </p> 245 </fieldset></td> 246 </tr> 247 <?php do_settings_fields( 'discussion', 'default' ); ?> 248 </table> 249 250 <h2 class="title"><?php _e( 'Avatars' ); ?></h2> 251 252 <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> 253 254 <?php 255 // The above would be a good place to link to the documentation on the Gravatar functions, for putting it in themes. Anything like that? 256 257 $show_avatars = get_option( 'show_avatars' ); 258 $show_avatars_class = ''; 259 if ( ! $show_avatars ) { 260 $show_avatars_class = ' hide-if-js'; 261 } 262 ?> 263 264 <table class="form-table" role="presentation"> 265 <tr> 266 <th scope="row"><?php _e( 'Avatar Display' ); ?></th> 267 <td> 268 <label for="show_avatars"> 269 <input type="checkbox" id="show_avatars" name="show_avatars" value="1" <?php checked( $show_avatars, 1 ); ?> /> 270 <?php _e( 'Show Avatars' ); ?> 271 </label> 272 </td> 273 </tr> 274 <tr class="avatar-settings<?php echo $show_avatars_class; ?>"> 275 <th scope="row"><?php _e( 'Maximum Rating' ); ?></th> 276 <td><fieldset><legend class="screen-reader-text"><span> 277 <?php 278 /* translators: Hidden accessibility text. */ 279 _e( 'Maximum Rating' ); 280 ?> 281 </span></legend> 282 283 <?php 284 $ratings = array( 285 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 286 'G' => __( 'G — Suitable for all audiences' ), 287 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 288 'PG' => __( 'PG — Possibly offensive, usually for audiences 13 and above' ), 289 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 290 'R' => __( 'R — Intended for adult audiences above 17' ), 291 /* translators: Content suitability rating: https://en.wikipedia.org/wiki/Motion_Picture_Association_of_America_film_rating_system */ 292 'X' => __( 'X — Even more mature than above' ), 293 ); 294 foreach ( $ratings as $key => $rating ) : 295 $selected = ( get_option( 'avatar_rating' ) === $key ) ? 'checked="checked"' : ''; 296 echo "\n\t<label><input type='radio' name='avatar_rating' value='" . esc_attr( $key ) . "' $selected/> $rating</label><br />"; 297 endforeach; 298 ?> 299 300 </fieldset></td> 301 </tr> 302 <tr class="avatar-settings<?php echo $show_avatars_class; ?>"> 303 <th scope="row"><?php _e( 'Default Avatar' ); ?></th> 304 <td class="defaultavatarpicker"><fieldset><legend class="screen-reader-text"><span> 305 <?php 306 /* translators: Hidden accessibility text. */ 307 _e( 'Default Avatar' ); 308 ?> 309 </span></legend> 310 311 <p> 312 <?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 /> 313 </p> 314 315 <?php 316 $avatar_defaults = array( 317 'mystery' => __( 'Mystery Person' ), 318 'blank' => __( 'Blank' ), 319 'gravatar_default' => __( 'Gravatar Logo' ), 320 'identicon' => __( 'Identicon (Generated)' ), 321 'wavatar' => __( 'Wavatar (Generated)' ), 322 'monsterid' => __( 'MonsterID (Generated)' ), 323 'retro' => __( 'Retro (Generated)' ), 324 'robohash' => __( 'RoboHash (Generated)' ), 325 ); 326 /** 327 * Filters the default avatars. 328 * 329 * Avatars are stored in key/value pairs, where the key is option value, 330 * and the name is the displayed avatar name. 331 * 332 * @since 2.6.0 333 * 334 * @param string[] $avatar_defaults Associative array of default avatars. 335 */ 336 $avatar_defaults = apply_filters( 'avatar_defaults', $avatar_defaults ); 337 $default = get_option( 'avatar_default', 'mystery' ); 338 $avatar_list = ''; 339 340 // Force avatars on to display these choices. 341 add_filter( 'pre_option_show_avatars', '__return_true', 100 ); 342 343 foreach ( $avatar_defaults as $default_key => $default_name ) { 344 $selected = ( $default === $default_key ) ? 'checked="checked" ' : ''; 345 $avatar_list .= "\n\t<label><input type='radio' name='avatar_default' id='avatar_{$default_key}' value='" . esc_attr( $default_key ) . "' {$selected}/> "; 346 $avatar_list .= get_avatar( $user_email, 32, $default_key, '', array( 'force_default' => true ) ); 347 $avatar_list .= ' ' . $default_name . '</label>'; 348 $avatar_list .= '<br />'; 349 } 350 351 remove_filter( 'pre_option_show_avatars', '__return_true', 100 ); 352 353 /** 354 * Filters the HTML output of the default avatar list. 355 * 356 * @since 2.6.0 357 * 358 * @param string $avatar_list HTML markup of the avatar list. 359 */ 360 echo apply_filters( 'default_avatar_select', $avatar_list ); 361 ?> 362 363 </fieldset></td> 364 </tr> 365 <?php do_settings_fields( 'discussion', 'avatars' ); ?> 366 </table> 367 368 <?php do_settings_sections( 'discussion' ); ?> 369 370 <?php submit_button(); ?> 371 </form> 372 </div> 373 374 <?php require_once ABSPATH . 'wp-admin/admin-footer.php'; ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated : Thu Apr 25 08:20:02 2024 | Cross-referenced by PHPXref |