Docs: Replace "html" and "xhtml" instances in DocBlocks and comments with "HTML" and "XHTML".
This ensures consistent capitalization where appropriate. Props navidos, desrosj. Fixes #50473. Built from https://develop.svn.wordpress.org/trunk@48199 git-svn-id: http://core.svn.wordpress.org/trunk@47968 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
parent
c892c420b7
commit
3336009e34
|
@ -169,7 +169,7 @@ function get_image_send_to_editor( $id, $caption, $title, $align, $url = '', $re
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Adds image shortcode with caption to editor
|
* Adds image shortcode with caption to editor.
|
||||||
*
|
*
|
||||||
* @since 2.6.0
|
* @since 2.6.0
|
||||||
*
|
*
|
||||||
|
@ -248,7 +248,7 @@ function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Private preg_replace callback used in image_add_caption()
|
* Private preg_replace callback used in image_add_caption().
|
||||||
*
|
*
|
||||||
* @access private
|
* @access private
|
||||||
* @since 3.4.0
|
* @since 3.4.0
|
||||||
|
@ -259,7 +259,7 @@ function _cleanup_image_add_caption( $matches ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Adds image html to editor
|
* Adds image HTML to editor.
|
||||||
*
|
*
|
||||||
* @since 2.5.0
|
* @since 2.5.0
|
||||||
*
|
*
|
||||||
|
@ -276,15 +276,15 @@ function media_send_to_editor( $html ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Save a file submitted from a POST request and create an attachment post for it.
|
* Saves a file submitted from a POST request and create an attachment post for it.
|
||||||
*
|
*
|
||||||
* @since 2.5.0
|
* @since 2.5.0
|
||||||
*
|
*
|
||||||
* @param string $file_id Index of the `$_FILES` array that the file was sent. Required.
|
* @param string $file_id Index of the `$_FILES` array that the file was sent. Required.
|
||||||
* @param int $post_id The post ID of a post to attach the media item to. Required, but can
|
* @param int $post_id The post ID of a post to attach the media item to. Required, but can
|
||||||
* be set to 0, creating a media item that has no relationship to a post.
|
* be set to 0, creating a media item that has no relationship to a post.
|
||||||
* @param array $post_data Overwrite some of the attachment. Optional.
|
* @param array $post_data Optional. Overwrite some of the attachment.
|
||||||
* @param array $overrides Override the wp_handle_upload() behavior. Optional.
|
* @param array $overrides Optional. Override the wp_handle_upload() behavior.
|
||||||
* @return int|WP_Error ID of the attachment or a WP_Error object on failure.
|
* @return int|WP_Error ID of the attachment or a WP_Error object on failure.
|
||||||
*/
|
*/
|
||||||
function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) {
|
function media_handle_upload( $file_id, $post_id, $post_data = array(), $overrides = array( 'test_form' => false ) ) {
|
||||||
|
|
|
@ -923,7 +923,7 @@ function parent_dropdown( $default = 0, $parent = 0, $level = 0, $post = null )
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Print out option html elements for role selectors.
|
* Print out option HTML elements for role selectors.
|
||||||
*
|
*
|
||||||
* @since 2.1.0
|
* @since 2.1.0
|
||||||
*
|
*
|
||||||
|
@ -1566,7 +1566,7 @@ function add_settings_section( $id, $title, $callback, $page ) {
|
||||||
* do_settings_fields() in do_settings-sections()
|
* do_settings_fields() in do_settings-sections()
|
||||||
*
|
*
|
||||||
* The $callback argument should be the name of a function that echoes out the
|
* The $callback argument should be the name of a function that echoes out the
|
||||||
* html input tags for this setting field. Use get_option() to retrieve existing
|
* HTML input tags for this setting field. Use get_option() to retrieve existing
|
||||||
* values to show.
|
* values to show.
|
||||||
*
|
*
|
||||||
* @since 2.7.0
|
* @since 2.7.0
|
||||||
|
@ -1918,7 +1918,7 @@ function find_posts_div( $found_action = '' ) {
|
||||||
/**
|
/**
|
||||||
* Displays the post password.
|
* Displays the post password.
|
||||||
*
|
*
|
||||||
* The password is passed through esc_attr() to ensure that it is safe for placing in an html attribute.
|
* The password is passed through esc_attr() to ensure that it is safe for placing in an HTML attribute.
|
||||||
*
|
*
|
||||||
* @since 2.7.0
|
* @since 2.7.0
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -70,7 +70,7 @@ function twentytwenty_site_logo( $args = array(), $echo = true ) {
|
||||||
/**
|
/**
|
||||||
* Filters the arguments for `twentytwenty_site_logo()`.
|
* Filters the arguments for `twentytwenty_site_logo()`.
|
||||||
*
|
*
|
||||||
* @param string $html Compiled html based on our arguments.
|
* @param string $html Compiled HTML based on our arguments.
|
||||||
* @param array $args Parsed arguments.
|
* @param array $args Parsed arguments.
|
||||||
* @param string $classname Class name based on current view, home or single.
|
* @param string $classname Class name based on current view, home or single.
|
||||||
* @param string $contents HTML for site title or logo.
|
* @param string $contents HTML for site title or logo.
|
||||||
|
@ -103,7 +103,7 @@ function twentytwenty_site_description( $echo = true ) {
|
||||||
$html = sprintf( $wrapper, esc_html( $description ) );
|
$html = sprintf( $wrapper, esc_html( $description ) );
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filters the html for the site description.
|
* Filters the HTML for the site description.
|
||||||
*
|
*
|
||||||
* @since Twenty Twenty 1.0
|
* @since Twenty Twenty 1.0
|
||||||
*
|
*
|
||||||
|
@ -326,7 +326,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
|
||||||
<?php
|
<?php
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Fires before post meta html display.
|
* Fires before post meta HTML display.
|
||||||
*
|
*
|
||||||
* Allow output of additional post meta info to be added by child themes and plugins.
|
* Allow output of additional post meta info to be added by child themes and plugins.
|
||||||
*
|
*
|
||||||
|
@ -453,7 +453,7 @@ function twentytwenty_get_post_meta( $post_id = null, $location = 'single-top' )
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Fires after post meta html display.
|
* Fires after post meta HTML display.
|
||||||
*
|
*
|
||||||
* Allow output of additional post meta info to be added by child themes and plugins.
|
* Allow output of additional post meta info to be added by child themes and plugins.
|
||||||
*
|
*
|
||||||
|
|
|
@ -55,7 +55,7 @@ class WP_Ajax_Response {
|
||||||
* @type int|false $old_id The previous response ID. Used as the value for the response type
|
* @type int|false $old_id The previous response ID. Used as the value for the response type
|
||||||
* `old_id` attribute. False hides the attribute. Default false.
|
* `old_id` attribute. False hides the attribute. Default false.
|
||||||
* @type string $position Value of the response type `position` attribute. Accepts 1 (bottom),
|
* @type string $position Value of the response type `position` attribute. Accepts 1 (bottom),
|
||||||
* -1 (top), html ID (after), or -html ID (before). Default 1 (bottom).
|
* -1 (top), HTML ID (after), or -HTML ID (before). Default 1 (bottom).
|
||||||
* @type string|WP_Error $data The response content/message. Also accepts a WP_Error object if the
|
* @type string|WP_Error $data The response content/message. Also accepts a WP_Error object if the
|
||||||
* ID does not exist. Default empty.
|
* ID does not exist. Default empty.
|
||||||
* @type array $supplemental An array of extra strings that will be output within a `<supplemental>`
|
* @type array $supplemental An array of extra strings that will be output within a `<supplemental>`
|
||||||
|
|
|
@ -1127,7 +1127,7 @@ final class WP_Customize_Nav_Menus {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Print the html template used to render the add-menu-item frame.
|
* Print the HTML template used to render the add-menu-item frame.
|
||||||
*
|
*
|
||||||
* @since 4.3.0
|
* @since 4.3.0
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -2734,7 +2734,7 @@ function discover_pingback_server_uri( $url, $deprecated = '' ) {
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
// Now do a GET since we're going to look in the html headers (and we're sure it's not a binary file).
|
// Now do a GET since we're going to look in the HTML headers (and we're sure it's not a binary file).
|
||||||
$response = wp_safe_remote_get(
|
$response = wp_safe_remote_get(
|
||||||
$url,
|
$url,
|
||||||
array(
|
array(
|
||||||
|
|
|
@ -379,18 +379,23 @@ function user_can_edit_user($user_id, $other_user) {
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param string $cat_name Optional. The category name to use. If no match is found uses all.
|
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
|
||||||
* @param string $before Optional. The html to output before the link.
|
* Default 'noname'.
|
||||||
* @param string $after Optional. The html to output after the link.
|
* @param string $before Optional. The HTML to output before the link. Default empty.
|
||||||
* @param string $between Optional. The html to output between the link/image and its description. Not used if no image or $show_images is true.
|
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
|
||||||
* @param bool $show_images Optional. Whether to show images (if defined).
|
* @param string $between Optional. The HTML to output between the link/image and its description.
|
||||||
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url', 'description' or 'rating'. Or maybe owner.
|
* Not used if no image or $show_images is true. Default ' '.
|
||||||
* If you start the name with an underscore the order will be reversed. You can also specify 'rand' as the order which will return links in a
|
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
|
||||||
* random order.
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
|
* 'description', 'rating', or 'owner'. Default 'id'.
|
||||||
* @param bool $show_rating Optional. Show rating stars/chars.
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
* @param int $show_updated Optional. Whether to show last updated timestamp
|
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
|
||||||
|
* Default true.
|
||||||
|
* @param bool $show_rating Optional. Show rating stars/chars. Default false.
|
||||||
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default -1.
|
||||||
|
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
|
||||||
*/
|
*/
|
||||||
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
|
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
|
||||||
$show_description = true, $show_rating = false,
|
$show_description = true, $show_rating = false,
|
||||||
|
@ -447,11 +452,14 @@ function wp_get_linksbyname($category, $args = '') {
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param string $cat_name The category name to use. If no match is found uses all.
|
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
|
||||||
* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
|
* Default 'noname'.
|
||||||
* Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* specify 'rand' as the order which will return links in a random order.
|
* 'description', 'rating', or 'owner'. Default 'name'.
|
||||||
* @param int $limit Limit to X entries. If not specified, all entries are shown.
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default -1.
|
||||||
* @return array
|
* @return array
|
||||||
*/
|
*/
|
||||||
function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
|
function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
|
||||||
|
@ -497,12 +505,14 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param int $category The category to use. If no category supplied uses all
|
* @param int $category Optional. The category to use. If no category supplied, uses all.
|
||||||
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
|
* Default 0.
|
||||||
* 'description', or 'rating'. Or maybe owner. If you start the name with an
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* underscore the order will be reversed. You can also specify 'rand' as the
|
* 'description', 'rating', or 'owner'. Default 'name'.
|
||||||
* order which will return links in a random order.
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
* @param int $limit Limit to X entries. If not specified, all entries are shown.
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default 0.
|
||||||
* @return array
|
* @return array
|
||||||
*/
|
*/
|
||||||
function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
|
function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
|
||||||
|
@ -524,18 +534,22 @@ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param string $cat_name The category name to use. If no match is found uses all
|
* @param string $cat_name Optional. The category name to use. If no match is found, uses all.
|
||||||
* @param string $before The html to output before the link
|
* Default 'noname'.
|
||||||
* @param string $after The html to output after the link
|
* @param string $before Optional. The HTML to output before the link. Default empty.
|
||||||
* @param string $between The html to output between the link/image and its description. Not used if no image or show_images is true
|
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
|
||||||
* @param bool $show_images Whether to show images (if defined).
|
* @param string $between Optional. The HTML to output between the link/image and its description.
|
||||||
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
|
* Not used if no image or $show_images is true. Default ' '.
|
||||||
* 'description', or 'rating'. Or maybe owner. If you start the name with an
|
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
|
||||||
* underscore the order will be reversed. You can also specify 'rand' as the
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* order which will return links in a random order.
|
* 'description', 'rating', or 'owner'. Default 'id'.
|
||||||
* @param bool $show_description Whether to show the description if show_images=false/not defined
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
* @param int $limit Limit to X entries. If not specified, all entries are shown.
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
* @param int $show_updated Whether to show last updated timestamp
|
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
|
||||||
|
* Default true.
|
||||||
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default -1.
|
||||||
|
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
|
||||||
*/
|
*/
|
||||||
function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
|
function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
|
||||||
$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
|
$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
|
||||||
|
@ -551,18 +565,22 @@ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after =
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param int $category The category to use. If no category supplied uses all
|
* @param int $category Optional. The category to use. If no category supplied, uses all.
|
||||||
* @param string $before The html to output before the link
|
* Default 0.
|
||||||
* @param string $after The html to output after the link
|
* @param string $before Optional. The HTML to output before the link. Default empty.
|
||||||
* @param string $between The html to output between the link/image and its description. Not used if no image or show_images == true
|
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
|
||||||
* @param bool $show_images Whether to show images (if defined).
|
* @param string $between Optional. The HTML to output between the link/image and its description.
|
||||||
* @param string $orderby The order to output the links. E.g. 'id', 'name', 'url',
|
* Not used if no image or $show_images is true. Default ' '.
|
||||||
* 'description', or 'rating'. Or maybe owner. If you start the name with an
|
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
|
||||||
* underscore the order will be reversed. You can also specify 'rand' as the
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* order which will return links in a random order.
|
* 'description', 'rating', or 'owner'. Default 'id'.
|
||||||
* @param bool $show_description Whether to show the description if show_images=false/not defined.
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
* @param int $limit Limit to X entries. If not specified, all entries are shown.
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
* @param int $show_updated Whether to show last updated timestamp
|
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
|
||||||
|
* Default true.
|
||||||
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default -1.
|
||||||
|
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 0.
|
||||||
*/
|
*/
|
||||||
function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
|
function get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,
|
||||||
$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
|
$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
|
||||||
|
@ -904,21 +922,24 @@ function wp_get_links($args = '') {
|
||||||
* @deprecated 2.1.0 Use get_bookmarks()
|
* @deprecated 2.1.0 Use get_bookmarks()
|
||||||
* @see get_bookmarks()
|
* @see get_bookmarks()
|
||||||
*
|
*
|
||||||
* @param int $category The category to use. If no category supplied uses all
|
* @param int $category Optional. The category to use. If no category supplied uses all.
|
||||||
* @param string $before the html to output before the link
|
* Default 0.
|
||||||
* @param string $after the html to output after the link
|
* @param string $before Optional. The HTML to output before the link. Default empty.
|
||||||
* @param string $between the html to output between the link/image and its description.
|
* @param string $after Optional. The HTML to output after the link. Default '<br />'.
|
||||||
* Not used if no image or show_images == true
|
* @param string $between Optional. The HTML to output between the link/image and its description.
|
||||||
* @param bool $show_images whether to show images (if defined).
|
* Not used if no image or $show_images is true. Default ' '.
|
||||||
* @param string $orderby the order to output the links. E.g. 'id', 'name', 'url',
|
* @param bool $show_images Optional. Whether to show images (if defined). Default true.
|
||||||
* 'description', or 'rating'. Or maybe owner. If you start the name with an
|
* @param string $orderby Optional. The order to output the links. E.g. 'id', 'name', 'url',
|
||||||
* underscore the order will be reversed. You can also specify 'rand' as the order
|
* 'description', 'rating', or 'owner'. Default 'name'.
|
||||||
* which will return links in a random order.
|
* If you start the name with an underscore, the order will be reversed.
|
||||||
* @param bool $show_description whether to show the description if show_images=false/not defined.
|
* Specifying 'rand' as the order will return links in a random order.
|
||||||
* @param bool $show_rating show rating stars/chars
|
* @param bool $show_description Optional. Whether to show the description if show_images=false/not defined.
|
||||||
* @param int $limit Limit to X entries. If not specified, all entries are shown.
|
* Default true.
|
||||||
* @param int $show_updated whether to show last updated timestamp
|
* @param bool $show_rating Optional. Show rating stars/chars. Default false.
|
||||||
* @param bool $echo whether to echo the results, or return them instead
|
* @param int $limit Optional. Limit to X entries. If not specified, all entries are shown.
|
||||||
|
* Default -1.
|
||||||
|
* @param int $show_updated Optional. Whether to show last updated timestamp. Default 1.
|
||||||
|
* @param bool $echo Whether to echo the results, or return them instead.
|
||||||
* @return null|string
|
* @return null|string
|
||||||
*/
|
*/
|
||||||
function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
|
function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',
|
||||||
|
@ -1628,30 +1649,31 @@ function the_author_ID() {
|
||||||
/**
|
/**
|
||||||
* Display the post content for the feed.
|
* Display the post content for the feed.
|
||||||
*
|
*
|
||||||
* For encoding the html or the $encode_html parameter, there are three possible
|
* For encoding the HTML or the $encode_html parameter, there are three possible values:
|
||||||
* values. '0' will make urls footnotes and use make_url_footnote(). '1' will
|
* - '0' will make urls footnotes and use make_url_footnote().
|
||||||
* encode special characters and automatically display all of the content. The
|
* - '1' will encode special characters and automatically display all of the content.
|
||||||
* value of '2' will strip all HTML tags from the content.
|
* - '2' will strip all HTML tags from the content.
|
||||||
*
|
*
|
||||||
* Also note that you cannot set the amount of words and not set the html
|
* Also note that you cannot set the amount of words and not set the HTML encoding.
|
||||||
* encoding. If that is the case, then the html encoding will default to 2,
|
* If that is the case, then the HTML encoding will default to 2, which will strip
|
||||||
* which will strip all HTML tags.
|
* all HTML tags.
|
||||||
*
|
*
|
||||||
* To restrict the amount of words of the content, you can use the cut
|
* To restrict the amount of words of the content, you can use the cut parameter.
|
||||||
* parameter. If the content is less than the amount, then there won't be any
|
* If the content is less than the amount, then there won't be any dots added to the end.
|
||||||
* dots added to the end. If there is content left over, then dots will be added
|
* If there is content left over, then dots will be added and the rest of the content
|
||||||
* and the rest of the content will be removed.
|
* will be removed.
|
||||||
*
|
*
|
||||||
* @since 0.71
|
* @since 0.71
|
||||||
*
|
*
|
||||||
* @deprecated 2.9.0 Use the_content_feed()
|
* @deprecated 2.9.0 Use the_content_feed()
|
||||||
* @see the_content_feed()
|
* @see the_content_feed()
|
||||||
*
|
*
|
||||||
* @param string $more_link_text Optional. Text to display when more content is available but not displayed.
|
* @param string $more_link_text Optional. Text to display when more content is available
|
||||||
* @param int $stripteaser Optional. Default is 0.
|
* but not displayed. Default '(more...)'.
|
||||||
* @param string $more_file Optional.
|
* @param int $stripteaser Optional. Default 0.
|
||||||
* @param int $cut Optional. Amount of words to keep for the content.
|
* @param string $more_file Optional.
|
||||||
* @param int $encode_html Optional. How to encode the content.
|
* @param int $cut Optional. Amount of words to keep for the content.
|
||||||
|
* @param int $encode_html Optional. How to encode the content.
|
||||||
*/
|
*/
|
||||||
function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
|
function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file='', $cut = 0, $encode_html = 0) {
|
||||||
_deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' );
|
_deprecated_function( __FUNCTION__, '2.9.0', 'the_content_feed()' );
|
||||||
|
@ -1704,7 +1726,7 @@ function the_content_rss($more_link_text='(more...)', $stripteaser=0, $more_file
|
||||||
* @since 0.71
|
* @since 0.71
|
||||||
* @deprecated 2.9.0
|
* @deprecated 2.9.0
|
||||||
*
|
*
|
||||||
* @param string $content Content to get links
|
* @param string $content Content to get links.
|
||||||
* @return string HTML stripped out of content with links at the bottom.
|
* @return string HTML stripped out of content with links at the bottom.
|
||||||
*/
|
*/
|
||||||
function make_url_footnote( $content ) {
|
function make_url_footnote( $content ) {
|
||||||
|
@ -1742,9 +1764,9 @@ function make_url_footnote( $content ) {
|
||||||
* @deprecated 2.9.0 Use _x()
|
* @deprecated 2.9.0 Use _x()
|
||||||
* @see _x()
|
* @see _x()
|
||||||
*
|
*
|
||||||
* @param string $text Text to translate
|
* @param string $text Text to translate.
|
||||||
* @param string $domain Optional. Domain to retrieve the translated text
|
* @param string $domain Optional. Domain to retrieve the translated text.
|
||||||
* @return string Translated context string without pipe
|
* @return string Translated context string without pipe.
|
||||||
*/
|
*/
|
||||||
function _c( $text, $domain = 'default' ) {
|
function _c( $text, $domain = 'default' ) {
|
||||||
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
|
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
|
||||||
|
@ -1759,9 +1781,9 @@ function _c( $text, $domain = 'default' ) {
|
||||||
* @deprecated 3.0.0 Use _x()
|
* @deprecated 3.0.0 Use _x()
|
||||||
* @see _x()
|
* @see _x()
|
||||||
*
|
*
|
||||||
* @param string $text Text to translate
|
* @param string $text Text to translate.
|
||||||
* @param string $domain Domain to retrieve the translated text
|
* @param string $domain Domain to retrieve the translated text.
|
||||||
* @return string Translated text
|
* @return string Translated text.
|
||||||
*/
|
*/
|
||||||
function translate_with_context( $text, $domain = 'default' ) {
|
function translate_with_context( $text, $domain = 'default' ) {
|
||||||
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
|
_deprecated_function( __FUNCTION__, '2.9.0', '_x()' );
|
||||||
|
|
|
@ -535,12 +535,12 @@ function atom_enclosure() {
|
||||||
/**
|
/**
|
||||||
* Determine the type of a string of data with the data formatted.
|
* Determine the type of a string of data with the data formatted.
|
||||||
*
|
*
|
||||||
* Tell whether the type is text, html, or xhtml, per RFC 4287 section 3.1.
|
* Tell whether the type is text, HTML, or XHTML, per RFC 4287 section 3.1.
|
||||||
*
|
*
|
||||||
* In the case of WordPress, text is defined as containing no markup,
|
* In the case of WordPress, text is defined as containing no markup,
|
||||||
* xhtml is defined as "well formed", and html as tag soup (i.e., the rest).
|
* XHTML is defined as "well formed", and HTML as tag soup (i.e., the rest).
|
||||||
*
|
*
|
||||||
* Container div tags are added to xhtml values, per section 3.1.1.3.
|
* Container div tags are added to XHTML values, per section 3.1.1.3.
|
||||||
*
|
*
|
||||||
* @link http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.3.1
|
* @link http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rfc.section.3.1
|
||||||
*
|
*
|
||||||
|
|
|
@ -928,7 +928,7 @@ function seems_utf8( $str ) {
|
||||||
* double if set to 'double' or both if otherwise set.
|
* double if set to 'double' or both if otherwise set.
|
||||||
* Default is ENT_NOQUOTES.
|
* Default is ENT_NOQUOTES.
|
||||||
* @param false|string $charset Optional. The character encoding of the string. Default false.
|
* @param false|string $charset Optional. The character encoding of the string. Default false.
|
||||||
* @param bool $double_encode Optional. Whether to encode existing html entities. Default false.
|
* @param bool $double_encode Optional. Whether to encode existing HTML entities. Default false.
|
||||||
* @return string The encoded text with HTML entities.
|
* @return string The encoded text with HTML entities.
|
||||||
*/
|
*/
|
||||||
function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
|
function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
|
||||||
|
@ -5136,7 +5136,7 @@ function wp_sprintf_l( $pattern, $args ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Safely extracts not more than the first $count characters from html string.
|
* Safely extracts not more than the first $count characters from HTML string.
|
||||||
*
|
*
|
||||||
* UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
|
* UTF-8, tags and entities safe prefix extraction. Entities inside will *NOT*
|
||||||
* be counted as one character. For example & will be counted as 4, < as
|
* be counted as one character. For example & will be counted as 4, < as
|
||||||
|
@ -6013,7 +6013,7 @@ function sanitize_hex_color( $color ) {
|
||||||
*
|
*
|
||||||
* Saving hex colors without a hash puts the burden of adding the hash on the
|
* Saving hex colors without a hash puts the burden of adding the hash on the
|
||||||
* UI, which makes it difficult to use or upgrade to other color types such as
|
* UI, which makes it difficult to use or upgrade to other color types such as
|
||||||
* rgba, hsl, rgb, and html color names.
|
* rgba, hsl, rgb, and HTML color names.
|
||||||
*
|
*
|
||||||
* Returns either '', a 3 or 6 digit hex color (without a #), or null.
|
* Returns either '', a 3 or 6 digit hex color (without a #), or null.
|
||||||
*
|
*
|
||||||
|
|
|
@ -6559,7 +6559,7 @@ function get_tag_regex( $tag ) {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Retrieve a canonical form of the provided charset appropriate for passing to PHP
|
* Retrieve a canonical form of the provided charset appropriate for passing to PHP
|
||||||
* functions such as htmlspecialchars() and charset html attributes.
|
* functions such as htmlspecialchars() and charset HTML attributes.
|
||||||
*
|
*
|
||||||
* @since 3.6.0
|
* @since 3.6.0
|
||||||
* @access private
|
* @access private
|
||||||
|
|
|
@ -3915,7 +3915,7 @@ function wp_get_code_editor_settings( $args ) {
|
||||||
* Retrieves the contents of the search WordPress query variable.
|
* Retrieves the contents of the search WordPress query variable.
|
||||||
*
|
*
|
||||||
* The search query string is passed through esc_attr() to ensure that it is safe
|
* The search query string is passed through esc_attr() to ensure that it is safe
|
||||||
* for placing in an html attribute.
|
* for placing in an HTML attribute.
|
||||||
*
|
*
|
||||||
* @since 2.3.0
|
* @since 2.3.0
|
||||||
*
|
*
|
||||||
|
@ -3943,7 +3943,7 @@ function get_search_query( $escaped = true ) {
|
||||||
* Displays the contents of the search query variable.
|
* Displays the contents of the search query variable.
|
||||||
*
|
*
|
||||||
* The search query string is passed through esc_attr() to ensure that it is safe
|
* The search query string is passed through esc_attr() to ensure that it is safe
|
||||||
* for placing in an html attribute.
|
* for placing in an HTML attribute.
|
||||||
*
|
*
|
||||||
* @since 2.1.0
|
* @since 2.1.0
|
||||||
*/
|
*/
|
||||||
|
@ -3959,14 +3959,14 @@ function the_search_query() {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Gets the language attributes for the html tag.
|
* Gets the language attributes for the 'html' tag.
|
||||||
*
|
*
|
||||||
* Builds up a set of html attributes containing the text direction and language
|
* Builds up a set of HTML attributes containing the text direction and language
|
||||||
* information for the page.
|
* information for the page.
|
||||||
*
|
*
|
||||||
* @since 4.3.0
|
* @since 4.3.0
|
||||||
*
|
*
|
||||||
* @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'.
|
* @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'.
|
||||||
*/
|
*/
|
||||||
function get_language_attributes( $doctype = 'html' ) {
|
function get_language_attributes( $doctype = 'html' ) {
|
||||||
$attributes = array();
|
$attributes = array();
|
||||||
|
@ -3989,27 +3989,27 @@ function get_language_attributes( $doctype = 'html' ) {
|
||||||
$output = implode( ' ', $attributes );
|
$output = implode( ' ', $attributes );
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Filters the language attributes for display in the html tag.
|
* Filters the language attributes for display in the 'html' tag.
|
||||||
*
|
*
|
||||||
* @since 2.5.0
|
* @since 2.5.0
|
||||||
* @since 4.3.0 Added the `$doctype` parameter.
|
* @since 4.3.0 Added the `$doctype` parameter.
|
||||||
*
|
*
|
||||||
* @param string $output A space-separated list of language attributes.
|
* @param string $output A space-separated list of language attributes.
|
||||||
* @param string $doctype The type of html document (xhtml|html).
|
* @param string $doctype The type of HTML document (xhtml|html).
|
||||||
*/
|
*/
|
||||||
return apply_filters( 'language_attributes', $output, $doctype );
|
return apply_filters( 'language_attributes', $output, $doctype );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Displays the language attributes for the html tag.
|
* Displays the language attributes for the 'html' tag.
|
||||||
*
|
*
|
||||||
* Builds up a set of html attributes containing the text direction and language
|
* Builds up a set of HTML attributes containing the text direction and language
|
||||||
* information for the page.
|
* information for the page.
|
||||||
*
|
*
|
||||||
* @since 2.1.0
|
* @since 2.1.0
|
||||||
* @since 4.3.0 Converted into a wrapper for get_language_attributes().
|
* @since 4.3.0 Converted into a wrapper for get_language_attributes().
|
||||||
*
|
*
|
||||||
* @param string $doctype Optional. The type of html document. Accepts 'xhtml' or 'html'. Default 'html'.
|
* @param string $doctype Optional. The type of HTML document. Accepts 'xhtml' or 'html'. Default 'html'.
|
||||||
*/
|
*/
|
||||||
function language_attributes( $doctype = 'html' ) {
|
function language_attributes( $doctype = 'html' ) {
|
||||||
echo get_language_attributes( $doctype );
|
echo get_language_attributes( $doctype );
|
||||||
|
@ -4654,7 +4654,7 @@ function get_the_generator( $type = '' ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Outputs the html checked attribute.
|
* Outputs the HTML checked attribute.
|
||||||
*
|
*
|
||||||
* Compares the first two arguments and if identical marks as checked
|
* Compares the first two arguments and if identical marks as checked
|
||||||
*
|
*
|
||||||
|
@ -4663,14 +4663,14 @@ function get_the_generator( $type = '' ) {
|
||||||
* @param mixed $checked One of the values to compare
|
* @param mixed $checked One of the values to compare
|
||||||
* @param mixed $current (true) The other value to compare if not just true
|
* @param mixed $current (true) The other value to compare if not just true
|
||||||
* @param bool $echo Whether to echo or just return the string
|
* @param bool $echo Whether to echo or just return the string
|
||||||
* @return string html attribute or empty string
|
* @return string HTML attribute or empty string
|
||||||
*/
|
*/
|
||||||
function checked( $checked, $current = true, $echo = true ) {
|
function checked( $checked, $current = true, $echo = true ) {
|
||||||
return __checked_selected_helper( $checked, $current, $echo, 'checked' );
|
return __checked_selected_helper( $checked, $current, $echo, 'checked' );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Outputs the html selected attribute.
|
* Outputs the HTML selected attribute.
|
||||||
*
|
*
|
||||||
* Compares the first two arguments and if identical marks as selected
|
* Compares the first two arguments and if identical marks as selected
|
||||||
*
|
*
|
||||||
|
@ -4679,14 +4679,14 @@ function checked( $checked, $current = true, $echo = true ) {
|
||||||
* @param mixed $selected One of the values to compare
|
* @param mixed $selected One of the values to compare
|
||||||
* @param mixed $current (true) The other value to compare if not just true
|
* @param mixed $current (true) The other value to compare if not just true
|
||||||
* @param bool $echo Whether to echo or just return the string
|
* @param bool $echo Whether to echo or just return the string
|
||||||
* @return string html attribute or empty string
|
* @return string HTML attribute or empty string
|
||||||
*/
|
*/
|
||||||
function selected( $selected, $current = true, $echo = true ) {
|
function selected( $selected, $current = true, $echo = true ) {
|
||||||
return __checked_selected_helper( $selected, $current, $echo, 'selected' );
|
return __checked_selected_helper( $selected, $current, $echo, 'selected' );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Outputs the html disabled attribute.
|
* Outputs the HTML disabled attribute.
|
||||||
*
|
*
|
||||||
* Compares the first two arguments and if identical marks as disabled
|
* Compares the first two arguments and if identical marks as disabled
|
||||||
*
|
*
|
||||||
|
@ -4695,14 +4695,14 @@ function selected( $selected, $current = true, $echo = true ) {
|
||||||
* @param mixed $disabled One of the values to compare
|
* @param mixed $disabled One of the values to compare
|
||||||
* @param mixed $current (true) The other value to compare if not just true
|
* @param mixed $current (true) The other value to compare if not just true
|
||||||
* @param bool $echo Whether to echo or just return the string
|
* @param bool $echo Whether to echo or just return the string
|
||||||
* @return string html attribute or empty string
|
* @return string HTML attribute or empty string
|
||||||
*/
|
*/
|
||||||
function disabled( $disabled, $current = true, $echo = true ) {
|
function disabled( $disabled, $current = true, $echo = true ) {
|
||||||
return __checked_selected_helper( $disabled, $current, $echo, 'disabled' );
|
return __checked_selected_helper( $disabled, $current, $echo, 'disabled' );
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Outputs the html readonly attribute.
|
* Outputs the HTML readonly attribute.
|
||||||
*
|
*
|
||||||
* Compares the first two arguments and if identical marks as readonly
|
* Compares the first two arguments and if identical marks as readonly
|
||||||
*
|
*
|
||||||
|
@ -4711,7 +4711,7 @@ function disabled( $disabled, $current = true, $echo = true ) {
|
||||||
* @param mixed $readonly One of the values to compare
|
* @param mixed $readonly One of the values to compare
|
||||||
* @param mixed $current (true) The other value to compare if not just true
|
* @param mixed $current (true) The other value to compare if not just true
|
||||||
* @param bool $echo Whether to echo or just return the string
|
* @param bool $echo Whether to echo or just return the string
|
||||||
* @return string html attribute or empty string
|
* @return string HTML attribute or empty string
|
||||||
*/
|
*/
|
||||||
function readonly( $readonly, $current = true, $echo = true ) {
|
function readonly( $readonly, $current = true, $echo = true ) {
|
||||||
return __checked_selected_helper( $readonly, $current, $echo, 'readonly' );
|
return __checked_selected_helper( $readonly, $current, $echo, 'readonly' );
|
||||||
|
@ -4729,7 +4729,7 @@ function readonly( $readonly, $current = true, $echo = true ) {
|
||||||
* @param mixed $current (true) The other value to compare if not just true
|
* @param mixed $current (true) The other value to compare if not just true
|
||||||
* @param bool $echo Whether to echo or just return the string
|
* @param bool $echo Whether to echo or just return the string
|
||||||
* @param string $type The type of checked|selected|disabled|readonly we are doing
|
* @param string $type The type of checked|selected|disabled|readonly we are doing
|
||||||
* @return string html attribute or empty string
|
* @return string HTML attribute or empty string
|
||||||
*/
|
*/
|
||||||
function __checked_selected_helper( $helper, $current, $echo, $type ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
|
function __checked_selected_helper( $helper, $current, $echo, $type ) { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
|
||||||
if ( (string) $helper === (string) $current ) {
|
if ( (string) $helper === (string) $current ) {
|
||||||
|
|
|
@ -2390,7 +2390,7 @@ function safecss_filter_attr( $css, $deprecated = '' ) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Helper function to add global attributes to a tag in the allowed html list.
|
* Helper function to add global attributes to a tag in the allowed HTML list.
|
||||||
*
|
*
|
||||||
* @since 3.5.0
|
* @since 3.5.0
|
||||||
* @since 5.0.0 Add support for `data-*` wildcard attributes.
|
* @since 5.0.0 Add support for `data-*` wildcard attributes.
|
||||||
|
|
|
@ -13,7 +13,7 @@
|
||||||
*
|
*
|
||||||
* @global string $wp_version
|
* @global string $wp_version
|
||||||
*/
|
*/
|
||||||
$wp_version = '5.5-alpha-48198';
|
$wp_version = '5.5-alpha-48199';
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
|
||||||
|
|
Loading…
Reference in New Issue