3 * Options Management Administration Screen.
5 * If accessed directly in a browser this page shows a list of all saved options
6 * along with editable fields for their values. Serialized data is not supported
7 * and there is no way to remove options via this page. It is not linked to from
8 * anywhere else in the admin.
10 * This file is also the target of the forms in core and custom options pages
11 * that use the Settings API. In this case it saves the new option values
12 * and returns the user to their page of origin.
15 * @subpackage Administration
18 /** WordPress Administration Bootstrap */
19 require_once( dirname( __FILE__ ) . '/admin.php' );
21 $title = __('Settings');
22 $this_file = 'options.php';
23 $parent_file = 'options-general.php';
25 wp_reset_vars(array('action', 'option_page'));
27 $capability = 'manage_options';
29 if ( empty($option_page) ) // This is for back compat and will eventually be removed.
30 $option_page = 'options';
34 * Filter the capability required when using the Settings API.
36 * By default, the options groups for all registered settings require the manage_options capability.
37 * This filter is required to change the capability required for a certain options page.
41 * @param string $capability The capability used for the page, which is manage_options by default.
43 $capability = apply_filters( "option_page_capability_{$option_page}", $capability );
45 if ( !current_user_can( $capability ) )
46 wp_die(__('Cheatin’ uh?'));
48 // Handle admin email change requests
49 if ( is_multisite() ) {
50 if ( ! empty($_GET[ 'adminhash' ] ) ) {
51 $new_admin_details = get_option( 'adminhash' );
52 $redirect = 'options-general.php?updated=false';
53 if ( is_array( $new_admin_details ) && $new_admin_details[ 'hash' ] == $_GET[ 'adminhash' ] && !empty($new_admin_details[ 'newemail' ]) ) {
54 update_option( 'admin_email', $new_admin_details[ 'newemail' ] );
55 delete_option( 'adminhash' );
56 delete_option( 'new_admin_email' );
57 $redirect = 'options-general.php?updated=true';
59 wp_redirect( admin_url( $redirect ) );
61 } elseif ( ! empty( $_GET['dismiss'] ) && 'new_admin_email' == $_GET['dismiss'] ) {
62 delete_option( 'adminhash' );
63 delete_option( 'new_admin_email' );
64 wp_redirect( admin_url( 'options-general.php?updated=true' ) );
69 if ( is_multisite() && !is_super_admin() && 'update' != $action )
70 wp_die(__('Cheatin’ uh?'));
72 $whitelist_options = array(
73 'general' => array( 'blogname', 'blogdescription', 'gmt_offset', 'date_format', 'time_format', 'start_of_week', 'timezone_string' ),
74 'discussion' => array( 'default_pingback_flag', 'default_ping_status', 'default_comment_status', 'comments_notify', 'moderation_notify', 'comment_moderation', 'require_name_email', 'comment_whitelist', 'comment_max_links', 'moderation_keys', 'blacklist_keys', 'show_avatars', 'avatar_rating', 'avatar_default', 'close_comments_for_old_posts', 'close_comments_days_old', 'thread_comments', 'thread_comments_depth', 'page_comments', 'comments_per_page', 'default_comments_page', 'comment_order', 'comment_registration' ),
75 'media' => array( 'thumbnail_size_w', 'thumbnail_size_h', 'thumbnail_crop', 'medium_size_w', 'medium_size_h', 'large_size_w', 'large_size_h', 'image_default_size', 'image_default_align', 'image_default_link_type' ),
76 'reading' => array( 'posts_per_page', 'posts_per_rss', 'rss_use_excerpt', 'show_on_front', 'page_on_front', 'page_for_posts', 'blog_public' ),
77 'writing' => array( 'use_smilies', 'default_category', 'default_email_category', 'use_balanceTags', 'default_link_category', 'default_post_format' )
79 $whitelist_options['misc'] = $whitelist_options['options'] = $whitelist_options['privacy'] = array();
81 $mail_options = array('mailserver_url', 'mailserver_port', 'mailserver_login', 'mailserver_pass');
83 if ( ! in_array( get_option( 'blog_charset' ), array( 'utf8', 'utf-8', 'UTF8', 'UTF-8' ) ) )
84 $whitelist_options['reading'][] = 'blog_charset';
86 if ( !is_multisite() ) {
87 if ( !defined( 'WP_SITEURL' ) )
88 $whitelist_options['general'][] = 'siteurl';
89 if ( !defined( 'WP_HOME' ) )
90 $whitelist_options['general'][] = 'home';
92 $whitelist_options['general'][] = 'admin_email';
93 $whitelist_options['general'][] = 'users_can_register';
94 $whitelist_options['general'][] = 'default_role';
96 $whitelist_options['writing'] = array_merge($whitelist_options['writing'], $mail_options);
97 $whitelist_options['writing'][] = 'ping_sites';
99 $whitelist_options['media'][] = 'uploads_use_yearmonth_folders';
101 // If upload_url_path and upload_path are both default values, they're locked.
102 if ( get_option( 'upload_url_path' ) || ( get_option('upload_path') != 'wp-content/uploads' && get_option('upload_path') ) ) {
103 $whitelist_options['media'][] = 'upload_path';
104 $whitelist_options['media'][] = 'upload_url_path';
107 $whitelist_options['general'][] = 'new_admin_email';
108 $whitelist_options['general'][] = 'WPLANG';
111 * Filter whether the post-by-email functionality is enabled.
115 * @param bool $enabled Whether post-by-email configuration is enabled. Default true.
117 if ( apply_filters( 'enable_post_by_email_configuration', true ) )
118 $whitelist_options['writing'] = array_merge($whitelist_options['writing'], $mail_options);
122 * Filter the options white list.
126 * @param array White list options.
128 $whitelist_options = apply_filters( 'whitelist_options', $whitelist_options );
131 * If $_GET['action'] == 'update' we are saving settings sent from a settings page
133 if ( 'update' == $action ) {
134 if ( 'options' == $option_page && !isset( $_POST['option_page'] ) ) { // This is for back compat and will eventually be removed.
135 $unregistered = true;
136 check_admin_referer( 'update-options' );
138 $unregistered = false;
139 check_admin_referer( $option_page . '-options' );
142 if ( !isset( $whitelist_options[ $option_page ] ) )
143 wp_die( __( '<strong>ERROR</strong>: options page not found.' ) );
145 if ( 'options' == $option_page ) {
146 if ( is_multisite() && ! is_super_admin() )
147 wp_die( __( 'You do not have sufficient permissions to modify unregistered settings for this site.' ) );
148 $options = explode( ',', wp_unslash( $_POST[ 'page_options' ] ) );
150 $options = $whitelist_options[ $option_page ];
153 // Handle custom date/time formats
154 if ( 'general' == $option_page ) {
155 if ( !empty($_POST['date_format']) && isset($_POST['date_format_custom']) && '\c\u\s\t\o\m' == wp_unslash( $_POST['date_format'] ) )
156 $_POST['date_format'] = $_POST['date_format_custom'];
157 if ( !empty($_POST['time_format']) && isset($_POST['time_format_custom']) && '\c\u\s\t\o\m' == wp_unslash( $_POST['time_format'] ) )
158 $_POST['time_format'] = $_POST['time_format_custom'];
159 // Map UTC+- timezones to gmt_offsets and set timezone_string to empty.
160 if ( !empty($_POST['timezone_string']) && preg_match('/^UTC[+-]/', $_POST['timezone_string']) ) {
161 $_POST['gmt_offset'] = $_POST['timezone_string'];
162 $_POST['gmt_offset'] = preg_replace('/UTC\+?/', '', $_POST['gmt_offset']);
163 $_POST['timezone_string'] = '';
168 foreach ( $options as $option ) {
170 _deprecated_argument( 'options.php', '2.7', sprintf( __( 'The <code>%1$s</code> setting is unregistered. Unregistered settings are deprecated. See http://codex.wordpress.org/Settings_API' ), $option, $option_page ) );
172 $option = trim( $option );
174 if ( isset( $_POST[ $option ] ) ) {
175 $value = $_POST[ $option ];
176 if ( ! is_array( $value ) )
177 $value = trim( $value );
178 $value = wp_unslash( $value );
180 update_option( $option, $value );
185 * Handle settings errors and return to options page
187 // If no settings errors were registered add a general 'updated' message.
188 if ( !count( get_settings_errors() ) )
189 add_settings_error('general', 'settings_updated', __('Settings saved.'), 'updated');
190 set_transient('settings_errors', get_settings_errors(), 30);
193 * Redirect back to the settings page that was submitted
195 $goback = add_query_arg( 'settings-updated', 'true', wp_get_referer() );
196 wp_redirect( $goback );
200 include( ABSPATH . 'wp-admin/admin-header.php' ); ?>
203 <h2><?php esc_html_e('All Settings'); ?></h2>
204 <form name="form" action="options.php" method="post" id="all-options">
205 <?php wp_nonce_field('options-options') ?>
206 <input type="hidden" name="action" value="update" />
207 <input type='hidden' name='option_page' value='options' />
208 <table class="form-table">
210 $options = $wpdb->get_results( "SELECT * FROM $wpdb->options ORDER BY option_name" );
212 foreach ( (array) $options as $option ) :
214 if ( $option->option_name == '' )
216 if ( is_serialized( $option->option_value ) ) {
217 if ( is_serialized_string( $option->option_value ) ) {
218 // this is a serialized string, so we should display it
219 $value = maybe_unserialize( $option->option_value );
220 $options_to_update[] = $option->option_name;
221 $class = 'all-options';
223 $value = 'SERIALIZED DATA';
225 $class = 'all-options disabled';
228 $value = $option->option_value;
229 $options_to_update[] = $option->option_name;
230 $class = 'all-options';
232 $name = esc_attr( $option->option_name );
235 <th scope='row'><label for='$name'>" . esc_html( $option->option_name ) . "</label></th>
237 if ( strpos( $value, "\n" ) !== false )
238 echo "<textarea class='$class' name='$name' id='$name' cols='30' rows='5'>" . esc_textarea( $value ) . "</textarea>";
240 echo "<input class='regular-text $class' type='text' name='$name' id='$name' value='" . esc_attr( $value ) . "'" . disabled( $disabled, true, false ) . " />";
247 <input type="hidden" name="page_options" value="<?php echo esc_attr( implode( ',', $options_to_update ) ); ?>" />
249 <?php submit_button( __( 'Save Changes' ), 'primary', 'Update' ); ?>
255 include( ABSPATH . 'wp-admin/admin-footer.php' );