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 G:i:s', 'timezone date format');
24 * Display JavaScript on the page.
28 function options_general_add_js() {
30 <script type="text/javascript">
32 jQuery(document).ready(function($){
33 var $siteName = $( '#wp-admin-bar-site-name' ).children( 'a' ).first(),
34 homeURL = ( <?php echo wp_json_encode( get_home_url() ); ?> || '' ).replace( /^(https?:\/\/)?(www\.)?/, '' );
36 $( '#blogname' ).on( 'input', function() {
37 var title = $.trim( $( this ).val() ) || homeURL;
39 // Truncate to 40 characters.
40 if ( 40 < title.length ) {
41 title = title.substring( 0, 40 ) + '\u2026';
44 $siteName.text( title );
47 $("input[name='date_format']").click(function(){
48 if ( "date_format_custom_radio" != $(this).attr("id") )
49 $("input[name='date_format_custom']").val( $(this).val() ).siblings('.example').text( $(this).siblings('span').text() );
51 $("input[name='date_format_custom']").focus(function(){
52 $( '#date_format_custom_radio' ).prop( 'checked', true );
55 $("input[name='time_format']").click(function(){
56 if ( "time_format_custom_radio" != $(this).attr("id") )
57 $("input[name='time_format_custom']").val( $(this).val() ).siblings('.example').text( $(this).siblings('span').text() );
59 $("input[name='time_format_custom']").focus(function(){
60 $( '#time_format_custom_radio' ).prop( 'checked', true );
62 $("input[name='date_format_custom'], input[name='time_format_custom']").change( function() {
64 format.siblings('.spinner').css('display', 'inline-block'); // show(); can't be used here
66 action: 'date_format_custom' == format.attr('name') ? 'date_format' : 'time_format',
68 }, function(d) { format.siblings('.spinner').hide(); format.siblings('.example').text(d); } );
71 var languageSelect = $( '#WPLANG' );
72 $( 'form' ).submit( function() {
73 // Don't show a spinner for English and installed languages,
74 // as there is nothing to download.
75 if ( ! languageSelect.find( 'option:selected' ).data( 'installed' ) ) {
76 $( '#submit', this ).after( '<span class="spinner language-install-spinner" />' );
84 add_action('admin_head', 'options_general_add_js');
86 $options_help = '<p>' . __('The fields on this screen determine some of the basics of your site setup.') . '</p>' .
87 '<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>';
89 if ( ! is_multisite() ) {
90 $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>' .
91 '<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>';
94 $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>' .
95 '<p>' . __( 'UTC means Coordinated Universal Time.' ) . '</p>' .
96 '<p>' . __( 'You must click the Save Changes button at the bottom of the screen for new settings to take effect.' ) . '</p>';
98 get_current_screen()->add_help_tab( array(
100 'title' => __('Overview'),
101 'content' => $options_help,
104 get_current_screen()->set_help_sidebar(
105 '<p><strong>' . __('For more information:') . '</strong></p>' .
106 '<p>' . __('<a href="http://codex.wordpress.org/Settings_General_Screen" target="_blank">Documentation on General Settings</a>') . '</p>' .
107 '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'
110 include( ABSPATH . 'wp-admin/admin-header.php' );
114 <h2><?php echo esc_html( $title ); ?></h2>
116 <form method="post" action="options.php" novalidate="novalidate">
117 <?php settings_fields('general'); ?>
119 <table class="form-table">
121 <th scope="row"><label for="blogname"><?php _e('Site Title') ?></label></th>
122 <td><input name="blogname" type="text" id="blogname" value="<?php form_option('blogname'); ?>" class="regular-text" /></td>
125 <th scope="row"><label for="blogdescription"><?php _e('Tagline') ?></label></th>
126 <td><input name="blogdescription" type="text" id="blogdescription" value="<?php form_option('blogdescription'); ?>" class="regular-text" />
127 <p class="description"><?php _e('In a few words, explain what this site is about.') ?></p></td>
129 <?php if ( !is_multisite() ) { ?>
131 <th scope="row"><label for="siteurl"><?php _e('WordPress Address (URL)') ?></label></th>
132 <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>
135 <th scope="row"><label for="home"><?php _e('Site Address (URL)') ?></label></th>
136 <td><input name="home" type="url" id="home" value="<?php form_option( 'home' ); ?>"<?php disabled( defined( 'WP_HOME' ) ); ?> class="regular-text code<?php if ( defined( 'WP_HOME' ) ) echo ' disabled' ?>" />
137 <p class="description"><?php _e('Enter the address here if you want your site homepage <a href="http://codex.wordpress.org/Giving_WordPress_Its_Own_Directory">to be different from the directory</a> you installed WordPress.'); ?></p></td>
140 <th scope="row"><label for="admin_email"><?php _e('E-mail Address') ?> </label></th>
141 <td><input name="admin_email" type="email" id="admin_email" value="<?php form_option( 'admin_email' ); ?>" class="regular-text ltr" />
142 <p class="description"><?php _e('This address is used for admin purposes, like new user notification.') ?></p></td>
145 <th scope="row"><?php _e('Membership') ?></th>
146 <td> <fieldset><legend class="screen-reader-text"><span><?php _e('Membership') ?></span></legend><label for="users_can_register">
147 <input name="users_can_register" type="checkbox" id="users_can_register" value="1" <?php checked('1', get_option('users_can_register')); ?> />
148 <?php _e('Anyone can register') ?></label>
152 <th scope="row"><label for="default_role"><?php _e('New User Default Role') ?></label></th>
154 <select name="default_role" id="default_role"><?php wp_dropdown_roles( get_option('default_role') ); ?></select>
159 <th scope="row"><label for="new_admin_email"><?php _e('E-mail Address') ?> </label></th>
160 <td><input name="new_admin_email" type="email" id="new_admin_email" value="<?php form_option( 'admin_email' ); ?>" class="regular-text ltr" />
161 <p class="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>
163 $new_admin_email = get_option( 'new_admin_email' );
164 if ( $new_admin_email && $new_admin_email != get_option('admin_email') ) : ?>
165 <div class="updated inline">
166 <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>
174 $current_offset = get_option('gmt_offset');
175 $tzstring = get_option('timezone_string');
177 $check_zone_info = true;
179 // Remove old Etc mappings. Fallback to gmt_offset.
180 if ( false !== strpos($tzstring,'Etc/GMT') )
183 if ( empty($tzstring) ) { // Create a UTC+- zone if no timezone string exists
184 $check_zone_info = false;
185 if ( 0 == $current_offset )
187 elseif ($current_offset < 0)
188 $tzstring = 'UTC' . $current_offset;
190 $tzstring = 'UTC+' . $current_offset;
194 <th scope="row"><label for="timezone_string"><?php _e('Timezone') ?></label></th>
197 <select id="timezone_string" name="timezone_string">
198 <?php echo wp_timezone_choice($tzstring); ?>
201 <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>
202 <?php if ( get_option('timezone_string') || !empty($current_offset) ) : ?>
203 <span id="local-time"><?php printf(__('Local time is <code>%1$s</code>'), date_i18n($timezone_format)); ?></span>
205 <p class="description"><?php _e('Choose a city in the same timezone as you.'); ?></p>
206 <?php if ($check_zone_info && $tzstring) : ?>
210 // Set TZ so localtime works.
211 date_default_timezone_set($tzstring);
212 $now = localtime(time(), true);
213 if ( $now['tm_isdst'] )
214 _e('This timezone is currently in daylight saving time.');
216 _e('This timezone is currently in standard time.');
220 $allowed_zones = timezone_identifiers_list();
222 if ( in_array( $tzstring, $allowed_zones) ) {
224 $date_time_zone_selected = new DateTimeZone($tzstring);
225 $tz_offset = timezone_offset_get($date_time_zone_selected, date_create());
227 foreach ( timezone_transitions_get($date_time_zone_selected) as $tr) {
228 if ( $tr['ts'] > $right_now ) {
236 $message = $tr['isdst'] ?
237 __('Daylight saving time begins on: <code>%s</code>.') :
238 __('Standard time begins on: <code>%s</code>.');
239 // Add the difference between the current offset and the new offset to ts to get the correct transition time from date_i18n().
240 printf( $message, date_i18n(get_option('date_format') . ' ' . get_option('time_format'), $tr['ts'] + ($tz_offset - $tr['offset']) ) );
242 _e('This timezone does not observe daylight saving time.');
246 date_default_timezone_set('UTC');
254 <th scope="row"><?php _e('Date Format') ?></th>
256 <fieldset><legend class="screen-reader-text"><span><?php _e('Date Format') ?></span></legend>
259 * Filter the default date formats.
262 * @since 4.0.0 Added ISO date standard YYYY-MM-DD format.
264 * @param array $default_date_formats Array of default date formats.
266 $date_formats = array_unique( apply_filters( 'date_formats', array( __( 'F j, Y' ), 'Y-m-d', 'm/d/Y', 'd/m/Y' ) ) );
270 foreach ( $date_formats as $format ) {
271 echo "\t<label title='" . esc_attr($format) . "'><input type='radio' name='date_format' value='" . esc_attr($format) . "'";
272 if ( get_option('date_format') === $format ) { // checked() uses "==" rather than "==="
273 echo " checked='checked'";
276 echo ' /> <span>' . date_i18n( $format ) . "</span></label><br />\n";
279 echo ' <label><input type="radio" name="date_format" id="date_format_custom_radio" value="\c\u\s\t\o\m"';
281 echo '/> ' . __('Custom:') . ' </label><input type="text" name="date_format_custom" value="' . esc_attr( get_option('date_format') ) . '" class="small-text" /> <span class="example"> ' . date_i18n( get_option('date_format') ) . "</span> <span class='spinner'></span>\n";
287 <th scope="row"><?php _e('Time Format') ?></th>
289 <fieldset><legend class="screen-reader-text"><span><?php _e('Time Format') ?></span></legend>
292 * Filter the default time formats.
296 * @param array $default_time_formats Array of default time formats.
298 $time_formats = array_unique( apply_filters( 'time_formats', array( __( 'g:i a' ), 'g:i A', 'H:i' ) ) );
302 foreach ( $time_formats as $format ) {
303 echo "\t<label title='" . esc_attr($format) . "'><input type='radio' name='time_format' value='" . esc_attr($format) . "'";
304 if ( get_option('time_format') === $format ) { // checked() uses "==" rather than "==="
305 echo " checked='checked'";
308 echo ' /> <span>' . date_i18n( $format ) . "</span></label><br />\n";
311 echo ' <label><input type="radio" name="time_format" id="time_format_custom_radio" value="\c\u\s\t\o\m"';
313 echo '/> ' . __('Custom:') . ' </label><input type="text" name="time_format_custom" value="' . esc_attr( get_option('time_format') ) . '" class="small-text" /> <span class="example"> ' . date_i18n( get_option('time_format') ) . "</span> <span class='spinner'></span>\n";
315 echo "\t<p>" . __('<a href="http://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">
324 for ($day_index = 0; $day_index <= 6; $day_index++) :
325 $selected = (get_option('start_of_week') == $day_index) ? 'selected="selected"' : '';
326 echo "\n\t<option value='" . esc_attr($day_index) . "' $selected>" . $wp_locale->get_weekday($day_index) . '</option>';
331 <?php do_settings_fields('general', 'default'); ?>
334 $languages = get_available_languages();
335 $translations = wp_get_available_translations();
336 if ( ! is_multisite() && defined( 'WPLANG' ) && '' !== WPLANG && 'en_US' !== WPLANG && ! in_array( WPLANG, $languages ) ) {
337 $languages[] = WPLANG;
339 if ( ! empty( $languages ) || ! empty( $translations ) ) {
342 <th width="33%" scope="row"><label for="WPLANG"><?php _e( 'Site Language' ); ?></label></th>
345 $locale = get_locale();
346 if ( ! in_array( $locale, $languages ) ) {
350 wp_dropdown_languages( array(
353 'selected' => $locale,
354 'languages' => $languages,
355 'translations' => $translations,
356 'show_available_translations' => ( ! is_multisite() || is_super_admin() ) && wp_can_install_language_pack(),
359 // Add note about deprecated WPLANG constant.
360 if ( defined( 'WPLANG' ) && ( '' !== WPLANG ) && $locale !== WPLANG ) {
361 if ( is_super_admin() ) {
363 <p class="description">
364 <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>' ); ?>
368 _deprecated_argument( 'define()', '4.0', sprintf( __( 'The %s constant in your %s file is no longer needed.' ), 'WPLANG', 'wp-config.php' ) );
378 <?php do_settings_sections('general'); ?>
380 <?php submit_button(); ?>
385 <?php include( ABSPATH . 'wp-admin/admin-footer.php' ); ?>