<?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

* @global bool $is_caddy

*

* @return bool Whether the server supports URL rewriting.

*/

function got_url_rewrite() {

$got_url_rewrite = ( got_mod_rewrite() || $GLOBALS['is_nginx'] || $GLOBALS['is_caddy'] || 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 string[] 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 ( str_contains( $markerline, '# END ' . $marker ) ) {

$state = false;

}

if ( $state ) {

if ( str_starts_with( $markerline, '#' ) ) {

continue;

}

$result[] = $markerline;

}

if ( str_contains( $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;

}

// Make sure the file is created with a minimum set of permissions.

$perms = fileperms( $filename );

if ( $perms ) {

chmod( $filename, $perms | 0644 );

}

} elseif ( ! is_writable( $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 && str_contains( $line, $start_marker ) ) {

$found_marker = true;

continue;

} elseif ( ! $found_end_marker && str_contains( $line, $end_marker ) ) {

$found_end_marker = true;

continue;

}

if ( ! $found_marker ) {

$pre_lines[] = $line;

} elseif ( $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() {

global $wp_rewrite;

if ( is_multisite() ) {

return null;

}

// 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() {

global $wp_rewrite;

if ( is_multisite() ) {

return null;

}

// 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;

}

/**

* Updates the "recently-edited" file for the plugin or theme file editor.

*

* @since 1.5.0

*

* @param string $file Path to the recently edited 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 file 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 file 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

/* translators: Hidden accessibility text. */

_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 file 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 file editor.

*

* @since 4.9.0

* @access private

*

* @global string $file Path to the file being edited.

* @global string $plugin Path to the plugin file relative to the plugins directory.

*

* @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

/* translators: Hidden accessibility text. */

_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 The old value of the option. Unused.

* @param string $value The new value of the option. Unused.

*/

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 an

* empty string 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 The message to display, or a WP_Error object.

*/

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();

}

/**

* Parses the PHP content and finds function calls to be used for documentation linking.

*

* @since 2.8.0

*

* @param string $content The PHP content to parse.

* @return string[] Array of function names.

*/

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' ), true ) )

|| ( 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 );

$output = array();

foreach ( $functions as $function ) {

if ( in_array( $function, $ignore_functions, true ) ) {

continue;

}

$output[] = $function;

}

return $output;

}

/**

* 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'] ) ) {

return;

}

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 ( sanitize_key( $option ) !== $option ) {

return;

}

$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 );

}

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 ( str_ends_with( $option, '_page' ) || '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

}

/**

* 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 );

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;

}

/**

* 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 Whether the rule exists.

*/

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 ) {

return false;

}

return true;

}

/**

* Deletes 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 Whether the rule was deleted.

*/

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;

}

/**

* 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.

* @return bool Whether the rule was added.

*/

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.

$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' );

$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 );

$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_web_server_node = $doc->createElement( 'system.webServer' );

$system_web_server_node->appendChild( $rewrite_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_web_server_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 The DOMDocument object to save.

* @param string $filename The file path to save the XML document to.

*/

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 );

}

/**

* Displays the default administration color scheme picker (Used in user-edit.php).

*

* @since 3.0.0

*

* @global array $_wp_admin_css_colors