diff --git a/wp-admin/includes/plugin.php b/wp-admin/includes/plugin.php index 792b2a63d8..2dd58b3354 100644 --- a/wp-admin/includes/plugin.php +++ b/wp-admin/includes/plugin.php @@ -430,13 +430,17 @@ function _get_dropins() { } /** - * Check whether a plugin is active. + * Determines whether a plugin is active. * * Only plugins installed in the plugins/ folder can be active. * * Plugins in the mu-plugins/ folder can't be "activated," so this function will * return false for those plugins. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.5.0 * * @param string $plugin Path to the main plugin file from plugins directory. @@ -447,10 +451,14 @@ function is_plugin_active( $plugin ) { } /** - * Check whether the plugin is inactive. + * Determines whether the plugin is inactive. * * Reverse of is_plugin_active(). Used as a callback. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.1.0 * @see is_plugin_active() * @@ -462,17 +470,21 @@ function is_plugin_inactive( $plugin ) { } /** - * Check whether the plugin is active for the entire network. + * Determines whether the plugin is active for the entire network. * * Only plugins installed in the plugins/ folder can be active. * * Plugins in the mu-plugins/ folder can't be "activated," so this function will * return false for those plugins. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.0.0 * * @param string $plugin Path to the main plugin file from plugins directory. - * @return bool True, if active for the network, otherwise false. + * @return bool True if active for the network, otherwise false. */ function is_plugin_active_for_network( $plugin ) { if ( !is_multisite() ) diff --git a/wp-includes/admin-bar.php b/wp-includes/admin-bar.php index 1be7034a40..d2156e4cca 100644 --- a/wp-includes/admin-bar.php +++ b/wp-includes/admin-bar.php @@ -985,8 +985,12 @@ function show_admin_bar( $show ) { } /** - * Determine whether the admin bar should be showing. - * + * Determines whether the admin bar should be showing. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.1.0 * * @global bool $show_admin_bar diff --git a/wp-includes/author-template.php b/wp-includes/author-template.php index 4baf681479..f3efee133e 100644 --- a/wp-includes/author-template.php +++ b/wp-includes/author-template.php @@ -503,10 +503,14 @@ function wp_list_authors( $args = '' ) { } /** - * Does this site have more than one author + * Determines whether this site has more than one author. * * Checks to see if more than one author has published posts. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.2.0 * * @global wpdb $wpdb WordPress database abstraction object. diff --git a/wp-includes/category-template.php b/wp-includes/category-template.php index e090fac264..83cb24c7e1 100644 --- a/wp-includes/category-template.php +++ b/wp-includes/category-template.php @@ -212,7 +212,7 @@ function get_the_category_list( $separator = '', $parents = '', $post_id = false } /** - * Check if the current post is within any of the given categories. + * Checks if the current post is within any of the given categories. * * The given categories are checked against the post's categories' term_ids, names and slugs. * Categories given as integers will only be checked against the post's categories' term_ids. @@ -222,6 +222,10 @@ function get_the_category_list( $separator = '', $parents = '', $post_id = false * Prior to v2.7, only one category could be compared: in_category( $single_category ). * Prior to v2.7, this function could only be used in the WordPress Loop. * As of 2.7, the function can be used anywhere if it is provided a post ID or post object. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.2.0 * @@ -1367,7 +1371,7 @@ function has_category( $category = '', $post = null ) { } /** - * Check if the current post has any of given tags. + * Checks if the current post has any of given tags. * * The given tags are checked against the post's tags' term_ids, names and slugs. * Tags given as integers will only be checked against the post's tags' term_ids. @@ -1376,6 +1380,10 @@ function has_category( $category = '', $post = null ) { * Prior to v2.7 of WordPress, tags given as integers would also be checked against the post's tags' names and slugs (in addition to term_ids) * Prior to v2.7, this function could only be used in the WordPress Loop. * As of 2.7, the function can be used anywhere if it is provided a post ID or post object. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.6.0 * diff --git a/wp-includes/comment-template.php b/wp-includes/comment-template.php index 5bcbcd674e..c44514738c 100644 --- a/wp-includes/comment-template.php +++ b/wp-includes/comment-template.php @@ -1181,8 +1181,12 @@ function trackback_rdf( $deprecated = '' ) { } /** - * Whether the current post is open for comments. - * + * Determines whether the current post is open for comments. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @param int|WP_Post $post_id Post ID or WP_Post object. Default current post. @@ -1207,7 +1211,11 @@ function comments_open( $post_id = null ) { } /** - * Whether the current post is open for pings. + * Determines whether the current post is open for pings. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.5.0 * diff --git a/wp-includes/deprecated.php b/wp-includes/deprecated.php index 0b3ce28d33..89203d764c 100644 --- a/wp-includes/deprecated.php +++ b/wp-includes/deprecated.php @@ -2508,10 +2508,14 @@ function is_term( $term, $taxonomy = '', $parent = 0 ) { } /** - * Is the current admin page generated by a plugin? + * Determines whether the current admin page is generated by a plugin. * * Use global $plugin_page and/or get_plugin_page_hookname() hooks. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * @deprecated 3.1.0 * @@ -3713,8 +3717,12 @@ function get_comments_popup_template() { } /** - * Whether the current URL is within the comments popup window. - * + * Determines whether the current URL is within the comments popup window. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * @deprecated 4.5.0 * diff --git a/wp-includes/functions.php b/wp-includes/functions.php index e8751414e4..c44685e604 100644 --- a/wp-includes/functions.php +++ b/wp-includes/functions.php @@ -654,9 +654,13 @@ function wp_get_http_headers( $url, $deprecated = false ) { } /** - * Whether the publish date of the current post in the loop is different from the - * publish date of the previous post in the loop. - * + * Determines whether the publish date of the current post in the loop is different + * from the publish date of the previous post in the loop. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 0.71 * * @global string $currentday The day of the current post in the loop. @@ -1340,13 +1344,17 @@ function do_robots() { } /** - * Test whether WordPress is already installed. + * Determines whether WordPress is already installed. * * The cache will be checked first. If you have a cache plugin, which saves * the cache values, then this will work. If you use the default WordPress * cache, and the database goes away, then you might have problems. * * Checks for the 'siteurl' option for whether WordPress is installed. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.1.0 * diff --git a/wp-includes/functions.wp-scripts.php b/wp-includes/functions.wp-scripts.php index d7b5d1d0d6..efe82d9774 100644 --- a/wp-includes/functions.wp-scripts.php +++ b/wp-includes/functions.wp-scripts.php @@ -329,8 +329,12 @@ function wp_dequeue_script( $handle ) { } /** - * Check whether a script has been added to the queue. - * + * Determines whether a script has been added to the queue. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.8.0 * @since 3.5.0 'enqueued' added as an alias of the 'queue' list. * diff --git a/wp-includes/l10n.php b/wp-includes/l10n.php index 56996bdc94..8df78717d5 100644 --- a/wp-includes/l10n.php +++ b/wp-includes/l10n.php @@ -1385,7 +1385,11 @@ function wp_dropdown_languages( $args = array() ) { } /** - * Checks if current locale is RTL. + * Determines whether the current locale is right-to-left (RTL). + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 3.0.0 * diff --git a/wp-includes/load.php b/wp-includes/load.php index 3551daf6da..64e4e447cb 100644 --- a/wp-includes/load.php +++ b/wp-includes/load.php @@ -701,11 +701,15 @@ function wp_clone( $object ) { } /** - * Whether the current request is for an administrative interface page. + * Determines whether the current request is for an administrative interface page. * * Does not check if the user is an administrator; current_user_can() * for checking roles and capabilities. * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.1 * * @global WP_Screen $current_screen diff --git a/wp-includes/pluggable.php b/wp-includes/pluggable.php index dda43ce658..0fc242a6b7 100644 --- a/wp-includes/pluggable.php +++ b/wp-includes/pluggable.php @@ -975,7 +975,11 @@ endif; if ( !function_exists('is_user_logged_in') ) : /** - * Checks if the current visitor is a logged in user. + * Determines whether the current visitor is a logged in user. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.0.0 * diff --git a/wp-includes/post-template.php b/wp-includes/post-template.php index 9ff1d08ea4..91c2d8f660 100644 --- a/wp-includes/post-template.php +++ b/wp-includes/post-template.php @@ -398,7 +398,11 @@ function get_the_excerpt( $post = null ) { } /** - * Whether the post has a custom excerpt. + * Determines whether the post has a custom excerpt. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.3.0 * @@ -1630,12 +1634,16 @@ function get_the_password_form( $post = 0 ) { } /** - * Whether currently in a page template. + * Determines whether currently in a page template. * * This template tag allows you to determine if you are in a page template. * You can optionally provide a template name or array of template names * and then the check will be specific to that template. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.5.0 * @since 4.2.0 The `$template` parameter was changed to also accept an array of page templates. * @since 4.7.0 Now works with any post type, not just pages. diff --git a/wp-includes/post-thumbnail-template.php b/wp-includes/post-thumbnail-template.php index 0dbe74aad6..3e72bb1395 100644 --- a/wp-includes/post-thumbnail-template.php +++ b/wp-includes/post-thumbnail-template.php @@ -10,7 +10,11 @@ */ /** - * Check if post has an image attached. + * Determines whether a post has an image attached. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.9.0 * @since 4.4.0 `$post` can be a post ID or WP_Post object. diff --git a/wp-includes/post.php b/wp-includes/post.php index 89b76184c3..9f2a404b30 100644 --- a/wp-includes/post.php +++ b/wp-includes/post.php @@ -999,7 +999,11 @@ function is_post_type_hierarchical( $post_type ) { } /** - * Check if a post type is registered. + * Determines whether a post type is registered. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 3.0.0 * @@ -2018,11 +2022,15 @@ function get_post_custom_values( $key = '', $post_id = 0 ) { } /** - * Check if post is sticky. + * Determines whether a post is sticky. * * Sticky posts should remain at the top of The Loop. If the post ID is not * given, then The Loop ID for the current post will be used. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.7.0 * * @param int $post_id Optional. Post ID. Default is ID of the global $post. @@ -4990,8 +4998,12 @@ function get_pages( $args = array() ) { // /** - * Check if the attachment URI is local one and is really an attachment. - * + * Determines whether an attachment URI is local and really an attachment. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.0.0 * * @param string $url URL to check @@ -5487,7 +5499,11 @@ function wp_attachment_is( $type, $post = null ) { } /** - * Checks if the attachment is an image. + * Determines whether an attachment is an image. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.1.0 * @since 4.2.0 Modified into wrapper for wp_attachment_is() and diff --git a/wp-includes/query.php b/wp-includes/query.php index 7df90a963e..8192090478 100644 --- a/wp-includes/query.php +++ b/wp-includes/query.php @@ -136,10 +136,14 @@ function wp_reset_postdata() { */ /** - * Is the query for an existing archive page? + * Determines whether the query is for an existing archive page. * * Month, Year, Category, Author, Post Type archive... - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -158,8 +162,12 @@ function is_archive() { } /** - * Is the query for an existing post type archive page? - * + * Determines whether the query is for an existing post type archive page. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.1.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -179,8 +187,12 @@ function is_post_type_archive( $post_types = '' ) { } /** - * Is the query for an existing attachment page? - * + * Determines whether the query is for an existing attachment page. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.0.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -200,11 +212,15 @@ function is_attachment( $attachment = '' ) { } /** - * Is the query for an existing author archive page? + * Determines whether the query is for an existing author archive page. * * If the $author parameter is specified, this function will additionally * check if the query is for one of the authors specified. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -224,11 +240,15 @@ function is_author( $author = '' ) { } /** - * Is the query for an existing category archive page? + * Determines whether the query is for an existing category archive page. * * If the $category parameter is specified, this function will additionally * check if the query is for one of the categories specified. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -248,10 +268,14 @@ function is_category( $category = '' ) { } /** - * Is the query for an existing tag archive page? + * Determines whether the query is for an existing tag archive page. * * If the $tag parameter is specified, this function will additionally * check if the query is for one of the tags specified. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.3.0 * @@ -272,7 +296,7 @@ function is_tag( $tag = '' ) { } /** - * Is the query for an existing custom taxonomy archive page? + * Determines whether the query is for an existing custom taxonomy archive page. * * If the $taxonomy parameter is specified, this function will additionally * check if the query is for that specific $taxonomy. @@ -280,6 +304,10 @@ function is_tag( $tag = '' ) { * If the $term parameter is specified in addition to the $taxonomy parameter, * this function will additionally check if the query is for one of the terms * specified. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.5.0 * @@ -301,8 +329,12 @@ function is_tax( $taxonomy = '', $term = '' ) { } /** - * Is the query for an existing date archive? - * + * Determines whether the query is for an existing date archive. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -321,7 +353,11 @@ function is_date() { } /** - * Is the query for an existing day archive? + * Determines whether the query is for an existing day archive. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.5.0 * @@ -341,8 +377,12 @@ function is_day() { } /** - * Is the query for a feed? - * + * Determines whether the query is for a feed. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -382,7 +422,7 @@ function is_comment_feed() { } /** - * Is the query for the front page of the site? + * Determines whether the query is for the front page of the site. * * This is for what is displayed at your site's main URL. * @@ -392,7 +432,11 @@ function is_comment_feed() { * true when viewing that page. * * Otherwise the same as @see is_home() - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -411,7 +455,7 @@ function is_front_page() { } /** - * Determines if the query is for the blog homepage. + * Determines whether the query is for the blog homepage. * * The blog homepage is the page that shows the time-based blog content of the site. * @@ -420,7 +464,11 @@ function is_front_page() { * * If a static page is set for the front page of the site, this function will return true only * on the page you set as the "Posts page". - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @see is_front_page() @@ -440,8 +488,12 @@ function is_home() { } /** - * Is the query for an existing month archive? - * + * Determines whether the query is for an existing month archive. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -460,11 +512,15 @@ function is_month() { } /** - * Is the query for an existing single page? + * Determines whether the query is for an existing single page. * * If the $page parameter is specified, this function will additionally * check if the query is for one of the pages specified. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @see is_single() * @see is_singular() * @@ -487,8 +543,12 @@ function is_page( $page = '' ) { } /** - * Is the query for paged result and not for the first page? - * + * Determines whether the query is for paged results and not for the first page. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -507,8 +567,12 @@ function is_paged() { } /** - * Is the query for a post or page preview? - * + * Determines whether the query is for a post or page preview. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.0.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -547,8 +611,12 @@ function is_robots() { } /** - * Is the query for a search? - * + * Determines whether the query is for a search. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -567,13 +635,17 @@ function is_search() { } /** - * Is the query for an existing single post? + * Determines whether the query is for an existing single post. * * Works for any post type, except attachments and pages * * If the $post parameter is specified, this function will additionally * check if the query is for one of the Posts specified. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @see is_page() * @see is_singular() * @@ -596,12 +668,16 @@ function is_single( $post = '' ) { } /** - * Is the query for an existing single post of any post type (post, attachment, page, - * custom post types)? + * Determines whether the query is for an existing single post of any post type + * (post, attachment, page, custom post types). * * If the $post_types parameter is specified, this function will additionally * check if the query is for one of the Posts Types specified. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @see is_page() * @see is_single() * @@ -624,7 +700,11 @@ function is_singular( $post_types = '' ) { } /** - * Is the query for a specific time? + * Determines whether the query is for a specific time. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.5.0 * @@ -644,7 +724,11 @@ function is_time() { } /** - * Is the query for a trackback endpoint call? + * Determines whether the query is for a trackback endpoint call. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.5.0 * @@ -664,7 +748,11 @@ function is_trackback() { } /** - * Is the query for an existing year archive? + * Determines whether the query is for an existing year archive. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 1.5.0 * @@ -684,8 +772,12 @@ function is_year() { } /** - * Is the query a 404 (returns no results)? - * + * Determines whether the query has resulted in a 404 (returns no results). + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 1.5.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -724,8 +816,12 @@ function is_embed() { } /** - * Is the query the main query? - * + * Determines whether the query is the main query. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 3.3.0 * * @global WP_Query $wp_query Global WP_Query instance. @@ -768,7 +864,11 @@ function have_posts() { } /** - * Whether the caller is in the Loop. + * Determines whether the caller is in the Loop. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.0.0 * diff --git a/wp-includes/taxonomy.php b/wp-includes/taxonomy.php index a612df26b4..5bf03fcb35 100644 --- a/wp-includes/taxonomy.php +++ b/wp-includes/taxonomy.php @@ -242,9 +242,13 @@ function get_taxonomy( $taxonomy ) { } /** - * Checks that the taxonomy name exists. + * Determines whether the taxonomy name exists. * * Formerly is_taxonomy(), introduced in 2.3.0. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 3.0.0 * @@ -260,12 +264,16 @@ function taxonomy_exists( $taxonomy ) { } /** - * Whether the taxonomy object is hierarchical. + * Determines whether the taxonomy object is hierarchical. * * Checks to make sure that the taxonomy is an object first. Then Gets the * object, and finally returns the hierarchical value in the object. * * A false return value might also mean that the taxonomy does not exist. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.3.0 * @@ -1265,9 +1273,13 @@ function unregister_term_meta( $taxonomy, $meta_key ) { } /** - * Check if Term exists. + * Determines whether a term exists. * * Formerly is_term(), introduced in 2.3.0. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 3.0.0 * diff --git a/wp-includes/user.php b/wp-includes/user.php index ef3bc57dea..02f64eead5 100644 --- a/wp-includes/user.php +++ b/wp-includes/user.php @@ -1314,7 +1314,11 @@ function clean_user_cache( $user ) { } /** - * Checks whether the given username exists. + * Determines whether the given username exists. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.0.0 * @@ -1340,7 +1344,11 @@ function username_exists( $username ) { } /** - * Checks whether the given email exists. + * Determines whether the given email exists. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. * * @since 2.1.0 * diff --git a/wp-includes/version.php b/wp-includes/version.php index 3a3af70864..876bc0139e 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -4,7 +4,7 @@ * * @global string $wp_version */ -$wp_version = '5.0-beta1-43826'; +$wp_version = '5.0-beta1-43827'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. diff --git a/wp-includes/widgets.php b/wp-includes/widgets.php index 683c7ab913..c86de84cb7 100644 --- a/wp-includes/widgets.php +++ b/wp-includes/widgets.php @@ -775,7 +775,7 @@ function dynamic_sidebar( $index = 1 ) { } /** - * Whether widget is displayed on the front end. + * Determines whether a given widget is displayed on the front end. * * Either $callback or $id_base can be used * $id_base is the first argument when extending WP_Widget class @@ -786,7 +786,11 @@ function dynamic_sidebar( $index = 1 ) { * * NOTE: $widget_id and $id_base are the same for single widgets. To be effective * this function has to run after widgets have initialized, at action {@see 'init'} or later. - * + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.2.0 * * @global array $wp_registered_widgets @@ -822,8 +826,12 @@ function is_active_widget( $callback = false, $widget_id = false, $id_base = fal } /** - * Whether the dynamic sidebar is enabled and used by theme. - * + * Determines whether the dynamic sidebar is enabled and used by the theme. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.2.0 * * @global array $wp_registered_widgets @@ -845,8 +853,12 @@ function is_dynamic_sidebar() { } /** - * Whether a sidebar is in use. - * + * Determines whether a sidebar is in use. + * + * For more information on this and similar theme functions, check out + * the {@link https://developer.wordpress.org/themes/basics/conditional-tags/ + * Conditional Tags} article in the Theme Developer Handbook. + * * @since 2.8.0 * * @param string|int $index Sidebar name, id or number to check.