diff options
Diffstat (limited to 'srcs/wordpress/wp-admin/includes/misc.php')
| -rw-r--r-- | srcs/wordpress/wp-admin/includes/misc.php | 1445 |
1 files changed, 1445 insertions, 0 deletions
diff --git a/srcs/wordpress/wp-admin/includes/misc.php b/srcs/wordpress/wp-admin/includes/misc.php new file mode 100644 index 0000000..1eb6aaa --- /dev/null +++ b/srcs/wordpress/wp-admin/includes/misc.php @@ -0,0 +1,1445 @@ +<?php +/** + * Misc WordPress Administration API. + * + * @package WordPress + * @subpackage Administration + */ + +/** + * Returns whether the server is running Apache with the mod_rewrite module loaded. + * + * @since 2.0.0 + * + * @return bool Whether the server is running Apache with the mod_rewrite module loaded. + */ +function got_mod_rewrite() { + $got_rewrite = apache_mod_loaded( 'mod_rewrite', true ); + + /** + * Filters whether Apache and mod_rewrite are present. + * + * This filter was previously used to force URL rewriting for other servers, + * like nginx. Use the {@see 'got_url_rewrite'} filter in got_url_rewrite() instead. + * + * @since 2.5.0 + * + * @see got_url_rewrite() + * + * @param bool $got_rewrite Whether Apache and mod_rewrite are present. + */ + return apply_filters( 'got_rewrite', $got_rewrite ); +} + +/** + * Returns whether the server supports URL rewriting. + * + * Detects Apache's mod_rewrite, IIS 7.0+ permalink support, and nginx. + * + * @since 3.7.0 + * + * @global bool $is_nginx + * + * @return bool Whether the server supports URL rewriting. + */ +function got_url_rewrite() { + $got_url_rewrite = ( got_mod_rewrite() || $GLOBALS['is_nginx'] || iis7_supports_permalinks() ); + + /** + * Filters whether URL rewriting is available. + * + * @since 3.7.0 + * + * @param bool $got_url_rewrite Whether URL rewriting is available. + */ + return apply_filters( 'got_url_rewrite', $got_url_rewrite ); +} + +/** + * Extracts strings from between the BEGIN and END markers in the .htaccess file. + * + * @since 1.5.0 + * + * @param string $filename Filename to extract the strings from. + * @param string $marker The marker to extract the strings from. + * @return array An array of strings from a file (.htaccess) from between BEGIN and END markers. + */ +function extract_from_markers( $filename, $marker ) { + $result = array(); + + if ( ! file_exists( $filename ) ) { + return $result; + } + + $markerdata = explode( "\n", implode( '', file( $filename ) ) ); + + $state = false; + foreach ( $markerdata as $markerline ) { + if ( false !== strpos( $markerline, '# END ' . $marker ) ) { + $state = false; + } + if ( $state ) { + if ( '#' === substr( $markerline, 0, 1 ) ) { + continue; + } + $result[] = $markerline; + } + if ( false !== strpos( $markerline, '# BEGIN ' . $marker ) ) { + $state = true; + } + } + + return $result; +} + +/** + * Inserts an array of strings into a file (.htaccess), placing it between + * BEGIN and END markers. + * + * Replaces existing marked info. Retains surrounding + * data. Creates file if none exists. + * + * @since 1.5.0 + * + * @param string $filename Filename to alter. + * @param string $marker The marker to alter. + * @param array|string $insertion The new content to insert. + * @return bool True on write success, false on failure. + */ +function insert_with_markers( $filename, $marker, $insertion ) { + if ( ! file_exists( $filename ) ) { + if ( ! is_writable( dirname( $filename ) ) ) { + return false; + } + if ( ! touch( $filename ) ) { + return false; + } + } elseif ( ! is_writeable( $filename ) ) { + return false; + } + + if ( ! is_array( $insertion ) ) { + $insertion = explode( "\n", $insertion ); + } + + $switched_locale = switch_to_locale( get_locale() ); + + $instructions = sprintf( + /* translators: 1: Marker. */ + __( + 'The directives (lines) between `BEGIN %1$s` and `END %1$s` are +dynamically generated, and should only be modified via WordPress filters. +Any changes to the directives between these markers will be overwritten.' + ), + $marker + ); + + $instructions = explode( "\n", $instructions ); + foreach ( $instructions as $line => $text ) { + $instructions[ $line ] = '# ' . $text; + } + + /** + * Filters the inline instructions inserted before the dynamically generated content. + * + * @since 5.3.0 + * + * @param string[] $instructions Array of lines with inline instructions. + * @param string $marker The marker being inserted. + */ + $instructions = apply_filters( 'insert_with_markers_inline_instructions', $instructions, $marker ); + + if ( $switched_locale ) { + restore_previous_locale(); + } + + $insertion = array_merge( $instructions, $insertion ); + + $start_marker = "# BEGIN {$marker}"; + $end_marker = "# END {$marker}"; + + $fp = fopen( $filename, 'r+' ); + if ( ! $fp ) { + return false; + } + + // Attempt to get a lock. If the filesystem supports locking, this will block until the lock is acquired. + flock( $fp, LOCK_EX ); + + $lines = array(); + while ( ! feof( $fp ) ) { + $lines[] = rtrim( fgets( $fp ), "\r\n" ); + } + + // Split out the existing file into the preceding lines, and those that appear after the marker + $pre_lines = array(); + $post_lines = array(); + $existing_lines = array(); + $found_marker = false; + $found_end_marker = false; + foreach ( $lines as $line ) { + if ( ! $found_marker && false !== strpos( $line, $start_marker ) ) { + $found_marker = true; + continue; + } elseif ( ! $found_end_marker && false !== strpos( $line, $end_marker ) ) { + $found_end_marker = true; + continue; + } + if ( ! $found_marker ) { + $pre_lines[] = $line; + } elseif ( $found_marker && $found_end_marker ) { + $post_lines[] = $line; + } else { + $existing_lines[] = $line; + } + } + + // Check to see if there was a change + if ( $existing_lines === $insertion ) { + flock( $fp, LOCK_UN ); + fclose( $fp ); + + return true; + } + + // Generate the new file data + $new_file_data = implode( + "\n", + array_merge( + $pre_lines, + array( $start_marker ), + $insertion, + array( $end_marker ), + $post_lines + ) + ); + + // Write to the start of the file, and truncate it to that length + fseek( $fp, 0 ); + $bytes = fwrite( $fp, $new_file_data ); + if ( $bytes ) { + ftruncate( $fp, ftell( $fp ) ); + } + fflush( $fp ); + flock( $fp, LOCK_UN ); + fclose( $fp ); + + return (bool) $bytes; +} + +/** + * Updates the htaccess file with the current rules if it is writable. + * + * Always writes to the file if it exists and is writable to ensure that we + * blank out old rules. + * + * @since 1.5.0 + * + * @global WP_Rewrite $wp_rewrite WordPress rewrite component. + * + * @return bool|null True on write success, false on failure. Null in multisite. + */ +function save_mod_rewrite_rules() { + if ( is_multisite() ) { + return; + } + + global $wp_rewrite; + + // Ensure get_home_path() is declared. + require_once( ABSPATH . 'wp-admin/includes/file.php' ); + + $home_path = get_home_path(); + $htaccess_file = $home_path . '.htaccess'; + + /* + * If the file doesn't already exist check for write access to the directory + * and whether we have some rules. Else check for write access to the file. + */ + if ( ( ! file_exists( $htaccess_file ) && is_writable( $home_path ) && $wp_rewrite->using_mod_rewrite_permalinks() ) || is_writable( $htaccess_file ) ) { + if ( got_mod_rewrite() ) { + $rules = explode( "\n", $wp_rewrite->mod_rewrite_rules() ); + return insert_with_markers( $htaccess_file, 'WordPress', $rules ); + } + } + + return false; +} + +/** + * Updates the IIS web.config file with the current rules if it is writable. + * If the permalinks do not require rewrite rules then the rules are deleted from the web.config file. + * + * @since 2.8.0 + * + * @global WP_Rewrite $wp_rewrite WordPress rewrite component. + * + * @return bool|null True on write success, false on failure. Null in multisite. + */ +function iis7_save_url_rewrite_rules() { + if ( is_multisite() ) { + return; + } + + global $wp_rewrite; + + // Ensure get_home_path() is declared. + require_once( ABSPATH . 'wp-admin/includes/file.php' ); + + $home_path = get_home_path(); + $web_config_file = $home_path . 'web.config'; + + // Using win_is_writable() instead of is_writable() because of a bug in Windows PHP + if ( iis7_supports_permalinks() && ( ( ! file_exists( $web_config_file ) && win_is_writable( $home_path ) && $wp_rewrite->using_mod_rewrite_permalinks() ) || win_is_writable( $web_config_file ) ) ) { + $rule = $wp_rewrite->iis7_url_rewrite_rules( false ); + if ( ! empty( $rule ) ) { + return iis7_add_rewrite_rule( $web_config_file, $rule ); + } else { + return iis7_delete_rewrite_rule( $web_config_file ); + } + } + return false; +} + +/** + * Update the "recently-edited" file for the plugin or theme editor. + * + * @since 1.5.0 + * + * @param string $file + */ +function update_recently_edited( $file ) { + $oldfiles = (array) get_option( 'recently_edited' ); + if ( $oldfiles ) { + $oldfiles = array_reverse( $oldfiles ); + $oldfiles[] = $file; + $oldfiles = array_reverse( $oldfiles ); + $oldfiles = array_unique( $oldfiles ); + if ( 5 < count( $oldfiles ) ) { + array_pop( $oldfiles ); + } + } else { + $oldfiles[] = $file; + } + update_option( 'recently_edited', $oldfiles ); +} + +/** + * Makes a tree structure for the theme editor's file list. + * + * @since 4.9.0 + * @access private + * + * @param array $allowed_files List of theme file paths. + * @return array Tree structure for listing theme files. + */ +function wp_make_theme_file_tree( $allowed_files ) { + $tree_list = array(); + foreach ( $allowed_files as $file_name => $absolute_filename ) { + $list = explode( '/', $file_name ); + $last_dir = &$tree_list; + foreach ( $list as $dir ) { + $last_dir =& $last_dir[ $dir ]; + } + $last_dir = $file_name; + } + return $tree_list; +} + +/** + * Outputs the formatted file list for the theme editor. + * + * @since 4.9.0 + * @access private + * + * @global string $relative_file Name of the file being edited relative to the + * theme directory. + * @global string $stylesheet The stylesheet name of the theme being edited. + * + * @param array|string $tree List of file/folder paths, or filename. + * @param int $level The aria-level for the current iteration. + * @param int $size The aria-setsize for the current iteration. + * @param int $index The aria-posinset for the current iteration. + */ +function wp_print_theme_file_tree( $tree, $level = 2, $size = 1, $index = 1 ) { + global $relative_file, $stylesheet; + + if ( is_array( $tree ) ) { + $index = 0; + $size = count( $tree ); + foreach ( $tree as $label => $theme_file ) : + $index++; + if ( ! is_array( $theme_file ) ) { + wp_print_theme_file_tree( $theme_file, $level, $index, $size ); + continue; + } + ?> + <li role="treeitem" aria-expanded="true" tabindex="-1" + aria-level="<?php echo esc_attr( $level ); ?>" + aria-setsize="<?php echo esc_attr( $size ); ?>" + aria-posinset="<?php echo esc_attr( $index ); ?>"> + <span class="folder-label"><?php echo esc_html( $label ); ?> <span class="screen-reader-text"><?php _e( 'folder' ); ?></span><span aria-hidden="true" class="icon"></span></span> + <ul role="group" class="tree-folder"><?php wp_print_theme_file_tree( $theme_file, $level + 1, $index, $size ); ?></ul> + </li> + <?php + endforeach; + } else { + $filename = $tree; + $url = add_query_arg( + array( + 'file' => rawurlencode( $tree ), + 'theme' => rawurlencode( $stylesheet ), + ), + self_admin_url( 'theme-editor.php' ) + ); + ?> + <li role="none" class="<?php echo esc_attr( $relative_file === $filename ? 'current-file' : '' ); ?>"> + <a role="treeitem" tabindex="<?php echo esc_attr( $relative_file === $filename ? '0' : '-1' ); ?>" + href="<?php echo esc_url( $url ); ?>" + aria-level="<?php echo esc_attr( $level ); ?>" + aria-setsize="<?php echo esc_attr( $size ); ?>" + aria-posinset="<?php echo esc_attr( $index ); ?>"> + <?php + $file_description = esc_html( get_file_description( $filename ) ); + if ( $file_description !== $filename && wp_basename( $filename ) !== $file_description ) { + $file_description .= '<br /><span class="nonessential">(' . esc_html( $filename ) . ')</span>'; + } + + if ( $relative_file === $filename ) { + echo '<span class="notice notice-info">' . $file_description . '</span>'; + } else { + echo $file_description; + } + ?> + </a> + </li> + <?php + } +} + +/** + * Makes a tree structure for the plugin editor's file list. + * + * @since 4.9.0 + * @access private + * + * @param array $plugin_editable_files List of plugin file paths. + * @return array Tree structure for listing plugin files. + */ +function wp_make_plugin_file_tree( $plugin_editable_files ) { + $tree_list = array(); + foreach ( $plugin_editable_files as $plugin_file ) { + $list = explode( '/', preg_replace( '#^.+?/#', '', $plugin_file ) ); + $last_dir = &$tree_list; + foreach ( $list as $dir ) { + $last_dir =& $last_dir[ $dir ]; + } + $last_dir = $plugin_file; + } + return $tree_list; +} + +/** + * Outputs the formatted file list for the plugin editor. + * + * @since 4.9.0 + * @access private + * + * @param array|string $tree List of file/folder paths, or filename. + * @param string $label Name of file or folder to print. + * @param int $level The aria-level for the current iteration. + * @param int $size The aria-setsize for the current iteration. + * @param int $index The aria-posinset for the current iteration. + */ +function wp_print_plugin_file_tree( $tree, $label = '', $level = 2, $size = 1, $index = 1 ) { + global $file, $plugin; + if ( is_array( $tree ) ) { + $index = 0; + $size = count( $tree ); + foreach ( $tree as $label => $plugin_file ) : + $index++; + if ( ! is_array( $plugin_file ) ) { + wp_print_plugin_file_tree( $plugin_file, $label, $level, $index, $size ); + continue; + } + ?> + <li role="treeitem" aria-expanded="true" tabindex="-1" + aria-level="<?php echo esc_attr( $level ); ?>" + aria-setsize="<?php echo esc_attr( $size ); ?>" + aria-posinset="<?php echo esc_attr( $index ); ?>"> + <span class="folder-label"><?php echo esc_html( $label ); ?> <span class="screen-reader-text"><?php _e( 'folder' ); ?></span><span aria-hidden="true" class="icon"></span></span> + <ul role="group" class="tree-folder"><?php wp_print_plugin_file_tree( $plugin_file, '', $level + 1, $index, $size ); ?></ul> + </li> + <?php + endforeach; + } else { + $url = add_query_arg( + array( + 'file' => rawurlencode( $tree ), + 'plugin' => rawurlencode( $plugin ), + ), + self_admin_url( 'plugin-editor.php' ) + ); + ?> + <li role="none" class="<?php echo esc_attr( $file === $tree ? 'current-file' : '' ); ?>"> + <a role="treeitem" tabindex="<?php echo esc_attr( $file === $tree ? '0' : '-1' ); ?>" + href="<?php echo esc_url( $url ); ?>" + aria-level="<?php echo esc_attr( $level ); ?>" + aria-setsize="<?php echo esc_attr( $size ); ?>" + aria-posinset="<?php echo esc_attr( $index ); ?>"> + <?php + if ( $file === $tree ) { + echo '<span class="notice notice-info">' . esc_html( $label ) . '</span>'; + } else { + echo esc_html( $label ); + } + ?> + </a> + </li> + <?php + } +} + +/** + * Flushes rewrite rules if siteurl, home or page_on_front changed. + * + * @since 2.1.0 + * + * @param string $old_value + * @param string $value + */ +function update_home_siteurl( $old_value, $value ) { + if ( wp_installing() ) { + return; + } + + if ( is_multisite() && ms_is_switched() ) { + delete_option( 'rewrite_rules' ); + } else { + flush_rewrite_rules(); + } +} + + +/** + * Resets global variables based on $_GET and $_POST + * + * This function resets global variables based on the names passed + * in the $vars array to the value of $_POST[$var] or $_GET[$var] or '' + * if neither is defined. + * + * @since 2.0.0 + * + * @param array $vars An array of globals to reset. + */ +function wp_reset_vars( $vars ) { + foreach ( $vars as $var ) { + if ( empty( $_POST[ $var ] ) ) { + if ( empty( $_GET[ $var ] ) ) { + $GLOBALS[ $var ] = ''; + } else { + $GLOBALS[ $var ] = $_GET[ $var ]; + } + } else { + $GLOBALS[ $var ] = $_POST[ $var ]; + } + } +} + +/** + * Displays the given administration message. + * + * @since 2.1.0 + * + * @param string|WP_Error $message + */ +function show_message( $message ) { + if ( is_wp_error( $message ) ) { + if ( $message->get_error_data() && is_string( $message->get_error_data() ) ) { + $message = $message->get_error_message() . ': ' . $message->get_error_data(); + } else { + $message = $message->get_error_message(); + } + } + echo "<p>$message</p>\n"; + wp_ob_end_flush_all(); + flush(); +} + +/** + * @since 2.8.0 + * + * @param string $content + * @return array + */ +function wp_doc_link_parse( $content ) { + if ( ! is_string( $content ) || empty( $content ) ) { + return array(); + } + + if ( ! function_exists( 'token_get_all' ) ) { + return array(); + } + + $tokens = token_get_all( $content ); + $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 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' ) ) ) || ( 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]; + } + } + + $functions = array_unique( $functions ); + sort( $functions ); + + /** + * Filters the list of functions and classes to be ignored from the documentation lookup. + * + * @since 2.8.0 + * + * @param string[] $ignore_functions Array of names of functions and classes to be ignored. + */ + $ignore_functions = apply_filters( 'documentation_ignore_functions', $ignore_functions ); + + $ignore_functions = array_unique( $ignore_functions ); + + $out = array(); + foreach ( $functions as $function ) { + if ( in_array( $function, $ignore_functions ) ) { + continue; + } + $out[] = $function; + } + + return $out; +} + +/** + * Saves option for number of rows when listing posts, pages, comments, etc. + * + * @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' ); + + $user = wp_get_current_user(); + if ( ! $user ) { + return; + } + $option = $_POST['wp_screen_options']['option']; + $value = $_POST['wp_screen_options']['value']; + + if ( $option != sanitize_key( $option ) ) { + return; + } + + $map_option = $option; + $type = str_replace( 'edit_', '', $map_option ); + $type = str_replace( '_per_page', '', $type ); + if ( in_array( $type, get_taxonomies() ) ) { + $map_option = 'edit_tags_per_page'; + } elseif ( in_array( $type, get_post_types() ) ) { + $map_option = 'edit_per_page'; + } else { + $option = str_replace( '-', '_', $option ); + } + + 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: + /** + * 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 to the filter will skip saving the current option. + * + * @since 2.8.0 + * + * @see set_screen_options() + * + * @param bool $keep Whether to save or skip saving the screen option value. Default false. + * @param string $option The option name. + * @param int $value The number of rows to use. + */ + $value = apply_filters( 'set-screen-option', false, $option, $value ); // phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores + + if ( false === $value ) { + return; + } + break; + } + + update_user_meta( $user->ID, $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 ); + } + + wp_safe_redirect( $url ); + exit; + } +} + +/** + * Check if rewrite rule for WordPress already exists in the IIS 7+ configuration file + * + * @since 2.8.0 + * + * @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 ( $rules->length == 0 ) { + return false; + } else { + return true; + } +} + +/** + * Delete WordPress rewrite rule from web.config file if it exists there + * + * @since 2.8.0 + * + * @param string $filename Name of the configuration file + * @return bool + */ +function iis7_delete_rewrite_rule( $filename ) { + // If configuration file does not exist then rules also do not exist so there is nothing to delete + if ( ! file_exists( $filename ) ) { + return true; + } + + if ( ! class_exists( 'DOMDocument', false ) ) { + return false; + } + + $doc = new DOMDocument(); + $doc->preserveWhiteSpace = false; + + 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; + $parent->removeChild( $child ); + $doc->formatOutput = true; + saveDomDocument( $doc, $filename ); + } + return true; +} + +/** + * Add 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 + * @return bool + */ +function iis7_add_rewrite_rule( $filename, $rewrite_rule ) { + if ( ! class_exists( 'DOMDocument', false ) ) { + return false; + } + + // If configuration file does not exist then we create one. + if ( ! file_exists( $filename ) ) { + $fp = fopen( $filename, 'w' ); + fwrite( $fp, '<configuration/>' ); + fclose( $fp ); + } + + $doc = new DOMDocument(); + $doc->preserveWhiteSpace = false; + + if ( $doc->load( $filename ) === false ) { + return false; + } + + $xpath = new DOMXPath( $doc ); + + // 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 ); + } else { + $rules_node = $doc->createElement( 'rules' ); + + $xmlnodes = $xpath->query( '/configuration/system.webServer/rewrite' ); + if ( $xmlnodes->length > 0 ) { + $rewrite_node = $xmlnodes->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 ); + } else { + $system_webServer_node = $doc->createElement( 'system.webServer' ); + $system_webServer_node->appendChild( $rewrite_node ); + + $xmlnodes = $xpath->query( '/configuration' ); + if ( $xmlnodes->length > 0 ) { + $config_node = $xmlnodes->item( 0 ); + $config_node->appendChild( $system_webServer_node ); + } else { + $config_node = $doc->createElement( 'configuration' ); + $doc->appendChild( $config_node ); + $config_node->appendChild( $system_webServer_node ); + } + } + } + } + + $rule_fragment = $doc->createDocumentFragment(); + $rule_fragment->appendXML( $rewrite_rule ); + $rules_node->appendChild( $rule_fragment ); + + $doc->encoding = 'UTF-8'; + $doc->formatOutput = true; + saveDomDocument( $doc, $filename ); + + return true; +} + +/** + * Saves the XML document into a file + * + * @since 2.8.0 + * + * @param DOMDocument $doc + * @param string $filename + */ +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' ); + fwrite( $fp, $config ); + fclose( $fp ); +} + +/** + * Display the default admin color scheme picker (Used in user-edit.php) + * + * @since 3.0.0 + * + * @global array $_wp_admin_css_colors + * + * @param int $user_id User ID. + */ +function admin_color_scheme_picker( $user_id ) { + global $_wp_admin_css_colors; + + ksort( $_wp_admin_css_colors ); + + if ( isset( $_wp_admin_css_colors['fresh'] ) ) { + // Set Default ('fresh') and Light should go first. + $_wp_admin_css_colors = array_filter( + array_merge( + array( + 'fresh' => '', + 'light' => '', + ), + $_wp_admin_css_colors + ) + ); + } + + $current_color = get_user_option( 'admin_color', $user_id ); + + if ( empty( $current_color ) || ! isset( $_wp_admin_css_colors[ $current_color ] ) ) { + $current_color = 'fresh'; + } + + ?> + <fieldset id="color-picker" class="scheme-list"> + <legend class="screen-reader-text"><span><?php _e( 'Admin Color Scheme' ); ?></span></legend> + <?php + wp_nonce_field( 'save-color-scheme', 'color-nonce', false ); + foreach ( $_wp_admin_css_colors as $color => $color_info ) : + + ?> + <div class="color-option <?php echo ( $color == $current_color ) ? 'selected' : ''; ?>"> + <input name="admin_color" id="admin_color_<?php echo esc_attr( $color ); ?>" type="radio" value="<?php echo esc_attr( $color ); ?>" class="tog" <?php checked( $color, $current_color ); ?> /> + <input type="hidden" class="css_url" value="<?php echo esc_url( $color_info->url ); ?>" /> + <input type="hidden" class="icon_colors" value="<?php echo esc_attr( wp_json_encode( array( 'icons' => $color_info->icon_colors ) ) ); ?>" /> + <label for="admin_color_<?php echo esc_attr( $color ); ?>"><?php echo esc_html( $color_info->name ); ?></label> + <table class="color-palette"> + <tr> + <?php + + foreach ( $color_info->colors as $html_color ) { + ?> + <td style="background-color: <?php echo esc_attr( $html_color ); ?>"> </td> + <?php + } + + ?> + </tr> + </table> + </div> + <?php + + endforeach; + + ?> + </fieldset> + <?php +} + +/** + * + * @global array $_wp_admin_css_colors + */ +function wp_color_scheme_settings() { + global $_wp_admin_css_colors; + + $color_scheme = get_user_option( 'admin_color' ); + + // It's possible to have a color scheme set that is no longer registered. + if ( empty( $_wp_admin_css_colors[ $color_scheme ] ) ) { + $color_scheme = 'fresh'; + } + + if ( ! empty( $_wp_admin_css_colors[ $color_scheme ]->icon_colors ) ) { + $icon_colors = $_wp_admin_css_colors[ $color_scheme ]->icon_colors; + } elseif ( ! empty( $_wp_admin_css_colors['fresh']->icon_colors ) ) { + $icon_colors = $_wp_admin_css_colors['fresh']->icon_colors; + } else { + // Fall back to the default set of icon colors if the default scheme is missing. + $icon_colors = array( + 'base' => '#a0a5aa', + 'focus' => '#00a0d2', + 'current' => '#fff', + ); + } + + echo '<script type="text/javascript">var _wpColorScheme = ' . wp_json_encode( array( 'icons' => $icon_colors ) ) . ";</script>\n"; +} + +/** + * @since 3.3.0 + */ +function _ipad_meta() { + if ( wp_is_mobile() ) { + ?> + <meta name="viewport" id="viewport-meta" content="width=device-width, initial-scale=1"> + <?php + } +} + +/** + * Check lock status for posts displayed on the Posts screen + * + * @since 3.6.0 + * + * @param array $response The Heartbeat response. + * @param array $data The $_POST data sent. + * @param string $screen_id The screen id. + * @return array The Heartbeat response. + */ +function wp_check_locked_posts( $response, $data, $screen_id ) { + $checked = array(); + + if ( array_key_exists( 'wp-check-locked-posts', $data ) && is_array( $data['wp-check-locked-posts'] ) ) { + foreach ( $data['wp-check-locked-posts'] as $key ) { + $post_id = absint( substr( $key, 5 ) ); + if ( ! $post_id ) { + continue; + } + + $user_id = wp_check_post_lock( $post_id ); + if ( $user_id ) { + $user = get_userdata( $user_id ); + if ( $user && current_user_can( 'edit_post', $post_id ) ) { + $send = array( + /* translators: %s: User's display name. */ + 'text' => sprintf( __( '%s is currently editing' ), $user->display_name ), + ); + + $avatar = get_avatar( $user->ID, 18 ); + if ( $avatar && preg_match( "|src='([^']+)'|", $avatar, $matches ) ) { + $send['avatar_src'] = $matches[1]; + } + + $checked[ $key ] = $send; + } + } + } + } + + if ( ! empty( $checked ) ) { + $response['wp-check-locked-posts'] = $checked; + } + + return $response; +} + +/** + * Check lock status on the New/Edit Post screen and refresh the lock + * + * @since 3.6.0 + * + * @param array $response The Heartbeat response. + * @param array $data The $_POST data sent. + * @param string $screen_id The screen id. + * @return array The Heartbeat response. + */ +function wp_refresh_post_lock( $response, $data, $screen_id ) { + if ( array_key_exists( 'wp-refresh-post-lock', $data ) ) { + $received = $data['wp-refresh-post-lock']; + $send = array(); + + $post_id = absint( $received['post_id'] ); + if ( ! $post_id ) { + return $response; + } + + if ( ! current_user_can( 'edit_post', $post_id ) ) { + return $response; + } + + $user_id = wp_check_post_lock( $post_id ); + $user = get_userdata( $user_id ); + if ( $user ) { + $error = array( + /* translators: %s: User's display name. */ + 'text' => sprintf( __( '%s has taken over and is currently editing.' ), $user->display_name ), + ); + + $avatar = get_avatar( $user->ID, 64 ); + if ( $avatar ) { + if ( preg_match( "|src='([^']+)'|", $avatar, $matches ) ) { + $error['avatar_src'] = $matches[1]; + } + } + + $send['lock_error'] = $error; + } else { + $new_lock = wp_set_post_lock( $post_id ); + if ( $new_lock ) { + $send['new_lock'] = implode( ':', $new_lock ); + } + } + + $response['wp-refresh-post-lock'] = $send; + } + + return $response; +} + +/** + * Check nonce expiration on the New/Edit Post screen and refresh if needed + * + * @since 3.6.0 + * + * @param array $response The Heartbeat response. + * @param array $data The $_POST data sent. + * @param string $screen_id The screen id. + * @return array The Heartbeat response. + */ +function wp_refresh_post_nonces( $response, $data, $screen_id ) { + if ( array_key_exists( 'wp-refresh-post-nonces', $data ) ) { + $received = $data['wp-refresh-post-nonces']; + $response['wp-refresh-post-nonces'] = array( 'check' => 1 ); + + $post_id = absint( $received['post_id'] ); + if ( ! $post_id ) { + return $response; + } + + if ( ! current_user_can( 'edit_post', $post_id ) ) { + return $response; + } + + $response['wp-refresh-post-nonces'] = array( + 'replace' => array( + 'getpermalinknonce' => wp_create_nonce( 'getpermalink' ), + 'samplepermalinknonce' => wp_create_nonce( 'samplepermalink' ), + 'closedpostboxesnonce' => wp_create_nonce( 'closedpostboxes' ), + '_ajax_linking_nonce' => wp_create_nonce( 'internal-linking' ), + '_ |