$message
\n"; wp_ob_end_flush_all(); flush(); @@ -592,18 +630,20 @@ $count = count( $tokens ); $functions = array(); $ignore_functions = array(); + for ( $t = 0; $t < $count - 2; $t++ ) { if ( ! is_array( $tokens[ $t ] ) ) { continue; } - if ( T_STRING == $tokens[ $t ][0] && ( '(' === $tokens[ $t + 1 ] || '(' === $tokens[ $t + 2 ] ) ) { + if ( T_STRING === $tokens[ $t ][0] && ( '(' === $tokens[ $t + 1 ] || '(' === $tokens[ $t + 2 ] ) ) { // If it's a function or class defined locally, there's not going to be any docs available. if ( ( isset( $tokens[ $t - 2 ][1] ) && in_array( $tokens[ $t - 2 ][1], array( 'function', 'class' ), true ) ) - || ( isset( $tokens[ $t - 2 ][0] ) && T_OBJECT_OPERATOR == $tokens[ $t - 1 ][0] ) + || ( isset( $tokens[ $t - 2 ][0] ) && T_OBJECT_OPERATOR === $tokens[ $t - 1 ][0] ) ) { $ignore_functions[] = $tokens[ $t ][1]; } + // Add this to our stack of unique references. $functions[] = $tokens[ $t ][1]; } @@ -624,10 +664,12 @@ $ignore_functions = array_unique( $ignore_functions ); $out = array(); + foreach ( $functions as $function ) { if ( in_array( $function, $ignore_functions, true ) ) { continue; } + $out[] = $function; } @@ -640,150 +682,163 @@ * @since 2.8.0 */ function set_screen_options() { - - if ( isset( $_POST['wp_screen_options'] ) && is_array( $_POST['wp_screen_options'] ) ) { - check_admin_referer( 'screen-options-nonce', 'screenoptionnonce' ); + if ( ! isset( $_POST['wp_screen_options'] ) || ! is_array( $_POST['wp_screen_options'] ) ) { + return; + } - $user = wp_get_current_user(); - if ( ! $user ) { - return; - } - $option = $_POST['wp_screen_options']['option']; - $value = $_POST['wp_screen_options']['value']; + check_admin_referer( 'screen-options-nonce', 'screenoptionnonce' ); + + $user = wp_get_current_user(); - if ( sanitize_key( $option ) != $option ) { - return; - } + if ( ! $user ) { + return; + } + + $option = $_POST['wp_screen_options']['option']; + $value = $_POST['wp_screen_options']['value']; - $map_option = $option; - $type = str_replace( 'edit_', '', $map_option ); - $type = str_replace( '_per_page', '', $type ); - if ( in_array( $type, get_taxonomies(), true ) ) { - $map_option = 'edit_tags_per_page'; - } elseif ( in_array( $type, get_post_types(), true ) ) { - $map_option = 'edit_per_page'; - } else { - $option = str_replace( '-', '_', $option ); - } + if ( sanitize_key( $option ) !== $option ) { + return; + } + + $map_option = $option; + $type = str_replace( 'edit_', '', $map_option ); + $type = str_replace( '_per_page', '', $type ); - switch ( $map_option ) { - case 'edit_per_page': - case 'users_per_page': - case 'edit_comments_per_page': - case 'upload_per_page': - case 'edit_tags_per_page': - case 'plugins_per_page': - case 'export_personal_data_requests_per_page': - case 'remove_personal_data_requests_per_page': - // Network admin. - case 'sites_network_per_page': - case 'users_network_per_page': - case 'site_users_network_per_page': - case 'plugins_network_per_page': - case 'themes_network_per_page': - case 'site_themes_network_per_page': - $value = (int) $value; - if ( $value < 1 || $value > 999 ) { - return; - } - break; - default: - $screen_option = false; + if ( in_array( $type, get_taxonomies(), true ) ) { + $map_option = 'edit_tags_per_page'; + } elseif ( in_array( $type, get_post_types(), true ) ) { + $map_option = 'edit_per_page'; + } else { + $option = str_replace( '-', '_', $option ); + } - if ( '_page' === substr( $option, -5 ) || 'layout_columns' === $option ) { - /** - * Filters a screen option value before it is set. - * - * The filter can also be used to modify non-standard [items]_per_page - * settings. See the parent function for a full list of standard options. - * - * Returning false from the filter will skip saving the current option. - * - * @since 2.8.0 - * @since 5.4.2 Only applied to options ending with '_page', - * or the 'layout_columns' option. - * - * @see set_screen_options() - * - * @param mixed $screen_option The value to save instead of the option value. - * Default false (to skip saving the current option). - * @param string $option The option name. - * @param int $value The option value. - */ - $screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores - } + switch ( $map_option ) { + case 'edit_per_page': + case 'users_per_page': + case 'edit_comments_per_page': + case 'upload_per_page': + case 'edit_tags_per_page': + case 'plugins_per_page': + case 'export_personal_data_requests_per_page': + case 'remove_personal_data_requests_per_page': + // Network admin. + case 'sites_network_per_page': + case 'users_network_per_page': + case 'site_users_network_per_page': + case 'plugins_network_per_page': + case 'themes_network_per_page': + case 'site_themes_network_per_page': + $value = (int) $value; + if ( $value < 1 || $value > 999 ) { + return; + } + + break; + + default: + $screen_option = false; + + if ( '_page' === substr( $option, -5 ) || 'layout_columns' === $option ) { /** * Filters a screen option value before it is set. * - * The dynamic portion of the hook, `$option`, refers to the option name. + * The filter can also be used to modify non-standard [items]_per_page + * settings. See the parent function for a full list of standard options. * * Returning false from the filter will skip saving the current option. * - * @since 5.4.2 + * @since 2.8.0 + * @since 5.4.2 Only applied to options ending with '_page', + * or the 'layout_columns' option. * * @see set_screen_options() * - * @param mixed $screen_option The value to save instead of the option value. - * Default false (to skip saving the current option). - * @param string $option The option name. - * @param int $value The option value. + * @param mixed $screen_option The value to save instead of the option value. + * Default false (to skip saving the current option). + * @param string $option The option name. + * @param int $value The option value. */ - $value = apply_filters( "set_screen_option_{$option}", $screen_option, $option, $value ); + $screen_option = apply_filters( 'set-screen-option', $screen_option, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores + } - if ( false === $value ) { - return; - } - break; - } - - update_user_meta( $user->ID, $option, $value ); + /** + * Filters a screen option value before it is set. + * + * The dynamic portion of the hook name, `$option`, refers to the option name. + * + * Returning false from the filter will skip saving the current option. + * + * @since 5.4.2 + * + * @see set_screen_options() + * + * @param mixed $screen_option The value to save instead of the option value. + * Default false (to skip saving the current option). + * @param string $option The option name. + * @param int $value The option value. + */ + $value = apply_filters( "set_screen_option_{$option}", $screen_option, $option, $value ); - $url = remove_query_arg( array( 'pagenum', 'apage', 'paged' ), wp_get_referer() ); - if ( isset( $_POST['mode'] ) ) { - $url = add_query_arg( array( 'mode' => $_POST['mode'] ), $url ); - } + if ( false === $value ) { + return; + } + + break; + } + + update_user_meta( $user->ID, $option, $value ); - wp_safe_redirect( $url ); - exit; + $url = remove_query_arg( array( 'pagenum', 'apage', 'paged' ), wp_get_referer() ); + + if ( isset( $_POST['mode'] ) ) { + $url = add_query_arg( array( 'mode' => $_POST['mode'] ), $url ); } + + wp_safe_redirect( $url ); + exit; } /** - * Check if rewrite rule for WordPress already exists in the IIS 7+ configuration file + * Checks if rewrite rule for WordPress already exists in the IIS 7+ configuration file. * * @since 2.8.0 * + * @param string $filename The file path to the configuration file. * @return bool - * @param string $filename The file path to the configuration file */ function iis7_rewrite_rule_exists( $filename ) { if ( ! file_exists( $filename ) ) { return false; } + if ( ! class_exists( 'DOMDocument', false ) ) { return false; } $doc = new DOMDocument(); + if ( $doc->load( $filename ) === false ) { return false; } + $xpath = new DOMXPath( $doc ); $rules = $xpath->query( '/configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'wordpress\')] | /configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'WordPress\')]' ); - if ( 0 == $rules->length ) { + + if ( 0 === $rules->length ) { return false; - } else { - return true; } + + return true; } /** - * Delete WordPress rewrite rule from web.config file if it exists there + * Deletes WordPress rewrite rule from web.config file if it exists there. * * @since 2.8.0 * - * @param string $filename Name of the configuration file + * @param string $filename Name of the configuration file. * @return bool */ function iis7_delete_rewrite_rule( $filename ) { @@ -802,8 +857,10 @@ if ( $doc->load( $filename ) === false ) { return false; } + $xpath = new DOMXPath( $doc ); $rules = $xpath->query( '/configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'wordpress\')] | /configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'WordPress\')]' ); + if ( $rules->length > 0 ) { $child = $rules->item( 0 ); $parent = $child->parentNode; @@ -811,16 +868,17 @@ $doc->formatOutput = true; saveDomDocument( $doc, $filename ); } + return true; } /** - * Add WordPress rewrite rule to the IIS 7+ configuration file. + * Adds WordPress rewrite rule to the IIS 7+ configuration file. * * @since 2.8.0 * - * @param string $filename The file path to the configuration file - * @param string $rewrite_rule The XML fragment with URL Rewrite rule + * @param string $filename The file path to the configuration file. + * @param string $rewrite_rule The XML fragment with URL Rewrite rule. * @return bool */ function iis7_add_rewrite_rule( $filename, $rewrite_rule ) { @@ -846,41 +904,46 @@ // First check if the rule already exists as in that case there is no need to re-add it. $wordpress_rules = $xpath->query( '/configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'wordpress\')] | /configuration/system.webServer/rewrite/rules/rule[starts-with(@name,\'WordPress\')]' ); + if ( $wordpress_rules->length > 0 ) { return true; } // Check the XPath to the rewrite rule and create XML nodes if they do not exist. - $xmlnodes = $xpath->query( '/configuration/system.webServer/rewrite/rules' ); - if ( $xmlnodes->length > 0 ) { - $rules_node = $xmlnodes->item( 0 ); + $xml_nodes = $xpath->query( '/configuration/system.webServer/rewrite/rules' ); + + if ( $xml_nodes->length > 0 ) { + $rules_node = $xml_nodes->item( 0 ); } else { $rules_node = $doc->createElement( 'rules' ); - $xmlnodes = $xpath->query( '/configuration/system.webServer/rewrite' ); - if ( $xmlnodes->length > 0 ) { - $rewrite_node = $xmlnodes->item( 0 ); + $xml_nodes = $xpath->query( '/configuration/system.webServer/rewrite' ); + + if ( $xml_nodes->length > 0 ) { + $rewrite_node = $xml_nodes->item( 0 ); $rewrite_node->appendChild( $rules_node ); } else { $rewrite_node = $doc->createElement( 'rewrite' ); $rewrite_node->appendChild( $rules_node ); - $xmlnodes = $xpath->query( '/configuration/system.webServer' ); - if ( $xmlnodes->length > 0 ) { - $system_webServer_node = $xmlnodes->item( 0 ); - $system_webServer_node->appendChild( $rewrite_node ); + $xml_nodes = $xpath->query( '/configuration/system.webServer' ); + + if ( $xml_nodes->length > 0 ) { + $system_web_server_node = $xml_nodes->item( 0 ); + $system_web_server_node->appendChild( $rewrite_node ); } else { - $system_webServer_node = $doc->createElement( 'system.webServer' ); - $system_webServer_node->appendChild( $rewrite_node ); + $system_web_server_node = $doc->createElement( 'system.webServer' ); + $system_web_server_node->appendChild( $rewrite_node ); - $xmlnodes = $xpath->query( '/configuration' ); - if ( $xmlnodes->length > 0 ) { - $config_node = $xmlnodes->item( 0 ); - $config_node->appendChild( $system_webServer_node ); + $xml_nodes = $xpath->query( '/configuration' ); + + if ( $xml_nodes->length > 0 ) { + $config_node = $xml_nodes->item( 0 ); + $config_node->appendChild( $system_web_server_node ); } else { $config_node = $doc->createElement( 'configuration' ); $doc->appendChild( $config_node ); - $config_node->appendChild( $system_webServer_node ); + $config_node->appendChild( $system_web_server_node ); } } } @@ -898,7 +961,7 @@ } /** - * Saves the XML document into a file + * Saves the XML document into a file. * * @since 2.8.0 * @@ -908,13 +971,14 @@ function saveDomDocument( $doc, $filename ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionNameInvalid $config = $doc->saveXML(); $config = preg_replace( "/([^\r])\n/", "$1\r\n", $config ); - $fp = fopen( $filename, 'w' ); + + $fp = fopen( $filename, 'w' ); fwrite( $fp, $config ); fclose( $fp ); } /** - * Display the default admin color scheme picker (Used in user-edit.php) + * Displays the default admin color scheme picker (Used in user-edit.php). * * @since 3.0.0 * @@ -946,7 +1010,6 @@ if ( empty( $current_color ) || ! isset( $_wp_admin_css_colors[ $current_color ] ) ) { $current_color = 'fresh'; } - ?>