<?php

/**
 * Filesystem API: Top-level functionality
 *
 * Functions for reading, writing, modifying, and deleting files on the file system.
 * Includes functionality for theme-specific files as well as operations for uploading,
 * archiving, and rendering output when necessary.
 *
 * @package WordPress
 * @subpackage Filesystem
 * @since 2.3.0
 */


/** The descriptions for theme files. */
$wp_file_descriptions = array(
  'functions.php'         => __( 'Theme Functions' ),
  'header.php'            => __( 'Theme Header' ),
  'footer.php'            => __( 'Theme Footer' ),
  'sidebar.php'           => __( 'Sidebar' ),
  'comments.php'          => __( 'Comments' ),
  'searchform.php'        => __( 'Search Form' ),
  '404.php'               => __( '404 Template' ),
  'link.php'              => __( 'Links Template' ),
  'theme.json'            => __( 'Theme Styles & Block Settings' ),
  // Archives.
  'index.php'             => __( 'Main Index Template' ),
  'archive.php'           => __( 'Archives' ),
  'author.php'            => __( 'Author Template' ),
  'taxonomy.php'          => __( 'Taxonomy Template' ),
  'category.php'          => __( 'Category Template' ),
  'tag.php'               => __( 'Tag Template' ),
  'home.php'              => __( 'Posts Page' ),
  'search.php'            => __( 'Search Results' ),
  'date.php'              => __( 'Date Template' ),
  // Content.
  'singular.php'          => __( 'Singular Template' ),
  'single.php'            => __( 'Single Post' ),
  'page.php'              => __( 'Single Page' ),
  'front-page.php'        => __( 'Homepage' ),
  'privacy-policy.php'    => __( 'Privacy Policy Page' ),
  // Attachments.
  'attachment.php'        => __( 'Attachment Template' ),
  'image.php'             => __( 'Image Attachment Template' ),
  'video.php'             => __( 'Video Attachment Template' ),
  'audio.php'             => __( 'Audio Attachment Template' ),
  'application.php'       => __( 'Application Attachment Template' ),
  // Embeds.
  'embed.php'             => __( 'Embed Template' ),
  'embed-404.php'         => __( 'Embed 404 Template' ),
  'embed-content.php'     => __( 'Embed Content Template' ),
  'header-embed.php'      => __( 'Embed Header Template' ),
  'footer-embed.php'      => __( 'Embed Footer Template' ),
  // Stylesheets.
  'style.css'             => __( 'Stylesheet' ),
  'editor-style.css'      => __( 'Visual Editor Stylesheet' ),
  'editor-style-rtl.css'  => __( 'Visual Editor RTL Stylesheet' ),
  'rtl.css'               => __( 'RTL Stylesheet' ),
  // Other.
  'my-hacks.php'          => __( 'my-hacks.php (legacy hacks support)' ),
  '.htaccess'             => __( '.htaccess (for rewrite rules )' ),
  // Deprecated files.
  'wp-layout.css'         => __( 'Stylesheet' ),
  'wp-comments.php'       => __( 'Comments Template' ),
  'wp-comments-popup.php' => __( 'Popup Comments Template' ),
  'comments-popup.php'    => __( 'Popup Comments' ),
);

/* function get_file_description() – Gets the description for standard WordPress theme files. */

/* function get_home_path() – Gets the absolute filesystem path to the root of the WordPress installation. */

/* function list_files() – Returns a listing of all files in the specified folder and all subdirectories up to 100 levels deep. */

/* function wp_get_plugin_file_editable_extensions() – Gets the list of file extensions that are editable in plugins. */

/* function wp_get_theme_file_editable_extensions() – Gets the list of file extensions that are editable for a given theme. */

/* function wp_print_file_editor_templates() – Print file editor templates (for plugins and themes). */

/* function wp_edit_theme_plugin_file() – Attempts to edit a file for a theme or plugin. */


/* function wp_tempnam() – Returns a filename of a temporary unique file. */

/* function validate_file_to_edit() – Makes sure that the file that was requested to be edited is allowed to be edited. */

/* function _wp_handle_upload() – Handles PHP uploads in WordPress. */
/* function wp_handle_upload_error() – */

/* function wp_handle_upload() – Wrapper for _wp_handle_upload(). */

/* function wp_handle_sideload() – Wrapper for _wp_handle_upload(). */

/* function download_url() – Downloads a URL to a local temporary file using the WordPress HTTP API. */

/* function verify_file_md5() – Calculates and compares the MD5 of a file to its expected value. */

/* function verify_file_signature() – Verifies the contents of a file against its ED25519 signature. */

/* function wp_trusted_keys() – Retrieves the list of signing keys trusted by WordPress. */

/* function unzip_file() – Unzips a specified ZIP file to a location on the filesystem via the WordPress
Filesystem Abstraction. */

/* function _unzip_file_ziparchive() – Attempts to unzip an archive using the ZipArchive class. */

/* function _unzip_file_pclzip() – Attempts to unzip an archive using the PclZip library. */

/* function copy_dir() – Copies a directory from one location to another via the WordPress Filesystem
Abstraction. */

/* function move_dir */

/* function WP_Filesystem() – Initializes and connects the WordPress Filesystem Abstraction classes. */

/* function get_filesystem_method() – Determines which method to use for reading, writing, modifying, or deleting
files on the filesystem. */

/* function request_filesystem_credentials() – Displays a form to the user to request for their FTP/SSH details in order
to connect to the filesystem. */

/* function wp_print_request_filesystem_credentials_modal() – Prints the filesystem credentials modal when needed. */

/* function wp_opcache_invalidate() – Attempts to clear the opcode cache for an individual PHP file. */

/* function wp_opcache_invalidate_directory */