3 * General settings administration panel.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
12 /** WordPress Translation Install API */
13 require_once( ABSPATH . 'wp-admin/includes/translation-install.php' );
15 if ( ! current_user_can( 'manage_options' ) )
16 wp_die( __( 'You do not have sufficient permissions to manage options for this site.' ) );
18 $title = __('General Settings');
19 $parent_file = 'options-general.php';
20 /* translators: date and time format for exact current time, mainly about timezones, see http://php.net/date */
21 $timezone_format = _x('Y-m-d H:i:s', 'timezone date format');
24 * Display JavaScript on the page.
28 function options_general_add_js() {
30 <script type="text/javascript">
31 jQuery(document).ready(function($){
32 var $siteName = $( '#wp-admin-bar-site-name' ).children( 'a' ).first(),
33 homeURL = ( <?php echo wp_json_encode( get_home_url() ); ?> || '' ).replace( /^(https?:\/\/)?(www\.)?/, '' );
35 $( '#blogname' ).on( 'input', function() {
36 var title = $.trim( $( this ).val() ) || homeURL;
38 // Truncate to 40 characters.
39 if ( 40 < title.length ) {
40 title = title.substring( 0, 40 ) + '\u2026';
43 $siteName.text( title );
46 $("input[name='date_format']").click(function(){
47 if ( "date_format_custom_radio" != $(this).attr("id") )
48 $( "input[name='date_format_custom']" ).val( $( this ).val() ).siblings( '.example' ).text( $( this ).parent( 'label' ).text() );
50 $("input[name='date_format_custom']").focus(function(){
51 $( '#date_format_custom_radio' ).prop( 'checked', true );
54 $("input[name='time_format']").click(function(){
55 if ( "time_format_custom_radio" != $(this).attr("id") )
56 $( "input[name='time_format_custom']" ).val( $( this ).val() ).siblings( '.example' ).text( $( this ).parent( 'label' ).text() );
58 $("input[name='time_format_custom']").focus(function(){
59 $( '#time_format_custom_radio' ).prop( 'checked', true );
61 $("input[name='date_format_custom'], input[name='time_format_custom']").change( function() {
63 format.siblings( '.spinner' ).addClass( 'is-active' );
65 action: 'date_format_custom' == format.attr('name') ? 'date_format' : 'time_format',
67 }, function(d) { format.siblings( '.spinner' ).removeClass( 'is-active' ); format.siblings('.example').text(d); } );
70 var languageSelect = $( '#WPLANG' );
71 $( 'form' ).submit( function() {
72 // Don't show a spinner for English and installed languages,
73 // as there is nothing to download.
74 if ( ! languageSelect.find( 'option:selected' ).data( 'installed' ) ) {
75 $( '#submit', this ).after( '<span class="spinner language-install-spinner" />' );
82 add_action('admin_head', 'options_general_add_js');
84 $options_help = '<p>' . __('The fields on this screen determine some of the basics of your site setup.') . '</p>' .
85 '<p>' . __('Most themes display the site title at the top of every page, in the title bar of the browser, and as the identifying name for syndicated feeds. The tagline is also displayed by many themes.') . '</p>';
87 if ( ! is_multisite() ) {
88 $options_help .= '<p>' . __('The WordPress URL and the Site URL can be the same (example.com) or different; for example, having the WordPress core files (example.com/wordpress) in a subdirectory instead of the root directory.') . '</p>' .
89 '<p>' . __('If you want site visitors to be able to register themselves, as opposed to by the site administrator, check the membership box. A default user role can be set for all new users, whether self-registered or registered by the site admin.') . '</p>';
92 $options_help .= '<p>' . __( 'You can set the language, and the translation files will be automatically downloaded and installed (available if your filesystem is writable).' ) . '</p>' .
93 '<p>' . __( 'UTC means Coordinated Universal Time.' ) . '</p>' .
94 '<p>' . __( 'You must click the Save Changes button at the bottom of the screen for new settings to take effect.' ) . '</p>';
96 get_current_screen()->add_help_tab( array(
98 'title' => __('Overview'),
99 'content' => $options_help,
102 get_current_screen()->set_help_sidebar(
103 '<p><strong>' . __('For more information:') . '</strong></p>' .
104 '<p>' . __('<a href="https://codex.wordpress.org/Settings_General_Screen" target="_blank">Documentation on General Settings</a>') . '</p>' .
105 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
108 include( ABSPATH . 'wp-admin/admin-header.php' );
112 <h2><?php echo esc_html( $title ); ?></h2>
114 <form method="post" action="options.php" novalidate="novalidate">
115 <?php settings_fields('general'); ?>
117 <table class="form-table">
119 <th scope="row"><label for="blogname"><?php _e('Site Title') ?></label></th>
120 <td><input name="blogname" type="text" id="blogname" value="<?php form_option('blogname'); ?>" class="regular-text" /></td>
123 <th scope="row"><label for="blogdescription"><?php _e('Tagline') ?></label></th>
124 <td><input name="blogdescription" type="text" id="blogdescription" aria-describedby="tagline-description" value="<?php form_option('blogdescription'); ?>" class="regular-text" />
125 <p class="description" id="tagline-description"><?php _e( 'In a few words, explain what this site is about.' ) ?></p></td>
127 <?php if ( !is_multisite() ) { ?>
129 <th scope="row"><label for="siteurl"><?php _e('WordPress Address (URL)') ?></label></th>
130 <td><input name="siteurl" type="url" id="siteurl" value="<?php form_option( 'siteurl' ); ?>"<?php disabled( defined( 'WP_SITEURL' ) ); ?> class="regular-text code<?php if ( defined( 'WP_SITEURL' ) ) echo ' disabled' ?>" /></td>
133 <th scope="row"><label for="home"><?php _e('Site Address (URL)') ?></label></th>
134 <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 if ( defined( 'WP_HOME' ) ) echo ' disabled' ?>" />
135 <p class="description" id="home-description"><?php _e( 'Enter the address here if you <a href="https://codex.wordpress.org/Giving_WordPress_Its_Own_Directory">want your site home page to be different from your WordPress installation directory.</a>' ); ?></p></td>
138 <th scope="row"><label for="admin_email"><?php _e('E-mail Address') ?> </label></th>
139 <td><input name="admin_email" type="email" id="admin_email" aria-describedby="admin-email-description" value="<?php form_option( 'admin_email' ); ?>" class="regular-text ltr" />
140 <p class="description" id="admin-email-description"><?php _e( 'This address is used for admin purposes, like new user notification.' ) ?></p></td>
143 <th scope="row"><?php _e('Membership') ?></th>
144 <td> <fieldset><legend class="screen-reader-text"><span><?php _e('Membership') ?></span></legend><label for="users_can_register">
145 <input name="users_can_register" type="checkbox" id="users_can_register" value="1" <?php checked('1', get_option('users_can_register')); ?> />
146 <?php _e('Anyone can register') ?></label>
150 <th scope="row"><label for="default_role"><?php _e('New User Default Role') ?></label></th>
152 <select name="default_role" id="default_role"><?php wp_dropdown_roles( get_option('default_role') ); ?></select>
157 <th scope="row"><label for="new_admin_email"><?php _e('E-mail Address') ?> </label></th>
158 <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" />
159 <p class="description" id="new-admin-email-description"><?php _e( 'This address is used for admin purposes. If you change this we will send you an e-mail at your new address to confirm it. <strong>The new address will not become active until confirmed.</strong>' ) ?></p>
161 $new_admin_email = get_option( 'new_admin_email' );
162 if ( $new_admin_email && $new_admin_email != get_option('admin_email') ) : ?>
163 <div class="updated inline">
164 <p><?php printf( __('There is a pending change of the admin e-mail to <code>%1$s</code>. <a href="%2$s">Cancel</a>'), esc_html( $new_admin_email ), esc_url( admin_url( 'options.php?dismiss=new_admin_email' ) ) ); ?></p>
172 $current_offset = get_option('gmt_offset');
173 $tzstring = get_option('timezone_string');
175 $check_zone_info = true;
177 // Remove old Etc mappings. Fallback to gmt_offset.
178 if ( false !== strpos($tzstring,'Etc/GMT') )
181 if ( empty($tzstring) ) { // Create a UTC+- zone if no timezone string exists
182 $check_zone_info = false;
183 if ( 0 == $current_offset )
185 elseif ($current_offset < 0)
186 $tzstring = 'UTC' . $current_offset;
188 $tzstring = 'UTC+' . $current_offset;
192 <th scope="row"><label for="timezone_string"><?php _e('Timezone') ?></label></th>
195 <select id="timezone_string" name="timezone_string" aria-describedby="timezone-description">
196 <?php echo wp_timezone_choice($tzstring); ?>
199 <span id="utc-time"><?php printf(__('<abbr title="Coordinated Universal Time">UTC</abbr> time is <code>%s</code>'), date_i18n($timezone_format, false, 'gmt')); ?></span>
200 <?php if ( get_option('timezone_string') || !empty($current_offset) ) : ?>
201 <span id="local-time"><?php printf(__('Local time is <code>%1$s</code>'), date_i18n($timezone_format)); ?></span>
203 <p class="description" id="timezone-description"><?php _e( 'Choose a city in the same timezone as you.' ); ?></p>
204 <?php if ($check_zone_info && $tzstring) : ?>
208 // Set TZ so localtime works.
209 date_default_timezone_set($tzstring);
210 $now = localtime(time(), true);
211 if ( $now['tm_isdst'] )
212 _e('This timezone is currently in daylight saving time.');
214 _e('This timezone is currently in standard time.');
218 $allowed_zones = timezone_identifiers_list();
220 if ( in_array( $tzstring, $allowed_zones) ) {
222 $date_time_zone_selected = new DateTimeZone($tzstring);
223 $tz_offset = timezone_offset_get($date_time_zone_selected, date_create());
225 foreach ( timezone_transitions_get($date_time_zone_selected) as $tr) {
226 if ( $tr['ts'] > $right_now ) {
234 $message = $tr['isdst'] ?
235 __('Daylight saving time begins on: <code>%s</code>.') :
236 __('Standard time begins on: <code>%s</code>.');
237 // Add the difference between the current offset and the new offset to ts to get the correct transition time from date_i18n().
238 printf( $message, date_i18n(get_option('date_format') . ' ' . get_option('time_format'), $tr['ts'] + ($tz_offset - $tr['offset']) ) );
240 _e('This timezone does not observe daylight saving time.');
244 date_default_timezone_set('UTC');
252 <th scope="row"><?php _e('Date Format') ?></th>
254 <fieldset><legend class="screen-reader-text"><span><?php _e('Date Format') ?></span></legend>
257 * Filter the default date formats.
260 * @since 4.0.0 Added ISO date standard YYYY-MM-DD format.
262 * @param array $default_date_formats Array of default date formats.
264 $date_formats = array_unique( apply_filters( 'date_formats', array( __( 'F j, Y' ), 'Y-m-d', 'm/d/Y', 'd/m/Y' ) ) );
268 foreach ( $date_formats as $format ) {
269 echo "\t<label title='" . esc_attr($format) . "'><input type='radio' name='date_format' value='" . esc_attr($format) . "'";
270 if ( get_option('date_format') === $format ) { // checked() uses "==" rather than "==="
271 echo " checked='checked'";
274 echo ' /> ' . date_i18n( $format ) . "</label><br />\n";
277 echo ' <label><input type="radio" name="date_format" id="date_format_custom_radio" value="\c\u\s\t\o\m"';
279 echo '/> ' . __( 'Custom:' ) . '<span class="screen-reader-text"> ' . __( 'enter a custom date format in the following field' ) . "</span></label>\n";
280 echo '<label for="date_format_custom" class="screen-reader-text">' . __( 'Custom date format:' ) . '</label><input type="text" name="date_format_custom" id="date_format_custom" value="' . esc_attr( get_option('date_format') ) . '" class="small-text" /> <span class="screen-reader-text">' . __( 'example:' ) . ' </span><span class="example"> ' . date_i18n( get_option('date_format') ) . "</span> <span class='spinner'></span>\n";
286 <th scope="row"><?php _e('Time Format') ?></th>
288 <fieldset><legend class="screen-reader-text"><span><?php _e('Time Format') ?></span></legend>
291 * Filter the default time formats.
295 * @param array $default_time_formats Array of default time formats.
297 $time_formats = array_unique( apply_filters( 'time_formats', array( __( 'g:i a' ), 'g:i A', 'H:i' ) ) );
301 foreach ( $time_formats as $format ) {
302 echo "\t<label title='" . esc_attr($format) . "'><input type='radio' name='time_format' value='" . esc_attr($format) . "'";
303 if ( get_option('time_format') === $format ) { // checked() uses "==" rather than "==="
304 echo " checked='checked'";
307 echo ' /> ' . date_i18n( $format ) . "</label><br />\n";
310 echo ' <label><input type="radio" name="time_format" id="time_format_custom_radio" value="\c\u\s\t\o\m"';
312 echo '/> ' . __( 'Custom:' ) . '<span class="screen-reader-text"> ' . __( 'enter a custom time format in the following field' ) . "</span></label>\n";
313 echo '<label for="time_format_custom" class="screen-reader-text">' . __( 'Custom time format:' ) . '</label><input type="text" name="time_format_custom" id="time_format_custom" value="' . esc_attr( get_option('time_format') ) . '" class="small-text" /> <span class="screen-reader-text">' . __( 'example:' ) . ' </span><span class="example"> ' . date_i18n( get_option('time_format') ) . "</span> <span class='spinner'></span>\n";
315 echo "\t<p>" . __('<a href="https://codex.wordpress.org/Formatting_Date_and_Time">Documentation on date and time formatting</a>.') . "</p>\n";
321 <th scope="row"><label for="start_of_week"><?php _e('Week Starts On') ?></label></th>
322 <td><select name="start_of_week" id="start_of_week">
326 for ($day_index = 0; $day_index <= 6; $day_index++) :
327 $selected = (get_option('start_of_week') == $day_index) ? 'selected="selected"' : '';
328 echo "\n\t<option value='" . esc_attr($day_index) . "' $selected>" . $wp_locale->get_weekday($day_index) . '</option>';
333 <?php do_settings_fields('general', 'default'); ?>
336 $languages = get_available_languages();
337 $translations = wp_get_available_translations();
338 if ( ! is_multisite() && defined( 'WPLANG' ) && '' !== WPLANG && 'en_US' !== WPLANG && ! in_array( WPLANG, $languages ) ) {
339 $languages[] = WPLANG;
341 if ( ! empty( $languages ) || ! empty( $translations ) ) {
344 <th width="33%" scope="row"><label for="WPLANG"><?php _e( 'Site Language' ); ?></label></th>
347 $locale = get_locale();
348 if ( ! in_array( $locale, $languages ) ) {
352 wp_dropdown_languages( array(
355 'selected' => $locale,
356 'languages' => $languages,
357 'translations' => $translations,
358 'show_available_translations' => ( ! is_multisite() || is_super_admin() ) && wp_can_install_language_pack(),
361 // Add note about deprecated WPLANG constant.
362 if ( defined( 'WPLANG' ) && ( '' !== WPLANG ) && $locale !== WPLANG ) {
363 if ( is_super_admin() ) {
365 <p class="description">
366 <strong><?php _e( 'Note:' ); ?></strong> <?php printf( __( 'The %s constant in your %s file is no longer needed.' ), '<code>WPLANG</code>', '<code>wp-config.php</code>' ); ?>
370 _deprecated_argument( 'define()', '4.0', sprintf( __( 'The %s constant in your %s file is no longer needed.' ), 'WPLANG', 'wp-config.php' ) );
380 <?php do_settings_sections('general'); ?>
382 <?php submit_button(); ?>
387 <?php include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>