[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/ -> deprecated.php (summary)

Deprecated functions from past WordPress versions. You shouldn't use these functions and look for the alternatives instead. The functions will be removed in a later version.

File Size: 6302 lines (186 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 232 functions

  get_postdata()
  start_wp()
  the_category_ID()
  the_category_head()
  previous_post()
  next_post()
  user_can_create_post()
  user_can_create_draft()
  user_can_edit_post()
  user_can_delete_post()
  user_can_set_post_date()
  user_can_edit_post_date()
  user_can_edit_post_comments()
  user_can_delete_post_comments()
  user_can_edit_user()
  get_linksbyname()
  wp_get_linksbyname()
  get_linkobjectsbyname()
  get_linkobjects()
  get_linksbyname_withrating()
  get_links_withrating()
  get_autotoggle()
  list_cats()
  wp_list_cats()
  dropdown_cats()
  list_authors()
  wp_get_post_cats()
  wp_set_post_cats()
  get_archives()
  get_author_link()
  link_pages()
  get_settings()
  permalink_link()
  permalink_single_rss()
  wp_get_links()
  get_links()
  get_links_list()
  links_popup_script()
  get_linkrating()
  get_linkcatname()
  comments_rss_link()
  get_category_rss_link()
  get_author_rss_link()
  comments_rss()
  create_user()
  gzip_compression()
  get_commentdata()
  get_catname()
  get_category_children()
  get_all_category_ids()
  get_the_author_description()
  the_author_description()
  get_the_author_login()
  the_author_login()
  get_the_author_firstname()
  the_author_firstname()
  get_the_author_lastname()
  the_author_lastname()
  get_the_author_nickname()
  the_author_nickname()
  get_the_author_email()
  the_author_email()
  get_the_author_icq()
  the_author_icq()
  get_the_author_yim()
  the_author_yim()
  get_the_author_msn()
  the_author_msn()
  get_the_author_aim()
  the_author_aim()
  get_author_name()
  get_the_author_url()
  the_author_url()
  get_the_author_ID()
  the_author_ID()
  the_content_rss()
  make_url_footnote()
  _c()
  translate_with_context()
  _nc()
  __ngettext()
  __ngettext_noop()
  get_alloptions()
  get_the_attachment_link()
  get_attachment_icon_src()
  get_attachment_icon()
  get_attachment_innerHTML()
  get_link()
  clean_url()
  js_escape()
  wp_specialchars()
  attribute_escape()
  register_sidebar_widget()
  unregister_sidebar_widget()
  register_widget_control()
  unregister_widget_control()
  delete_usermeta()
  get_usermeta()
  update_usermeta()
  get_users_of_blog()
  automatic_feed_links()
  get_profile()
  get_usernumposts()
  funky_javascript_callback()
  funky_javascript_fix()
  is_taxonomy()
  is_term()
  is_plugin_page()
  update_category_cache()
  wp_timezone_supported()
  the_editor()
  get_user_metavalues()
  sanitize_user_object()
  get_boundary_post_rel_link()
  start_post_rel_link()
  get_index_rel_link()
  index_rel_link()
  get_parent_post_rel_link()
  parent_post_rel_link()
  wp_admin_bar_dashboard_view_site_menu()
  is_blog_user()
  debug_fopen()
  debug_fwrite()
  debug_fclose()
  get_themes()
  get_theme()
  get_current_theme()
  clean_pre()
  add_custom_image_header()
  remove_custom_image_header()
  add_custom_background()
  remove_custom_background()
  get_theme_data()
  update_page_cache()
  clean_page_cache()
  wp_explain_nonce()
  sticky_class()
  _get_post_ancestors()
  wp_load_image()
  image_resize()
  wp_get_single_post()
  user_pass_ok()
  _save_post_hook()
  gd_edit_image_support()
  wp_convert_bytes_to_hr()
  _search_terms_tidy()
  rich_edit_exists()
  default_topic_count_text()
  format_to_post()
  like_escape()
  url_is_accessable_via_ssl()
  preview_theme()
  _preview_theme_template_filter()
  _preview_theme_stylesheet_filter()
  preview_theme_ob_filter()
  preview_theme_ob_filter_callback()
  wp_richedit_pre()
  wp_htmledit_pre()
  post_permalink()
  wp_get_http()
  force_ssl_login()
  get_comments_popup_template()
  is_comments_popup()
  comments_popup_script()
  popuplinks()
  wp_embed_handler_googlevideo()
  get_paged_template()
  wp_kses_js_entities()
  _usort_terms_by_ID()
  _usort_terms_by_name()
  _sort_nav_menu_items()
  get_shortcut_link()
  wp_ajax_press_this_save_post()
  wp_ajax_press_this_add_category()
  wp_get_user_request_data()
  wp_make_content_images_responsive()
  wp_unregister_GLOBALS()
  wp_blacklist_check()
  _wp_register_meta_args_whitelist()
  add_option_whitelist()
  remove_option_whitelist()
  wp_slash_strings_only()
  addslashes_strings_only()
  noindex()
  wp_no_robots()
  wp_sensitive_page_meta()
  _excerpt_render_inner_columns_blocks()
  wp_render_duotone_filter_preset()
  wp_skip_border_serialization()
  wp_skip_dimensions_serialization()
  wp_skip_spacing_serialization()
  wp_add_iframed_editor_assets_html()
  wp_get_attachment_thumb_file()
  _get_path_to_translation()
  _get_path_to_translation_from_lang_dir()
  _wp_multiple_block_styles()
  wp_typography_get_css_variable_inline_style()
  global_terms_enabled()
  _filter_query_attachment_filenames()
  get_page_by_title()
  _resolve_home_block_template()
  wlwmanifest_link()
  wp_queue_comments_for_comment_meta_lazyload()
  wp_get_loading_attr_default()
  wp_img_tag_add_loading_attr()
  wp_tinycolor_bound01()
  _wp_tinycolor_bound_alpha()
  wp_tinycolor_rgb_to_rgb()
  wp_tinycolor_hue_to_rgb()
  wp_tinycolor_hsl_to_rgb()
  wp_tinycolor_string_to_rgb()
  wp_get_duotone_filter_id()
  wp_get_duotone_filter_property()
  wp_get_duotone_filter_svg()
  wp_register_duotone_support()
  wp_render_duotone_support()
  wp_get_global_styles_svg_filters()
  wp_global_styles_render_svg_filters()
  block_core_navigation_submenu_build_css_colors()
  _wp_theme_json_webfonts_handler()
  print_embed_styles()
  print_emoji_styles()
  wp_admin_bar_header()
  _admin_bar_bump_cb()
  wp_update_https_detection_errors()
  wp_img_tag_add_decoding_attr()
  _inject_theme_attribute_in_block_template_content()
  _remove_theme_attribute_in_block_template_content()
  the_block_template_skip_link()
  block_core_query_ensure_interactivity_dependency()
  block_core_file_ensure_interactivity_dependency()
  block_core_image_ensure_interactivity_dependency()

Functions
Functions that are not part of a class:

get_postdata($postid)   X-Ref
Retrieves all post data for a given post.

param: int $postid Post ID.
return: array Post data.

start_wp()   X-Ref
Sets up the WordPress Loop.

Use The Loop instead.


the_category_ID($display = true)   X-Ref
Returns or prints a category ID.

param: bool $display Optional. Whether to display the output. Default true.
return: int Category ID.

the_category_head( $before = '', $after = '' )   X-Ref
Prints a category with optional text before and after.

param: string $before Optional. Text to display before the category. Default empty.
param: string $after  Optional. Text to display after the category. Default empty.

previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='')   X-Ref
Prints a link to the previous post.

param: string $format
param: string $previous
param: string $title
param: string $in_same_cat
param: int    $limitprev
param: string $excluded_categories

next_post($format='%', $next='next post: ', $title='yes', $in_same_cat='no', $limitnext=1, $excluded_categories='')   X-Ref
Prints link to the next post.

param: string $format
param: string $next
param: string $title
param: string $in_same_cat
param: int $limitnext
param: string $excluded_categories

user_can_create_post($user_id, $blog_id = 1, $category_id = 'None')   X-Ref
Whether user can create a post.

param: int $user_id
param: int $blog_id Not Used
param: int $category_id Not Used
return: bool

user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None')   X-Ref
Whether user can create a post.

param: int $user_id
param: int $blog_id Not Used
param: int $category_id Not Used
return: bool

user_can_edit_post($user_id, $post_id, $blog_id = 1)   X-Ref
Whether user can edit a post.

param: int $user_id
param: int $post_id
param: int $blog_id Not Used
return: bool

user_can_delete_post($user_id, $post_id, $blog_id = 1)   X-Ref
Whether user can delete a post.

param: int $user_id
param: int $post_id
param: int $blog_id Not Used
return: bool

user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None')   X-Ref
Whether user can set new posts' dates.

param: int $user_id
param: int $blog_id Not Used
param: int $category_id Not Used
return: bool

user_can_edit_post_date($user_id, $post_id, $blog_id = 1)   X-Ref
Whether user can delete a post.

param: int $user_id
param: int $post_id
param: int $blog_id Not Used
return: bool returns true if $user_id can edit $post_id's date

user_can_edit_post_comments($user_id, $post_id, $blog_id = 1)   X-Ref
Whether user can delete a post.

param: int $user_id
param: int $post_id
param: int $blog_id Not Used
return: bool returns true if $user_id can edit $post_id's comments

user_can_delete_post_comments($user_id, $post_id, $blog_id = 1)   X-Ref
Whether user can delete a post.

param: int $user_id
param: int $post_id
param: int $blog_id Not Used
return: bool returns true if $user_id can delete $post_id's comments

user_can_edit_user($user_id, $other_user)   X-Ref
Can user can edit other user.

param: int $user_id
param: int $other_user
return: bool

get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',$show_description = true, $show_rating = false,$limit = -1, $show_updated = 0)   X-Ref
Gets the links associated with category $cat_name.

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 empty.
param: string $after            Optional. The HTML to output after the link. Default '<br />'.
param: string $between          Optional. The HTML to output between the link/image and its description.
param: bool   $show_images      Optional. Whether to show images (if defined). Default true.
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.
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.
param: int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.

wp_get_linksbyname($category, $args = '')   X-Ref
Gets the links associated with the named category.

param: string $category The category to use.
param: string $args
return: string|null

get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1)   X-Ref
Gets an array of link objects associated with category $cat_name.

$links = get_linkobjectsbyname( 'fred' );
foreach ( $links as $link ) {
echo '<li>' . $link->link_name . '</li>';
}

param: string $cat_name Optional. The category name to use. If no match is found, uses all.
param: string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
param: int    $limit    Optional. Limit to X entries. If not specified, all entries are shown.
return: array

get_linkobjects($category = 0, $orderby = 'name', $limit = 0)   X-Ref
Gets an array of link objects associated with category n.

Usage:

$links = get_linkobjects(1);
if ($links) {
foreach ($links as $link) {
echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
}
}

Fields are:

- link_id
- link_url
- link_name
- link_image
- link_target
- link_category
- link_description
- link_visible
- link_owner
- link_rating
- link_updated
- link_rel
- link_notes

param: int    $category Optional. The category to use. If no category supplied, uses all.
param: string $orderby  Optional. The order to output the links. E.g. 'id', 'name', 'url',
param: int    $limit    Optional. Limit to X entries. If not specified, all entries are shown.
return: array

get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0)   X-Ref
Gets the links associated with category 'cat_name' and display rating stars/chars.

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 empty.
param: string $after            Optional. The HTML to output after the link. Default '<br />'.
param: string $between          Optional. The HTML to output between the link/image and its description.
param: bool   $show_images      Optional. Whether to show images (if defined). Default true.
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.
param: int    $limit               Optional. Limit to X entries. If not specified, all entries are shown.
param: int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.

get_links_withrating($category = -1, $before = '', $after = '<br />', $between = " ", $show_images = true,$orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0)   X-Ref
Gets the links associated with category n and display rating stars/chars.

param: int    $category         Optional. The category to use. If no category supplied, uses all.
param: string $before           Optional. The HTML to output before the link. Default empty.
param: string $after            Optional. The HTML to output after the link. Default '<br />'.
param: string $between          Optional. The HTML to output between the link/image and its description.
param: bool   $show_images      Optional. Whether to show images (if defined). Default true.
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.
param: int    $limit               Optional. Limit to X entries. If not specified, all entries are shown.
param: int    $show_updated     Optional. Whether to show last updated timestamp. Default 0.

get_autotoggle($id = 0)   X-Ref
Gets the auto_toggle setting.

param: int $id The category to get. If no category supplied uses 0
return: int Only returns 0.

list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0,$optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=false, $child_of=0, $categories=0,$recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false)   X-Ref
Lists categories.

param: int $optionall
param: string $all
param: string $sort_column
param: string $sort_order
param: string $file
param: bool $list
param: int $optiondates
param: int $optioncount
param: int $hide_empty
param: int $use_desc_for_title
param: bool $children
param: int $child_of
param: int $categories
param: int $recurse
param: string $feed
param: string $feed_image
param: string $exclude
param: bool $hierarchical
return: null|false

wp_list_cats($args = '')   X-Ref
Lists categories.

param: string|array $args
return: null|string|false

dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = 'asc',$show_last_update = 0, $show_count = 0, $hide_empty = 1, $optionnone = false,$selected = 0, $exclude = 0)   X-Ref
Deprecated method for generating a drop-down of categories.

param: int $optionall
param: string $all
param: string $orderby
param: string $order
param: int $show_last_update
param: int $show_count
param: int $hide_empty
param: bool $optionnone
param: int $selected
param: int $exclude
return: string

list_authors($optioncount = false, $exclude_admin = true, $show_fullname = false, $hide_empty = true, $feed = '', $feed_image = '')   X-Ref
Lists authors.

param: bool $optioncount
param: bool $exclude_admin
param: bool $show_fullname
param: bool $hide_empty
param: string $feed
param: string $feed_image
return: null|string

wp_get_post_cats($blogid = '1', $post_id = 0)   X-Ref
Retrieves a list of post categories.

param: int $blogid Not Used
param: int $post_id
return: array

wp_set_post_cats($blogid = '1', $post_id = 0, $post_categories = array()   X-Ref
Sets the categories that the post ID belongs to.

param: int $blogid Not used
param: int $post_id
param: array $post_categories
return: bool|mixed

get_archives($type='', $limit='', $format='html', $before = '', $after = '', $show_post_count = false)   X-Ref
Retrieves a list of archives.

param: string $type
param: string $limit
param: string $format
param: string $before
param: string $after
param: bool $show_post_count
return: string|null

get_author_link($display, $author_id, $author_nicename = '')   X-Ref
Returns or Prints link to the author's posts.

param: bool $display
param: int $author_id
param: string $author_nicename Optional.
return: string|null

link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',$pagelink='%', $more_file='')   X-Ref
Print list of pages based on arguments.

param: string $before
param: string $after
param: string $next_or_number
param: string $nextpagelink
param: string $previouspagelink
param: string $pagelink
param: string $more_file
return: string

get_settings($option)   X-Ref
Get value based on option.

param: string $option
return: string

permalink_link()   X-Ref
Print the permalink of the current post in the loop.


permalink_single_rss($deprecated = '')   X-Ref
Print the permalink to the RSS feed.

param: string $deprecated

wp_get_links($args = '')   X-Ref
Gets the links associated with category.

param: string $args a query string
return: null|string

get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name',$show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $display = true)   X-Ref
Gets the links associated with category by ID.

param: int    $category         Optional. The category to use. If no category supplied uses all.
param: string $before           Optional. The HTML to output before the link. Default empty.
param: string $after            Optional. The HTML to output after the link. Default '<br />'.
param: string $between          Optional. The HTML to output between the link/image and its description.
param: bool   $show_images      Optional. Whether to show images (if defined). Default true.
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.
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.
param: int    $show_updated     Optional. Whether to show last updated timestamp. Default 1.
param: bool   $display          Whether to display the results, or return them instead.
return: null|string

get_links_list($order = 'name')   X-Ref
Output entire list of links by category.

Output a list of all links, listed by category, using the settings in
$wpdb->linkcategories and output it as a nested HTML unordered list.

param: string $order Sort link categories by 'name' or 'id'

links_popup_script($text = 'Links', $width=400, $height=400, $file='links.all.php', $count = true)   X-Ref
Show the link to the links popup and the number of links.

param: string $text the text of the link
param: int $width the width of the popup window
param: int $height the height of the popup window
param: string $file the page to open in the popup window
param: bool $count the number of links in the db

get_linkrating( $link )   X-Ref
Legacy function that retrieved the value of a link's link_rating field.

param: object $link Link object.
return: mixed Value of the 'link_rating' field, false otherwise.

get_linkcatname($id = 0)   X-Ref
Gets the name of category by ID.

param: int $id The category to get. If no category supplied uses 0
return: string

comments_rss_link($link_text = 'Comments RSS')   X-Ref
Print RSS comment feed link.

param: string $link_text

get_category_rss_link($display = false, $cat_id = 1)   X-Ref
Print/Return link to category RSS2 feed.

param: bool $display
param: int $cat_id
return: string

get_author_rss_link($display = false, $author_id = 1)   X-Ref
Print/Return link to author RSS feed.

param: bool $display
param: int $author_id
return: string

comments_rss()   X-Ref
Return link to the post RSS feed.

return: string

create_user($username, $password, $email)   X-Ref
An alias of wp_create_user().

param: string $username The user's username.
param: string $password The user's password.
param: string $email    The user's email.
return: int The new user's ID.

gzip_compression()   X-Ref
Unused function.


get_commentdata( $comment_id, $no_cache = 0, $include_unapproved = false )   X-Ref
Retrieve an array of comment data about comment $comment_id.

param: int $comment_id The ID of the comment
param: int $no_cache Whether to use the cache (cast to bool)
param: bool $include_unapproved Whether to include unapproved comments
return: array The comment data

get_catname( $cat_id )   X-Ref
Retrieve the category name by the category ID.

param: int $cat_id Category ID
return: string category name

get_category_children( $id, $before = '/', $after = '', $visited = array()   X-Ref
Retrieve category children list separated before and after the term IDs.

param: int    $id      Category ID to retrieve children.
param: string $before  Optional. Prepend before category term ID. Default '/'.
param: string $after   Optional. Append after category term ID. Default empty string.
param: array  $visited Optional. Category Term IDs that have already been added.
return: string

get_all_category_ids()   X-Ref
Retrieves all category IDs.

return: int[] List of all of the category IDs.

get_the_author_description()   X-Ref
Retrieve the description of the author of the current post.

return: string The author's description.

the_author_description()   X-Ref
Display the description of the author of the current post.


get_the_author_login()   X-Ref
Retrieve the login name of the author of the current post.

return: string The author's login name (username).

the_author_login()   X-Ref
Display the login name of the author of the current post.


get_the_author_firstname()   X-Ref
Retrieve the first name of the author of the current post.

return: string The author's first name.

the_author_firstname()   X-Ref
Display the first name of the author of the current post.


get_the_author_lastname()   X-Ref
Retrieve the last name of the author of the current post.

return: string The author's last name.

the_author_lastname()   X-Ref
Display the last name of the author of the current post.


get_the_author_nickname()   X-Ref
Retrieve the nickname of the author of the current post.

return: string The author's nickname.

the_author_nickname()   X-Ref
Display the nickname of the author of the current post.


get_the_author_email()   X-Ref
Retrieve the email of the author of the current post.

return: string The author's username.

the_author_email()   X-Ref
Display the email of the author of the current post.


get_the_author_icq()   X-Ref
Retrieve the ICQ number of the author of the current post.

return: string The author's ICQ number.

the_author_icq()   X-Ref
Display the ICQ number of the author of the current post.


get_the_author_yim()   X-Ref
Retrieve the Yahoo! IM name of the author of the current post.

return: string The author's Yahoo! IM name.

the_author_yim()   X-Ref
Display the Yahoo! IM name of the author of the current post.


get_the_author_msn()   X-Ref
Retrieve the MSN address of the author of the current post.

return: string The author's MSN address.

the_author_msn()   X-Ref
Display the MSN address of the author of the current post.


get_the_author_aim()   X-Ref
Retrieve the AIM address of the author of the current post.

return: string The author's AIM address.

the_author_aim()   X-Ref
Display the AIM address of the author of the current post.


get_author_name( $auth_id = false )   X-Ref
Retrieve the specified author's preferred display name.

param: int $auth_id The ID of the author.
return: string The author's display name.

get_the_author_url()   X-Ref
Retrieve the URL to the home page of the author of the current post.

return: string The URL to the author's page.

the_author_url()   X-Ref
Display the URL to the home page of the author of the current post.


get_the_author_ID()   X-Ref
Retrieve the ID of the author of the current post.

return: string|int The author's ID.

the_author_ID()   X-Ref
Display the ID of the author of the current post.


the_content_rss($more_link_text='(more...)   X-Ref
Display the post content for the feed.

For encoding the HTML or the $encode_html parameter, there are three possible values:
- '0' will make urls footnotes and use make_url_footnote().
- '1' will encode special characters and automatically display all of 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 encoding.
If that is the case, then the HTML encoding will default to 2, which will strip
all HTML tags.

To restrict the amount of words of the content, you can use the cut parameter.
If the content is less than the amount, then there won't be any dots added to the end.
If there is content left over, then dots will be added and the rest of the content
will be removed.

param: string $more_link_text Optional. Text to display when more content is available
param: int    $stripteaser    Optional. Default 0.
param: string $more_file      Optional.
param: int    $cut            Optional. Amount of words to keep for the content.
param: int    $encode_html    Optional. How to encode the content.

make_url_footnote( $content )   X-Ref
Strip HTML and put links at the bottom of stripped content.

Searches for all of the links, strips them out of the content, and places
them at the bottom of the content with numbers.

param: string $content Content to get links.
return: string HTML stripped out of content with links at the bottom.

_c( $text, $domain = 'default' )   X-Ref
Retrieve translated string with vertical bar context

Quite a few times, there will be collisions with similar translatable text
found in more than two places but with different translated context.

In order to use the separate contexts, the _c() function is used and the
translatable string uses a pipe ('|') which has the context the string is in.

When the translated string is returned, it is everything before the pipe, not
including the pipe character. If there is no pipe in the translated text then
everything is returned.

param: string $text Text to translate.
param: string $domain Optional. Domain to retrieve the translated text.
return: string Translated context string without pipe.

translate_with_context( $text, $domain = 'default' )   X-Ref
Translates $text like translate(), but assumes that the text
contains a context after its last vertical bar.

param: string $text Text to translate.
param: string $domain Domain to retrieve the translated text.
return: string Translated text.

_nc( $single, $plural, $number, $domain = 'default' )   X-Ref
Legacy version of _n(), which supports contexts.

Strips everything from the translation after the last bar.

param: string $single The text to be used if the number is singular.
param: string $plural The text to be used if the number is plural.
param: int    $number The number to compare against to use either the singular or plural form.
param: string $domain Optional. Text domain. Unique identifier for retrieving translated strings.
return: string The translated singular or plural form.

__ngettext( ...$args )   X-Ref
Retrieve the plural or single form based on the amount.


__ngettext_noop( ...$args )   X-Ref
Register plural strings in POT file, but don't translate them.


get_alloptions()   X-Ref
Retrieve all autoload options, or all options if no autoloaded ones exist.

return: array List of all options.

get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false)   X-Ref
Retrieve HTML content of attachment image with link.

param: int   $id       Optional. Post ID.
param: bool  $fullsize Optional. Whether to use full size image. Default false.
param: array $max_dims Optional. Max image dimensions.
param: bool $permalink Optional. Whether to include permalink to image. Default false.
return: string

get_attachment_icon_src( $id = 0, $fullsize = false )   X-Ref
Retrieve icon URL and Path.

param: int  $id       Optional. Post ID.
param: bool $fullsize Optional. Whether to have full image. Default false.
return: array Icon URL and full path to file, respectively.

get_attachment_icon( $id = 0, $fullsize = false, $max_dims = false )   X-Ref
Retrieve HTML content of icon attachment image element.

param: int   $id       Optional. Post ID.
param: bool  $fullsize Optional. Whether to have full size image. Default false.
param: array $max_dims Optional. Dimensions of image.
return: string|false HTML content.

get_attachment_innerHTML($id = 0, $fullsize = false, $max_dims = false)   X-Ref
Retrieve HTML content of image element.

param: int   $id       Optional. Post ID.
param: bool  $fullsize Optional. Whether to have full size image. Default false.
param: array $max_dims Optional. Dimensions of image.
return: string|false

get_link( $bookmark_id, $output = OBJECT, $filter = 'raw' )   X-Ref
Retrieves bookmark data based on ID.

param: int    $bookmark_id ID of link
param: string $output      Optional. Type of output. Accepts OBJECT, ARRAY_N, or ARRAY_A.
param: string $filter      Optional. How to filter the link for output. Accepts 'raw', 'edit',
return: object|array Bookmark object or array, depending on the type specified by `$output`.

clean_url( $url, $protocols = null, $context = 'display' )   X-Ref
Checks and cleans a URL.

A number of characters are removed from the URL. If the URL is for displaying
(the default behavior) ampersands are also replaced. The 'clean_url' filter
is applied to the returned cleaned URL.

param: string $url The URL to be cleaned.
param: array $protocols Optional. An array of acceptable protocols.
param: string $context Optional. How the URL will be used. Default is 'display'.
return: string The cleaned $url after the {@see 'clean_url'} filter is applied.

js_escape( $text )   X-Ref
Escape single quotes, specialchar double quotes, and fix line endings.

The filter {@see 'js_escape'} is also applied by esc_js().

param: string $text The text to be escaped.
return: string Escaped text.

wp_specialchars( $text, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false )   X-Ref
Legacy escaping for HTML blocks.

param: string       $text          Text to escape.
param: string       $quote_style   Unused.
param: false|string $charset       Unused.
param: false        $double_encode Whether to double encode. Unused.
return: string Escaped `$text`.

attribute_escape( $text )   X-Ref
Escaping for HTML attributes.

param: string $text
return: string

register_sidebar_widget($name, $output_callback, $classname = '', ...$params)   X-Ref
Register widget for sidebar with backward compatibility.

Allows $name to be an array that accepts either three elements to grab the
first element and the third for the name or just uses the first element of
the array for the name.

Passes to wp_register_sidebar_widget() after argument list and backward
compatibility is complete.

param: string|int $name            Widget ID.
param: callable   $output_callback Run when widget is called.
param: string     $classname       Optional. Classname widget option. Default empty.
param: mixed      ...$params       Widget parameters.

unregister_sidebar_widget($id)   X-Ref
Serves as an alias of wp_unregister_sidebar_widget().

param: int|string $id Widget ID.

register_widget_control($name, $control_callback, $width = '', $height = '', ...$params)   X-Ref
Registers widget control callback for customizing options.

Allows $name to be an array that accepts either three elements to grab the
first element and the third for the name or just uses the first element of
the array for the name.

Passes to wp_register_widget_control() after the argument list has
been compiled.

param: int|string $name             Sidebar ID.
param: callable   $control_callback Widget control callback to display and process form.
param: int        $width            Widget width.
param: int        $height           Widget height.
param: mixed      ...$params        Widget parameters.

unregister_widget_control($id)   X-Ref
Alias of wp_unregister_widget_control().

param: int|string $id Widget ID.

delete_usermeta( $user_id, $meta_key, $meta_value = '' )   X-Ref
Remove user meta data.

param: int $user_id User ID.
param: string $meta_key Metadata key.
param: mixed $meta_value Optional. Metadata value. Default empty.
return: bool True deletion completed and false if user_id is not a number.

get_usermeta( $user_id, $meta_key = '' )   X-Ref
Retrieve user metadata.

If $user_id is not a number, then the function will fail over with a 'false'
boolean return value. Other returned values depend on whether there is only
one item to be returned, which be that single item type. If there is more
than one metadata value, then it will be list of metadata values.

param: int $user_id User ID
param: string $meta_key Optional. Metadata key. Default empty.
return: mixed

update_usermeta( $user_id, $meta_key, $meta_value )   X-Ref
Update metadata of user.

There is no need to serialize values, they will be serialized if it is
needed. The metadata key can only be a string with underscores. All else will
be removed.

Will remove the metadata, if the meta value is empty.

param: int $user_id User ID
param: string $meta_key Metadata key.
param: mixed $meta_value Metadata value.
return: bool True on successful update, false on failure.

get_users_of_blog( $id = '' )   X-Ref
Get users for the site.

For setups that use the multisite feature. Can be used outside of the
multisite feature.

param: int $id Site ID.
return: array List of users that are part of that site ID

automatic_feed_links( $add = true )   X-Ref
Enable/disable automatic general feed link outputting.

param: bool $add Optional. Add or remove links. Default true.

get_profile( $field, $user = false )   X-Ref
Retrieve user data based on field.

param: string    $field User meta field.
param: false|int $user  Optional. User ID to retrieve the field for. Default false (current user).
return: string The author's field from the current author's DB object.

get_usernumposts( $userid )   X-Ref
Retrieves the number of posts a user has written.

param: int $userid User to count posts for.
return: int Number of posts the given user has written.

funky_javascript_callback($matches)   X-Ref
Callback used to change %uXXXX to &#YYY; syntax

param: array $matches Single Match
return: string An HTML entity

funky_javascript_fix($text)   X-Ref
Fixes JavaScript bugs in browsers.

Converts unicode characters to HTML numbered entities.

param: string $text Text to be made safe.
return: string Fixed text.

is_taxonomy( $taxonomy )   X-Ref
Checks that the taxonomy name exists.

param: string $taxonomy Name of taxonomy object
return: bool Whether the taxonomy exists.

is_term( $term, $taxonomy = '', $parent = 0 )   X-Ref
Check if Term exists.

param: int|string $term The term to check
param: string $taxonomy The taxonomy name to use
param: int $parent ID of parent term under which to confine the exists search.
return: mixed Get the term ID or term object, if exists.

is_plugin_page()   X-Ref
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.

return: bool

update_category_cache()   X-Ref
Update the categories cache.

This function does not appear to be used anymore or does not appear to be
needed. It might be a legacy function left over from when there was a need
for updating the category cache.

return: bool Always return True

wp_timezone_supported()   X-Ref
Check for PHP timezone support

return: bool

the_editor($content, $id = 'content', $prev_id = 'title', $media_buttons = true, $tab_index = 2, $extended = true)   X-Ref
Displays an editor: TinyMCE, HTML, or both.

param: string $content       Textarea content.
param: string $id            Optional. HTML ID attribute value. Default 'content'.
param: string $prev_id       Optional. Unused.
param: bool   $media_buttons Optional. Whether to display media buttons. Default true.
param: int    $tab_index     Optional. Unused.
param: bool   $extended      Optional. Unused.

get_user_metavalues($ids)   X-Ref
Perform the query to get the $metavalues array(s) needed by _fill_user and _fill_many_users

param: array $ids User ID numbers list.
return: array of arrays. The array is indexed by user_id, containing $metavalues object arrays.

sanitize_user_object($user, $context = 'display')   X-Ref
Sanitize every user field.

If the context is 'raw', then the user object or array will get minimal santization of the int fields.

param: object|array $user    The user object or array.
param: string       $context Optional. How to sanitize user fields. Default 'display'.
return: object|array The now sanitized user object or array (will be the same type as $user).

get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true)   X-Ref
Get boundary post relational link.

Can either be start or end post relational link.

param: string $title               Optional. Link title format. Default '%title'.
param: bool   $in_same_cat         Optional. Whether link should be in a same category.
param: string $excluded_categories Optional. Excluded categories IDs. Default empty.
param: bool   $start               Optional. Whether to display link to first or last post.
return: string

start_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '')   X-Ref
Display relational link for the first post.

param: string $title Optional. Link title format.
param: bool $in_same_cat Optional. Whether link should be in a same category.
param: string $excluded_categories Optional. Excluded categories IDs.

get_index_rel_link()   X-Ref
Get site index relational link.

return: string

index_rel_link()   X-Ref
Display relational link for the site index.


get_parent_post_rel_link( $title = '%title' )   X-Ref
Get parent post relational link.

param: string $title Optional. Link title format. Default '%title'.
return: string

parent_post_rel_link( $title = '%title' )   X-Ref
Display relational link for parent item

param: string $title Optional. Link title format. Default '%title'.

wp_admin_bar_dashboard_view_site_menu( $wp_admin_bar )   X-Ref
Add the "Dashboard"/"Visit Site" menu.

param: WP_Admin_Bar $wp_admin_bar WP_Admin_Bar instance.

is_blog_user( $blog_id = 0 )   X-Ref
Checks if the current user belong to a given site.

param: int $blog_id Site ID
return: bool True if the current users belong to $blog_id, false if not.

debug_fopen( $filename, $mode )   X-Ref
Open the file handle for debugging.

param: string $filename File name.
param: string $mode     Type of access you required to the stream.
return: false Always false.

debug_fwrite( $fp, $message )   X-Ref
Write contents to the file used for debugging.

param: mixed  $fp      Unused.
param: string $message Message to log.

debug_fclose( $fp )   X-Ref
Close the debugging file handle.

param: mixed $fp Unused.

get_themes()   X-Ref
Retrieve list of themes with theme data in theme directory.

The theme is broken, if it doesn't have a parent theme and is missing either
style.css and, or index.php. If the theme has a parent theme then it is
broken, if it is missing style.css; index.php is optional.

return: array Theme list with theme data.

get_theme( $theme )   X-Ref
Retrieve theme data.

param: string $theme Theme name.
return: array|null Null, if theme name does not exist. Theme data, if exists.

get_current_theme()   X-Ref
Retrieve current theme name.

return: string

clean_pre($matches)   X-Ref
Accepts matches array from preg_replace_callback in wpautop() or a string.

Ensures that the contents of a `<pre>...</pre>` HTML block are not
converted into paragraphs or line breaks.

param: array|string $matches The array or string
return: string The pre block without paragraph/line break conversion.

add_custom_image_header( $wp_head_callback, $admin_head_callback, $admin_preview_callback = '' )   X-Ref
Add callbacks for image header display.

param: callable $wp_head_callback Call on the {@see 'wp_head'} action.
param: callable $admin_head_callback Call on custom header administration screen.
param: callable $admin_preview_callback Output a custom header image div on the custom header administration screen. Optional.

remove_custom_image_header()   X-Ref
Remove image header support.

return: null|bool Whether support was removed.

add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' )   X-Ref
Add callbacks for background image display.

param: callable $wp_head_callback Call on the {@see 'wp_head'} action.
param: callable $admin_head_callback Call on custom background administration screen.
param: callable $admin_preview_callback Output a custom background image div on the custom background administration screen. Optional.

remove_custom_background()   X-Ref
Remove custom background support.

return: null|bool Whether support was removed.

get_theme_data( $theme_file )   X-Ref
Retrieve theme data from parsed theme file.

param: string $theme_file Theme file path.
return: array Theme data.

update_page_cache( &$pages )   X-Ref
Alias of update_post_cache().

param: array $pages list of page objects

clean_page_cache( $id )   X-Ref
Will clean the page in the cache.

Clean (read: delete) page from cache that matches $id. Will also clean cache
associated with 'all_page_ids' and 'get_pages'.

param: int $id Page ID to clean

wp_explain_nonce( $action )   X-Ref
Retrieve nonce action "Are you sure" message.

Deprecated in 3.4.1 and 3.5.0. Backported to 3.3.3.

param: string $action Nonce action.
return: string Are you sure message.

sticky_class( $post_id = null )   X-Ref
Display "sticky" CSS class, if a post is sticky.

param: int $post_id An optional post ID.

_get_post_ancestors( &$post )   X-Ref
Retrieve post ancestors.

This is no longer needed as WP_Post lazy-loads the ancestors
property with get_post_ancestors().

param: WP_Post $post Post object, passed by reference (unused).

wp_load_image( $file )   X-Ref
Load an image from a string, if PHP supports it.

param: string $file Filename of the image to load.
return: resource|GdImage|string The resulting image resource or GdImage instance on success,

image_resize( $file, $max_w, $max_h, $crop = false, $suffix = null, $dest_path = null, $jpeg_quality = 90 )   X-Ref
Scale down an image to fit a particular size and save a new copy of the image.

The PNG transparency will be preserved using the function, as well as the
image type. If the file going in is PNG, then the resized image is going to
be PNG. The only supported image types are PNG, GIF, and JPEG.

Some functionality requires API to exist, so some PHP version may lose out
support. This is not the fault of WordPress (where functionality is
downgraded, not actual defects), but of your PHP version.

param: string $file         Image file path.
param: int    $max_w        Maximum width to resize to.
param: int    $max_h        Maximum height to resize to.
param: bool   $crop         Optional. Whether to crop image or resize. Default false.
param: string $suffix       Optional. File suffix. Default null.
param: string $dest_path    Optional. New image file path. Default null.
param: int    $jpeg_quality Optional. Image quality percentage. Default 90.
return: mixed WP_Error on failure. String with new destination path.

wp_get_single_post( $postid = 0, $mode = OBJECT )   X-Ref
Retrieve a single post, based on post ID.

Has categories in 'post_category' property or key. Has tags in 'tags_input'
property or key.

param: int $postid Post ID.
param: string $mode How to return result, either OBJECT, ARRAY_N, or ARRAY_A.
return: WP_Post|null Post object or array holding post contents and information

user_pass_ok($user_login, $user_pass)   X-Ref
Check that the user login name and password is correct.

param: string $user_login User name.
param: string $user_pass User password.
return: bool False if does not authenticate, true if username and password authenticates.

_save_post_hook()   X-Ref
Callback formerly fired on the save_post hook. No longer needed.


gd_edit_image_support($mime_type)   X-Ref
Check if the installed version of GD supports particular image type

param: string $mime_type
return: bool

wp_convert_bytes_to_hr( $bytes )   X-Ref
Converts an integer byte value to a shorthand byte value.

param: int $bytes An integer byte value.
return: string A shorthand byte value.

_search_terms_tidy( $t )   X-Ref
Formerly used internally to tidy up the search terms.

param: string $t Search terms to "tidy", e.g. trim.
return: string Trimmed search terms.

rich_edit_exists()   X-Ref
Determine if TinyMCE is available.

Checks to see if the user has deleted the tinymce files to slim down
their WordPress installation.

return: bool Whether TinyMCE exists.

default_topic_count_text( $count )   X-Ref
Old callback for tag link tooltips.

param: int $count Number of topics.
return: int Number of topics.

format_to_post( $content )   X-Ref
Formerly used to escape strings before inserting into the DB.

Has not performed this function for many, many years. Use wpdb::prepare() instead.

param: string $content The text to format.
return: string The very same text.

like_escape($text)   X-Ref
Formerly used to escape strings before searching the DB. It was poorly documented and never worked as described.

param: string $text The text to be escaped.
return: string text, safe for inclusion in LIKE query.

url_is_accessable_via_ssl( $url )   X-Ref
Determines if the URL can be accessed over SSL.

Determines if the URL can be accessed over SSL by using the WordPress HTTP API to access
the URL using https as the scheme.

param: string $url The URL to test.
return: bool Whether SSL access is available.

preview_theme()   X-Ref
Start preview theme output buffer.

Will only perform task if the user has permissions and template and preview
query variables exist.


_preview_theme_template_filter()   X-Ref
Private function to modify the current template when previewing a theme

return: string

_preview_theme_stylesheet_filter()   X-Ref
Private function to modify the current stylesheet when previewing a theme

return: string

preview_theme_ob_filter( $content )   X-Ref
Callback function for ob_start() to capture all links in the theme.

param: string $content
return: string

preview_theme_ob_filter_callback( $matches )   X-Ref
Manipulates preview theme links in order to control and maintain location.

Callback function for preg_replace_callback() to accept and filter matches.

param: array $matches
return: string

wp_richedit_pre($text)   X-Ref
Formats text for the rich text editor.

The {@see 'richedit_pre'} filter is applied here. If `$text` is empty the filter will
be applied to an empty string.

param: string $text The text to be formatted.
return: string The formatted text after filter is applied.

wp_htmledit_pre($output)   X-Ref
Formats text for the HTML editor.

Unless $output is empty it will pass through htmlspecialchars before the
{@see 'htmledit_pre'} filter is applied.

param: string $output The text to be formatted.
return: string Formatted text after filter applied.

post_permalink( $post = 0 )   X-Ref
Retrieve permalink from post ID.

param: int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
return: string|false

wp_get_http( $url, $file_path = false, $red = 1 )   X-Ref
Perform a HTTP HEAD or GET request.

If $file_path is a writable filename, this will do a GET request and write
the file to that path.

param: string      $url       URL to fetch.
param: string|bool $file_path Optional. File path to write request to. Default false.
param: int         $red       Optional. The number of Redirects followed, Upon 5 being hit,
return: \WpOrg\Requests\Utility\CaseInsensitiveDictionary|false Headers on success, false on failure.

force_ssl_login( $force = null )   X-Ref
Whether SSL login should be forced.

param: string|bool $force Optional Whether to force SSL login. Default null.
return: bool True if forced, false if not forced.

get_comments_popup_template()   X-Ref
Retrieve path of comment popup template in current or parent template.

return: string Full path to comments popup template file.

is_comments_popup()   X-Ref
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.

return: false Always returns false.

comments_popup_script()   X-Ref
Display the JS popup script to show a comment.


popuplinks( $text )   X-Ref
Adds element attributes to open links in new tabs.

param: string $text Content to replace links to open in a new tab.
return: string Content that has filtered links.

wp_embed_handler_googlevideo( $matches, $attr, $url, $rawattr )   X-Ref
The Google Video embed handler callback.

Deprecated function that previously assisted in turning Google Video URLs
into embeds but that service has since been shut down.

return: string An empty string.

get_paged_template()   X-Ref
Retrieve path of paged template in current or parent template.

return: string Full path to paged template file.

wp_kses_js_entities( $content )   X-Ref
Removes the HTML JavaScript entities found in early versions of Netscape 4.

Previously, this function was pulled in from the original
import of kses and removed a specific vulnerability only
existent in early version of Netscape 4. However, this
vulnerability never affected any other browsers and can
be considered safe for the modern web.

The regular expression which sanitized this vulnerability
has been removed in consideration of the performance and
energy demands it placed, now merely passing through its
input to the return.

param: string $content
return: string

_usort_terms_by_ID( $a, $b )   X-Ref
Sort categories by ID.

Used by usort() as a callback, should not be used directly. Can actually be
used to sort any term object.

param: object $a
param: object $b
return: int

_usort_terms_by_name( $a, $b )   X-Ref
Sort categories by name.

Used by usort() as a callback, should not be used directly. Can actually be
used to sort any term object.

param: object $a
param: object $b
return: int

_sort_nav_menu_items( $a, $b )   X-Ref
Sort menu items by the desired key.

param: object $a The first object to compare
param: object $b The second object to compare
return: int -1, 0, or 1 if $a is considered to be respectively less than, equal to, or greater than $b.

get_shortcut_link()   X-Ref
Retrieves the Press This bookmarklet link.

return: string

wp_ajax_press_this_save_post()   X-Ref
Ajax handler for saving a post from Press This.


wp_ajax_press_this_add_category()   X-Ref
Ajax handler for creating new category from Press This.


wp_get_user_request_data( $request_id )   X-Ref
Return the user request object for the specified request ID.

param: int $request_id The ID of the user request.
return: WP_User_Request|false

wp_make_content_images_responsive( $content )   X-Ref
Filters 'img' elements in post content to add 'srcset' and 'sizes' attributes.

param: string $content The raw post content to be filtered.
return: string Converted content with 'srcset' and 'sizes' attributes added to images.

wp_unregister_GLOBALS()   X-Ref
Turn register globals off.


wp_blacklist_check( $author, $email, $url, $comment, $user_ip, $user_agent )   X-Ref
Does comment contain disallowed characters or words.

param: string $author The author of the comment
param: string $email The email of the comment
param: string $url The url used in the comment
param: string $comment The comment content
param: string $user_ip The comment author's IP address
param: string $user_agent The author's browser user agent
return: bool True if comment contains disallowed content, false if comment does not

_wp_register_meta_args_whitelist( $args, $default_args )   X-Ref
Filters out `register_meta()` args based on an allowed list.

`register_meta()` args may change over time, so requiring the allowed list
to be explicitly turned off is a warranty seal of sorts.

param: array $args         Arguments from `register_meta()`.
param: array $default_args Default arguments for `register_meta()`.
return: array Filtered arguments.

add_option_whitelist( $new_options, $options = '' )   X-Ref
Adds an array of options to the list of allowed options.

param: array        $new_options
param: string|array $options
return: array

remove_option_whitelist( $del_options, $options = '' )   X-Ref
Removes a list of options from the allowed options list.

param: array        $del_options
param: string|array $options
return: array

wp_slash_strings_only( $value )   X-Ref
Adds slashes to only string values in an array of values.

This should be used when preparing data for core APIs that expect slashed data.
This should not be used to escape data going directly into an SQL query.

param: mixed $value Scalar or array of scalars.
return: mixed Slashes $value

addslashes_strings_only( $value )   X-Ref
Adds slashes only if the provided value is a string.

param: mixed $value
return: mixed

noindex()   X-Ref
Displays a `noindex` meta tag if required by the blog configuration.

If a blog is marked as not being public then the `noindex` meta tag will be
output to tell web robots not to index the page content.

Typical usage is as a {@see 'wp_head'} callback:

add_action( 'wp_head', 'noindex' );


wp_no_robots()   X-Ref
Display a `noindex` meta tag.

Outputs a `noindex` meta tag that tells web robots not to index the page content.

Typical usage is as a {@see 'wp_head'} callback:

add_action( 'wp_head', 'wp_no_robots' );


wp_sensitive_page_meta()   X-Ref
Display a `noindex,noarchive` meta tag and referrer `strict-origin-when-cross-origin` meta tag.

Outputs a `noindex,noarchive` meta tag that tells web robots not to index or cache the page content.
Outputs a referrer `strict-origin-when-cross-origin` meta tag that tells the browser not to send
the full URL as a referrer to other sites when cross-origin assets are loaded.

Typical usage is as a {@see 'wp_head'} callback:

add_action( 'wp_head', 'wp_sensitive_page_meta' );


_excerpt_render_inner_columns_blocks( $columns, $allowed_blocks )   X-Ref
Render inner blocks from the `core/columns` block for generating an excerpt.

param: array $columns        The parsed columns block.
param: array $allowed_blocks The list of allowed inner blocks.
return: string The rendered inner blocks.

wp_render_duotone_filter_preset( $preset )   X-Ref
Renders the duotone filter SVG and returns the CSS filter property to
reference the rendered SVG.

param: array $preset Duotone preset value as seen in theme.json.
return: string Duotone CSS filter property.

wp_skip_border_serialization( $block_type )   X-Ref
Checks whether serialization of the current block's border properties should occur.

param: WP_Block_Type $block_type Block type.
return: bool Whether serialization of the current block's border properties

wp_skip_dimensions_serialization( $block_type )   X-Ref
Checks whether serialization of the current block's dimensions properties should occur.

param: WP_Block_type $block_type Block type.
return: bool Whether to serialize spacing support styles & classes.

wp_skip_spacing_serialization( $block_type )   X-Ref
Checks whether serialization of the current block's spacing properties should occur.

param: WP_Block_Type $block_type Block type.
return: bool Whether to serialize spacing support styles & classes.

wp_add_iframed_editor_assets_html()   X-Ref
Inject the block editor assets that need to be loaded into the editor's iframe as an inline script.


wp_get_attachment_thumb_file( $post_id = 0 )   X-Ref
Retrieves thumbnail for an attachment.
Note that this works only for the (very) old image metadata style where 'thumb' was set,
and the 'sizes' array did not exist. This function returns false for the newer image metadata style
despite that 'thumbnail' is present in the 'sizes' array.

param: int $post_id Optional. Attachment ID. Default is the ID of the global `$post`.
return: string|false Thumbnail file path on success, false on failure.

_get_path_to_translation( $domain, $reset = false )   X-Ref
Gets the path to a translation file for loading a textdomain just in time.

Caches the retrieved results internally.

param: string $domain Text domain. Unique identifier for retrieving translated strings.
param: bool   $reset  Whether to reset the internal cache. Used by the switch to locale functionality.
return: string|false The path to the translation file or false if no translation file was found.

_get_path_to_translation_from_lang_dir( $domain )   X-Ref
Gets the path to a translation file in the languages directory for the current locale.

Holds a cached list of available .mo files to improve performance.

param: string $domain Text domain. Unique identifier for retrieving translated strings.
return: string|false The path to the translation file or false if no translation file was found.

_wp_multiple_block_styles( $metadata )   X-Ref
Allows multiple block styles.

param: array $metadata Metadata for registering a block type.
return: array Metadata for registering a block type.

wp_typography_get_css_variable_inline_style( $attributes, $feature, $css_property )   X-Ref
Generates an inline style for a typography feature e.g. text decoration,
text transform, and font style.

param: array  $attributes   Block's attributes.
param: string $feature      Key for the feature within the typography styles.
param: string $css_property Slug for the CSS property the inline style sets.
return: string CSS inline style.

global_terms_enabled()   X-Ref
Determines whether global terms are enabled.

return: bool Always returns false.

_filter_query_attachment_filenames( $clauses )   X-Ref
Filter the SQL clauses of an attachment query to include filenames.

param: array $clauses An array including WHERE, GROUP BY, JOIN, ORDER BY,
return: array The unmodified clauses.

get_page_by_title( $page_title, $output = OBJECT, $post_type = 'page' )   X-Ref
Retrieves a page given its title.

If more than one post uses the same title, the post with the smallest ID will be returned.
Be careful: in case of more than one post having the same title, it will check the oldest
publication date, not the smallest ID.

Because this function uses the MySQL '=' comparison, $page_title will usually be matched
as case-insensitive with default collation.

param: string       $page_title Page title.
param: string       $output     Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
param: string|array $post_type  Optional. Post type or array of post types. Default 'page'.
return: WP_Post|array|null WP_Post (or array) on success, or null on failure.

_resolve_home_block_template()   X-Ref
Returns the correct template for the site's home page.

return: array|null A template object, or null if none could be found.

wlwmanifest_link()   X-Ref
Displays the link to the Windows Live Writer manifest file.


wp_queue_comments_for_comment_meta_lazyload( $comments )   X-Ref
Queues comments for metadata lazy-loading.

param: WP_Comment[] $comments Array of comment objects.

wp_get_loading_attr_default( $context )   X-Ref
Gets the default value to use for a `loading` attribute on an element.

This function should only be called for a tag and context if lazy-loading is generally enabled.

The function usually returns 'lazy', but uses certain heuristics to guess whether the current element is likely to
appear above the fold, in which case it returns a boolean `false`, which will lead to the `loading` attribute being
omitted on the element. The purpose of this refinement is to avoid lazy-loading elements that are within the initial
viewport, which can have a negative performance impact.

Under the hood, the function uses {@see wp_increase_content_media_count()} every time it is called for an element
within the main content. If the element is the very first content element, the `loading` attribute will be omitted.
This default threshold of 3 content elements to omit the `loading` attribute for can be customized using the
{@see 'wp_omit_loading_attr_threshold'} filter.

param: string $context Context for the element for which the `loading` attribute value is requested.
return: string|bool The default `loading` attribute value. Either 'lazy', 'eager', or a boolean `false`, to indicate

wp_img_tag_add_loading_attr( $image, $context )   X-Ref
Adds `loading` attribute to an `img` HTML tag.

param: string $image   The HTML `img` tag where the attribute should be added.
param: string $context Additional context to pass to the filters.
return: string Converted `img` tag with `loading` attribute added.

wp_tinycolor_bound01( $n, $max )   X-Ref
Takes input from [0, n] and returns it as [0, 1].

Direct port of TinyColor's function, lightly simplified to maintain
consistency with TinyColor.

param: mixed $n   Number of unknown type.
param: int   $max Upper value of the range to bound to.
return: float Value in the range [0, 1].

_wp_tinycolor_bound_alpha( $n )   X-Ref
Direct port of tinycolor's boundAlpha function to maintain consistency with
how tinycolor works.

param: mixed $n Number of unknown type.
return: float Value in the range [0,1].

wp_tinycolor_rgb_to_rgb( $rgb_color )   X-Ref
Rounds and converts values of an RGB object.

Direct port of TinyColor's function, lightly simplified to maintain
consistency with TinyColor.

param: array $rgb_color RGB object.
return: array Rounded and converted RGB object.

wp_tinycolor_hue_to_rgb( $p, $q, $t )   X-Ref
Helper function for hsl to rgb conversion.

Direct port of TinyColor's function, lightly simplified to maintain
consistency with TinyColor.

param: float $p first component.
param: float $q second component.
param: float $t third component.
return: float R, G, or B component.

wp_tinycolor_hsl_to_rgb( $hsl_color )   X-Ref
Converts an HSL object to an RGB object with converted and rounded values.

Direct port of TinyColor's function, lightly simplified to maintain
consistency with TinyColor.

param: array $hsl_color HSL object.
return: array Rounded and converted RGB object.

wp_tinycolor_string_to_rgb( $color_str )   X-Ref
Parses hex, hsl, and rgb CSS strings using the same regex as TinyColor v1.4.2
used in the JavaScript. Only colors output from react-color are implemented.

Direct port of TinyColor's function, lightly simplified to maintain
consistency with TinyColor.

param: string $color_str CSS color string.
return: array RGB object.

wp_get_duotone_filter_id( $preset )   X-Ref
Returns the prefixed id for the duotone filter for use as a CSS id.

param: array $preset Duotone preset value as seen in theme.json.
return: string Duotone filter CSS id.

wp_get_duotone_filter_property( $preset )   X-Ref
Returns the CSS filter property url to reference the rendered SVG.

param: array $preset Duotone preset value as seen in theme.json.
return: string Duotone CSS filter property url value.

wp_get_duotone_filter_svg( $preset )   X-Ref
Returns the duotone filter SVG string for the preset.

param: array $preset Duotone preset value as seen in theme.json.
return: string Duotone SVG filter.

wp_register_duotone_support( $block_type )   X-Ref
Registers the style and colors block attributes for block types that support it.

param: WP_Block_Type $block_type Block Type.

wp_render_duotone_support( $block_content, $block )   X-Ref
Renders out the duotone stylesheet and SVG.

param: string $block_content Rendered block content.
param: array  $block         Block object.
return: string Filtered block content.

wp_get_global_styles_svg_filters()   X-Ref
Returns a string containing the SVGs to be referenced as filters (duotone).

return: string

wp_global_styles_render_svg_filters()   X-Ref
Renders the SVG filters supplied by theme.json.

Note that this doesn't render the per-block user-defined
filters which are handled by wp_render_duotone_support,
but it should be rendered before the filtered content
in the body to satisfy Safari's rendering quirks.


block_core_navigation_submenu_build_css_colors( $context, $attributes, $is_sub_menu = false )   X-Ref
Build an array with CSS classes and inline styles defining the colors
which will be applied to the navigation markup in the front-end.

param: array $context     Navigation block context.
param: array $attributes  Block attributes.
param: bool  $is_sub_menu Whether the block is a sub-menu.
return: array Colors CSS classes and inline styles.

_wp_theme_json_webfonts_handler()   X-Ref
Runs the theme.json webfonts handler.

Using `WP_Theme_JSON_Resolver`, it gets the fonts defined
in the `theme.json` for the current selection and style
variations, validates the font-face properties, generates
the '@font-face' style declarations, and then enqueues the
styles for both the editor and front-end.

Design Notes:
This is not a public API, but rather an internal handler.
A future public Webfonts API will replace this stopgap code.

This code design is intentional.
a. It hides the inner-workings.
b. It does not expose API ins or outs for consumption.
c. It only works with a theme's `theme.json`.

Why?
a. To avoid backwards-compatibility issues when
the Webfonts API is introduced in Core.
b. To make `fontFace` declarations in `theme.json` work.


print_embed_styles()   X-Ref
Prints the CSS in the embed iframe header.


print_emoji_styles()   X-Ref
Prints the important emoji-related styles.


wp_admin_bar_header()   X-Ref
Prints style and scripts for the admin bar.


_admin_bar_bump_cb()   X-Ref
Prints default admin bar callback.


wp_update_https_detection_errors()   X-Ref
Runs a remote HTTPS request to detect whether HTTPS supported, and stores potential errors.

This internal function is called by a regular Cron hook to ensure HTTPS support is detected and maintained.


wp_img_tag_add_decoding_attr( $image, $context )   X-Ref
Adds `decoding` attribute to an `img` HTML tag.

The `decoding` attribute allows developers to indicate whether the
browser can decode the image off the main thread (`async`), on the
main thread (`sync`) or as determined by the browser (`auto`).

By default WordPress adds `decoding="async"` to images but developers
can use the {@see 'wp_img_tag_add_decoding_attr'} filter to modify this
to remove the attribute or set it to another accepted value.

param: string $image   The HTML `img` tag where the attribute should be added.
param: string $context Additional context to pass to the filters.
return: string Converted `img` tag with `decoding` attribute added.

_inject_theme_attribute_in_block_template_content( $template_content )   X-Ref
Parses wp_template content and injects the active theme's
stylesheet as a theme attribute into each wp_template_part

param: string $template_content serialized wp_template content.
return: string Updated 'wp_template' content.

_remove_theme_attribute_in_block_template_content( $template_content )   X-Ref
Parses a block template and removes the theme attribute from each template part.

param: string $template_content Serialized block template content.
return: string Updated block template content.

the_block_template_skip_link()   X-Ref
Prints the skip-link script & styles.


block_core_query_ensure_interactivity_dependency()   X-Ref
Ensure that the view script has the `wp-interactivity` dependency.


block_core_file_ensure_interactivity_dependency()   X-Ref
Ensure that the view script has the `wp-interactivity` dependency.


block_core_image_ensure_interactivity_dependency()   X-Ref
Ensures that the view script has the `wp-interactivity` dependency.




Generated : Mon Mar 18 08:20:01 2024 Cross-referenced by PHPXref