[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-admin/ -> options-general.php (source)

   1  <?php
   2  /**
   3   * General settings administration panel.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  
   9  /** WordPress Administration Bootstrap */
  10  require_once  __DIR__ . '/admin.php';
  11  
  12  /** WordPress Translation Installation API */
  13  require_once  ABSPATH . 'wp-admin/includes/translation-install.php';
  14  
  15  if ( ! current_user_can( 'manage_options' ) ) {
  16      wp_die( __( 'Sorry, you are not allowed to manage options for this site.' ) );
  17  }
  18  
  19  // Used in the HTML title tag.
  20  $title       = __( 'General Settings' );
  21  $parent_file = 'options-general.php';
  22  /* translators: Date and time format for exact current time, mainly about timezones, see https://www.php.net/manual/datetime.format.php */
  23  $timezone_format = _x( 'Y-m-d H:i:s', 'timezone date format' );
  24  
  25  add_action( 'admin_head', 'options_general_add_js' );
  26  
  27  $options_help = '<p>' . __( 'The fields on this screen determine some of the basics of your site setup.' ) . '</p>' .
  28      '<p>' . __( 'Most themes show the site title at the top of every page, in the title bar of the browser, and as the identifying name for syndicated feeds. Many themes also show the tagline.' ) . '</p>';
  29  
  30  if ( ! is_multisite() ) {
  31      $options_help .= '<p>' . __( 'Two terms you will want to know are the WordPress URL and the site URL. The WordPress URL is where the core WordPress installation files are, and the site URL is the address a visitor uses in the browser to go to your site.' ) . '</p>' .
  32          '<p>' . sprintf(
  33              /* translators: %s: Documentation URL. */
  34              __( 'Though the terms refer to two different concepts, in practice, they can be the same address or different. For example, you can have the core WordPress installation files in the root directory (<code>https://example.com</code>), in which case the two URLs would be the same. Or the <a href="%s">WordPress files can be in a subdirectory</a> (<code>https://example.com/wordpress</code>). In that case, the WordPress URL and the site URL would be different.' ),
  35              __( 'https://developer.wordpress.org/advanced-administration/server/wordpress-in-directory/' )
  36          ) . '</p>' .
  37          '<p>' . sprintf(
  38              /* translators: 1: http://, 2: https:// */
  39              __( 'Both WordPress URL and site URL can start with either %1$s or %2$s. A URL starting with %2$s requires an SSL certificate, so be sure that you have one before changing to %2$s. With %2$s, a padlock will appear next to the address in the browser address bar. Both %2$s and the padlock signal that your site meets some basic security requirements, which can build trust with your visitors and with search engines.' ),
  40              '<code>http://</code>',
  41              '<code>https://</code>'
  42          ) . '</p>' .
  43          '<p>' . __( 'If you want site visitors to be able to register themselves, check the membership box. If you want the site administrator to register every new user, leave the box unchecked. In either case, you can set a default user role for all new users.' ) . '</p>';
  44  }
  45  
  46  $options_help .= '<p>' . __( 'You can set the language, and WordPress will automatically download and install the translation files (available if your filesystem is writable).' ) . '</p>' .
  47      '<p>' . __( 'UTC means Coordinated Universal Time.' ) . '</p>' .
  48      '<p>' . __( 'You must click the Save Changes button at the bottom of the screen for new settings to take effect.' ) . '</p>';
  49  
  50  get_current_screen()->add_help_tab(
  51      array(
  52          'id'      => 'overview',
  53          'title'   => __( 'Overview' ),
  54          'content' => $options_help,
  55      )
  56  );
  57  
  58  get_current_screen()->set_help_sidebar(
  59      '<p><strong>' . __( 'For more information:' ) . '</strong></p>' .
  60      '<p>' . __( '<a href="https://wordpress.org/documentation/article/settings-general-screen/">Documentation on General Settings</a>' ) . '</p>' .
  61      '<p>' . __( '<a href="https://wordpress.org/support/forums/">Support forums</a>' ) . '</p>'
  62  );
  63  
  64  require_once  ABSPATH . 'wp-admin/admin-header.php';
  65  ?>
  66  
  67  <div class="wrap">
  68  <h1><?php echo esc_html( $title ); ?></h1>
  69  
  70  <form method="post" action="options.php" novalidate="novalidate">
  71  <?php settings_fields( 'general' ); ?>
  72  
  73  <table class="form-table" role="presentation">
  74  
  75  <tr>
  76  <th scope="row"><label for="blogname"><?php _e( 'Site Title' ); ?></label></th>
  77  <td><input name="blogname" type="text" id="blogname" value="<?php form_option( 'blogname' ); ?>" class="regular-text" /></td>
  78  </tr>
  79  
  80  <?php
  81  if ( ! is_multisite() ) {
  82      /* translators: Site tagline. */
  83      $sample_tagline = __( 'Just another WordPress site' );
  84  } else {
  85      /* translators: %s: Network title. */
  86      $sample_tagline = sprintf( __( 'Just another %s site' ), get_network()->site_name );
  87  }
  88  $tagline_description = sprintf(
  89      /* translators: %s: Site tagline example. */
  90      __( 'In a few words, explain what this site is about. Example: &#8220;%s.&#8221;' ),
  91      $sample_tagline
  92  );
  93  ?>
  94  <tr>
  95  <th scope="row"><label for="blogdescription"><?php _e( 'Tagline' ); ?></label></th>
  96  <td><input name="blogdescription" type="text" id="blogdescription" aria-describedby="tagline-description" value="<?php form_option( 'blogdescription' ); ?>" class="regular-text" />
  97  <p class="description" id="tagline-description"><?php echo $tagline_description; ?></p></td>
  98  </tr>
  99  
 100  <?php if ( current_user_can( 'upload_files' ) ) : ?>
 101  <tr class="hide-if-no-js site-icon-section">
 102  <th scope="row"><?php _e( 'Site Icon' ); ?></th>
 103  <td>
 104      <?php
 105      wp_enqueue_media();
 106      wp_enqueue_script( 'site-icon' );
 107  
 108      $classes_for_upload_button = 'upload-button button-add-media button-add-site-icon';
 109      $classes_for_update_button = 'button';
 110      $classes_for_wrapper       = '';
 111  
 112      if ( has_site_icon() ) {
 113          $classes_for_wrapper         .= ' has-site-icon';
 114          $classes_for_button           = $classes_for_update_button;
 115          $classes_for_button_on_change = $classes_for_upload_button;
 116      } else {
 117          $classes_for_wrapper         .= ' hidden';
 118          $classes_for_button           = $classes_for_upload_button;
 119          $classes_for_button_on_change = $classes_for_update_button;
 120      }
 121  
 122      // Handle alt text for site icon on page load.
 123      $site_icon_id           = (int) get_option( 'site_icon' );
 124      $app_icon_alt_value     = '';
 125      $browser_icon_alt_value = '';
 126  
 127      $site_icon_url = get_site_icon_url();
 128  
 129      if ( $site_icon_id ) {
 130          $img_alt            = get_post_meta( $site_icon_id, '_wp_attachment_image_alt', true );
 131          $filename           = wp_basename( $site_icon_url );
 132          $app_icon_alt_value = sprintf(
 133              /* translators: %s: The selected image filename. */
 134              __( 'App icon preview: The current image has no alternative text. The file name is: %s' ),
 135              $filename
 136          );
 137  
 138          $browser_icon_alt_value = sprintf(
 139              /* translators: %s: The selected image filename. */
 140              __( 'Browser icon preview: The current image has no alternative text. The file name is: %s' ),
 141              $filename
 142          );
 143  
 144          if ( $img_alt ) {
 145              $app_icon_alt_value = sprintf(
 146                  /* translators: %s: The selected image alt text. */
 147                  __( 'App icon preview: Current image: %s' ),
 148                  $img_alt
 149              );
 150  
 151              $browser_icon_alt_value = sprintf(
 152                  /* translators: %s: The selected image alt text. */
 153                  __( 'Browser icon preview: Current image: %s' ),
 154                  $img_alt
 155              );
 156          }
 157      }
 158      ?>
 159  
 160      <style>
 161      :root {
 162          --site-icon-url: url( '<?php echo esc_url( $site_icon_url ); ?>' );
 163      }
 164      </style>
 165  
 166      <div id="site-icon-preview" class="site-icon-preview settings <?php echo esc_attr( $classes_for_wrapper ); ?>">
 167          <div class="direction-wrap">
 168              <img id="app-icon-preview" src="<?php echo esc_url( $site_icon_url ); ?>" class="app-icon-preview" alt="<?php echo esc_attr( $app_icon_alt_value ); ?>" />
 169              <div class="site-icon-preview-browser">
 170                  <svg role="img" aria-hidden="true" fill="none" xmlns="http://www.w3.org/2000/svg" class="browser-buttons"><path fill-rule="evenodd" clip-rule="evenodd" d="M0 20a6 6 0 1 1 12 0 6 6 0 0 1-12 0Zm18 0a6 6 0 1 1 12 0 6 6 0 0 1-12 0Zm24-6a6 6 0 1 0 0 12 6 6 0 0 0 0-12Z" /></svg>
 171                  <div class="site-icon-preview-tab">
 172                      <img id="browser-icon-preview" src="<?php echo esc_url( $site_icon_url ); ?>" class="browser-icon-preview" alt="<?php echo esc_attr( $browser_icon_alt_value ); ?>" />
 173                      <div class="site-icon-preview-site-title" id="site-icon-preview-site-title" aria-hidden="true"><?php bloginfo( 'name' ); ?></div>
 174                          <svg role="img" aria-hidden="true" fill="none" xmlns="http://www.w3.org/2000/svg" class="close-button">
 175                              <path d="M12 13.0607L15.7123 16.773L16.773 15.7123L13.0607 12L16.773 8.28772L15.7123 7.22706L12 10.9394L8.28771 7.22705L7.22705 8.28771L10.9394 12L7.22706 15.7123L8.28772 16.773L12 13.0607Z" />
 176                          </svg>
 177                      </div>
 178                  </div>
 179              </div>
 180          </div>
 181      </div>
 182  
 183      <input type="hidden" name="site_icon" id="site_icon_hidden_field" value="<?php form_option( 'site_icon' ); ?>" />
 184      <div class="site-icon-action-buttons">
 185          <button type="button"
 186              id="choose-from-library-button"
 187              type="button"
 188              class="<?php echo esc_attr( $classes_for_button ); ?>"
 189              data-alt-classes="<?php echo esc_attr( $classes_for_button_on_change ); ?>"
 190              data-size="512"
 191              data-choose-text="<?php esc_attr_e( 'Choose a Site Icon' ); ?>"
 192              data-update-text="<?php esc_attr_e( 'Change Site Icon' ); ?>"
 193              data-update="<?php esc_attr_e( 'Set as Site Icon' ); ?>"
 194              data-state="<?php echo esc_attr( has_site_icon() ); ?>"
 195  
 196          >
 197              <?php if ( has_site_icon() ) : ?>
 198                  <?php _e( 'Change Site Icon' ); ?>
 199              <?php else : ?>
 200                  <?php _e( 'Choose a Site Icon' ); ?>
 201              <?php endif; ?>
 202          </button>
 203          <button
 204              id="js-remove-site-icon"
 205              type="button"
 206              <?php echo has_site_icon() ? 'class="button button-secondary reset remove-site-icon"' : 'class="button button-secondary reset hidden"'; ?>
 207          >
 208              <?php _e( 'Remove Site Icon' ); ?>
 209          </button>
 210      </div>
 211  
 212      <p class="description">
 213          <?php
 214              printf(
 215                  /* translators: 1: pixel value for icon size. 2: pixel value for icon size. */
 216                  __( 'The Site Icon is what you see in browser tabs, bookmark bars, and within the WordPress mobile apps. It should be square and at least <code>%1$s by %2$s</code> pixels.' ),
 217                  512,
 218                  512
 219              );
 220          ?>
 221      </p>
 222  
 223  </td>
 224  </tr>
 225  
 226      <?php
 227  endif;
 228      /* End Site Icon */
 229  
 230  if ( ! is_multisite() ) {
 231      $wp_site_url_class = '';
 232      $wp_home_class     = '';
 233      if ( defined( 'WP_SITEURL' ) ) {
 234          $wp_site_url_class = ' disabled';
 235      }
 236      if ( defined( 'WP_HOME' ) ) {
 237          $wp_home_class = ' disabled';
 238      }
 239      ?>
 240  
 241  <tr>
 242  <th scope="row"><label for="siteurl"><?php _e( 'WordPress Address (URL)' ); ?></label></th>
 243  <td><input name="siteurl" type="url" id="siteurl" value="<?php form_option( 'siteurl' ); ?>"<?php disabled( defined( 'WP_SITEURL' ) ); ?> class="regular-text code<?php echo $wp_site_url_class; ?>" /></td>
 244  </tr>
 245  
 246  <tr>
 247  <th scope="row"><label for="home"><?php _e( 'Site Address (URL)' ); ?></label></th>
 248  <td><input name="home" type="url" id="home" aria-describedby="home-description" value="<?php form_option( 'home' ); ?>"<?php disabled( defined( 'WP_HOME' ) ); ?> class="regular-text code<?php echo $wp_home_class; ?>" />
 249      <?php if ( ! defined( 'WP_HOME' ) ) : ?>
 250  <p class="description" id="home-description">
 251          <?php
 252          printf(
 253              /* translators: %s: Documentation URL. */
 254              __( 'Enter the same address here unless you <a href="%s">want your site home page to be different from your WordPress installation directory</a>.' ),
 255              __( 'https://developer.wordpress.org/advanced-administration/server/wordpress-in-directory/' )
 256          );
 257          ?>
 258  </p>
 259  <?php endif; ?>
 260  </td>
 261  </tr>
 262  
 263  <?php } ?>
 264  
 265  <tr>
 266  <th scope="row"><label for="new_admin_email"><?php _e( 'Administration Email Address' ); ?></label></th>
 267  <td><input name="new_admin_email" type="email" id="new_admin_email" aria-describedby="new-admin-email-description" value="<?php form_option( 'admin_email' ); ?>" class="regular-text ltr" />
 268  <p class="description" id="new-admin-email-description"><?php _e( 'This address is used for admin purposes. If you change this, an email will be sent to your new address to confirm it. <strong>The new address will not become active until confirmed.</strong>' ); ?></p>
 269  <?php
 270  $new_admin_email = get_option( 'new_admin_email' );
 271  if ( $new_admin_email && get_option( 'admin_email' ) !== $new_admin_email ) {
 272      $pending_admin_email_message = sprintf(
 273          /* translators: %s: New admin email. */
 274          __( 'There is a pending change of the admin email to %s.' ),
 275          '<code>' . esc_html( $new_admin_email ) . '</code>'
 276      );
 277      $pending_admin_email_message .= sprintf(
 278          ' <a href="%1$s">%2$s</a>',
 279          esc_url( wp_nonce_url( admin_url( 'options.php?dismiss=new_admin_email' ), 'dismiss-' . get_current_blog_id() . '-new_admin_email' ) ),
 280          __( 'Cancel' )
 281      );
 282      wp_admin_notice(
 283          $pending_admin_email_message,
 284          array(
 285              'additional_classes' => array( 'updated', 'inline' ),
 286          )
 287      );
 288  }
 289  ?>
 290  </td>
 291  </tr>
 292  
 293  <?php if ( ! is_multisite() ) { ?>
 294  
 295  <tr>
 296  <th scope="row"><?php _e( 'Membership' ); ?></th>
 297  <td> <fieldset><legend class="screen-reader-text"><span>
 298      <?php
 299      /* translators: Hidden accessibility text. */
 300      _e( 'Membership' );
 301      ?>
 302  </span></legend><label for="users_can_register">
 303  <input name="users_can_register" type="checkbox" id="users_can_register" value="1" <?php checked( '1', get_option( 'users_can_register' ) ); ?> />
 304      <?php _e( 'Anyone can register' ); ?></label>
 305  </fieldset></td>
 306  </tr>
 307  
 308  <tr>
 309  <th scope="row"><label for="default_role"><?php _e( 'New User Default Role' ); ?></label></th>
 310  <td>
 311  <select name="default_role" id="default_role"><?php wp_dropdown_roles( get_option( 'default_role' ) ); ?></select>
 312  </td>
 313  </tr>
 314  
 315      <?php
 316  }
 317  
 318  $languages    = get_available_languages();
 319  $translations = wp_get_available_translations();
 320  if ( ! is_multisite() && defined( 'WPLANG' ) && '' !== WPLANG && 'en_US' !== WPLANG && ! in_array( WPLANG, $languages, true ) ) {
 321      $languages[] = WPLANG;
 322  }
 323  if ( ! empty( $languages ) || ! empty( $translations ) ) {
 324      ?>
 325      <tr>
 326          <th scope="row"><label for="WPLANG"><?php _e( 'Site Language' ); ?><span class="dashicons dashicons-translation" aria-hidden="true"></span></label></th>
 327          <td>
 328              <?php
 329              $locale = get_locale();
 330              if ( ! in_array( $locale, $languages, true ) ) {
 331                  $locale = '';
 332              }
 333  
 334              wp_dropdown_languages(
 335                  array(
 336                      'name'                        => 'WPLANG',
 337                      'id'                          => 'WPLANG',
 338                      'selected'                    => $locale,
 339                      'languages'                   => $languages,
 340                      'translations'                => $translations,
 341                      'show_available_translations' => current_user_can( 'install_languages' ) && wp_can_install_language_pack(),
 342                  )
 343              );
 344  
 345              // Add note about deprecated WPLANG constant.
 346              if ( defined( 'WPLANG' ) && ( '' !== WPLANG ) && WPLANG !== $locale ) {
 347                  _deprecated_argument(
 348                      'define()',
 349                      '4.0.0',
 350                      /* translators: 1: WPLANG, 2: wp-config.php */
 351                      sprintf( __( 'The %1$s constant in your %2$s file is no longer needed.' ), 'WPLANG', 'wp-config.php' )
 352                  );
 353              }
 354              ?>
 355          </td>
 356      </tr>
 357      <?php
 358  }
 359  ?>
 360  <tr>
 361  <?php
 362  $current_offset = get_option( 'gmt_offset' );
 363  $tzstring       = get_option( 'timezone_string' );
 364  
 365  $check_zone_info = true;
 366  
 367  // Remove old Etc mappings. Fallback to gmt_offset.
 368  if ( str_contains( $tzstring, 'Etc/GMT' ) ) {
 369      $tzstring = '';
 370  }
 371  
 372  if ( empty( $tzstring ) ) { // Create a UTC+- zone if no timezone string exists.
 373      $check_zone_info = false;
 374      if ( 0 === (int) $current_offset ) {
 375          $tzstring = 'UTC+0';
 376      } elseif ( $current_offset < 0 ) {
 377          $tzstring = 'UTC' . $current_offset;
 378      } else {
 379          $tzstring = 'UTC+' . $current_offset;
 380      }
 381  }
 382  
 383  ?>
 384  <th scope="row"><label for="timezone_string"><?php _e( 'Timezone' ); ?></label></th>
 385  <td>
 386  
 387  <select id="timezone_string" name="timezone_string" aria-describedby="timezone-description">
 388      <?php echo wp_timezone_choice( $tzstring, get_user_locale() ); ?>
 389  </select>
 390  
 391  <p class="description" id="timezone-description">
 392  <?php
 393      printf(
 394          /* translators: %s: UTC abbreviation */
 395          __( 'Choose either a city in the same timezone as you or a %s (Coordinated Universal Time) time offset.' ),
 396          '<abbr>UTC</abbr>'
 397      );
 398      ?>
 399  </p>
 400  
 401  <p class="timezone-info">
 402      <span id="utc-time">
 403      <?php
 404          printf(
 405              /* translators: %s: UTC time. */
 406              __( 'Universal time is %s.' ),
 407              '<code>' . date_i18n( $timezone_format, false, true ) . '</code>'
 408          );
 409          ?>
 410      </span>
 411  <?php if ( get_option( 'timezone_string' ) || ! empty( $current_offset ) ) : ?>
 412      <span id="local-time">
 413      <?php
 414          printf(
 415              /* translators: %s: Local time. */
 416              __( 'Local time is %s.' ),
 417              '<code>' . date_i18n( $timezone_format ) . '</code>'
 418          );
 419      ?>
 420      </span>
 421  <?php endif; ?>
 422  </p>
 423  
 424  <?php if ( $check_zone_info && $tzstring ) : ?>
 425  <p class="timezone-info">
 426  <span>
 427      <?php
 428      $now = new DateTime( 'now', new DateTimeZone( $tzstring ) );
 429      $dst = (bool) $now->format( 'I' );
 430  
 431      if ( $dst ) {
 432          _e( 'This timezone is currently in daylight saving time.' );
 433      } else {
 434          _e( 'This timezone is currently in standard time.' );
 435      }
 436      ?>
 437      <br />
 438      <?php
 439      if ( in_array( $tzstring, timezone_identifiers_list( DateTimeZone::ALL_WITH_BC ), true ) ) {
 440          $transitions = timezone_transitions_get( timezone_open( $tzstring ), time() );
 441  
 442          // 0 index is the state at current time, 1 index is the next transition, if any.
 443          if ( ! empty( $transitions[1] ) ) {
 444              echo ' ';
 445              $message = $transitions[1]['isdst'] ?
 446                  /* translators: %s: Date and time. */
 447                  __( 'Daylight saving time begins on: %s.' ) :
 448                  /* translators: %s: Date and time. */
 449                  __( 'Standard time begins on: %s.' );
 450              printf(
 451                  $message,
 452                  '<code>' . wp_date( __( 'F j, Y' ) . ' ' . __( 'g:i a' ), $transitions[1]['ts'] ) . '</code>'
 453              );
 454          } else {
 455              _e( 'This timezone does not observe daylight saving time.' );
 456          }
 457      }
 458      ?>
 459      </span>
 460  </p>
 461  <?php endif; ?>
 462  </td>
 463  
 464  </tr>
 465  <tr>
 466  <th scope="row"><?php _e( 'Date Format' ); ?></th>
 467  <td>
 468      <fieldset><legend class="screen-reader-text"><span>
 469          <?php
 470          /* translators: Hidden accessibility text. */
 471          _e( 'Date Format' );
 472          ?>
 473      </span></legend>
 474  <?php
 475      /**
 476       * Filters the default date formats.
 477       *
 478       * @since 2.7.0
 479       * @since 4.0.0 Added ISO date standard YYYY-MM-DD format.
 480       *
 481       * @param string[] $default_date_formats Array of default date formats.
 482       */
 483      $date_formats = array_unique( apply_filters( 'date_formats', array( __( 'F j, Y' ), 'Y-m-d', 'm/d/Y', 'd/m/Y' ) ) );
 484  
 485      $custom = true;
 486  
 487  foreach ( $date_formats as $format ) {
 488      echo "\t<label><input type='radio' name='date_format' value='" . esc_attr( $format ) . "'";
 489      if ( get_option( 'date_format' ) === $format ) { // checked() uses "==" rather than "===".
 490          echo " checked='checked'";
 491          $custom = false;
 492      }
 493      echo ' /> <span class="date-time-text format-i18n">' . date_i18n( $format ) . '</span><code>' . esc_html( $format ) . "</code></label><br />\n";
 494  }
 495  
 496      echo '<label><input type="radio" name="date_format" id="date_format_custom_radio" value="\c\u\s\t\o\m"';
 497      checked( $custom );
 498      echo '/> <span class="date-time-text date-time-custom-text">' . __( 'Custom:' ) . '<span class="screen-reader-text"> ' .
 499              /* translators: Hidden accessibility text. */
 500              __( 'enter a custom date format in the following field' ) .
 501          '</span></span></label>' .
 502          '<label for="date_format_custom" class="screen-reader-text">' .
 503              /* translators: Hidden accessibility text. */
 504              __( 'Custom date format:' ) .
 505          '</label>' .
 506          '<input type="text" name="date_format_custom" id="date_format_custom" value="' . esc_attr( get_option( 'date_format' ) ) . '" class="small-text" />' .
 507          '<br />' .
 508          '<p><strong>' . __( 'Preview:' ) . '</strong> <span class="example">' . date_i18n( get_option( 'date_format' ) ) . '</span>' .
 509          "<span class='spinner'></span>\n" . '</p>';
 510  ?>
 511      </fieldset>
 512  </td>
 513  </tr>
 514  <tr>
 515  <th scope="row"><?php _e( 'Time Format' ); ?></th>
 516  <td>
 517      <fieldset><legend class="screen-reader-text"><span>
 518          <?php
 519          /* translators: Hidden accessibility text. */
 520          _e( 'Time Format' );
 521          ?>
 522      </span></legend>
 523  <?php
 524      /**
 525       * Filters the default time formats.
 526       *
 527       * @since 2.7.0
 528       *
 529       * @param string[] $default_time_formats Array of default time formats.
 530       */
 531      $time_formats = array_unique( apply_filters( 'time_formats', array( __( 'g:i a' ), 'g:i A', 'H:i' ) ) );
 532  
 533      $custom = true;
 534  
 535  foreach ( $time_formats as $format ) {
 536      echo "\t<label><input type='radio' name='time_format' value='" . esc_attr( $format ) . "'";
 537      if ( get_option( 'time_format' ) === $format ) { // checked() uses "==" rather than "===".
 538          echo " checked='checked'";
 539          $custom = false;
 540      }
 541      echo ' /> <span class="date-time-text format-i18n">' . date_i18n( $format ) . '</span><code>' . esc_html( $format ) . "</code></label><br />\n";
 542  }
 543  
 544      echo '<label><input type="radio" name="time_format" id="time_format_custom_radio" value="\c\u\s\t\o\m"';
 545      checked( $custom );
 546      echo '/> <span class="date-time-text date-time-custom-text">' . __( 'Custom:' ) . '<span class="screen-reader-text"> ' .
 547              /* translators: Hidden accessibility text. */
 548              __( 'enter a custom time format in the following field' ) .
 549          '</span></span></label>' .
 550          '<label for="time_format_custom" class="screen-reader-text">' .
 551              /* translators: Hidden accessibility text. */
 552              __( 'Custom time format:' ) .
 553          '</label>' .
 554          '<input type="text" name="time_format_custom" id="time_format_custom" value="' . esc_attr( get_option( 'time_format' ) ) . '" class="small-text" />' .
 555          '<br />' .
 556          '<p><strong>' . __( 'Preview:' ) . '</strong> <span class="example">' . date_i18n( get_option( 'time_format' ) ) . '</span>' .
 557          "<span class='spinner'></span>\n" . '</p>';
 558  
 559      echo "\t<p class='date-time-doc'>" . __( '<a href="https://wordpress.org/documentation/article/customize-date-and-time-format/">Documentation on date and time formatting</a>.' ) . "</p>\n";
 560  ?>
 561      </fieldset>
 562  </td>
 563  </tr>
 564  <tr>
 565  <th scope="row"><label for="start_of_week"><?php _e( 'Week Starts On' ); ?></label></th>
 566  <td><select name="start_of_week" id="start_of_week">
 567  <?php
 568  /**
 569   * @global WP_Locale $wp_locale WordPress date and time locale object.
 570   */
 571  global $wp_locale;
 572  
 573  for ( $day_index = 0; $day_index <= 6; $day_index++ ) :
 574      $selected = ( (int) get_option( 'start_of_week' ) === $day_index ) ? 'selected="selected"' : '';
 575      echo "\n\t<option value='" . esc_attr( $day_index ) . "' $selected>" . $wp_locale->get_weekday( $day_index ) . '</option>';
 576  endfor;
 577  ?>
 578  </select></td>
 579  </tr>
 580  <?php do_settings_fields( 'general', 'default' ); ?>
 581  </table>
 582  
 583  <?php do_settings_sections( 'general' ); ?>
 584  
 585  <?php submit_button(); ?>
 586  </form>
 587  
 588  </div>
 589  
 590  <?php require_once  ABSPATH . 'wp-admin/admin-footer.php'; ?>


Generated : Thu Nov 21 08:20:01 2024 Cross-referenced by PHPXref