diff --git a/src/wp-admin/comment.php b/src/wp-admin/comment.php index bdd326ecf1..0d6af5f17b 100644 --- a/src/wp-admin/comment.php +++ b/src/wp-admin/comment.php @@ -36,10 +36,10 @@ if ( isset( $_GET['dt'] ) ) { } } -// Prevent actions on a comment associated with a trashed post. $comment_id = absint( $_GET['c'] ); $comment = get_comment( $comment_id ); +// Prevent actions on a comment associated with a trashed post. if ( 'trash' === get_post_status( $comment->comment_post_ID ) ) { wp_die( __( 'You can’t edit this comment because the associated post is in the Trash. Please restore the post first, then try again.' ) diff --git a/src/wp-admin/includes/ajax-actions.php b/src/wp-admin/includes/ajax-actions.php index 5e15ecc784..fbbf4af57e 100644 --- a/src/wp-admin/includes/ajax-actions.php +++ b/src/wp-admin/includes/ajax-actions.php @@ -421,8 +421,8 @@ function wp_ajax_logged_in() { * * Contrary to normal success Ajax response ("1"), die with time() on success. * - * @access private * @since 2.7.0 + * @access private * * @param int $comment_id * @param int $delta @@ -554,8 +554,8 @@ function _wp_ajax_delete_comment_response( $comment_id, $delta = -1 ) { /** * Ajax handler for adding a hierarchical term. * - * @access private * @since 3.1.0 + * @access private */ function _wp_ajax_add_hierarchical_term() { $action = $_POST['action']; @@ -4668,6 +4668,7 @@ function wp_ajax_search_install_plugins() { * Ajax handler for editing a theme or plugin file. * * @since 4.9.0 + * * @see wp_edit_theme_plugin_file() */ function wp_ajax_edit_theme_plugin_file() { diff --git a/src/wp-admin/includes/file.php b/src/wp-admin/includes/file.php index e343e651fc..a483046128 100644 --- a/src/wp-admin/includes/file.php +++ b/src/wp-admin/includes/file.php @@ -1468,9 +1468,10 @@ function unzip_file( $file, $to ) { * Assumes that WP_Filesystem() has already been called and set up. * * @since 3.0.0 - * @see unzip_file() * @access private * + * @see unzip_file() + * * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass. * * @param string $file Full path and filename of ZIP archive. @@ -1599,9 +1600,10 @@ function _unzip_file_ziparchive( $file, $to, $needed_dirs = array() ) { * Assumes that WP_Filesystem() has already been called and set up. * * @since 3.0.0 - * @see unzip_file() * @access private * + * @see unzip_file() + * * @global WP_Filesystem_Base $wp_filesystem WordPress filesystem subclass. * * @param string $file Full path and filename of ZIP archive. diff --git a/src/wp-admin/includes/plugin.php b/src/wp-admin/includes/plugin.php index 426d11df0e..e3af2ce240 100644 --- a/src/wp-admin/includes/plugin.php +++ b/src/wp-admin/includes/plugin.php @@ -542,6 +542,7 @@ function is_plugin_active( $plugin ) { * Conditional Tags} article in the Theme Developer Handbook. * * @since 3.1.0 + * * @see is_plugin_active() * * @param string $plugin Path to the plugin file relative to the plugins directory. diff --git a/src/wp-admin/includes/theme.php b/src/wp-admin/includes/theme.php index 0c917c52d9..b6e44ad9ae 100644 --- a/src/wp-admin/includes/theme.php +++ b/src/wp-admin/includes/theme.php @@ -146,6 +146,7 @@ function _get_template_edit_filename( $fullpath, $containingfolder ) { * Will display link, if there is an update available. * * @since 2.7.0 + * * @see get_theme_update_available() * * @param WP_Theme $theme Theme data object. diff --git a/src/wp-admin/includes/update-core.php b/src/wp-admin/includes/update-core.php index 595ebc053a..935f1a7303 100644 --- a/src/wp-admin/includes/update-core.php +++ b/src/wp-admin/includes/update-core.php @@ -11,6 +11,7 @@ * Stores files to be deleted. * * @since 2.7.0 + * * @global array $_old_files * @var array * @name $_old_files @@ -1314,14 +1315,16 @@ function update_core( $from, $to ) { /** * Copies a directory from one location to another via the WordPress Filesystem Abstraction. + * * Assumes that WP_Filesystem() has already been called and setup. * - * This is a temporary function for the 3.1 -> 3.2 upgrade, as well as for those upgrading to - * 3.7+ + * This is a temporary function for the 3.1 -> 3.2 upgrade, as well as for those + * upgrading to 3.7+. * * @ignore * @since 3.2.0 - * @since 3.7.0 Updated not to use a regular expression for the skip list + * @since 3.7.0 Updated not to use a regular expression for the skip list. + * * @see copy_dir() * * @global WP_Filesystem_Base $wp_filesystem diff --git a/src/wp-content/themes/twentyeleven/inc/theme-options.php b/src/wp-content/themes/twentyeleven/inc/theme-options.php index e0c73202bb..11a54cad48 100644 --- a/src/wp-content/themes/twentyeleven/inc/theme-options.php +++ b/src/wp-content/themes/twentyeleven/inc/theme-options.php @@ -644,6 +644,7 @@ add_action( 'customize_register', 'twentyeleven_customize_register' ); * Render the site title for the selective refresh partial. * * @since Twenty Eleven 2.4 + * * @see twentyeleven_customize_register() * * @return void @@ -656,6 +657,7 @@ function twentyeleven_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Eleven 2.4 + * * @see twentyeleven_customize_register() * * @return void diff --git a/src/wp-content/themes/twentyfifteen/inc/customizer.php b/src/wp-content/themes/twentyfifteen/inc/customizer.php index 9d70b07eda..618b616ec0 100644 --- a/src/wp-content/themes/twentyfifteen/inc/customizer.php +++ b/src/wp-content/themes/twentyfifteen/inc/customizer.php @@ -116,6 +116,7 @@ add_action( 'customize_register', 'twentyfifteen_customize_register', 11 ); * Render the site title for the selective refresh partial. * * @since Twenty Fifteen 1.5 + * * @see twentyfifteen_customize_register() * * @return void @@ -128,6 +129,7 @@ function twentyfifteen_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Fifteen 1.5 + * * @see twentyfifteen_customize_register() * * @return void diff --git a/src/wp-content/themes/twentyfourteen/inc/customizer.php b/src/wp-content/themes/twentyfourteen/inc/customizer.php index 1b48c1bf9a..bcf2e2c6e8 100644 --- a/src/wp-content/themes/twentyfourteen/inc/customizer.php +++ b/src/wp-content/themes/twentyfourteen/inc/customizer.php @@ -98,6 +98,7 @@ add_action( 'customize_register', 'twentyfourteen_customize_register' ); * Render the site title for the selective refresh partial. * * @since Twenty Fourteen 1.7 + * * @see twentyfourteen_customize_register() * * @return void @@ -110,6 +111,7 @@ function twentyfourteen_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Fourteen 1.7 + * * @see twentyfourteen_customize_register() * * @return void diff --git a/src/wp-content/themes/twentyseventeen/functions.php b/src/wp-content/themes/twentyseventeen/functions.php index 1ef1b570a7..6b212b128b 100644 --- a/src/wp-content/themes/twentyseventeen/functions.php +++ b/src/wp-content/themes/twentyseventeen/functions.php @@ -625,6 +625,7 @@ add_filter( 'widget_tag_cloud_args', 'twentyseventeen_widget_tag_cloud_args' ); * but it is unique across the life of the PHP process. * * @since Twenty Seventeen 2.0 + * * @see wp_unique_id() Themes requiring WordPress 5.0.3 and greater should use this instead. * * @staticvar int $id_counter diff --git a/src/wp-content/themes/twentyseventeen/inc/customizer.php b/src/wp-content/themes/twentyseventeen/inc/customizer.php index 9b8243f4bd..1e9c60c9bf 100644 --- a/src/wp-content/themes/twentyseventeen/inc/customizer.php +++ b/src/wp-content/themes/twentyseventeen/inc/customizer.php @@ -197,6 +197,7 @@ function twentyseventeen_sanitize_colorscheme( $input ) { * Render the site title for the selective refresh partial. * * @since Twenty Seventeen 1.0 + * * @see twentyseventeen_customize_register() * * @return void @@ -209,6 +210,7 @@ function twentyseventeen_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Seventeen 1.0 + * * @see twentyseventeen_customize_register() * * @return void diff --git a/src/wp-content/themes/twentysixteen/inc/customizer.php b/src/wp-content/themes/twentysixteen/inc/customizer.php index 41f52667bc..6201f299d5 100644 --- a/src/wp-content/themes/twentysixteen/inc/customizer.php +++ b/src/wp-content/themes/twentysixteen/inc/customizer.php @@ -251,6 +251,7 @@ add_action( 'customize_register', 'twentysixteen_customize_register', 11 ); * Render the site title for the selective refresh partial. * * @since Twenty Sixteen 1.2 + * * @see twentysixteen_customize_register() * * @return void @@ -263,6 +264,7 @@ function twentysixteen_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Sixteen 1.2 + * * @see twentysixteen_customize_register() * * @return void diff --git a/src/wp-content/themes/twentythirteen/functions.php b/src/wp-content/themes/twentythirteen/functions.php index a7a87d8e7e..fad45c14e9 100644 --- a/src/wp-content/themes/twentythirteen/functions.php +++ b/src/wp-content/themes/twentythirteen/functions.php @@ -734,6 +734,7 @@ add_action( 'customize_register', 'twentythirteen_customize_register' ); * Render the site title for the selective refresh partial. * * @since Twenty Thirteen 1.9 + * * @see twentythirteen_customize_register() * * @return void @@ -746,6 +747,7 @@ function twentythirteen_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Thirteen 1.9 + * * @see twentythirteen_customize_register() * * @return void diff --git a/src/wp-content/themes/twentytwelve/functions.php b/src/wp-content/themes/twentytwelve/functions.php index 9c14de24e6..21b1967c71 100644 --- a/src/wp-content/themes/twentytwelve/functions.php +++ b/src/wp-content/themes/twentytwelve/functions.php @@ -651,6 +651,7 @@ add_action( 'customize_register', 'twentytwelve_customize_register' ); * Render the site title for the selective refresh partial. * * @since Twenty Twelve 2.0 + * * @see twentytwelve_customize_register() * * @return void @@ -663,6 +664,7 @@ function twentytwelve_customize_partial_blogname() { * Render the site tagline for the selective refresh partial. * * @since Twenty Twelve 2.0 + * * @see twentytwelve_customize_register() * * @return void diff --git a/src/wp-includes/author-template.php b/src/wp-includes/author-template.php index c1dbf4d5c4..04614c9d99 100644 --- a/src/wp-includes/author-template.php +++ b/src/wp-includes/author-template.php @@ -49,6 +49,7 @@ function get_the_author( $deprecated = '' ) { * return it. However, backward compatibility has to be maintained. * * @since 0.71 + * * @see get_the_author() * @link https://developer.wordpress.org/reference/functions/the_author/ * diff --git a/src/wp-includes/blocks.php b/src/wp-includes/blocks.php index 422b75e945..2e675f1bae 100644 --- a/src/wp-includes/blocks.php +++ b/src/wp-includes/blocks.php @@ -48,6 +48,7 @@ function unregister_block_type( $name ) { * you should use the block parser on post content. * * @since 5.0.0 + * * @see parse_blocks() * * @param int|string|WP_Post|null $post Optional. Post content, post ID, or post object. Defaults to global $post. @@ -72,6 +73,7 @@ function has_blocks( $post = null ) { * you should use the block parser on post content. * * @since 5.0.0 + * * @see parse_blocks() * * @param string $block_name Full Block type to look for. diff --git a/src/wp-includes/category-template.php b/src/wp-includes/category-template.php index aa090d11fe..679bad78d3 100644 --- a/src/wp-includes/category-template.php +++ b/src/wp-includes/category-template.php @@ -11,6 +11,7 @@ * Retrieves category link URL. * * @since 1.0.0 + * * @see get_term_link() * * @param int|object $category Category ID or object. @@ -1117,6 +1118,7 @@ function walk_category_dropdown_tree( ...$args ) { * Retrieves the link to the tag. * * @since 2.3.0 + * * @see get_term_link() * * @param int|object $tag Tag ID or object. diff --git a/src/wp-includes/category.php b/src/wp-includes/category.php index 0e671ffa89..527bc11a77 100644 --- a/src/wp-includes/category.php +++ b/src/wp-includes/category.php @@ -13,6 +13,7 @@ * will be returned instead. * * @since 2.1.0 + * * @see get_terms() Type of arguments that can be changed. * * @param string|array $args { diff --git a/src/wp-includes/class-http.php b/src/wp-includes/class-http.php index 963ed541e4..5260fcf7ba 100644 --- a/src/wp-includes/class-http.php +++ b/src/wp-includes/class-http.php @@ -847,6 +847,7 @@ class WP_Http { * are supported, eg `*.wordpress.org` will allow for all subdomains of `wordpress.org` to be contacted. * * @since 2.8.0 + * * @link https://core.trac.wordpress.org/ticket/8927 Allow preventing external requests. * @link https://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_ACCESSIBLE_HOSTS * diff --git a/src/wp-includes/class-wp-ajax-response.php b/src/wp-includes/class-wp-ajax-response.php index 43772d2610..a45564c306 100644 --- a/src/wp-includes/class-wp-ajax-response.php +++ b/src/wp-includes/class-wp-ajax-response.php @@ -18,6 +18,7 @@ class WP_Ajax_Response { * Constructor - Passes args to WP_Ajax_Response::add(). * * @since 2.1.0 + * * @see WP_Ajax_Response::add() * * @param string|array $args Optional. Will be passed to add() method. diff --git a/src/wp-includes/class-wp-customize-manager.php b/src/wp-includes/class-wp-customize-manager.php index 9d55fb23ac..4c67962856 100644 --- a/src/wp-includes/class-wp-customize-manager.php +++ b/src/wp-includes/class-wp-customize-manager.php @@ -606,6 +606,7 @@ final class WP_Customize_Manager { * enabled, then a new UUID will be generated. * * @since 4.9.0 + * * @global string $pagenow */ public function establish_loaded_changeset() { @@ -737,6 +738,7 @@ final class WP_Customize_Manager { * Gets whether settings are or will be previewed. * * @since 4.9.0 + * * @see WP_Customize_Setting::preview() * * @return bool @@ -749,6 +751,7 @@ final class WP_Customize_Manager { * Gets whether data from a changeset's autosaved revision should be loaded if it exists. * * @since 4.9.0 + * * @see WP_Customize_Manager::changeset_data() * * @return bool Is using autosaved changeset revision. @@ -761,6 +764,7 @@ final class WP_Customize_Manager { * Whether the changeset branching is allowed. * * @since 4.9.0 + * * @see WP_Customize_Manager::establish_loaded_changeset() * * @return bool Is changeset branching. @@ -801,6 +805,7 @@ final class WP_Customize_Manager { * Get the changeset UUID. * * @since 4.7.0 + * * @see WP_Customize_Manager::establish_loaded_changeset() * * @return string UUID. @@ -1946,6 +1951,7 @@ final class WP_Customize_Manager { * Add customize state query params to a given URL if preview is allowed. * * @since 4.7.0 + * * @see wp_redirect() * @see WP_Customize_Manager::get_allowed_url() * @@ -3030,8 +3036,9 @@ final class WP_Customize_Manager { * untouched. * * @since 4.9.0 - * @global wpdb $wpdb WordPress database abstraction object. + * * @see wp_trash_post() + * @global wpdb $wpdb WordPress database abstraction object. * * @param int|WP_Post $post The changeset post. * @return mixed A WP_Post object for the trashed post or an empty value on failure. @@ -3179,6 +3186,7 @@ final class WP_Customize_Manager { * This should be able to be removed once #40922 is addressed in core. * * @since 4.9.0 + * * @link https://core.trac.wordpress.org/ticket/40922 * @see WP_Customize_Manager::save_changeset_post() * @see _wp_translate_postdata() @@ -3407,6 +3415,7 @@ final class WP_Customize_Manager { * invoking this method. * * @since 4.7.0 + * * @see _wp_customize_publish_changeset() * @global wpdb $wpdb WordPress database abstraction object. * diff --git a/src/wp-includes/class-wp-customize-nav-menus.php b/src/wp-includes/class-wp-customize-nav-menus.php index ef152895a8..fd46c1be85 100644 --- a/src/wp-includes/class-wp-customize-nav-menus.php +++ b/src/wp-includes/class-wp-customize-nav-menus.php @@ -1409,6 +1409,7 @@ final class WP_Customize_Nav_Menus { * Keep track of the arguments that are being passed to wp_nav_menu(). * * @since 4.3.0 + * * @see wp_nav_menu() * @see WP_Customize_Widgets::filter_dynamic_sidebar_params() * diff --git a/src/wp-includes/class-wp-customize-setting.php b/src/wp-includes/class-wp-customize-setting.php index 33a7320a08..964191d6b0 100644 --- a/src/wp-includes/class-wp-customize-setting.php +++ b/src/wp-includes/class-wp-customize-setting.php @@ -13,9 +13,9 @@ * Handles saving and sanitizing of settings. * * @since 3.4.0 - * @link https://developer.wordpress.org/themes/customize-api * * @see WP_Customize_Manager + * @link https://developer.wordpress.org/themes/customize-api */ class WP_Customize_Setting { /** diff --git a/src/wp-includes/class-wp-http-encoding.php b/src/wp-includes/class-wp-http-encoding.php index a64253123a..7c2b61068b 100644 --- a/src/wp-includes/class-wp-http-encoding.php +++ b/src/wp-includes/class-wp-http-encoding.php @@ -91,6 +91,7 @@ class WP_Http_Encoding { * https://core.trac.wordpress.org/ticket/18273 * * @since 2.8.1 + * * @link https://core.trac.wordpress.org/ticket/18273 * @link https://www.php.net/manual/en/function.gzinflate.php#70875 * @link https://www.php.net/manual/en/function.gzinflate.php#77336 diff --git a/src/wp-includes/class-wp-query.php b/src/wp-includes/class-wp-query.php index 9f1a1b3fb5..3461239cb7 100644 --- a/src/wp-includes/class-wp-query.php +++ b/src/wp-includes/class-wp-query.php @@ -3378,6 +3378,7 @@ class WP_Query { * Sets up the current comment. * * @since 2.2.0 + * * @global WP_Comment $comment Global comment object. */ public function the_comment() { diff --git a/src/wp-includes/comment.php b/src/wp-includes/comment.php index ed3bc80e9b..d18c462731 100644 --- a/src/wp-includes/comment.php +++ b/src/wp-includes/comment.php @@ -445,6 +445,7 @@ function get_comment_count( $post_id = 0 ) { * Add meta data field to a comment. * * @since 2.9.0 + * * @link https://developer.wordpress.org/reference/functions/add_comment_meta/ * * @param int $comment_id Comment ID. @@ -466,6 +467,7 @@ function add_comment_meta( $comment_id, $meta_key, $meta_value, $unique = false * allows removing all metadata matching key, if needed. * * @since 2.9.0 + * * @link https://developer.wordpress.org/reference/functions/delete_comment_meta/ * * @param int $comment_id Comment ID. @@ -483,6 +485,7 @@ function delete_comment_meta( $comment_id, $meta_key, $meta_value = '' ) { * Retrieve comment meta field for a comment. * * @since 2.9.0 + * * @link https://developer.wordpress.org/reference/functions/get_comment_meta/ * * @param int $comment_id Comment ID. @@ -507,6 +510,7 @@ function get_comment_meta( $comment_id, $key = '', $single = false ) { * If the meta field for the comment does not exist, it will be added. * * @since 2.9.0 + * * @link https://developer.wordpress.org/reference/functions/update_comment_meta/ * * @param int $comment_id Comment ID. @@ -2449,6 +2453,7 @@ function wp_update_comment( $commentarr ) { * updated without having to call wp_update_comment_count() after. * * @since 2.5.0 + * * @staticvar bool $_defer * * @param bool $defer @@ -2480,6 +2485,7 @@ function wp_defer_comment_counting( $defer = null ) { * IDs will be updated along with the current $post_id. * * @since 2.1.0 + * * @see wp_update_comment_count_now() For what could cause a false return value * * @staticvar array $_deferred @@ -3013,6 +3019,7 @@ function weblog_ping( $server = '', $path = '' ) { * Default filter attached to pingback_ping_source_uri to validate the pingback's Source URI * * @since 3.5.1 + * * @see wp_http_validate_url() * * @param string $source_uri @@ -3029,6 +3036,7 @@ function pingback_ping_source_uri( $source_uri ) { * which reports that the pingback is already registered. * * @since 3.5.1 + * * @link https://www.hixie.ch/specs/pingback/pingback#TOC3 * * @param IXR_Error $ixr_error @@ -3127,8 +3135,8 @@ function _prime_comment_caches( $comment_ids, $update_meta_cache = true ) { /** * Close comments on old posts on the fly, without any extra DB queries. Hooked to the_posts. * - * @access private * @since 2.7.0 + * @access private * * @param WP_Post $posts Post data object. * @param WP_Query $query Query object. @@ -3167,8 +3175,8 @@ function _close_comments_for_old_posts( $posts, $query ) { /** * Close comments on an old post. Hooked to comments_open and pings_open. * - * @access private * @since 2.7.0 + * @access private * * @param bool $open Comments open or closed * @param int $post_id Post ID diff --git a/src/wp-includes/customize/class-wp-customize-code-editor-control.php b/src/wp-includes/customize/class-wp-customize-code-editor-control.php index 0e687a2249..c22d6ea036 100644 --- a/src/wp-includes/customize/class-wp-customize-code-editor-control.php +++ b/src/wp-includes/customize/class-wp-customize-code-editor-control.php @@ -65,6 +65,7 @@ class WP_Customize_Code_Editor_Control extends WP_Customize_Control { * Refresh the parameters passed to the JavaScript via JSON. * * @since 4.9.0 + * * @see WP_Customize_Control::json() * * @return array Array of parameters passed to the JavaScript. diff --git a/src/wp-includes/customize/class-wp-customize-custom-css-setting.php b/src/wp-includes/customize/class-wp-customize-custom-css-setting.php index ea0732efc2..f1911c88ec 100644 --- a/src/wp-includes/customize/class-wp-customize-custom-css-setting.php +++ b/src/wp-includes/customize/class-wp-customize-custom-css-setting.php @@ -95,6 +95,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting { * This is used in the preview when `wp_get_custom_css()` is called for rendering the styles. * * @since 4.7.0 + * * @see wp_get_custom_css() * * @param string $css Original CSS. @@ -115,6 +116,7 @@ final class WP_Customize_Custom_CSS_Setting extends WP_Customize_Setting { * Fetch the value of the setting. Will return the previewed value when `preview()` is called. * * @since 4.7.0 + * * @see WP_Customize_Setting::value() * * @return string diff --git a/src/wp-includes/customize/class-wp-customize-date-time-control.php b/src/wp-includes/customize/class-wp-customize-date-time-control.php index 36bd192518..0d88b378bc 100644 --- a/src/wp-includes/customize/class-wp-customize-date-time-control.php +++ b/src/wp-includes/customize/class-wp-customize-date-time-control.php @@ -187,6 +187,7 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control { * Based on touch_time(). * * @since 4.9.0 + * * @see touch_time() * * @global WP_Locale $wp_locale WordPress date and time locale object. @@ -261,6 +262,7 @@ class WP_Customize_Date_Time_Control extends WP_Customize_Control { * Format GMT Offset. * * @since 4.9.0 + * * @see wp_timezone_choice() * * @param float $offset Offset in hours. diff --git a/src/wp-includes/customize/class-wp-customize-partial.php b/src/wp-includes/customize/class-wp-customize-partial.php index 5d8ff42945..be9bccce83 100644 --- a/src/wp-includes/customize/class-wp-customize-partial.php +++ b/src/wp-includes/customize/class-wp-customize-partial.php @@ -97,10 +97,11 @@ class WP_Customize_Partial { * Render callback. * * @since 4.5.0 + * * @see WP_Customize_Partial::render() * @var callable Callback is called with one argument, the instance of - * WP_Customize_Partial. The callback can either echo the - * partial or return the partial as a string, or return false if error. + * WP_Customize_Partial. The callback can either echo the + * partial or return the partial as a string, or return false if error. */ public $render_callback; diff --git a/src/wp-includes/default-constants.php b/src/wp-includes/default-constants.php index 98c8e48369..c7a37cbfbe 100644 --- a/src/wp-includes/default-constants.php +++ b/src/wp-includes/default-constants.php @@ -401,6 +401,7 @@ function wp_templating_constants() { * It will be used as the fallback if the current theme doesn't exist. * * @since 3.0.0 + * * @see WP_Theme::get_core_default_theme() */ if ( ! defined( 'WP_DEFAULT_THEME' ) ) { diff --git a/src/wp-includes/feed.php b/src/wp-includes/feed.php index 3ac76955e1..7c2f8f350d 100644 --- a/src/wp-includes/feed.php +++ b/src/wp-includes/feed.php @@ -18,6 +18,7 @@ * are retrieved for use in the feeds. * * @since 1.5.1 + * * @see get_bloginfo() For the list of possible values to display. * * @param string $show See get_bloginfo() for possible values. @@ -47,6 +48,7 @@ function get_bloginfo_rss( $show = '' ) { * are retrieved for use in the feeds. * * @since 0.71 + * * @see get_bloginfo() For the list of possible values to display. * * @param string $show See get_bloginfo() for possible values. @@ -177,6 +179,7 @@ function the_title_rss() { * Retrieve the post content for feeds. * * @since 2.9.0 + * * @see get_the_content() * * @param string $feed_type The type of feed. rss2 | atom | rss | rdf @@ -427,6 +430,7 @@ function get_the_category_rss( $type = null ) { * Display the post categories in the feed. * * @since 0.71 + * * @see get_the_category_rss() For better explanation. * * @param string $type Optional, default is the type returned by get_default_feed(). @@ -772,6 +776,7 @@ function fetch_feed( $url ) { $feed->set_feed_url( $url ); /** This filter is documented in wp-includes/class-wp-feed-cache-transient.php */ $feed->set_cache_duration( apply_filters( 'wp_feed_cache_transient_lifetime', 12 * HOUR_IN_SECONDS, $url ) ); + /** * Fires just before processing the SimplePie feed object. * @@ -781,6 +786,7 @@ function fetch_feed( $url ) { * @param string|string[] $url URL of feed or array of URLs of feeds to retrieve. */ do_action_ref_array( 'wp_feed_options', array( &$feed, $url ) ); + $feed->init(); $feed->set_output_encoding( get_option( 'blog_charset' ) ); diff --git a/src/wp-includes/link-template.php b/src/wp-includes/link-template.php index ff79bdce93..6f3eb5d031 100644 --- a/src/wp-includes/link-template.php +++ b/src/wp-includes/link-template.php @@ -2123,6 +2123,7 @@ function get_next_post_link( $format = '%link »', $link = '%title', $in_sa * Displays the next post link that is adjacent to the current post. * * @since 1.5.0 + * * @see get_next_post_link() * * @param string $format Optional. Link anchor format. Default '« %link'. diff --git a/src/wp-includes/media.php b/src/wp-includes/media.php index 28be1549ac..1d42822b8f 100644 --- a/src/wp-includes/media.php +++ b/src/wp-includes/media.php @@ -3277,6 +3277,7 @@ function get_attachment_taxonomies( $attachment, $output = 'names' ) { * Handles mime-type-specific taxonomies such as attachment:image and attachment:video. * * @since 3.5.0 + * * @see get_taxonomies() * * @param string $output Optional. The type of taxonomy output to return. Accepts 'names' or 'objects'. diff --git a/src/wp-includes/ms-functions.php b/src/wp-includes/ms-functions.php index 6a75f6bc18..8d0e2b0160 100644 --- a/src/wp-includes/ms-functions.php +++ b/src/wp-includes/ms-functions.php @@ -2200,6 +2200,7 @@ function add_existing_user_to_blog( $details = false ) { * is specifically hooked into the {@see 'wpmu_activate_user'} action. * * @since MU (3.0.0) + * * @see add_user_to_blog() * * @param int $user_id User ID. diff --git a/src/wp-includes/nav-menu.php b/src/wp-includes/nav-menu.php index e786d786db..ed7c98de19 100644 --- a/src/wp-includes/nav-menu.php +++ b/src/wp-includes/nav-menu.php @@ -106,6 +106,7 @@ function register_nav_menus( $locations = array() ) { * Unregisters a navigation menu location for a theme. * * @since 3.1.0 + * * @global array $_wp_registered_nav_menus * * @param string $location The menu location identifier. diff --git a/src/wp-includes/pluggable.php b/src/wp-includes/pluggable.php index 3b99d5e6b2..f3d4e8494c 100644 --- a/src/wp-includes/pluggable.php +++ b/src/wp-includes/pluggable.php @@ -17,6 +17,7 @@ if ( ! function_exists( 'wp_set_current_user' ) ) : * actions on users who aren't signed in. * * @since 2.0.3 + * * @global WP_User $current_user The current user object which holds the user data. * * @param int $id User ID @@ -2370,7 +2371,7 @@ if ( ! function_exists( 'wp_check_password' ) ) : * @since 2.5.0 * * @global PasswordHash $wp_hasher PHPass object used for checking the password - * against the $hash + $password + * against the $hash + $password * @uses PasswordHash::CheckPassword * * @param string $password Plaintext user's password diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php index 6e12c072ba..8ebc3a82f7 100644 --- a/src/wp-includes/post.php +++ b/src/wp-includes/post.php @@ -999,6 +999,7 @@ function _wp_privacy_statuses() { * Arguments prefixed with an _underscore shouldn't be used by plugins and themes. * * @since 3.0.0 + * * @global array $wp_post_statuses Inserts new post status object into the list * * @param string $post_status Name of the post status. diff --git a/src/wp-includes/script-loader.php b/src/wp-includes/script-loader.php index a4f6fac120..a6a8e6d8ce 100644 --- a/src/wp-includes/script-loader.php +++ b/src/wp-includes/script-loader.php @@ -1971,6 +1971,7 @@ function wp_localize_community_events() { * the $_wp_admin_css_colors array value URL. * * @since 2.6.0 + * * @global array $_wp_admin_css_colors * * @param string $src Source URL. @@ -2183,7 +2184,7 @@ function wp_print_footer_scripts() { } /** - * Wrapper for do_action('wp_enqueue_scripts') + * Wrapper for do_action( 'wp_enqueue_scripts' ). * * Allows plugins to queue scripts for the front end using wp_enqueue_script(). * Runs first in wp_head() where all is_home(), is_page(), etc. functions are available. diff --git a/src/wp-includes/theme.php b/src/wp-includes/theme.php index 46317ff4b4..9a122366de 100644 --- a/src/wp-includes/theme.php +++ b/src/wp-includes/theme.php @@ -834,6 +834,7 @@ function switch_theme( $stylesheet ) { * disable this functionality. * * @since 1.5.0 + * * @see WP_DEFAULT_THEME * * @return bool @@ -2817,7 +2818,9 @@ function get_theme_support( $feature, ...$args ) { * be used for child themes to override support from the parent theme. * * @since 3.0.0 + * * @see add_theme_support() + * * @param string $feature The feature being removed. * @return bool|void Whether feature was removed. */ @@ -3240,6 +3243,7 @@ function _wp_customize_publish_changeset( $new_status, $old_status, $changeset_p * transitioned into pending status by a contributor. * * @since 4.7.0 + * * @see wp_insert_post() * * @param array $post_data An array of slashed post data. diff --git a/src/wp-includes/update.php b/src/wp-includes/update.php index a26e15943a..d0c9839755 100644 --- a/src/wp-includes/update.php +++ b/src/wp-includes/update.php @@ -9,11 +9,13 @@ /** * Check WordPress version against the newest version. * - * The WordPress version, PHP version, and Locale is sent. Checks against the - * WordPress server at api.wordpress.org server. Will only check if WordPress - * isn't installing. + * The WordPress version, PHP version, and locale is sent. + * + * Checks against the WordPress server at api.wordpress.org. Will only check + * if WordPress isn't installing. * * @since 2.3.0 + * * @global string $wp_version Used to check against the newest WordPress version. * @global wpdb $wpdb WordPress database abstraction object. * @global string $wp_local_package Locale code of the package. @@ -251,11 +253,13 @@ function wp_version_check( $extra_stats = array(), $force_check = false ) { /** * Check plugin versions against the latest versions hosted on WordPress.org. * - * The WordPress version, PHP version, and Locale is sent along with a list of - * all plugins installed. Checks against the WordPress server at - * api.wordpress.org. Will only check if WordPress isn't installing. + * A list of all plugins installed is sent to WP, along with the site locale. + * + * Checks against the WordPress server at api.wordpress.org. Will only check + * if WordPress isn't installing. * * @since 2.3.0 + * * @global string $wp_version The WordPress version string. * * @param array $extra_stats Extra statistics to report to the WordPress.org API. @@ -442,11 +446,13 @@ function wp_update_plugins( $extra_stats = array() ) { /** * Check theme versions against the latest versions hosted on WordPress.org. * - * A list of all themes installed in sent to WP. Checks against the - * WordPress server at api.wordpress.org. Will only check if WordPress isn't - * installing. + * A list of all themes installed is sent to WP, along with the site locale. + * + * Checks against the WordPress server at api.wordpress.org. Will only check + * if WordPress isn't installing. * * @since 2.7.0 + * * @global string $wp_version The WordPress version string. * * @param array $extra_stats Extra statistics to report to the WordPress.org API. diff --git a/src/wp-includes/user.php b/src/wp-includes/user.php index 8302837f2b..fe2d8498f6 100644 --- a/src/wp-includes/user.php +++ b/src/wp-includes/user.php @@ -803,6 +803,7 @@ function add_user_meta( $user_id, $meta_key, $meta_value, $unique = false ) { * allows removing all metadata matching key, if needed. * * @since 3.0.0 + * * @link https://developer.wordpress.org/reference/functions/delete_user_meta/ * * @param int $user_id User ID @@ -820,6 +821,7 @@ function delete_user_meta( $user_id, $meta_key, $meta_value = '' ) { * Retrieve user meta field for a user. * * @since 3.0.0 + * * @link https://developer.wordpress.org/reference/functions/get_user_meta/ * * @param int $user_id User ID. @@ -844,6 +846,7 @@ function get_user_meta( $user_id, $key = '', $single = false ) { * If the meta field for the user does not exist, it will be added. * * @since 3.0.0 + * * @link https://developer.wordpress.org/reference/functions/update_user_meta/ * * @param int $user_id User ID. @@ -1554,7 +1557,7 @@ function wp_insert_user( $userdata ) { return new WP_Error( 'invalid_user_id', __( 'Invalid user ID.' ) ); } - // hashed in wp_update_user(), plaintext if called directly. + // Hashed in wp_update_user(), plaintext if called directly. $user_pass = ! empty( $userdata['user_pass'] ) ? $userdata['user_pass'] : $old_user_data->user_pass; } else { $update = false; @@ -2163,7 +2166,8 @@ All at ###SITENAME### * complex user creation use wp_insert_user() to specify more information. * * @since 2.0.0 - * @see wp_insert_user() More complete way to create a new user + * + * @see wp_insert_user() More complete way to create a new user. * * @param string $username The user's username. * @param string $password The user's password. @@ -2629,6 +2633,7 @@ function wp_get_session_token() { * Retrieve a list of sessions for the current user. * * @since 4.0.0 + * * @return array Array of sessions. */ function wp_get_all_sessions() {