Changeset 20951
- Timestamp:
- 05/29/2012 06:50:47 PM (12 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
branches/iis/tbex.xml
r19568 r20951 38 38 <Ribbon> 39 39 <AddRibbonButton> 40 <Label> .ORG</Label>41 <Uri> http://wordpress.org/</Uri>42 <ImageUri>http://www.microsoft.com/web/ media/gallery/apps-screenshots/webmatrix-stack-6-256.png</ImageUri>40 <Label>Site Admin</Label> 41 <Uri>/wp-admin</Uri>/wp-admin 42 <ImageUri>http://www.microsoft.com/web/handlers/webpi.ashx?command=getimage&guid=f67accd3-8455-4830-b1d7-eef8959c0325</ImageUri> 43 43 </AddRibbonButton> 44 44 <AddRibbonButton> 45 <Label> .COM</Label>46 <Uri>http://wordpress. com/</Uri>47 <ImageUri>http://www.microsoft.com/web/ media/gallery/apps-screenshots/webmatrix-stack-6-256.png</ImageUri>45 <Label>Community</Label> 46 <Uri>http://wordpress.org/</Uri> 47 <ImageUri>http://www.microsoft.com/web/handlers/webpi.ashx?command=getimage&guid=f67accd3-8455-4830-b1d7-eef8959c0325</ImageUri> 48 48 </AddRibbonButton> 49 49 </Ribbon> … … 67 67 <iconurl>http://s.wordpress.org/about/images/wpmini-blue.png</iconurl> 68 68 <items> 69 <item name="get_header"> 70 <description>Includes the header.php template file from your current theme's directory. if a name is specified then a specialised header header-{name}.php will be included. If the theme contains no header.php file then the header from the default theme wp-includes/theme-compat/header.php will be included.</description> 71 <signature>get_header( $name )</signature> 72 <docrelurl>get_header</docrelurl> 73 </item> 74 <item name="get_footer"> 75 <description>Includes the footer.php template file from your current theme's directory. if a name is specified then a specialised footer footer-{name}.php will be included. If the theme contains no footer.php file then the footer from the default theme wp-includes/theme-compat/footer.php will be included.</description> 76 <signature>get_footer( $name )</signature> 77 <docrelurl>get_footer</docrelurl> 78 </item> 79 <item name="get_sidebar"> 80 <description>Includes the sidebar.php template file from your current theme's directory. If a name ($name) is specified then a specialized sidebar sidebar-{name}.php will be included. If the theme contains no sidebar.php file then the sidebar from the default theme wp-includes/theme-compat/sidebar.php will be included.</description> 81 <signature>get_sidebar( $name )</signature> 82 <docrelurl>get_sidebar</docrelurl> 83 </item> 84 <item name="get_template_part"> 85 <description>Load a template part into a template (other than header, sidebar, footer). Makes it easy for a theme to reuse sections of code in an easy to overload way for child themes. Includes the named template part for a theme or if a name is specified then a specialized part will be included. If the theme contains no {slug}.php file then no template will be included. For the parameter, if the file is called "{slug}-{name}.php".</description> 86 <signature>get_template_part( $slug, $name )</signature> 87 <docrelurl>get_template_part</docrelurl> 88 </item> 89 <item name="get_search_form"> 90 <description>Display search form using searchform.php Theme file.</description> 91 <signature>get_search_form( $echo )</signature> 92 <docrelurl>get_search_form</docrelurl> 93 </item> 94 <item name="wp_loginout"> 95 <description>Displays a login link, or if a user is logged in, displays a logout link. An optional, redirect argument can be used to redirect the user upon login or logout.</description> 96 <signature>wp_loginout( $redirect, $echo )</signature> 97 <docrelurl>wp_loginout</docrelurl> 98 </item> 99 <item name="wp_logout_url"> 100 <description>This Template Tag returns the URL that allows the user to log out of the site.</description> 101 <signature>wp_logout_url( $redirect )</signature> 102 <docrelurl>wp_logout_url</docrelurl> 103 </item> 104 <item name="wp_login_url"> 105 <description>This Template Tag returns the URL that allows the user to log in to the site.</description> 106 <signature>wp_login_url( $redirect )</signature> 107 <docrelurl>wp_login_url</docrelurl> 108 </item> 109 <item name="wp_login_form"> 110 <description>Provides a simple login form for use anywhere within WordPress. By default, it echoes the HTML immediately. Pass array('echo' => false) to return the string instead.</description> 111 <signature>wp_login_form( $args )</signature> 112 <docrelurl>wp_login_form</docrelurl> 113 </item> 114 <item name="wp_lostpassword_url"> 115 <description>This Template Tag returns the URL that allows the user to retrieve the lost password.</description> 116 <signature>wp_lostpassword_url( $redirect )</signature> 117 <docrelurl>wp_lostpassword_url</docrelurl> 118 </item> 119 <item name="wp_register"> 120 <description>This tag displays either the "Site Admin" link if the user is logged in or "Register" link if the user is not logged in. The "Register" link is not offered if the Administration > Settings > General > Membership: Anyone can register box is not checked. This tag does not function as intended on WordPress µ.</description> 121 <signature>wp_register( $before, $after, $echo)</signature> 122 <docrelurl>wp_register</docrelurl> 123 </item> 124 <item name="wp_meta"> 125 <description>Theme container function for the 'wp_meta' action. The 'wp_meta' action can have several purposes, depending on how you use it, but one purpose might have been to allow for theme switching.</description> 126 <signature>wp_meta()</signature> 127 <docrelurl>wp_meta</docrelurl> 128 </item> 129 <item name="bloginfo"> 130 <description>Displays information about your blog, mostly gathered from the information you supply in your User Profile and General Options from the WordPress Administration panels (Settings → General). It can be used anywhere within a page template. This always prints a result to the browser. If you need the values for use in PHP, use get_bloginfo().</description> 131 <signature>bloginfo( $show )</signature> 132 <docrelurl>bloginfo</docrelurl> 133 </item> 134 <item name="get_bloginfo"> 135 <description>The get_bloginfo() function returns information about your site which can then be used elsewhere in your PHP code. This function, as well as bloginfo(), can also be used to display your site information.</description> 136 <signature>get_bloginfo( $show, $filter )</signature> 137 <docrelurl>get_bloginfo</docrelurl> 138 </item> 139 <item name="get_current_blog_id"> 140 <description>Retrieve the current blog id.</description> 141 <signature>get_current_blog_id()</signature> 142 <docrelurl>get_current_blog_id</docrelurl> 143 </item> 144 <item name="wp_title"> 145 <description>Displays or returns the title of the page. A separator string can be defined, and beginning with Version 2.5, that separator can be designated to print before or after the title of the page. This tag can be used anywhere within a template as long as it's outside The Loop on the main page, though is typically used in the <title> element for the head of a page. The title text depends on the query:</description> 146 <signature>wp_title( $sep, $echo, $seplocation )</signature> 147 <docrelurl>wp_title</docrelurl> 148 </item> 149 <item name="single_post_title"> 150 <description>Displays or returns the title of the post when on a single post page (permalink page). This tag can be useful for displaying post titles outside The Loop.</description> 151 <signature>single_post_title( $prefix, $display )</signature> 152 <docrelurl>single_post_title</docrelurl> 153 </item> 154 <item name="post_type_archive_title"> 155 <description>Display or retrieve title for a post type archive. This is optimized for archive.php and archive-{posttype}.php template files for displaying the title of the post type.</description> 156 <signature>post_type_archive_title( $prefix, $display )</signature> 157 <docrelurl>post_type_archive_title</docrelurl> 158 </item> 159 <item name="single_cat_title"> 160 <description>Displays or returns the category title for the current page. For pages displaying WordPress tags rather than categories (e.g. "/tag/geek") the name of the tag is displayed instead of the category. Can be used only outside The Loop.</description> 161 <signature>single_cat_title( $prefix, $display )</signature> 162 <docrelurl>single_cat_title</docrelurl> 163 </item> 164 <item name="single_tag_title"> 165 <description>Displays or returns the tag title for the current archive page.</description> 166 <signature>single_tag_title( $prefix, $display )</signature> 167 <docrelurl>single_tag_title</docrelurl> 168 </item> 169 <item name="single_term_title"> 170 <description>Displays or returns the term title for the current page.</description> 171 <signature>single_term_title( $prefix, $display )</signature> 172 <docrelurl>single_term_title</docrelurl> 173 </item> 174 <item name="single_month_title"> 175 <description>Displays or returns the month and year title for the current page. This tag only works when the m or archive month argument has been passed by WordPress to the current page (this occurs when viewing a monthly archive page). Note: This tag works only on date archive pages, not on category templates or others. It does not support placing the separator after the title, but by leaving the prefix parameter empty, you can set the title separator manually. The prefix does not automatically place a space between the prefix, so if there should be a space, the parameter value will need to have it at the end.</description> 176 <signature>single_month_title( $prefix, $display )</signature> 177 <docrelurl>single_month_title</docrelurl> 178 </item> 179 <item name="get_archives_link"> 180 <description>Retrieve archive link content based on predefined or custom code. The format can be one of four styles. The 'link' for head element, 'option' for use in the select element, 'html' for use in list (either ol or ul HTML elements). Custom content is also supported using the before and after parameters. The 'link' format uses the link HTML element with the archives relationship. The before and after parameters are not used. The text parameter is used to describe the link. The 'option' format uses the option HTML element for use in select element. The value is the url parameter and the before and after parameters are used between the text description. The 'html' format, which is the default, uses the li HTML element for use in the list HTML elements. The before parameter is before the link and the after parameter is after the closing link. The custom format uses the before parameter before the link ('a' HTML element) and the after parameter after the closing link tag. If the above three values for the format are not used, then custom format is assumed.</description> 181 <signature>get_archives_link( $url, $text, $format, $before, $after )</signature> 182 <docrelurl>get_archives_link</docrelurl> 183 </item> 184 <item name="wp_get_archives"> 185 <description>This function displays a date-based archives list. This tag can be used anywhere within a template.</description> 186 <signature>wp_get_archives( $args )</signature> 187 <docrelurl>wp_get_archives</docrelurl> 188 </item> 189 <item name="get_calendar"> 190 <description>Displays the calendar (defaults to current month/year). Days with posts are styled as such. This tag can be used anywhere within a template.</description> 191 <signature>get_calendar( $initial )</signature> 192 <docrelurl>get_calendar</docrelurl> 193 </item> 194 <item name="edit_bookmark_link"> 195 <description>Displays a link to edit the current bookmark, if the user is logged in and allowed to edit the bookmark. It must be within The Loop.</description> 196 <signature>edit_bookmark_link( $link, $before, $after, $bookmark )</signature> 197 <docrelurl>edit_bookmark_link</docrelurl> 198 </item> 199 <item name="edit_comment_link"> 200 <description>Displays a link to edit the current comment, if the user is logged in and allowed to edit the comment. It must be within The Loop, and within a comment loop. Use get_edit_comment_link to retrieve the url.</description> 201 <signature>edit_comment_link( $link, $before, $after )</signature> 202 <docrelurl>edit_comment_link</docrelurl> 203 </item> 204 <item name="edit_post_link"> 205 <description>Displays a link to edit the current post, if a user is logged in and allowed to edit the post. It must be within The Loop. Use get_edit_post_link to retrieve the url.</description> 206 <signature>edit_post_link( $link, $before, $after, $id )</signature> 207 <docrelurl>edit_post_link</docrelurl> 208 </item> 209 <item name="edit_tag_link"> 210 <description>Displays a link to edit the current tag, if the user is logged in and allowed to edit the tag. It must be within The Loop. Use get_edit_tag_link to retrieve the url to edit.</description> 211 <signature>edit_tag_link( $link, $before, $after, $tag )</signature> 212 <docrelurl>edit_tag_link</docrelurl> 213 </item> 214 <item name="get_admin_url"> 215 <description>Retrieve the url to the admin area for a given site.</description> 216 <signature>get_admin_url( $blog_id, $path, $scheme )</signature> 217 <docrelurl>get_admin_url</docrelurl> 218 </item> 219 <item name="get_home_url"> 220 <description>The get_home_url template tag retrieves the home url for a given site. Returns the 'home' option with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden.</description> 221 <signature>get_home_url( $blog_id, $path, $scheme )</signature> 222 <docrelurl>get_home_url</docrelurl> 223 </item> 224 <item name="get_site_url"> 225 <description>The get_site_url() template tag retrieve the site url for a given site. Returns the 'siteurl' option with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is overridden.</description> 226 <signature>get_site_url( $blog_id, $path, $scheme )</signature> 227 <docrelurl>get_site_url</docrelurl> 228 </item> 229 <item name="home_url"> 230 <description>The home_url template tag retrieves the home url for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden. In case of Wordpress Network setup, use network_home_url() instead.</description> 231 <signature>home_url( $path, $scheme )</signature> 232 <docrelurl>home_url</docrelurl> 233 </item> 234 <item name="site_url"> 235 <description>The site_url template tag retrieves the site url for the current site (where the WordPress core files) with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden. In case of WordPress Network setup, use network_site_url() instead.</description> 236 <signature>site_url( $path, $scheme )</signature> 237 <docrelurl>site_url</docrelurl> 238 </item> 239 <item name="get_search_link"> 240 <description>Retrieve permalink for search.</description> 241 <signature>get_search_link( $query )</signature> 242 <docrelurl>get_search_link</docrelurl> 243 </item> 244 <item name="get_search_query"> 245 <description>The search query string is passed through {@link esc_attr()} to ensure that it is safe for placing in an html attribute. 246 This function is used to get the query string when a user performs a search on the site. It returns the query string rather than displaying it, as the the_search_query() function does.</description> 247 <signature>get_search_query()</signature> 248 <docrelurl>get_search_query</docrelurl> 249 </item> 250 <item name="the_author"> 251 <description>The author of a post can be displayed by using this Template Tag. This tag must be used within The Loop. To return to PHP rather than displaying, use get_the_author.</description> 252 <signature>the_author()</signature> 253 <docrelurl>the_author</docrelurl> 254 </item> 255 <item name="get_the_author"> 256 <description>Retrieve the post author. This tag must be used within The Loop. To display a page for authors which have no posts, see this discussion.</description> 257 <signature>get_the_author()</signature> 258 <docrelurl>get_the_author</docrelurl> 259 </item> 260 <item name="the_author_link"> 261 <description>This tag displays a link to the Website for the author of a post. The Website field is set in the user's profile (Administration > Profile > Your Profile). The text for the link is the author's Profile Display name publicly as field. This tag must be used within The Loop.</description> 262 <signature>the_author_link()</signature> 263 <docrelurl>the_author_link</docrelurl> 264 </item> 265 <item name="get_the_author_link"> 266 <description>This tag returns a link to the Website for the author of a post. The Website field is set in the user's profile (Administration > Users > Your Profile). The text for the link is the author's Profile Display name publicly as field. This tag must be used within The Loop.</description> 267 <signature>get_the_author_link()</signature> 268 <docrelurl>get_the_author_link</docrelurl> 269 </item> 270 <item name="the_author_meta"> 271 <description>The the_author_meta Template Tag displays the desired meta data for a user. If this tag is used within The Loop, the user ID value need not be specified, and the displayed data is that of the current post author. A user ID can be specified if this tag is used outside The Loop. NOTE: Use get_the_author_meta() if you need to return (not display) the information.</description> 272 <signature>the_author_meta( $field, $userID )</signature> 273 <docrelurl>the_author_meta</docrelurl> 274 </item> 275 <item name="the_author_posts"> 276 <description>Displays the total number of posts an author has published. Drafts and private posts aren't counted. This tag must be used within The Loop.</description> 277 <signature>the_author_posts()</signature> 278 <docrelurl>the_author_posts</docrelurl> 279 </item> 280 <item name="the_author_posts_link"> 281 <description>Displays a link to all posts by an author. The link text is the user's Display name publicly as field. The results of clicking on the presented link will be controlled by the Template Hierarchy of Author Templates. This tag must be used within The Loop.</description> 282 <signature>the_author_posts_link()</signature> 283 <docrelurl>the_author_posts_link</docrelurl> 284 </item> 285 <item name="wp_dropdown_users"> 286 <description>Create dropdown HTML content of users.</description> 287 <signature>wp_dropdown_users( $args )</signature> 288 <docrelurl>wp_dropdown_users</docrelurl> 289 </item> 290 <item name="wp_list_authors"> 291 <description>Displays a list of the sites's authors (users), and if the user has authored any posts, the author name is displayed as a link to their posts. Optionally this tag displays each author's post count and RSS feed link.</description> 292 <signature>wp_list_authors( $args )</signature> 293 <docrelurl>wp_list_authors</docrelurl> 294 </item> 295 <item name="get_author_posts_url"> 296 <description>Gets the url to the author page of the author of the current post.</description> 297 <signature>get_author_posts_url()</signature> 298 <docrelurl>get_author_posts_url</docrelurl> 299 </item> 300 <item name="wp_list_bookmarks"> 301 <description>Displays bookmarks found in the Administration > Links panel. This Template Tag allows the user to control how the bookmarks are sorted and displayed. NOTE: wp_list_bookmarks() intended to replace the deprecated Template tags get_links_list() and get_links().</description> 302 <signature>wp_list_bookmarks( $args )</signature> 303 <docrelurl>wp_list_bookmarks</docrelurl> 304 </item> 305 <item name="category_description"> 306 <description>Returns the description of a category defined in the category settings screen for the current category (Posts > Categories). If used in the archive.php template, place this function within the is_category() conditional statement. Otherwise, this function will stop the processing of the page for monthly and other archive pages.</description> 307 <signature>category_description( $category_id )</signature> 308 <docrelurl>category_description</docrelurl> 309 </item> 310 <item name="the_category"> 311 <description>Displays a link to the category or categories a post belongs to. This tag must be used within The Loop.</description> 312 <signature>the_category( $separator, $parents, $post_id )</signature> 313 <docrelurl>the_category</docrelurl> 314 </item> 315 <item name="the_category_rss"> 316 <description>Display the post categories in the feed.</description> 317 <signature>the_category_rss( $type )</signature> 318 <docrelurl>the_category_rss</docrelurl> 319 </item> 320 <item name="wp_dropdown_categories"> 321 <description>Display or retrieve the HTML dropdown list of categories.</description> 322 <signature>wp_dropdown_categories( $args )</signature> 323 <docrelurl>wp_dropdown_categories</docrelurl> 324 </item> 325 <item name="tag_description"> 326 <description>First available with WordPress Version 2.8, this template tag returns the description of a tag. A tag ID can be passed as a parameter, but if no tag ID is passed, the description current queried tag will be returned.</description> 327 <signature>tag_description( $tag_id )</signature> 328 <docrelurl>tag_description</docrelurl> 329 </item> 330 <item name="the_tags"> 331 <description>This template tag displays a link to the tag or tags a post belongs to. If no tags are associated with the current entry, the associated category is displayed instead. This tag should be used within The Loop.</description> 332 <signature>the_tags( $before, $separator, $after )</signature> 333 <docrelurl>the_tags</docrelurl> 334 </item> 335 <item name="wp_generate_tag_cloud"> 336 <description>Returns an HTML string that makes a tag cloud.</description> 337 <signature>wp_generate_tag_cloud( $tags, $args )</signature> 338 <docrelurl>wp_generate_tag_cloud</docrelurl> 339 </item> 340 <item name="wp_tag_cloud"> 341 <description>Available with WordPress Version 2.3, the wp_tag_cloud() function displays a list of tags in what is called a 'tag cloud', where the size of each tag is determined by how many times that particular tag has been assigned to posts. Beginning with Version 2.8, the taxonomy parameter was added so that any taxonomy could be used as the basis of generating the cloud. That means that a cloud for Categories or any other Custom Taxonomies can be presented to visitors.</description> 342 <signature>wp_tag_cloud( $args )</signature> 343 <docrelurl>wp_tag_cloud</docrelurl> 344 </item> 345 <item name="term_description"> 346 <description>First available with WordPress Version 2.8, this template tag returns the description of a given term. A term ID and taxonomy are as parameters. If no term ID is passed, the description current queried term (e.g. post category or tag) will be returned.</description> 347 <signature>term_description( $term_id, $taxonomy )</signature> 348 <docrelurl>term_description</docrelurl> 349 </item> 350 <item name="get_the_term_list"> 351 <description>Returns an HTML string of taxonomy terms associated with a post and given taxonomy. Terms are linked to their respective term listing pages.</description> 352 <signature>get_the_term_list( $id, $taxonomy, $before, $sep, $after )</signature> 353 <docrelurl>get_the_term_list</docrelurl> 354 </item> 355 <item name="the_terms"> 356 <description>Displays the terms of a custom taxonomy.</description> 357 <signature>the_terms( $id, $taxonomy, $before, $sep, $after )</signature> 358 <docrelurl>the_terms</docrelurl> 359 </item> 360 <item name="the_taxonomies"> 361 <description>This template tag can be used within The Loop to display the taxonomies for a post without specifying the Post ID. You can also use it outside The Loop to display the taxonomies for a specific post.</description> 362 <signature>the_taxonomies( $args )</signature> 363 <docrelurl>the_taxonomies</docrelurl> 364 </item> 365 <item name="cancel_comment_reply_link"> 366 <description>Displays a link which cancels the replying to a previous comment (a nested comment) and resets the comment form back to the default state.</description> 367 <signature>cancel_comment_reply_link('text')</signature> 368 <docrelurl>cancel_comment_reply_link</docrelurl> 369 </item> 370 <item name="comment_author"> 371 <description>Displays the comment author name; that is, the one supplied by the commenter. If no name is provided (and "User must fill out name and email" is not enabled under Discussion Options), WordPress will assign "Anonymous" as comment author. Use get_comment_author to retrieve the value.</description> 372 <signature>comment_author( $comment_ID )</signature> 373 <docrelurl>comment_author</docrelurl> 374 </item> 375 <item name="comment_author_email"> 376 <description>Displays the comment author's email address, not linked. An email address must be provided if "User must fill out name and email" is enabled under Discussion Options. Use get_comment_author_email to retrieve the value.</description> 377 <signature>comment_author_email( $comment_ID )</signature> 378 <docrelurl>comment_author_email</docrelurl> 379 </item> 380 <item name="comment_author_email_link"> 381 <description>Displays the comment author's email address, as a mailto link. An email address must be provided if "User must fill out name and email" is enabled under Discussion Options. This tag must be within The Loop, or a comment loop. Note: Displaying email addresses is not recommended, as it provides spam collection tools the opportunity to cull them from your site. Use get_comment_author_email_link to retrieve the value.</description> 382 <signature>comment_author_email_link('linktext', 'before', 'after')</signature> 383 <docrelurl>comment_author_email_link</docrelurl> 384 </item> 385 <item name="comment_author_IP"> 386 <description>Displays the comment author's IP address. This tag must be within The Loop, or a comment loop. Use get_comment_author_IP to retrieve the value.</description> 387 <signature>comment_author_IP($comment_ID)</signature> 388 <docrelurl>comment_author_IP</docrelurl> 389 </item> 390 <item name="comment_author_link"> 391 <description>Displays the comment author's name linked to his/her URL, if one was provided. Use get_comment_author_link to retrieve the value.</description> 392 <signature>comment_author_link( $comment_ID )</signature> 393 <docrelurl>comment_author_link</docrelurl> 394 </item> 395 <item name="comment_author_rss"> 396 <description>Display the current comment author in the feed.</description> 397 <signature>comment_author_rss()</signature> 398 <docrelurl>comment_author_rss</docrelurl> 399 </item> 400 <item name="comment_author_url"> 401 <description>Displays the comment author's URL (usually their web site), not linked. If the author provided no URL, this will display the URL of the current page instead. The tag get_comment_author_url returns an empty string in this case.</description> 402 <signature>comment_author_url( $comment_ID )</signature> 403 <docrelurl>comment_author_url</docrelurl> 404 </item> 405 <item name="comment_author_url_link"> 406 <description>Displays the comment author's URL (usually their web site), linked, if one was provided. This tag must be within The Loop, or a comment loop. Use get_comment_author_url_link to retrieve the value.</description> 407 <signature>comment_author_url_link('linktext', 'before', 'after')</signature> 408 <docrelurl>comment_author_url_link</docrelurl> 409 </item> 410 <item name="comment_class"> 411 <description></description> 412 <signature>comment_class()</signature> 413 <docrelurl>comment_class</docrelurl> 414 </item> 415 <item name="comment_date"> 416 <description>Displays the date a comment was posted. Use get_comment_date to retrieve the value.</description> 417 <signature>comment_date( 'd', $comment_ID )</signature> 418 <docrelurl>comment_date</docrelurl> 419 </item> 420 <item name="comment_excerpt"> 421 <description>Displays an excerpt (maximum of 20 words) of a comment's text. Use get_comment_excerpt to retrieve the value.</description> 422 <signature>comment_excerpt( $comment_ID )</signature> 423 <docrelurl>comment_excerpt</docrelurl> 424 </item> 425 <item name="comment_form_title"> 426 <description>Displays text based on comment reply status. This only affects users with Javascript disabled or pages without the comment-reply.js JavaScript loaded. This tag is normally used directly below <div id="respond"> and before the comment form.</description> 427 <signature>comment_form_title( $noreplytext, $replytext, $linktoparent )</signature> 428 <docrelurl>comment_form_title</docrelurl> 429 </item> 430 <item name="comment_form"> 431 <description>This tag outputs a complete commenting form for use within a template. Most strings and form fields may be controlled through the $args array passed into the function, while you may also choose to use the comment_form_default_fields filter to modify the array of default fields if you'd just like to add a new one or remove a single field. All fields are also individually passed through a filter of the form comment_form_field_$name where $name is the key used in the array of fields.</description> 432 <signature>comment_form( $args, $post_id )</signature> 433 <docrelurl>comment_form</docrelurl> 434 </item> 435 <item name="comment_ID"> 436 <description>Displays the numeric ID of the current comment. This tag must be within The Loop, or a comment loop. Use get_comment_ID to retrieve the value.</description> 437 <signature>comment_ID()</signature> 438 <docrelurl>comment_ID</docrelurl> 439 </item> 440 <item name="comment_id_fields"> 441 <description>Generates two hidden inputs for the comment form to identify the comment_post_ID and comment_parent for threaded comments. This tag must be within the <form> section of comments.php. New since WordPress version 2.7.</description> 442 <signature>comment_id_fields()</signature> 443 <docrelurl>comment_id_fields</docrelurl> 444 </item> 445 <item name="comment_reply_link"> 446 <description>Displays a link that lets users post a comment in reply to a specific comment. If JavaScript is enabled and the comment-reply.js JavaScript is loaded the link moves the comment form to just below the comment.</description> 447 <signature>comment_reply_link( $args, $comment, $post )</signature> 448 <docrelurl>comment_reply_link</docrelurl> 449 </item> 450 <item name="comment_text"> 451 <description>Displays the text of a comment. Use get_comment_text to retrieve the value.</description> 452 <signature>comment_text( $comment_ID )</signature> 453 <docrelurl>comment_text</docrelurl> 454 </item> 455 <item name="comment_text_rss"> 456 <description>Display the current comment content for use in the feeds.</description> 457 <signature>comment_text_rss()</signature> 458 <docrelurl>comment_text_rss</docrelurl> 459 </item> 460 <item name="comment_time"> 461 <description>Displays the time a comment was posted. This tag must be within The Loop, or a comment loop. Use get_comment_time to retrieve the value.</description> 462 <signature>comment_time('d')</signature> 463 <docrelurl>comment_time</docrelurl> 464 </item> 465 <item name="comment_type"> 466 <description>Displays the type of comment (regular comment, Trackback or Pingback) a comment entry is. This tag must be within The Loop, or a comment loop. Use get_comment_type to retrieve the value.</description> 467 <signature>comment_type('comment', 'trackback', 'pingback')</signature> 468 <docrelurl>comment_type</docrelurl> 469 </item> 470 <item name="comments_link"> 471 <description>The comments_link template tag displays the URL to the current post's comments. This tag must be within The Loop, or the loop set up for comments. Use get_comments_link to retrieve the value.</description> 472 <signature>comments_link()</signature> 473 <docrelurl>comments_link</docrelurl> 474 </item> 475 <item name="comments_number"> 476 <description>Displays the total number of comments, Trackbacks, and Pingbacks for the current post. This tag must be within The Loop. Use get_comments_number() to retrieve the value.</description> 477 <signature>comments_number( $zero, $one, $more )</signature> 478 <docrelurl>comments_number</docrelurl> 479 </item> 480 <item name="comments_popup_link"> 481 <description>Displays a link to the comments popup window if comments_popup_script() is used, otherwise it displays a normal link to comments. This tag must be within The Loop, or a comment loop, and it does nothing if is_single() or is_page() is true (even when within The Loop).</description> 482 <signature>comments_popup_link( $zero, $one, $more, $css_class, $none )</signature> 483 <docrelurl>comments_popup_link</docrelurl> 484 </item> 485 <item name="comments_popup_script"> 486 <description>Outputs the JavaScript code for a comments popup window. Used in tandem with comments_popup_link(), this tag can be used anywhere within a template, though is typically placed within the <head> portion of a page.</description> 487 <signature>comments_popup_script(width, height, 'file')</signature> 488 <docrelurl>comments_popup_script</docrelurl> 489 </item> 490 <item name="comments_rss_link"> 491 <description>This function has been deprecated, please use post_comments_feed_link(). Much like an RSS feed for your WordPress blog, this feature will display a link to the RSS feed for a given post's comments. By implementing the feature, your readers will be able to track the comment thread for a given post, perhaps encouraging them to stay connected to the conversation. This tag must be within The Loop, or the loop set up for comments.</description> 492 <signature>comments_rss_link('text', 'file')</signature> 493 <docrelurl>comments_rss_link</docrelurl> 494 </item> 495 <item name="get_avatar"> 496 <description>Retrieve the avatar for a user who provided a user ID or email address. Most commonly used in the comments section. This function is pluggable, however plugin authors wishing to change the gravatar output should use the get_avatar filter instead, for compatibility purposes.</description> 497 <signature>get_avatar( $id_or_email, $size, $default, $alt )</signature> 498 <docrelurl>get_avatar</docrelurl> 499 </item> 500 <item name="next_comments_link"> 501 <description>Display link to next comments pages.</description> 502 <signature>next_comments_link( $label, $max_page )</signature> 503 <docrelurl>next_comments_link</docrelurl> 504 </item> 505 <item name="paginate_comments_links"> 506 <description>Create pagination links for the comments on the current post. Basically this is a macro to paginate_links() which sets the functional options of paginate_links() to make it work for comments. But you may use all the parameters of paginate_links() to style the output of paginate_comments_links().</description> 507 <signature>paginate_comments_links( $args )</signature> 508 <docrelurl>paginate_comments_links</docrelurl> 509 </item> 510 <item name="permalink_comments_rss"> 511 <description>Displays the permalink to the post to which a comment belongs, formatted for RSS. Typically used in the RSS comment feed template. This tag must be within The Loop, or a comment loop.</description> 512 <signature>permalink_comments_rss()</signature> 513 <docrelurl>permalink_comments_rss</docrelurl> 514 </item> 515 <item name="previous_comments_link"> 516 <description>Display the previous comments page link.</description> 517 <signature>previous_comments_link( $label )</signature> 518 <docrelurl>previous_comments_link</docrelurl> 519 </item> 520 <item name="wp_list_comments"> 521 <description>Displays all comments for a post or Page based on a variety of parameters including ones set in the administration area. See also: Migrating Plugins and Themes to 2.7</description> 522 <signature>wp_list_comments( $args )</signature> 523 <docrelurl>wp_list_comments</docrelurl> 524 </item> 525 <item name="the_permalink"> 526 <description>Displays the URL for the permalink to the post currently being processed in The Loop. This tag must be within The Loop, and is generally used to display the permalink for each post, when the posts are being displayed. Since this template tag is limited to displaying the permalink for the post that is being processed, you cannot use it to display the permalink to an arbitrary post on your weblog. Refer to get_permalink() if you want to get the permalink for a post, given its unique post id.</description> 527 <signature>the_permalink()</signature> 528 <docrelurl>the_permalink</docrelurl> 529 </item> 530 <item name="permalink_anchor"> 531 <description>Outputs a permalink anchor identifier or id (<a id="....) for a post. This is useful for linking to a particular post on a page displaying several posts, such as an archive page. This tag must be within The Loop.</description> 532 <signature>permalink_anchor( $type )</signature> 533 <docrelurl>permalink_anchor</docrelurl> 534 </item> 535 <item name="get_permalink"> 536 <description>Returns the permalink to a post for use in PHP. It does NOT display the permalink and can be used outside of The Loop. On failure returns false. Note that when used outside The Loop on a posts page (index, archive, etc.) without the ID parameter, it will return the URL of the last post in The Loop, not the permalink for the current page. See: http://core.trac.wordpress.org/ticket/9963</description> 537 <signature>get_permalink( $id )</signature> 538 <docrelurl>get_permalink</docrelurl> 539 </item> 540 <item name="get_post_permalink"> 541 <description>The get_post_permalink template tag retrieves the permalink for a post with a custom post type.</description> 542 <signature>get_post_permalink( $id, $leavename, $sample )</signature> 543 <docrelurl>get_post_permalink</docrelurl> 544 </item> 545 <item name="post_permalink"> 546 <description>Returns the permalink for a post with a custom post type.</description> 547 <signature>post_permalink()</signature> 548 <docrelurl>post_permalink</docrelurl> 549 </item> 550 <item name="get_page_link"> 551 <description>Retrieves the permalink for the current page (if in The Loop) or any arbitrary page ID if passed as the first argument. All arguments are optional. All arguments default to false. If $id is passed, it will be the id of the page whose link is returned. $leavename can be used to toggle off the switching out of "%pagename%" in permalinks. $sample returns a sample permalink.</description> 552 <signature>get_page_link($id, $leavename, $sample)</signature> 553 <docrelurl>get_page_link</docrelurl> 554 </item> 555 <item name="get_attachment_link"> 556 <description>Returns the URI of the page for an attachment.</description> 557 <signature>get_attachment_link($id)</signature> 558 <docrelurl>get_attachment_link</docrelurl> 559 </item> 560 <item name="get_bookmark"> 561 <description>Retrieve Bookmark data based on bookmark link ID.</description> 562 <signature>get_bookmark( $bookmark, $output, $filter )</signature> 563 <docrelurl>get_bookmark</docrelurl> 564 </item> 565 <item name="get_bookmark_field"> 566 <description>Retrieve single bookmark data item or field.</description> 567 <signature>get_bookmark_field( $field, $bookmark, $context )</signature> 568 <docrelurl>get_bookmark_field</docrelurl> 569 </item> 570 <item name="get_bookmarks"> 571 <description>This function returns an array of bookmarks found in the Administration > Links > Edit panel. This Template Tag allows the user to retrieve the bookmark information directly.</description> 572 <signature>get_bookmarks( $args )</signature> 573 <docrelurl>get_bookmarks</docrelurl> 574 </item> 575 <item name="body_class"> 576 <description>Themes have a template tag for the body tag which will help theme authors to style more effectively with CSS. The Template Tag is called body_class. This function gives the body element different classes and can be added, typically, in the header.php's HTML body tag.</description> 577 <signature>body_class( $class )</signature> 578 <docrelurl>body_class</docrelurl> 579 </item> 580 <item name="next_image_link"> 581 <description>This creates a link to the next image attached to the current post.</description> 582 <signature>next_image_link( $size, $text )</signature> 583 <docrelurl>next_image_link</docrelurl> 584 </item> 585 <item name="next_post_link"> 586 <description>Used on single post permalink pages, this template tag displays a link to the next post which exists in chronological order from the current post. This tag must be used in The Loop.</description> 587 <signature>next_post_link('format', 'link', 'in_same_cat', 'excluded_categories')</signature> 588 <docrelurl>next_post_link</docrelurl> 589 </item> 590 <item name="next_posts_link"> 591 <description>Prints a link to the next set of posts within the current query. If you need the values for use in PHP, use get_next_posts_link(). Because post queries are usually sorted in reverse chronological order, next_posts_link() usually points to older entries (toward the end of the set) and prev_posts_link() usually points to newer entries (toward the beginning of the set).</description> 592 <signature>next_posts_link( $label , $max_pages )</signature> 593 <docrelurl>next_posts_link</docrelurl> 594 </item> 595 <item name="post_class"> 596 <description>WordPress Themes have a template tag for the post HTML tag which will help theme authors to style more effectively with CSS. The Template Tag is called post_class. This function prints out different post container classes which can be added, typically, in the index.php, single.php, and other template files featuring post content, typically in the HTML <div id="post"> tag. If you don't want the post classes to be echoed use get_post_class(). The post_class template tag creates CSS selectors to style content only within the post content area. For information on styling entire pages based upon a distinctive CSS selector, see body_class().</description> 597 <signature>post_class()</signature> 598 <docrelurl>post_class</docrelurl> 599 </item> 600 <item name="post_password_required"> 601 <description>Whether post requires password and correct password has been provided.</description> 602 <signature>post_password_required( $post )</signature> 603 <docrelurl>post_password_required</docrelurl> 604 </item> 605 <item name="posts_nav_link"> 606 <description>Displays links for next and previous pages. Useful for providing "paged" navigation of index, category and archive pages. For displaying next and previous pages of posts see next_posts_link and previous_posts_link(). For displaying next and previous post navigation on individual posts, see next_post_link() and previous_post_link().</description> 607 <signature>posts_nav_link( $sep, $prelabel, $nextlabel )</signature> 608 <docrelurl>posts_nav_link</docrelurl> 609 </item> 610 <item name="previous_image_link"> 611 <description>This creates a link to the previous image attached to the current post.</description> 612 <signature>previous_image_link( $size, $text )</signature> 613 <docrelurl>previous_image_link</docrelurl> 614 </item> 615 <item name="previous_post_link"> 616 <description>Used on single post permalink pages, this template tag displays a link to the previous post which exists in chronological order from the current post. This tag must be used in The Loop.</description> 617 <signature>previous_post_link($format, $link, $in_same_cat = false, $excluded_categories = '')</signature> 618 <docrelurl>previous_post_link</docrelurl> 619 </item> 620 <item name="previous_posts_link"> 621 <description>Prints a link to the previous set of posts within the current query. If you need the values for use in PHP, use get_previous_posts_link(). Because post queries are usually sorted in reverse chronological order, next_posts_link() usually points to older entries (toward the end of the set) and previous_posts_link() usually points to newer entries (toward the beginning of the set).</description> 622 <signature>previous_posts_link( $label , $max_pages )</signature> 623 <docrelurl>previous_posts_link</docrelurl> 624 </item> 625 <item name="sticky_class"> 626 <description>Displays the Sticky Posts class on a post if applicable. This tag must be within The Loop.</description> 627 <signature>sticky_class()</signature> 628 <docrelurl>sticky_class</docrelurl> 629 </item> 630 <item name="the_content"> 631 <description>Displays the contents of the current post. This tag must be within The_Loop. If the quicktag <!--more--> is used in a post to designate the "cut-off" point for the post to be excerpted, the_content() tag will only show the excerpt up to the <!--more--> quicktag point on non-single/non-permalink post pages. By design, the_content() tag includes a parameter for formatting the <!--more--> content and look, which creates a link to "continue reading" the full post.</description> 632 <signature>the_content( $more_link_text, $strip_teaser )</signature> 633 <docrelurl>the_content</docrelurl> 634 </item> 635 <item name="the_content_rss"> 636 <description>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. The value of '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.</description> 637 <signature>the_content_rss( $more_link_text, $stripteaser, $more_file, $cut, $encode_html )</signature> 638 <docrelurl>the_content_rss</docrelurl> 639 </item> 640 <item name="the_excerpt"> 641 <description>Displays the excerpt of the current post with [...] at the end, which is not a "read more" link. If you do not provide an explicit excerpt to a post (in the post editor's optional excerpt field), it will display an automatic excerpt which refers to the first 55 words of the post's content. Also in the latter case, HTML tags and graphics are stripped from the excerpt's content. This tag must be within The Loop. Note: If the current post is an attachment, such as in the attachment.php and image.php template loops, then the attachment caption is displayed. Captions do not include the excerpt [...] marks.</description> 642 <signature>the_excerpt()</signature> 643 <docrelurl>the_excerpt</docrelurl> 644 </item> 645 <item name="the_excerpt_rss"> 646 <description>Display the post excerpt for the feed.</description> 647 <signature>the_excerpt_rss()</signature> 648 <docrelurl>the_excerpt_rss</docrelurl> 649 </item> 650 <item name="the_ID"> 651 <description>Displays the numeric ID of the current post. This tag must be within The Loop. Note: This function displays the ID of the post, to return the ID use get_the_ID().</description> 652 <signature>the_ID()</signature> 653 <docrelurl>the_ID</docrelurl> 654 </item> 655 <item name="the_meta"> 656 <description>This is a simple built-in function for displaying custom fields for the current post, known as the "post-meta" (stored in the wp_postmeta table). It formats the data into an unordered list (see output below). It must be used from within The Loop or in a theme file that handles data from a single post (e.g. single.php). the_meta() will ignore meta_keys (i.e. field names) that begin with an underscore. For more information on this tag, see Custom Fields.</description> 657 <signature>the_meta()</signature> 658 <docrelurl>the_meta</docrelurl> 659 </item> 660 <item name="the_shortlink"> 661 <description>Used on single post permalink pages, this template tag displays a "URL shortening" link for the current post. By default, this will mean the URL has a format of /?p=1234, and will only appear if pretty permalinks are enabled. However, this feature is limited by design and intended to be leveraged by plugins that may offer links in a different format, a custom format, or even a format provided by a third-party URL shortening service. Refer to get_permalink() if you want to return the permalink to a post for use in PHP. This tag can be used outside of The Loop. Note: This function outputs the complete shortlink for the post, to return the shortlink use wp_get_shortlink().</description> 662 <signature>the_shortlink( $text, $title, $before, $after )</signature> 663 <docrelurl>the_shortlink</docrelurl> 664 </item> 665 <item name="the_title"> 666 <description>Displays or returns the title of the current post. This tag must be within The Loop. If the post is protected or private, this will be noted by the words "Protected: " or "Private: " prepended to the title.</description> 667 <signature>the_title( $before, $after, $echo )</signature> 668 <docrelurl>the_title</docrelurl> 669 </item> 670 <item name="the_title_attribute"> 671 <description>Displays or returns the title of the current post. It somewhat duplicates the functionality of the_title(), but provides a 'clean' version of the title for use in HTML attributes by stripping HTML tags and converting certain characters (including quotes) to their character entity equivalent; it also uses query-string style parameters. This tag must be within The Loop.</description> 672 <signature>the_title_attribute( $args )</signature> 673 <docrelurl>the_title_attribute</docrelurl> 674 </item> 675 <item name="the_title_rss"> 676 <description>Display the post title in the feed.</description> 677 <signature>the_title_rss()</signature> 678 <docrelurl>the_title_rss</docrelurl> 679 </item> 680 <item name="wp_link_pages"> 681 <description>Displays page-links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times). This works in much the same way as link_pages() (deprecated), the difference being that arguments are given in query string format. This tag must be within The_Loop.</description> 682 <signature>wp_link_pages( $args )</signature> 683 <docrelurl>wp_link_pages</docrelurl> 684 </item> 685 <item name="wp_get_attachment_link"> 686 <description>Returns an HTML hyperlink to an attachment file or page, containing either</description> 687 <signature>wp_get_attachment_link($id, $size, $permalink, $icon, $text)</signature> 688 <docrelurl>wp_get_attachment_link</docrelurl> 689 </item> 690 <item name="the_attachment_link"> 691 <description>Outputs an HTML hyperlink to an attachment file or page, containing either</description> 692 <signature>the_attachment_link( $id, $fullsize, $deprecated, $permalink)</signature> 693 <docrelurl>the_attachment_link</docrelurl> 694 </item> 695 <item name="the_search_query"> 696 <description>Displays the search query for the current request, if a search was made. This function can be used safely within HTML attributes (as in the "search box" example, below). Use get_search_query to retrieve the value.</description> 697 <signature>the_search_query()</signature> 698 <docrelurl>the_search_query</docrelurl> 699 </item> 700 <item name="is_attachment"> 701 <description>This Conditional Tag checks if an attachment is being displayed. An attachment is an image or other file uploaded through the post editor's upload utility. Attachments can be displayed on their own 'page' or template. For more information, see Using Image and File Attachments. This is a boolean function, meaning it returns either TRUE or FALSE.</description> 702 <signature>is_attachment()</signature> 703 <docrelurl>is_attachment</docrelurl> 704 </item> 705 <item name="wp_attachment_is_image"> 706 <description>This function determines if a post's attachment is an image. It returns TRUE if the attachment is an image, FALSE if not. The accepted file extensions/mime types are: .jpg, .jpeg, .gif, .png.</description> 707 <signature>wp_attachment_is_image( $post_id )</signature> 708 <docrelurl>wp_attachment_is_image</docrelurl> 709 </item> 710 <item name="wp_get_attachment_image"> 711 <description>Returns an HTML image element representing an attachment file, if there is any, otherwise an empty string.</description> 712 <signature>wp_get_attachment_image( $attachment_id, $size, $icon )</signature> 713 <docrelurl>wp_get_attachment_image</docrelurl> 714 </item> 715 <item name="wp_get_attachment_image_src"> 716 <description>Returns an array with the image attributes "url", "width" and "height", of an image attachment file. 717 Note: For just the image src, use the first element in the returned array.</description> 718 <signature>wp_get_attachment_image_src( $attachment_id, $size, $icon )</signature> 719 <docrelurl>wp_get_attachment_image_src</docrelurl> 720 </item> 721 <item name="wp_get_attachment_metadata"> 722 <description>Retrieve attachment meta field for attachment ID.</description> 723 <signature>wp_get_attachment_metadata( $post_id, $unfiltered )</signature> 724 <docrelurl>wp_get_attachment_metadata</docrelurl> 725 </item> 726 <item name="get_the_date"> 727 <description>The get_the_date template tag retrieves the date the current $post was written. Unlike the_date() this tag will always return the date. Modify output with 'get_the_date' filter.</description> 728 <signature>get_the_date( $d )</signature> 729 <docrelurl>get_the_date</docrelurl> 730 </item> 731 <item name="the_date"> 732 <description>Displays or returns the date of a post, or a set of posts if published on the same day.</description> 733 <signature>the_date( $format, $before, $after, $echo )</signature> 734 <docrelurl>the_date</docrelurl> 735 </item> 736 <item name="the_date_xml"> 737 <description>Displays the date of the post in YYYY-MM-DD format (ex: 2004-09-24). This tag must be used within The Loop.</description> 738 <signature>the_date_xml()</signature> 739 <docrelurl>the_date_xml</docrelurl> 740 </item> 741 <item name="the_modified_author"> 742 <description>The author who last modified a post can be displayed by using this Template Tag. This tag must be used within The Loop. Note: the_modified_author was first available with Version 2.8.</description> 743 <signature>the_modified_author()</signature> 744 <docrelurl>the_modified_author</docrelurl> 745 </item> 746 <item name="the_modified_date"> 747 <description>This tag displays the date (and time) a post was last modified. This tag works just like the_modified_time(), which also displays the time/date a post was last modified. This tag must be used within The Loop. If no format parameter is specified, the Default date format (please note that says Date format) setting from Administration > Settings > General is used for the display format. If the post or page is not yet modified, the modified date is the same as the creation date. Use get_the_modified_date to retrieve the value.</description> 748 <signature>the_modified_date( $d, $before, $after, $echo )</signature> 749 <docrelurl>the_modified_date</docrelurl> 750 </item> 751 <item name="the_modified_time"> 752 <description>This tag displays the time (and date) a post was last modified and is similar to the functionality of the_time(), which displays the time (and date) a post was created. This tag must be used within The Loop. If no format parameter is specified, the Default date format (please note that says Date format) setting from Administration > Settings > General is used for the display format. If the post or page is not yet modified, the modified time is the same as the creation time. If you want to display both the modified time and the creation time, you may want to use an if statement (e.g. if (get_the_modified_time() != get_the_time())) to avoid showing the same time/date twice. Use get_the_modified_time to retrieve the value.</description> 753 <signature>the_modified_time( $d )</signature> 754 <docrelurl>the_modified_time</docrelurl> 755 </item> 756 <item name="the_time"> 757 <description>Displays the time of the current post. This tag must be used within The Loop.</description> 758 <signature>the_time( $d )</signature> 759 <docrelurl>the_time</docrelurl> 760 </item> 761 <item name="wp_get_shortlink"> 762 <description>Returns the Short Link to a post for use in PHP. It does NOT display the short link.</description> 763 <signature>wp_get_shortlink()</signature> 764 <docrelurl>wp_get_shortlink</docrelurl> 765 </item> 766 <item name="has_post_thumbnail"> 767 <description>Returns a boolean if a post has a Post Thumbnail attached (true) or not (false). Note: To enable post thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails.</description> 768 <signature>has_post_thumbnail( $post_id )</signature> 769 <docrelurl>has_post_thumbnail</docrelurl> 770 </item> 771 <item name="get_post_thumbnail_id"> 772 <description>Note: To enable post thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails.</description> 773 <signature>get_post_thumbnail_id( $post_id )</signature> 774 <docrelurl>get_post_thumbnail_id</docrelurl> 775 </item> 776 <item name="the_post_thumbnail"> 777 <description>Display Post Thumbnail as set in post's edit screen. This tag must be within The Loop. Note: To enable post thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails.</description> 778 <signature>the_post_thumbnail( $size, $attr )</signature> 779 <docrelurl>the_post_thumbnail</docrelurl> 780 </item> 781 <item name="get_the_post_thumbnail"> 782 <description>Gets Post Thumbnail as set in post's or page's edit screen and returns an HTML image element representing a Post Thumbnail, if there is any, otherwise an empty string. Note: To enable Post Thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails.</description> 783 <signature>get_the_post_thumbnail( $id, $size, $attr )</signature> 784 <docrelurl>get_the_post_thumbnail</docrelurl> 785 </item> 786 <item name="wp_nav_menu"> 787 <description>Displays a navigation menu created in the Appearance → Menus panel. Given a theme_location parameter, the function displays the menu assigned to that location, or nothing if no such location exists or no menu is assigned to it. If not given a theme_location parameter, the function displays</description> 788 <signature>wp_nav_menu($args)</signature> 789 <docrelurl>wp_nav_menu</docrelurl> 790 </item> 69 <item name= "get_adjacent_post"> 70 <description>Retrieve adjacent post. Can either be next or previous post. </description> 71 <signature>get_adjacent_post( $in_same_cat, $excluded_categories, $previous ) </signature> 72 <docrelurl>get_adjacent_post</docrelurl> 73 </item> 74 <item name= "get_boundary_post"> 75 <description>Get the first or last post by publish date </description> 76 <signature>get_boundary_post( $in_same_cat, $excluded_categories, $start ); </signature> 77 <docrelurl>get_boundary_post</docrelurl> 78 </item> 79 <item name= "get_extended"> 80 <description> 81 Get extended entry info ( <!--more--> ). There should not be any space after the second dash and before the word 'more'. There can be text or space(s) after the word 'more', but won't be referenced. The returned array has 'main' and 'extended' keys. Main has the text before the <code> 82 <!--more--> 83 </code> . The 'extended' key has the content after the <code> 84 <!--more--> 85 </code> comment. 86 </description> 87 <signature>get_extended( $post ) </signature> 88 <docrelurl>get_extended</docrelurl> 89 </item> 90 <item name= "get_next_post"> 91 <description>Retrieve next post that is adjacent to current post. </description> 92 <signature>get_next_post( $in_same_cat, $excluded_categories ) </signature> 93 <docrelurl>get_next_post</docrelurl> 94 </item> 95 <item name= "get_next_posts_link"> 96 <description>Return a link to the set of posts of the current page. </description> 97 <signature>echo get_next_posts_link(); </signature> 98 <docrelurl>get_next_posts_link</docrelurl> 99 </item> 100 <item name= "get_permalink"> 101 <description>Returns the permalink to a post or page for use in PHP. It does NOT display the permalink and can be used outside of The Loop. On failure returns false. Note that when used outside The Loop on a posts page (index, archive, etc.) without the ID parameter, it will return the URL of the last post in The Loop, not the permalink for the current page. See: http://core.trac.wordpress.org/ticket/9963 </description> 102 <signature></signature> 103 <docrelurl>get_permalink</docrelurl> 104 </item> 105 <item name= "get_the_excerpt"> 106 <description> 107 Returns the post excerpt for assignment to a variable. This tag must be within The Loop. 108 If you only wish to print the excerpt you may prefer to use the_excerpt(). 109 </description> 110 <signature>$excerpt = get_the_excerpt( $deprecated ) </signature> 111 <docrelurl>get_the_excerpt</docrelurl> 112 </item> 113 <item name= "get_the_post_thumbnail"> 114 <description>Gets Post Thumbnail as set in post's or page's edit screen and returns an HTML image element representing a Post Thumbnail, if there is any, otherwise an empty string. Note: To enable Post Thumbnails, the current theme must include add_theme_support( 'post-thumbnails' ); in its functions.php file. See also Post Thumbnails. </description> 115 <signature>$pages = get_pages(array('child_of' => 1)); </signature> 116 <docrelurl>get_the_post_thumbnail</docrelurl> 117 </item> 118 <item name= "get_post"> 119 <description>Takes a post ID and returns the database record for that post. You can specify, by means of the $output parameter, how you would like the results returned. </description> 120 <signature>get_post( $post_id, $output ); </signature> 121 <docrelurl>get_post</docrelurl> 122 </item> 123 <item name= "get_post_ancestors"> 124 <description>Retrieve the parents of the post based on the post ID. </description> 125 <signature>get_post_ancestors( $post ) </signature> 126 <docrelurl>get_post_ancestors</docrelurl> 127 </item> 128 <item name= "get_post_mime_type"> 129 <description>Retrieve the mime type of an attachment based on the ID. This function can be used with any Post Type, but it makes more sense with Attachments. </description> 130 <signature>get_post_mime_type( $ID ) </signature> 131 <docrelurl>get_post_mime_type</docrelurl> 132 </item> 133 <item name= "get_post_status"> 134 <description>Retrieve the post status based on the Post ID. If the post ID is of an attachment, then the parent post status will be given instead. </description> 135 <signature>get_post_status( $ID ) </signature> 136 <docrelurl>get_post_status</docrelurl> 137 </item> 138 <item name= "get_post_format"> 139 <description>Returns the post format of a post. This will usually be called in the the loop, but can be used anywhere if a post ID is provided. </description> 140 <signature>$format = get_post_format( $post_id ); </signature> 141 <docrelurl>get_post_format</docrelurl> 142 </item> 143 <item name= "get_delete_post_link"> 144 <description>Returns URL to move a post to the trash as string value. Can be used within the WordPress loop or outside of it. Can be used with pages, posts, attachments, and revisions. </description> 145 <signature></signature> 146 <docrelurl>get_delete_post_link</docrelurl> 147 </item> 148 <item name= "get_previous_post"> 149 <description>Retrieve previous post that is adjacent to current post. </description> 150 <signature>get_previous_post( $in_same_cat, $excluded_categories ) </signature> 151 <docrelurl>get_previous_post</docrelurl> 152 </item> 153 <item name= "previous_posts_link"> 154 <description>Prints a link to the previous set of posts within the current query. If you need the values for use in PHP, use get_previous_posts_link(). Because post queries are usually sorted in reverse chronological order, next_posts_link() usually points to older entries (toward the end of the set) and previous_posts_link() usually points to newer entries (toward the beginning of the set). </description> 155 <signature>previous_posts_link(); </signature> 156 <docrelurl>previous_posts_link</docrelurl> 157 </item> 158 <item name= "is_single"> 159 <description>This Conditional Tag checks if any single post is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 160 <signature>is_single($post); </signature> 161 <docrelurl>is_single</docrelurl> 162 </item> 163 <item name= "is_sticky"> 164 <description>This Conditional Tag checks if "Stick this post to the front page" check box has been checked for the current post. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 165 <signature>is_sticky($post_ID); </signature> 166 <docrelurl>is_sticky</docrelurl> 167 </item> 168 <item name= "the_ID"> 169 <description>Displays the numeric ID of the current post. This tag must be within The Loop. Note: This function displays the ID of the post, to return the ID use get_the_ID(). </description> 170 <signature></signature> 171 <docrelurl>the_ID</docrelurl> 172 </item> 173 <item name= "the_date"> 174 <description>Displays or returns the date of a post, or a set of posts if published on the same day. </description> 175 <signature>the_date('Y-m-d', '<h2>', '</h2>');</signature> 176 <docrelurl>the_date</docrelurl> 177 </item> 178 <item name= "wp_get_recent_posts"> 179 <description>Retrieve the recent posts. </description> 180 <signature>wp_get_recent_posts( $args ) </signature> 181 <docrelurl>wp_get_recent_posts</docrelurl> 182 </item> 183 <item name= "wp_get_single_post"> 184 <description>Retrieve a single post, based on post ID. </description> 185 <signature>wp_get_single_post( $postid, $mode ) </signature> 186 <docrelurl>wp_get_single_post</docrelurl> 187 </item> 188 <item name= "register_post_type"> 189 <description>Create or modify a post type. Do not use register_post_type before init. </description> 190 <signature>register_post_type( $post_type, $args ) </signature> 191 <docrelurl>register_post_type</docrelurl> 192 </item> 193 <item name= "is_post_type_archive"> 194 <description>Is the query for a post type archive page? </description> 195 <signature>is_post_type_archive( $post_types ); </signature> 196 <docrelurl>is_post_type_archive</docrelurl> 197 </item> 198 <item name= "post_type_archive_title"> 199 <description>Display or retrieve title for a post type archive. This is optimized for archive.php and archive-{posttype}.php template files for displaying the title of the post type. </description> 200 <signature>post_type_archive_title( $prefix, $display ); </signature> 201 <docrelurl>post_type_archive_title</docrelurl> 202 </item> 203 <item name= "add_post_type_support"> 204 <description>Register support of certain features for a given post type (s). All features are directly associated with a functional area of the edit screen, such as the editor or a meta box. Additionally, the 'revisions' feature dictates whether the post type will store revisions, and the 'comments' feature dictates whether the comments count will show on the edit screen. Typically add_post_type_support() should be attached to the 'init' action hook. </description> 205 <signature>add_post_type_support( $post_type, $supports ) </signature> 206 <docrelurl>add_post_type_support</docrelurl> 207 </item> 208 <item name= "remove_post_type_support"> 209 <description>Remove support of certain features for a given post type (s). All features are directly associated with a functional area of the edit screen, such as the editor or a meta box. Additionally, the 'revisions' feature dictates whether the post type will store revisions, and the 'comments' feature dictates whether the comments count will show on the edit screen. Typically remove_post_type_support() should be attached to the 'init' action hook. </description> 210 <signature>remove_post_type_support( $post_type, $supports ) </signature> 211 <docrelurl>remove_post_type_support</docrelurl> 212 </item> 213 <item name= "post_type_supports"> 214 <description>Checks a post type's support for a given feature. </description> 215 <signature></signature> 216 <docrelurl>post_type_supports</docrelurl> 217 </item> 218 <item name= "set_post_type"> 219 <description>Updates the post type for the post ID. The page or post cache will be cleaned for the post ID. @uses $wpdb name a few. </description> 220 <signature>set_post_type( $post_id, $post_type ); </signature> 221 <docrelurl>set_post_type</docrelurl> 222 </item> 223 <item name= "post_type_exists"> 224 <description>This Conditional Tag checks if a post type exists by passing a post type name an argument. This is a boolean function and uses a global $wp_post_types variable for checking the post type existence, meaning it returns either TRUE if the post type exists or FALSE if it doesn't exist. The post type must be a registered post type. </description> 225 <signature>post_type_exists( $post_type ); </signature> 226 <docrelurl>post_type_exists</docrelurl> 227 </item> 228 <item name= "get_post_type"> 229 <description>Retrieve the post type of the current post or of a given post. </description> 230 <signature>get_post_type( $post ) </signature> 231 <docrelurl>get_post_type</docrelurl> 232 </item> 233 <item name= "get_post_types"> 234 <description>Returns the registered post types as found in $wp_post_types. </description> 235 <signature>$post_types=get_post_types(); </signature> 236 <docrelurl>get_post_types</docrelurl> 237 </item> 238 <item name= "get_post_type_archive_link"> 239 <description>Retrieve the permalink for a post type archive. </description> 240 <signature>get_post_type_archive_link( $post_type ); </signature> 241 <docrelurl>get_post_type_archive_link</docrelurl> 242 </item> 243 <item name= "get_post_type_object"> 244 <description>Retrieves an object which describes any registered post type (i.e. built-in types like 'post' and 'page', or any user-created custom post type). </description> 245 <signature>get_post_type_object($post_type); </signature> 246 <docrelurl>get_post_type_object</docrelurl> 247 </item> 248 <item name= "get_post_type_capabilities"> 249 <description>Returns information about the post type capabilities of an post type object </description> 250 <signature>get_post_type_capabilities( $args ) </signature> 251 <docrelurl>get_post_type_capabilities</docrelurl> 252 </item> 253 <item name= "get_post_type_labels"> 254 <description>Builds an object with all post type labels out of a post type object Accepted keys of the label array in the post type object: </description> 255 <signature>get_post_type_labels( $post_type_object ); </signature> 256 <docrelurl>get_post_type_labels</docrelurl> 257 </item> 258 <item name= "is_post_type_hierarchical"> 259 <description>This Conditional Tag checks if the post type is hierarchical. This is a boolean function, meaning it returns either TRUE or FALSE (A false return value might also mean that the post type does not exist). Checks to make sure that the post type exists first. Then gets the post type object, and finally returns the hierarchical value in the object. </description> 260 <signature>is_post_type_hierarchical( $post_type) </signature> 261 <docrelurl>is_post_type_hierarchical</docrelurl> 262 </item> 263 <item name= "wp_delete_post"> 264 <description>Removes a post, attachment, or page. When the post and page goes, everything that is tied to it is deleted also. This includes comments, post meta fields, and terms associated with the post. </description> 265 <signature></signature> 266 <docrelurl>wp_delete_post</docrelurl> 267 </item> 268 <item name= "wp_insert_post"> 269 <description>This function inserts posts (and pages) in the database. It sanitizes variables, does some checks, fills in missing variables like date/time, etc. It takes an object as its argument and returns the post ID of the created post (or 0 if there is an error). </description> 270 <signature></signature> 271 <docrelurl>wp_insert_post</docrelurl> 272 </item> 273 <item name= "wp_publish_post"> 274 <description>Publish a post by transitioning the post status. Note: This function does not do anything except transition the post status. If you want to ensure post_name is set, use wp_update_post() instead. </description> 275 <signature>wp_publish_post( $post_id ) </signature> 276 <docrelurl>wp_publish_post</docrelurl> 277 </item> 278 <item name= "wp_update_post"> 279 <description>This function updates posts (and pages) in the database. To work as expected, it is necessary to pass the ID of the post to be updated. Note that when the post is "updated", the existing Post record is duplicated for audit/revision purposes. The primary record is then updated with the new values. Category associations, custom fields, post meta, and other related entries continue to be linked to the primary Post record. </description> 280 <signature></signature> 281 <docrelurl>wp_update_post</docrelurl> 282 </item> 283 <item name= "get_all_page_ids"> 284 <description>Get a list of page IDs. </description> 285 <signature>get_all_page_ids() </signature> 286 <docrelurl>get_all_page_ids</docrelurl> 287 </item> 288 <item name= "get_ancestors"> 289 <description>Returns an array containing the parents of the given object. </description> 290 <signature>get_ancestors( 208, 'category' ); </signature> 291 <docrelurl>get_ancestors</docrelurl> 292 </item> 293 <item name= "get_page"> 294 <description>Retrieves page data given a page ID or page object. Pages provide a way to have static content that will not affect things like articles or archives or any other blog entry features of WordPress. Its simply a way to turn a blog entry into static content. </description> 295 <signature>get_page( $page_id ) </signature> 296 <docrelurl>get_page</docrelurl> 297 </item> 298 <item name= "get_page_link"> 299 <description>Retrieves the permalink for the current page (if in The Loop) or any arbitrary page ID if passed as the first argument. All arguments are optional. All arguments default to false. If $id is passed, it will be the id of the page whose link is returned. $leavename can be used to toggle off the switching out of "%pagename%" in permalinks. $sample returns a sample permalink. </description> 300 <signature>get_page_link($id, $leavename, $sample); </signature> 301 <docrelurl>get_page_link</docrelurl> 302 </item> 303 <item name= "get_page_by_path"> 304 <description>Retrieves a page given its path. </description> 305 <signature>get_page_by_path( $page_path, $output, $post_type ) </signature> 306 <docrelurl>get_page_by_path</docrelurl> 307 </item> 308 <item name= "get_page_by_title"> 309 <description>Retrieves a post given its title. If more that one post uses the same title, the post with the smallest ID will be returned. Because this function uses the MySQL '=' comparison the $page_title will usually be matched as case insensitive with default collating. </description> 310 <signature> 311 $page = get_page_by_title( 'About' ); 312 wp_list_pages( 'exclude=' . $page->ID ); 313 </signature> 314 <docrelurl>get_page_by_title</docrelurl> 315 </item> 316 <item name= "get_page_children"> 317 <description>Retrieve child pages from list of pages matching page ID. Matches against the pages parameter against the page ID. Also matches all children for the same to retrieve all children of a page. Does not make any SQL queries to get the children. </description> 318 <signature>&get_page_children( $page_id, $pages ) </signature> 319 <docrelurl>get_page_children</docrelurl> 320 </item> 321 <item name= "get_page_uri"> 322 <description>Builds URI for a page. Sub pages will be in the "directory" under the parent page post name. </description> 323 <signature>get_page_uri( $page_id ) </signature> 324 <docrelurl>get_page_uri</docrelurl> 325 </item> 326 <item name= "get_pages"> 327 <description>This function is used to get a list of all the pages that are defined in the blog. Essentially get_pages gives you an array of the pages, and that array is not tree-like. See the wp_list_pages() Template Tag for the output of page titles in a tree-like fashion. Note that, although similar to get_posts, several of the parameter names and values differ. </description> 328 <signature>$mypages = get_pages( array( 'child_of' => $post->ID, 'sort_column' => 'post_date', 'sort_order' => 'desc' ) );</signature> 329 <docrelurl>get_pages</docrelurl> 330 </item> 331 <item name= "is_page"> 332 <description>This Conditional Tag checks if Pages are being displayed. This is a boolean function, meaning it returns either TRUE or FALSE. This tag must be used BEFORE The Loop and does not work inside The Loop (see Notes below). </description> 333 <signature>is_page($page); </signature> 334 <docrelurl>is_page</docrelurl> 335 </item> 336 <item name= "page_uri_index"> 337 <description>Retrieve all pages and attachments for pages URIs. The attachments are for those that have pages as parents and will be retrieved. </description> 338 <signature>page_uri_index() </signature> 339 <docrelurl>page_uri_index</docrelurl> 340 </item> 341 <item name= "wp_link_pages"> 342 <description> 343 Displays page-links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times). This works in much the same way as link_pages() (deprecated), the difference being that arguments are given in query string format. This tag must be within The_Loop. 344 </description> 345 <signature>wp_link_pages(); </signature> 346 <docrelurl>wp_link_pages</docrelurl> 347 </item> 348 <item name= "add_post_meta"> 349 <description>add_post_meta adds a custom (meta) field to the specified post, page or any other post type. If the $unique parameter is set to true and the specified meta key already exists, the function returns false and makes no changes; otherwise, it returns true. </description> 350 <signature>add_post_meta(68, 'my_key', 47); </signature> 351 <docrelurl>add_post_meta</docrelurl> 352 </item> 353 <item name= "delete_post_meta"> 354 <description>This function deletes all custom fields with the specified key, or key and value, from the specified post. See also update_post_meta(), get_post_meta() and add_post_meta(). </description> 355 <signature>delete_post_meta(76, 'my_key', 'Steve'); </signature> 356 <docrelurl>delete_post_meta</docrelurl> 357 </item> 358 <item name= "get_post_custom"> 359 <description>Returns a multidimensional array with all custom fields of a particular post or page. See also get_post_custom_keys() and get_post_custom_values() </description> 360 <signature>$custom_fields = get_post_custom(); </signature> 361 <docrelurl>get_post_custom</docrelurl> 362 </item> 363 <item name= "get_post_custom_keys"> 364 <description>Returns an array containing the keys of all custom fields of a particular post or page. See also get_post_custom() and get_post_custom_values() </description> 365 <signature>$custom_field_keys = get_post_custom_keys();</signature> 366 <docrelurl>get_post_custom_keys</docrelurl> 367 </item> 368 <item name= "get_post_custom_values"> 369 <description>This function is useful if you wish to access a custom field that is not unique, i.e. has more than 1 value associated with it. Otherwise, you might wish to look at get_post_meta(). Returns an array containing all the values of the custom fields with a particular key ($key) of a post with ID $post_id (defaults to the current post if unspecified). Returns nothing if no such key exists, or none is entered. See also get_post_custom() and get_post_custom_keys(). </description> 370 <signature>$mykey_values = get_post_custom_values('my_key');</signature> 371 <docrelurl>get_post_custom_values</docrelurl> 372 </item> 373 <item name= "get_post_meta"> 374 <description>This function returns the values of the custom fields with the specified key from the specified post. To return all of the custom fields, see get_post_custom(). See also update_post_meta(), delete_post_meta() and add_post_meta(). </description> 375 <signature>$key_1_values = get_post_meta(76, 'key_1'); </signature> 376 <docrelurl>get_post_meta</docrelurl> 377 </item> 378 <item name= "update_post_meta"> 379 <description>The function, update_post_meta(), updates the value of an existing meta key (custom field) for the specified post. This may be used in place of add_post_meta() function. The first thing this function will do is make sure that $meta_key already exists on $post_id. If it does not, add_post_meta($post_id, $meta_key, $meta_value) is called instead and its result is returned. Returns true on success and false on failure. Please note that if your db collation is case insensitive (has with suffix _ci) then update_post_meta and delete_post_meta and get_posts will update/delete/query the meta records with keys that are upper or lower case. However get_post_meta will apparently be case sensitive due to wordpress caching. See https://core.trac.wordpress.org/ticket/18210 for more info. </description> 380 <signature>update_post_meta(76, 'my_key', 'Steve'); </signature> 381 <docrelurl>update_post_meta</docrelurl> 382 </item> 383 <item name= "get_attached_file"> 384 <description>Retrieve attached file path based on attachment ID. You can optionally send it through the 'get_attached_file' filter, but by default it will just return the file path unfiltered. The function works by getting the single post meta name, named '_wp_attached_file' and returning it. This is a convenience function to prevent looking up the meta name and provide a mechanism for sending the attached file name through a filter. </description> 385 <signature>get_attached_file( $attachment_id, $unfiltered ); </signature> 386 <docrelurl>get_attached_file</docrelurl> 387 </item> 388 <item name= "is_attachment"> 389 <description>This Conditional Tag checks if an attachment is being displayed. An attachment is an image or other file uploaded through the post editor's upload utility. Attachments can be displayed on their own 'page' or template. For more information, see Using Image and File Attachments. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 390 <signature>is_attachment(); </signature> 391 <docrelurl>is_attachment</docrelurl> 392 </item> 393 <item name= "is_local_attachment"> 394 <description>Check if the attachment URI is local one and is really an attachment. </description> 395 <signature>is_local_attachment( $url ) </signature> 396 <docrelurl>is_local_attachment</docrelurl> 397 </item> 398 <item name= "update_attached_file"> 399 <description>Update attachment file path based on attachment ID. Used to update the file path of the attachment, which uses post meta name '_wp_attached_file' to store the path of the attachment. Note: This does not move the file. This simply updates the '_wp_attached_file' post meta after a move. </description> 400 <signature>update_attached_file( $attachment_id, $file ) </signature> 401 <docrelurl>update_attached_file</docrelurl> 402 </item> 403 <item name= "wp_attachment_is_image"> 404 <description>This function determines if a post's attachment is an image. It returns TRUE if the attachment is an image, FALSE if not. The accepted file extensions/mime types are: .jpg, .jpeg, .gif, .png. </description> 405 <signature> 406 $id = 37; 407 if ( wp_attachment_is_image( $id ) ) { 408 echo "Post ".$id." is an image!"; 409 } else { 410 echo "Post ".$id." is not an image."; 411 } 412 </signature> 413 <docrelurl>wp_attachment_is_image</docrelurl> 414 </item> 415 <item name= "wp_insert_attachment"> 416 <description>This function inserts an attachment into the media library. The function should be used in conjunction with wp_update_attachment_metadata() and wp_generate_attachment_metadata(). Returns the ID of the entry created in the wp_posts table. </description> 417 <signature>$attach_id = wp_insert_attachment( $attachment, $filename, 37 );</signature> 418 <docrelurl>wp_insert_attachment</docrelurl> 419 </item> 420 <item name= "wp_delete_attachment"> 421 <description>This function deletes an attachment </description> 422 <signature>wp_delete_attachment( 76 ); </signature> 423 <docrelurl>wp_delete_attachment</docrelurl> 424 </item> 425 <item name= "wp_get_attachment_image"> 426 <description>Returns an HTML image element representing an attachment file, if there is any, otherwise an empty string. </description> 427 <signature>wp_get_attachment_image( $attachment_id, $size, $icon, $attr ); </signature> 428 <docrelurl>wp_get_attachment_image</docrelurl> 429 </item> 430 <item name= "wp_get_attachment_link"> 431 <description>Returns an HTML hyperlink to an attachment file or page, containing either </description> 432 <signature>wp_get_attachment_link( $id, $size, $permalink, $icon, $text ); </signature> 433 <docrelurl>wp_get_attachment_link</docrelurl> 434 </item> 435 <item name= "wp_get_attachment_image_src"> 436 <description> 437 Returns an array with the image attributes "url", "width" and "height", of an image attachment file. 438 Note: For just the image src, use the first element in the returned array. 439 </description> 440 <signature> 441 $attachment_id = 8; // attachment ID 442 $image_attributes = wp_get_attachment_image_src( $attachment_id ); // returns an array 443 </signature> 444 <docrelurl>wp_get_attachment_image_src</docrelurl> 445 </item> 446 <item name= "wp_get_attachment_metadata"> 447 <description>Retrieve attachment meta field for attachment ID. </description> 448 <signature>wp_get_attachment_metadata( $post_id, $unfiltered ); </signature> 449 <docrelurl>wp_get_attachment_metadata</docrelurl> 450 </item> 451 <item name= "wp_get_attachment_thumb_file"> 452 <description>Retrieve thumbnail for an attachment. </description> 453 <signature>wp_get_attachment_thumb_file( $post_id ); </signature> 454 <docrelurl>wp_get_attachment_thumb_file</docrelurl> 455 </item> 456 <item name= "wp_get_attachment_thumb_url"> 457 <description>Retrieve URL for an attachment thumbnail. </description> 458 <signature>wp_get_attachment_thumb_url( $post_id ); </signature> 459 <docrelurl>wp_get_attachment_thumb_url</docrelurl> 460 </item> 461 <item name= "wp_get_attachment_url"> 462 <description>Returns a full URI for an attachment file or false on failure. </description> 463 <signature>wp_get_attachment_url( $id ); </signature> 464 <docrelurl>wp_get_attachment_url</docrelurl> 465 </item> 466 <item name= "wp_check_for_changed_slugs"> 467 <description>Checked for changed slugs for published posts and save old slug. The function is used along with form POST data. It checks for the wp-old-slug POST field. Will only be concerned with published posts and the slug actually changing. If the slug was changed and not already part of the old slugs then it will be added to the post meta field ('_wp_old_slug') for storing old slugs for that post. The most logically usage of this function is redirecting changed posts, so that those that linked to an changed post will be redirected to the new post. </description> 468 <signature>wp_check_for_changed_slugs( $post_id ); </signature> 469 <docrelurl>wp_check_for_changed_slugs</docrelurl> 470 </item> 471 <item name= "wp_count_posts"> 472 <description>This function was introduced in WordPress Version 2.5, and outputs the number for each post status of a post type. You can also use wp_count_posts() as a template_tag with the second parameter and include the private post status. By default, or if the user isn't logged in or is a guest of your site, then private post status post count will not be included. This function will return an object with the post statuses as the properties. You should check for the property using isset() PHP function, if you are wanting the value for the private post status. Not all post statuses will be part of the object. </description> 473 <signature> 474 $count_posts = wp_count_posts(); 475 </signature> 476 <docrelurl>wp_count_posts</docrelurl> 477 </item> 478 <item name= "wp_mime_type_icon"> 479 <description>Retrieve the icon for a MIME type. </description> 480 <signature>wp_mime_type_icon( $mime ) </signature> 481 <docrelurl>wp_mime_type_icon</docrelurl> 482 </item> 483 <item name= "wp_generate_attachment_metadata"> 484 <description>This function generates metadata for an image attachment. It also creates a thumbnail and other intermediate sizes of the image attachment based on the sizes defined on the Settings_Media_Screen. </description> 485 <signature> 486 $attach_id = wp_insert_attachment( $attachment, $filename, 37 ); 487 $attach_data = wp_generate_attachment_metadata( $attach_id, $filename ); 488 wp_update_attachment_metadata( $attach_id, $attach_data ); 489 </signature> 490 <docrelurl>wp_generate_attachment_metadata</docrelurl> 491 </item> 492 <item name= "wp_update_attachment_metadata"> 493 <description>Update metadata for an attachment. </description> 494 <signature>wp_update_attachment_metadata( $post_id, $data ); </signature> 495 <docrelurl>wp_update_attachment_metadata</docrelurl> 496 </item> 497 <item name= "get_bookmark"> 498 <description>Retrieve Bookmark data based on bookmark link ID. </description> 499 <signature>get_bookmark( $bookmark, $output, $filter ) </signature> 500 <docrelurl>get_bookmark</docrelurl> 501 </item> 502 <item name= "get_bookmarks"> 503 <description>This function returns an array of bookmarks found in the Administration > Links > Edit panel. This Template Tag allows the user to retrieve the bookmark information directly. </description> 504 <signature></signature> 505 <docrelurl>get_bookmarks</docrelurl> 506 </item> 507 <item name= "wp_get_post_categories"> 508 <description>Retrieve the list of categories for a post. Compatibility layer for themes and plugins. Also an easy layer of abstraction away from the complexity of the taxonomy layer. </description> 509 <signature>wp_get_post_categories( $post_id, $args ) </signature> 510 <docrelurl>wp_get_post_categories</docrelurl> 511 </item> 512 <item name= "wp_get_post_tags"> 513 <description>Retrieve the list of tags for a post. </description> 514 <signature>wp_get_post_tags( $post_id, $args ) </signature> 515 <docrelurl>wp_get_post_tags</docrelurl> 516 </item> 517 <item name= "wp_set_post_tags"> 518 <description>Set tags for a post. Every tag that does not already exists will be automatically created. Uses wp_set_post_terms(). </description> 519 <signature>wp_set_post_tags( $post_ID, $tags, $append ) </signature> 520 <docrelurl>wp_set_post_tags</docrelurl> 521 </item> 522 <item name= "wp_get_post_terms"> 523 <description>Retrieve the terms for a post. There is only one default for this function, called 'fields' and by default is set to 'all'. Other values can be 'names' or 'ids'. There are other defaults that can be overridden in wp_get_object_terms(). </description> 524 <signature>$terms = wp_get_post_terms( $post_id, $taxonomy, $args ) </signature> 525 <docrelurl>wp_get_post_terms</docrelurl> 526 </item> 527 <item name= "wp_set_post_terms"> 528 <description>Set terms for a post. Uses wp_set_object_terms(). </description> 529 <signature>wp_set_post_terms( $post_ID, $terms, $taxonomy, $append ) </signature> 530 <docrelurl>wp_set_post_terms</docrelurl> 531 </item> 532 <item name= "add_meta_box"> 533 <description>The add_meta_box() function was introduced in Version 2.5. It allows plugin developers to add sections to the Write Post, Write Page, and Write Link editing pages. </description> 534 <signature>add_meta_box( 535 'myplugin_sectionid', 536 __( 'My Post Section Title', 'myplugin_textdomain' ), 537 'myplugin_inner_custom_box', 'post'); 538 </signature> 539 <docrelurl>add_meta_box</docrelurl> 540 </item> 541 <item name= "remove_meta_box"> 542 <description>The remove_meta_box() function was introduced in WordPress 2.6. It allows plugin developers to remove sections from the Write Post, Write Page, and Write Link editing pages. </description> 543 <signature>remove_meta_box( 'postcustom' , 'post' , 'normal' );</signature> 544 <docrelurl>remove_meta_box</docrelurl> 545 </item> 546 <item name= "get_the_ID"> 547 <description>Returns the numeric ID of the current post. This tag must be within The Loop. </description> 548 <signature>$id = get_the_ID(); 549 </signature> 550 <docrelurl>get_the_ID</docrelurl> 551 </item> 552 <item name= "get_the_author"> 553 <description>Retrieve the post author. This tag must be used within The Loop. To display a page for authors which have no posts, see this discussion. </description> 554 <signature></signature> 555 <docrelurl>get_the_author</docrelurl> 556 </item> 557 <item name= "get_the_content"> 558 <description>Retrieve the post content. (Must be used in a Loop) </description> 559 <signature>get_the_content( $more_link_text, $stripteaser, $more_file ) </signature> 560 <docrelurl>get_the_content</docrelurl> 561 </item> 562 <item name= "get_the_title"> 563 <description>This function will return the title of a post for a given post id. If the post is protected or private, the word "Protected: " or "Private: " prepended to the title. </description> 564 <signature></signature> 565 <docrelurl>get_the_title</docrelurl> 566 </item> 567 <item name= "wp_trim_excerpt"> 568 <description>Generates an excerpt from the content, if needed. The excerpt word amount will be 55 words and if the amount is greater than that, then the string ' [...]' will be appended to the excerpt. If the string is less than 55 words, then the content will be returned as is. </description> 569 <signature>wp_trim_excerpt( $text ) </signature> 570 <docrelurl>wp_trim_excerpt</docrelurl> 571 </item> 572 <item name= "cat_is_ancestor_of"> 573 <description>This Conditional Tag Check if a category is an ancestor of another category. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 574 <signature>if (cat_is_ancestor_of(4, $cat) or is_category(4)) { // if the category is music or a music SUBcategory, </signature> 575 <docrelurl>cat_is_ancestor_of</docrelurl> 576 </item> 577 <item name= "get_all_category_ids"> 578 <description>Retrieves all category IDs. </description> 579 <signature>get_all_category_ids() </signature> 580 <docrelurl>get_all_category_ids</docrelurl> 581 </item> 582 <item name= "get_ancestors"> 583 <description>Returns an array containing the parents of the given object. </description> 584 <signature>get_ancestors( 208, 'category' ); </signature> 585 <docrelurl>get_ancestors</docrelurl> 586 </item> 587 <item name= "get_cat_ID"> 588 <description>Retrieve the ID of a category from its name. </description> 589 <signature>get_cat_ID( $cat_name ) </signature> 590 <docrelurl>get_cat_ID</docrelurl> 591 </item> 592 <item name= "get_cat_name"> 593 <description>Retrieve the name of a category from its ID. </description> 594 <signature>get_cat_name( $cat_id ) </signature> 595 <docrelurl>get_cat_name</docrelurl> 596 </item> 597 <item name= "get_categories"> 598 <description>Returns an array of category objects matching the query parameters. Arguments are pretty much the same as wp_list_categories and can be passed as either array or in query syntax. </description> 599 <signature> 600 $args = array( 601 'type' => 'post', 602 'child_of' => 0, 603 'parent' => '', 604 'orderby' => 'name', 605 'order' => 'ASC', 606 'hide_empty' => 1, 607 'hierarchical' => 1, 608 'exclude' => '', 609 'include' => '', 610 'number' => '', 611 'taxonomy' => 'category', 612 'pad_counts' => false ); 613 </signature> 614 <docrelurl>get_categories</docrelurl> 615 </item> 616 <item name= "get_categories"> 617 <description>Returns an array of category objects matching the query parameters. Arguments are pretty much the same as wp_list_categories and can be passed as either array or in query syntax. </description> 618 <signature> 619 $args = array( 620 'type' => 'post', 621 'child_of' => 0, 622 'parent' => '', 623 'orderby' => 'name', 624 'order' => 'ASC', 625 'hide_empty' => 1, 626 'hierarchical' => 1, 627 'exclude' => '', 628 'include' => '', 629 'number' => '', 630 'taxonomy' => 'category', 631 'pad_counts' => false ); 632 </signature> 633 <docrelurl>get_categories</docrelurl> 634 </item> 635 <item name= "get_category"> 636 <description>Retrieves category data given a category ID or category object. If you pass the $category parameter an object, which is assumed to be the category row object retrieved the database. It will cache the category data. If you pass $category an integer of the category ID, then that category will be retrieved from the database, if it isn't already cached, and pass it back. If you look at get_term(), then both types will be passed through several filters and finally sanitized based on the $filter parameter value. The category will converted to maintain backwards compatibility. Note: use get_term() to get Link Categories based on their ID's. get_category only returns Post Categories. </description> 637 <signature>get_category( $category, $output, $filter ) </signature> 638 <docrelurl>get_category</docrelurl> 639 </item> 640 <item name= "get_category_by_path"> 641 <description>Retrieve category based on URL containing the category slug. Breaks the $category_path parameter up to get the category slug. Tries to find the child path and will return it. If it doesn't find a match, then it will return the first category matching slug, if $full_match, is set to false. If it does not, then it will return null. It is also possible that it will return a WP_Error object on failure. Check for it when using this function. </description> 642 <signature>get_category_by_path( $category_path, $full_match, $output ) </signature> 643 <docrelurl>get_category_by_path</docrelurl> 644 </item> 645 <item name= "get_category_by_slug"> 646 <description>Retrieve category object by category slug. Returns false if not found. </description> 647 <signature>get_category_by_slug( $slug ) </signature> 648 <docrelurl>get_category_by_slug</docrelurl> 649 </item> 650 <item name= "get_the_category_by_ID"> 651 <description>Retrieve category name based on category ID. </description> 652 <signature>get_the_category_by_ID( $cat_ID ); </signature> 653 <docrelurl>get_the_category_by_ID</docrelurl> 654 </item> 655 <item name= "get_category_link"> 656 <description>Returns the correct url for a given Category ID. </description> 657 <signature>get_category_link( $category_id ); </signature> 658 <docrelurl>get_category_link</docrelurl> 659 </item> 660 <item name= "get_category_parents"> 661 <description>Returns a list of the parents of a category, including the category, in hierarchical order. </description> 662 <signature>echo get_category_parents($cat, TRUE, ' &raquo; '); </signature> 663 <docrelurl>get_category_parents</docrelurl> 664 </item> 665 <item name= "get_the_category"> 666 <description>Returns an array of objects, one object for each category assigned to the post. This tag may be used outside The Loop by passing a post id as the parameter. This function only returns results from the default "category" taxonomy. For custom taxonomies use get_the_terms. </description> 667 <signature>get_the_category( $id ) </signature> 668 <docrelurl>get_the_category</docrelurl> 669 </item> 670 <item name= "single_cat_title"> 671 <description>Displays or returns the category title for the current page. For pages displaying WordPress tags rather than categories (e.g. "/tag/geek") the name of the tag is displayed instead of the category. Can be used only outside The Loop. </description> 672 <signature>$current_category = single_cat_title("", false); </signature> 673 <docrelurl>single_cat_title</docrelurl> 674 </item> 675 <item name= "in_category"> 676 <description>Tests if the current post (or any specified post) is assigned to any of the specified categories. in_category() considers only the categories a post is directly assigned to (the checked categories in Write/Edit Post panel), not the parents of the assigned categories (but see Testing if a post is in a descendant category below). This tag can be used to test the current post within The Loop or (since Version 2.7) outside the Loop during a single post request. You can use it anywhere if you specify which post you want to test. </description> 677 <signature>in_category( $category, $_post ) </signature> 678 <docrelurl>in_category</docrelurl> 679 </item> 680 <item name= "the_category"> 681 <description>Displays a link to the category or categories a post belongs to. This tag must be used within The Loop. </description> 682 <signature></signature> 683 <docrelurl>the_category</docrelurl> 684 </item> 685 <item name= "wp_create_category"> 686 <description>This function adds a "simple" category by specifying a category name and (optionally) a category parent. </description> 687 <signature>wp_create_category( $cat_name, $parent ); </signature> 688 <docrelurl>wp_create_category</docrelurl> 689 </item> 690 <item name= "wp_delete_category"> 691 <description>Deletes one existing category. </description> 692 <signature>wp_delete_category( $cat_ID ) </signature> 693 <docrelurl>wp_delete_category</docrelurl> 694 </item> 695 <item name= "wp_insert_category"> 696 <description>Inserts a new category into the taxonomy system. </description> 697 <signature>wp_insert_category( $catarr, $wp_error ); </signature> 698 <docrelurl>wp_insert_category</docrelurl> 699 </item> 700 <item name= "get_tag"> 701 <description>Retrieve post tag by tag ID or tag object. If you pass the $tag parameter an object, which is assumed to be the tag row object retrieved the database. It will cache the tag data. If you pass $tag an integer of the tag ID, then that tag will be retrieved from the database, if it isn't already cached, and pass it back. If you look at get_term(), then both types will be passed through several filters and finally sanitized based on the $filter parameter value. </description> 702 <signature>&get_tag( $tag, $output, $filter ) </signature> 703 <docrelurl>get_tag</docrelurl> 704 </item> 705 <item name= "get_tag_link"> 706 <description>Returns the correct link url for a given Tag ID. </description> 707 <signature></signature> 708 <docrelurl>get_tag_link</docrelurl> 709 </item> 710 <item name= "get_tags"> 711 <description>Retrieve an array of objects for each term in post_tag taxonomy. </description> 712 <signature></signature> 713 <docrelurl>get_tags</docrelurl> 714 </item> 715 <item name= "get_the_tag_list"> 716 <description>Generates a HTML string of the tags associated with the current post. The name of each tag will be linked to the relevant 'tag' page. You can tell the function to put a string before and after all the tags, and in between each tag. Differently from get_the_category_list, this tag must be used inside The Loop. </description> 717 <signature> 718 echo get_the_tag_list('<p>Tags: ',', ','</p>'); 719 </signature> 720 <docrelurl>get_the_tag_list</docrelurl> 721 </item> 722 <item name= "get_the_tags"> 723 <description>Returns an array of objects, one object for each tag assigned to the post. This tag must be used within The Loop. </description> 724 <signature> 725 $posttags = get_the_tags(); 726 if ($posttags) { 727 foreach($posttags as $tag) { 728 echo $tag->name . ' '; 729 } 730 } 731 </signature> 732 <docrelurl>get_the_tags</docrelurl> 733 </item> 734 <item name= "is_tag"> 735 <description>This Conditional Tag checks if a Tag archive page is being displayed. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 736 <signature>is_tag( $slug ); </signature> 737 <docrelurl>is_tag</docrelurl> 738 </item> 739 <item name= "the_tags"> 740 <description>This template tag displays a link to the tag or tags a post belongs to. If no tags are associated with the current entry, nothing is displayed. This tag should be used within The Loop. </description> 741 <signature>the_tags('Social tagging: ',' > '); </signature> 742 <docrelurl>the_tags</docrelurl> 743 </item> 744 <item name= "get_taxonomies"> 745 <description>Get a list of registered taxonomy objects. </description> 746 <signature>$taxonomies=get_taxonomies(); </signature> 747 <docrelurl>get_taxonomies</docrelurl> 748 </item> 749 <item name= "get_term"> 750 <description>Get all Term data from database by Term ID. To retrieve term data by name, slug or ID, use get_term_by() instead The usage of the get_term function is to apply filters to a term object. It is possible to get a term object from the database before applying the filters. $term ID must be part of $taxonomy, to get from the database. Failure, might be able to be captured by the hooks. Failure would be the same value as $wpdb returns for the get_row method. There are two hooks, one is specifically for each term, named 'get_term', and the second is for the taxonomy name, 'term_$taxonomy'. Both hooks gets the term object, and the taxonomy name as parameters. Both hooks are expected to return a Term object. 'get_term' hook - Takes two parameters the term Object and the taxonomy name. Must return term object. Used in get_term() as a catch-all filter for every $term. 'get_$taxonomy' hook - Takes two parameters the term Object and the taxonomy name. Must return term object. $taxonomy will be the taxonomy name, so for example, if 'category', it would be 'get_category' as the filter name. Useful for custom taxonomies or plugging into default taxonomies. </description> 751 <signature>get_term( $term, $taxonomy, $output, $filter ) </signature> 752 <docrelurl>get_term</docrelurl> 753 </item> 754 <item name= "get_the_term_list"> 755 <description>Returns an HTML string of taxonomy terms associated with a post and given taxonomy. Terms are linked to their respective term listing pages. </description> 756 <signature></signature> 757 <docrelurl>get_the_term_list</docrelurl> 758 </item> 759 <item name= "get_term_by"> 760 <description>Get all Term data from database by Term field and data. Warning: $value is not escaped for 'name' $field. You must do it yourself, if required. The default $field is 'id', therefore it is possible to also use null for field, but not recommended that you do so. If $value does not exist, the return value will be false. If $taxonomy exists and $field and $value combinations exist, the Term will be returned. </description> 761 <signature>get_term_by( $field, $value, $taxonomy, $output, $filter ) </signature> 762 <docrelurl>get_term_by</docrelurl> 763 </item> 764 <item name= "the_terms"> 765 <description>Displays the terms of a custom taxonomies. </description> 766 <signature> 767 the_terms( $post->ID, 'category', 'categories: ', ' <span style="color:#000">/</span> ', '' ); 768 </signature> 769 <docrelurl>the_terms</docrelurl> 770 </item> 771 <item name= "get_the_terms"> 772 <description>Retrieve the terms of the taxonomy that are attached to the post. </description> 773 <signature> 774 $terms = get_the_terms( $post->ID, 'on-draught' ); 791 775 792 </items> 776 if ( $terms && ! is_wp_error( $terms ) ) : 777 778 $draught_links = array(); 779 780 foreach ( $terms as $term ) { 781 $draught_links[] = $term->name; 782 } 783 784 $on_draught = join( ", ", $draught_links ); 785 </signature> 786 <docrelurl>get_the_terms</docrelurl> 787 </item> 788 <item name= "get_term_children"> 789 <description>Merge all term children into a single array. This recursive function will merge all of the children of $term into the same array. Only useful for taxonomies which are hierarchical. Will return an empty array if $term does not exist in $taxonomy. </description> 790 <signature>get_term_children( $term, $taxonomy ) </signature> 791 <docrelurl>get_term_children</docrelurl> 792 </item> 793 <item name= "get_term_link"> 794 <description>Returns permalink for a taxonomy term archive. </description> 795 <signature>get_term_link( $term, $taxonomy ); </signature> 796 <docrelurl>get_term_link</docrelurl> 797 </item> 798 <item name= "get_terms"> 799 <description>Retrieve the terms in taxonomy or list of taxonomies. </description> 800 <signature>get_terms( $taxonomies, $args ) </signature> 801 <docrelurl>get_terms</docrelurl> 802 </item> 803 <item name= "is_taxonomy"> 804 <description>This function is deprecated as of Version 3.0. Please use taxonomy_exists instead. This Conditional Tag checks if the taxonomy name exists by passing a taxonomy name as an argument to it. This is a boolean function uses a global $wp_taxonomies variable for checking if taxonomy name existence, meaning it returns either TRUE if the taxonomy name exist or FALSE if it doesn't exist. </description> 805 <signature>is_taxonomy($taxonomy); </signature> 806 <docrelurl>is_taxonomy</docrelurl> 807 </item> 808 <item name= "is_taxonomy_hierarchical"> 809 <description>This Conditional Tag checks if the taxonomy object is hierarchical. This is a boolean function uses a global, meaning it returns either TRUE or FALSE (A false return value might also mean that the taxonomy does not exist). checks to make sure that the taxonomy is an object first. Then gets the object, and finally returns the hierarchical value in the object. </description> 810 <signature>is_taxonomy_hierarchical( $taxonomy ) </signature> 811 <docrelurl>is_taxonomy_hierarchical</docrelurl> 812 </item> 813 <item name= "is_term"> 814 <description>Check if Term exists. Returns the index of a defined term, or 0 (false) if the term doesn't exist. </description> 815 <signature>is_term( $term, $taxonomy ) </signature> 816 <docrelurl>is_term</docrelurl> 817 </item> 818 <item name= "taxonomy_exists"> 819 <description>This Conditional Tag checks if the taxonomy name exists by passing a taxonomy name as an argument to it. This is a boolean function uses a global $wp_taxonomies variable for checking if taxonomy name existence, meaning it returns either TRUE if the taxonomy name exist or FALSE if it doesn't exist. </description> 820 <signature>taxonomy_exists($taxonomy); </signature> 821 <docrelurl>taxonomy_exists</docrelurl> 822 </item> 823 <item name= "term_exists"> 824 <description>Check if a given term exists and return the term ID, a term object, or 0 (false) if the term doesn't exist. </description> 825 <signature>term_exists( $term, $taxonomy, $parent ) </signature> 826 <docrelurl>term_exists</docrelurl> 827 </item> 828 <item name= "register_taxonomy"> 829 <description>This function adds or overwrites a taxonomy. It takes in a name, an object name that it affects, and an array of parameters. It does not return anything. Care should be used in selecting a taxonomy name so that it does not conflict with other taxonomies, post types, and reserved WordPress public and private query variables. A complete list of those is described in the Reserved Terms section. In particular, capital letters should be avoided (This was allowed in 3.0, but not enforced until 3.1 with the "Cheatin'" error). </description> 830 <signature> 831 //hook into the init action and call create_book_taxonomies when it fires 832 add_action( 'init', 'create_book_taxonomies', 0 ); 833 834 //create two taxonomies, genres and writers for the post type "book" 835 function create_book_taxonomies() 836 { 837 // Add new taxonomy, make it hierarchical (like categories) 838 $labels = array( 839 'name' => _x( 'Genres', 'taxonomy general name' ), 840 'singular_name' => _x( 'Genre', 'taxonomy singular name' ), 841 'search_items' => __( 'Search Genres' ), 842 'all_items' => __( 'All Genres' ), 843 'parent_item' => __( 'Parent Genre' ), 844 'parent_item_colon' => __( 'Parent Genre:' ), 845 'edit_item' => __( 'Edit Genre' ), 846 'update_item' => __( 'Update Genre' ), 847 'add_new_item' => __( 'Add New Genre' ), 848 'new_item_name' => __( 'New Genre Name' ), 849 'menu_name' => __( 'Genre' ), 850 ); 851 852 register_taxonomy('genre',array('book'), array( 853 'hierarchical' => true, 854 'labels' => $labels, 855 'show_ui' => true, 856 'query_var' => true, 857 'rewrite' => array( 'slug' => 'genre' ), 858 )); 859 860 // Add new taxonomy, NOT hierarchical (like tags) 861 $labels = array( 862 'name' => _x( 'Writers', 'taxonomy general name' ), 863 'singular_name' => _x( 'Writer', 'taxonomy singular name' ), 864 'search_items' => __( 'Search Writers' ), 865 'popular_items' => __( 'Popular Writers' ), 866 'all_items' => __( 'All Writers' ), 867 'parent_item' => null, 868 'parent_item_colon' => null, 869 'edit_item' => __( 'Edit Writer' ), 870 'update_item' => __( 'Update Writer' ), 871 'add_new_item' => __( 'Add New Writer' ), 872 'new_item_name' => __( 'New Writer Name' ), 873 'separate_items_with_commas' => __( 'Separate writers with commas' ), 874 'add_or_remove_items' => __( 'Add or remove writers' ), 875 'choose_from_most_used' => __( 'Choose from the most used writers' ), 876 'menu_name' => __( 'Writers' ), 877 ); 878 879 register_taxonomy('writer','book',array( 880 'hierarchical' => false, 881 'labels' => $labels, 882 'show_ui' => true, 883 'update_count_callback' => '_update_post_term_count', 884 'query_var' => true, 885 'rewrite' => array( 'slug' => 'writer' ), 886 )); 887 } 888 </signature> 889 <docrelurl>register_taxonomy</docrelurl> 890 </item> 891 <item name= "register_taxonomy_for_object_type"> 892 <description>This function adds an already registered taxonomy to an (custom) object type. It takes in a name, an object name that it affects. It returns true on success. </description> 893 <signature>register_taxonomy_for_object_type('category', 'foo'); </signature> 894 <docrelurl>register_taxonomy_for_object_type</docrelurl> 895 </item> 896 <item name= "wp_get_object_terms"> 897 <description>Retrieves the terms associated with the given object(s), in the supplied taxonomies. </description> 898 <signature>wp_get_object_terms( $object_ids, $taxonomies, $args ) </signature> 899 <docrelurl>wp_get_object_terms</docrelurl> 900 </item> 901 <item name= "wp_set_object_terms"> 902 <description>Relates an object (post, link etc) to a term and taxonomy type (tag, category, etc). Creates the term and taxonomy relationship if it doesn't already exist. A relationship means that the term is grouped in or belongs to the taxonomy. A term has no meaning until it is given context by defining which taxonomy it exists under. </description> 903 <signature> 904 $cat_ids = array( 6,8 ); 905 //to make sure the terms IDs is integers: 906 //$cat_ids = array_map('intval', $cat_ids); 907 //$cat_ids = array_unique( $cat_ids ); 908 wp_set_object_terms( '42', $cat_ids, 'category' ); 909 </signature> 910 <docrelurl>wp_set_object_terms</docrelurl> 911 </item> 912 <item name= "wp_insert_term"> 913 <description>Adds a new term to the database. Optionally marks it as an alias of an existing term. Error handling is assigned for the nonexistance of the $taxonomy and $term parameters before inserting. If both the term id and taxonomy exist previously, then an array will be returned that contains the term id and the contents of what is returned. The keys of the array are 'term_id' and 'term_taxonomy_id' containing numeric values. It is assumed that the term does not yet exist or the above will apply. The term will be first added to the term table and then related to the taxonomy if everything is well. If everything is correct, then several actions will be run prior to a filter and then several actions will be run after the filter is run. The arguments decide how the term is handled based on the $args parameter. The following is a list of the available overrides and the defaults. </description> 914 <signature>wp_insert_term( $term, $taxonomy, $args = array() ); </signature> 915 <docrelurl>wp_insert_term</docrelurl> 916 </item> 917 <item name= "wp_update_term"> 918 <description>Update term based on arguments provided. </description> 919 <signature>wp_update_term( $term_id, $taxonomy, $args ) </signature> 920 <docrelurl>wp_update_term</docrelurl> 921 </item> 922 <item name= "wp_delete_term"> 923 <description>Removes a term from the database. </description> 924 <signature>wp_delete_term( $term_id, $taxonomy, $args ) </signature> 925 <docrelurl>wp_delete_term</docrelurl> 926 </item> 927 <item name= "wp_terms_checklist"> 928 <description>Taxonomy independent version of wp_category_checklist </description> 929 <signature>wp_terms_checklist( $post_id, $args ); </signature> 930 <docrelurl>wp_terms_checklist</docrelurl> 931 </item> 932 <item name= "add_cap"> 933 <description>Adds a capability to a role. </description> 934 <signature></signature> 935 <docrelurl>add_cap</docrelurl> 936 </item> 937 <item name= "add_role"> 938 <description>Adds a new Role to WordPress. </description> 939 <signature></signature> 940 <docrelurl>add_role</docrelurl> 941 </item> 942 <item name= "add_role"> 943 <description>Adds a new Role to WordPress. </description> 944 <signature></signature> 945 <docrelurl>add_role</docrelurl> 946 </item> 947 <item name= "author_can"> 948 <description>Whether author of supplied post has capability or role. </description> 949 <signature></signature> 950 <docrelurl>author_can</docrelurl> 951 </item> 952 <item name= "current_user_can"> 953 <description>Whether the current user has a certain capability or role. See: Roles and Capabilities. It will only return true if a logged in user's role or capability matches the queried role or capability. In some circumstances, the global current user is not yet defined. If you experience problems with this, try declaring the global $current_user and using user_can($current_user->ID, $capability) - this seems to work more consistently. </description> 954 <signature></signature> 955 <docrelurl>current_user_can</docrelurl> 956 </item> 957 <item name= "current_user_can_for_blog"> 958 <description>Whether current user has a capability or role for a given blog. </description> 959 <signature></signature> 960 <docrelurl>current_user_can_for_blog</docrelurl> 961 </item> 962 <item name= "get_role"> 963 <description>Fetch a Role definition. </description> 964 <signature></signature> 965 <docrelurl>get_role</docrelurl> 966 </item> 967 <item name= "get_super_admins"> 968 <description>Retrieve a list of super admins. Uses $super_admins Super admins global variable, if set. </description> 969 <signature> 970 $super_admins = get_super_admins(); 971 echo 'List of super-admin users:<ul> 972 '; 973 foreach ($super_admins as $admin) { 974 echo '<li>' . $admin . '</li>'; 975 } 976 echo ' 977 </ul>'; 978 </signature> 979 <docrelurl>get_super_admins</docrelurl> 980 </item> 981 <item name= "get_super_admins"> 982 <description>Retrieve a list of super admins. Uses $super_admins Super admins global variable, if set. </description> 983 <signature> 984 $super_admins = get_super_admins(); 985 echo 'List of super-admin users:<ul> 986 '; 987 foreach ($super_admins as $admin) { 988 echo '<li>' . $admin . '</li>'; 989 } 990 echo ' 991 </ul>'; 992 </signature> 993 <docrelurl>get_super_admins</docrelurl> 994 </item> 995 <item name= "is_super_admin"> 996 <description>Determine if user is a network (super) admin. </description> 997 <signature></signature> 998 <docrelurl>is_super_admin</docrelurl> 999 </item> 1000 <item name= "map_meta_cap"> 1001 <description>Map meta capabilities to primitive capabilities. This does not actually compare whether the user ID has the actual capability, just what the capability or capabilities are. Meta capability list value can be 'delete_user', 'edit_user', 'remove_user', 'promote_user', 'delete_post', 'delete_page', 'edit_post', 'edit_page', 'read_post', or 'read_page'. </description> 1002 <signature></signature> 1003 <docrelurl>map_meta_cap</docrelurl> 1004 </item> 1005 <item name= "remove_cap"> 1006 <description>Removes a capability from a role. </description> 1007 <signature></signature> 1008 <docrelurl>remove_cap</docrelurl> 1009 </item> 1010 <item name= "remove_role"> 1011 <description>Removes a user role. </description> 1012 <signature>remove_role( 'subscriber' ); </signature> 1013 <docrelurl>remove_role</docrelurl> 1014 </item> 1015 <item name= "user_can"> 1016 <description>Whether a user has capability or role. Similar to current_user_can(), but this function takes a user ID or object as its first parameter. </description> 1017 <signature></signature> 1018 <docrelurl>user_can</docrelurl> 1019 </item> 1020 <item name= "auth_redirect"> 1021 <description>auth_redirect() is a simple function that requires that the user be logged in before they can access a page. </description> 1022 <signature>auth_redirect() </signature> 1023 <docrelurl>auth_redirect</docrelurl> 1024 </item> 1025 <item name= "count_users"> 1026 <description>Returns the count of users having each role, as well as the count of all users. </description> 1027 <signature> 1028 $result = count_users(); 1029 echo 'There are ', $result['total_users'], ' total users'; 1030 foreach($result['avail_roles'] as $role => $count) 1031 echo ', ', $count, ' are ', $role, 's'; 1032 echo '.'; 1033 </signature> 1034 <docrelurl>count_users</docrelurl> 1035 </item> 1036 <item name= "count_user_posts"> 1037 <description>Returns the post count for the user whose ID is passed to it. </description> 1038 <signature>echo 'Posts made: ' . count_user_posts(1); </signature> 1039 <docrelurl>count_user_posts</docrelurl> 1040 </item> 1041 <item name= "count_many_users_posts"> 1042 <description>Returns the post counts for a list of user IDs. This is an O(n) operation, so it is preferred over count_user_posts() any time more than a single count is needed. </description> 1043 <signature> 1044 $users = array(1, 3, 9, 10); 1045 $counts = count_many_users_posts($users); 1046 echo 'Posts made by user 3: ' . $counts[3]; 1047 </signature> 1048 <docrelurl>count_many_users_posts</docrelurl> 1049 </item> 1050 <item name= "email_exists"> 1051 <description>This function will check whether or not a given email address ($email) has already been registered to a username, and returns that users ID (or false if none exists). See also username_exists. Note: To execute this function you will need to add this line of code: require_once(ABSPATH . WPINC . '/registration.php'); in order to define the function. </description> 1052 <signature>if ( email_exists($email) ) { . . . } </signature> 1053 <docrelurl>email_exists</docrelurl> 1054 </item> 1055 <item name= "get_currentuserinfo"> 1056 <description>Retrieves the information pertaining to the currently logged in user, and places it in the global variable $current_user. Properties map directly to the wp_users table in the database (see Database Description). Also places the individual attributes into the following separate global variables: </description> 1057 <signature>get_currentuserinfo();</signature> 1058 <docrelurl>get_currentuserinfo</docrelurl> 1059 </item> 1060 <item name= "get_current_user_id"> 1061 <description>Returns the ID of the current user. </description> 1062 <signature></signature> 1063 <docrelurl>get_current_user_id</docrelurl> 1064 </item> 1065 <item name= "get_profile"> 1066 <description>Retrieve user data based on field. Use get_profile() will make a database query to get the value of the table column. The value might be cached using the query cache, but care should be taken when using the function to not make a lot of queries for retrieving user profile information. If the $user parameter is not used, then the user will be retrieved from a cookie of the user. Therefore, if the cookie does not exist, then no value might be returned. Sanity checking must be done to ensure that when using get_profile() that (empty|null|false) values are handled and that something is at least displayed. </description> 1067 <signature>get_profile( $field, $user ); </signature> 1068 <docrelurl>get_profile</docrelurl> 1069 </item> 1070 <item name= "get_user_by"> 1071 <description>Get user data by field and data. </description> 1072 <signature>get_user_by($field, $value) </signature> 1073 <docrelurl>get_user_by</docrelurl> 1074 </item> 1075 <item name= "get_userdata"> 1076 <description>Returns a WP_User object with the information pertaining to the user whose ID is passed to it. Properties map directly to wp_users and wp_usermeta tables in the database (see Database Description). If the user does not exist, the function returns false. An alias of get_user_by('id'). </description> 1077 <signature> 1078 $user_info = get_userdata(1); 1079 echo 'Username: ' . $user_info->user_login . "\n"; 1080 echo 'User level: ' . $user_info->user_level . "\n"; 1081 echo 'User ID: ' . $user_info->ID . "\n"; 1082 </signature> 1083 <docrelurl>get_userdata</docrelurl> 1084 </item> 1085 <item name= "get_userdata"> 1086 <description>Returns a WP_User object with the information pertaining to the user whose ID is passed to it. Properties map directly to wp_users and wp_usermeta tables in the database (see Database Description). If the user does not exist, the function returns false. An alias of get_user_by('id'). </description> 1087 <signature> 1088 $user_info = get_userdata(1); 1089 echo 'Username: ' . $user_info->user_login . "\n"; 1090 echo 'User level: ' . $user_info->user_level . "\n"; 1091 echo 'User ID: ' . $user_info->ID . "\n"; 1092 </signature> 1093 <docrelurl>get_userdata</docrelurl> 1094 </item> 1095 <item name= "get_usernumposts"> 1096 <description>Returns the post count for the user whose ID is passed to it. Properties map directly to the wp_posts table in the database (see Database Description). </description> 1097 <signature>echo 'Posts made: ' . get_usernumposts(1); </signature> 1098 <docrelurl>get_usernumposts</docrelurl> 1099 </item> 1100 <item name= "get_users"> 1101 <description>Retrieves an array of users matching the criteria given in $args. </description> 1102 <signature></signature> 1103 <docrelurl>get_users</docrelurl> 1104 </item> 1105 <item name= "set_current_user"> 1106 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Changes the current user by ID or name. Set $id to null and specify a name if you do not know a user's ID. </description> 1107 <signature>set_current_user( $id, $name ) </signature> 1108 <docrelurl>set_current_user</docrelurl> 1109 </item> 1110 <item name= "set_current_user"> 1111 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Changes the current user by ID or name. Set $id to null and specify a name if you do not know a user's ID. </description> 1112 <signature>set_current_user( $id, $name ) </signature> 1113 <docrelurl>set_current_user</docrelurl> 1114 </item> 1115 <item name= "user_pass_ok"> 1116 <description>Check that the user login name and password is correct. </description> 1117 <signature>user_pass_ok( $user_login, $user_pass ) </signature> 1118 <docrelurl>user_pass_ok</docrelurl> 1119 </item> 1120 <item name= "username_exists"> 1121 <description>Returns the user ID if the user exists or null if the user doesn't exist. Note: To execute this function you will need to add this line of code: require_once(ABSPATH . WPINC . '/registration.php'); in order to define the function. </description> 1122 <signature>username_exists( $username ); </signature> 1123 <docrelurl>username_exists</docrelurl> 1124 </item> 1125 <item name= "validate_username"> 1126 <description>Checks whether username is valid. </description> 1127 <signature>validate_username( $username ) </signature> 1128 <docrelurl>validate_username</docrelurl> 1129 </item> 1130 <item name= "wp_get_current_user"> 1131 <description> 1132 Retrieve the current user object (WP_User). 1133 Wrapper of get_currentuserinfo() using the global variable $current_user. 1134 </description> 1135 <signature>wp_get_current_user(); </signature> 1136 <docrelurl>wp_get_current_user</docrelurl> 1137 </item> 1138 <item name= "wp_set_current_user"> 1139 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Changes the current user by ID or name. Set $id to null and specify a name if you do not know a user's ID. Some WordPress functionality is based on the current user and not based on the signed in user. wp_set_current_user() opens the ability to edit and perform actions on users who aren't signed in. </description> 1140 <signature>wp_set_current_user( $id, $name ); </signature> 1141 <docrelurl>wp_set_current_user</docrelurl> 1142 </item> 1143 <item name= "get_author_posts_url"> 1144 <description>Gets the URL of the author page for the author with a given ID. </description> 1145 <signature>get_author_posts_url( $author_id, $author_nicename ); </signature> 1146 <docrelurl>get_author_posts_url</docrelurl> 1147 </item> 1148 <item name= "add_user_meta"> 1149 <description>Add metadata to a user's record. </description> 1150 <signature>add_user_meta( $user_id, $meta_key, $meta_value, $unique ) </signature> 1151 <docrelurl>add_user_meta</docrelurl> 1152 </item> 1153 <item name= "delete_user_meta"> 1154 <description>Remove metadata matching criteria from a user. You can match based on the key, or key and value. Removing based on key and value, will keep from removing duplicate metadata with the same key. It also allows removing all metadata matching key, if needed. </description> 1155 <signature>delete_user_meta( $user_id, $meta_key, $meta_value ) </signature> 1156 <docrelurl>delete_user_meta</docrelurl> 1157 </item> 1158 <item name= "get_user_meta"> 1159 <description>Retrieve user meta field for a user, using get_metadata(). This function replaces the deprecated get_usermeta() function. </description> 1160 <signature>get_user_meta($user_id, $key, $single); </signature> 1161 <docrelurl>get_user_meta</docrelurl> 1162 </item> 1163 <item name= "update_user_meta"> 1164 <description>Update user meta field based on user ID. Use the $prev_value parameter to differentiate between meta fields with the same key and user ID. If the meta field for the user does not exist, it will be added. </description> 1165 <signature>update_user_meta( $user_id, $meta_key, $meta_value, $prev_value ) </signature> 1166 <docrelurl>update_user_meta</docrelurl> 1167 </item> 1168 <item name= "get_the_author_meta"> 1169 <description>This function returns the desired meta data for a user. If used within The Loop, the user ID need not be specified, and the displayed data is that of the current post author. A user ID must be specified if used outside The Loop. get_the_author_meta() returns the data for use in PHP. To display the information instead, use the_author_meta() If the specified meta field does not exist for this user, is returned. </description> 1170 <signature>$user_email = get_the_author_meta('user_email'); </signature> 1171 <docrelurl>get_the_author_meta</docrelurl> 1172 </item> 1173 <item name= "wp_create_user"> 1174 <description>The wp_create_user function allows you to insert a new user into the WordPress database. It uses the $wpdb class to escape the variable values, preparing it for insertion into the database. Then the PHP compact() function is used to create an array with these values. To create a user with additional parameters, use wp_insert_user(). </description> 1175 <signature></signature> 1176 <docrelurl>wp_create_user</docrelurl> 1177 </item> 1178 <item name= "wp_delete_user"> 1179 <description>Remove user and optionally reassign posts and links to another user. If the $reassign parameter is not assigned to a User ID, then all posts will be deleted of that user. The action 'delete_user' that is passed the User ID being deleted will be run after the posts are either reassigned or deleted. The user meta will also be deleted that are for that User ID. </description> 1180 <signature>wp_delete_user( $id, $reassign ); </signature> 1181 <docrelurl>wp_delete_user</docrelurl> 1182 </item> 1183 <item name= "wp_insert_user"> 1184 <description>Insert a user into the database. Can update a current user or insert a new user based on whether the user's ID is present. Can be used to update the user's info (see below), set the user's role, and set the user's preference on the use of the rich editor. Note: As late as 2.7.1, if you are attempting to update the password for the user, this function will not hash the password, thus failing. Use the wp_update_user instead. </description> 1185 <signature>wp_insert_user( $userdata ) </signature> 1186 <docrelurl>wp_insert_user</docrelurl> 1187 </item> 1188 <item name= "wp_update_user"> 1189 <description>Update a user in the database. It is possible to update a user's password by specifying the 'user_pass' value in the $userdata parameter array. If $userdata does not contain an 'ID' key, then a new user will be created and the new user's ID will be returned. If current user's password is being updated, then the cookies will be cleared. Note: Use the wp_insert_user function to create a new user. </description> 1190 <signature>wp_update_user( $userdata ) </signature> 1191 <docrelurl>wp_update_user</docrelurl> 1192 </item> 1193 <item name= "is_user_logged_in"> 1194 <description>This Conditional Tag checks if the current visitor is logged in. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 1195 <signature></signature> 1196 <docrelurl>is_user_logged_in</docrelurl> 1197 </item> 1198 <item name= "wp_login_form"> 1199 <description>Provides a simple login form for use anywhere within WordPress. By default, it echoes the HTML immediately. Pass array('echo' => false) to return the string instead. </description> 1200 <signature>wp_login_form(); </signature> 1201 <docrelurl>wp_login_form</docrelurl> 1202 </item> 1203 <item name= "wp_signon"> 1204 <description>Authenticates a user with option to remember credentials. Replaces deprecated function wp_login. </description> 1205 <signature></signature> 1206 <docrelurl>wp_signon</docrelurl> 1207 </item> 1208 <item name= "wp_logout"> 1209 <description>Log the current user out, by destroying the current user session. </description> 1210 <signature></signature> 1211 <docrelurl>wp_logout</docrelurl> 1212 </item> 1213 <item name= "bloginfo_rss"> 1214 <description>Display RSS container for the bloginfo function. You can retrieve anything that you can using the get_bloginfo() function. Everything will be stripped of tags and characters converted, when the values are retrieved for use in the feeds. </description> 1215 <signature>bloginfo_rss( $show ) </signature> 1216 <docrelurl>bloginfo_rss</docrelurl> 1217 </item> 1218 <item name= "comment_author_rss"> 1219 <description>Display the current comment author in the feed. </description> 1220 <signature>comment_author_rss() </signature> 1221 <docrelurl>comment_author_rss</docrelurl> 1222 </item> 1223 <item name= "comment_link"> 1224 <description>Display the full, anchored URL to a single comment. This function must be used within the comments loop. If you want to link to all of the comments for an entry, use the function comments_link() instead. </description> 1225 <signature>comment_link() </signature> 1226 <docrelurl>comment_link</docrelurl> 1227 </item> 1228 <item name= "comment_text_rss"> 1229 <description>Display the current comment content for use in the feeds. </description> 1230 <signature>comment_text_rss() </signature> 1231 <docrelurl>comment_text_rss</docrelurl> 1232 </item> 1233 <item name= "do_feed"> 1234 <description>Loads the feed template from the use of an action hook. If the feed action does not have a hook, then the function will die with a message telling the visitor that the feed is not valid. It is better to only have one hook for each feed. </description> 1235 <signature>do_feed() </signature> 1236 <docrelurl>do_feed</docrelurl> 1237 </item> 1238 <item name= "do_feed_atom"> 1239 <description>Load either Atom comment feed or Atom posts feed. </description> 1240 <signature>do_feed_atom( $for_comments ) </signature> 1241 <docrelurl>do_feed_atom</docrelurl> 1242 </item> 1243 <item name= "do_feed_rdf"> 1244 <description>Load the RDF RSS 0.91 Feed template. </description> 1245 <signature>do_feed_rdf() </signature> 1246 <docrelurl>do_feed_rdf</docrelurl> 1247 </item> 1248 <item name= "do_feed_rss"> 1249 <description>Load the RDF RSS 1.0 Feed template. </description> 1250 <signature>do_feed_rss() </signature> 1251 <docrelurl>do_feed_rss</docrelurl> 1252 </item> 1253 <item name= "do_feed_rss2"> 1254 <description>Load either the RSS2 comment feed or the RSS2 posts feed. </description> 1255 <signature>do_feed_rss2( $for_comments ) </signature> 1256 <docrelurl>do_feed_rss2</docrelurl> 1257 </item> 1258 <item name= "fetch_feed"> 1259 <description>Retrieves an external feed and parses it. Uses the SimplePie and FeedCache functionality for retrieval and parsing and automatic caching. </description> 1260 <signature>$feed = fetch_feed( $uri ); </signature> 1261 <docrelurl>fetch_feed</docrelurl> 1262 </item> 1263 <item name= "fetch_rss"> 1264 <description>Retrieves an RSS feed and parses it. Uses the MagpieRSS and RSSCache functions for parsing and automatic caching and the Snoopy HTTP client for the actual retrieval. Deprecated note: Switch to using fetch_feed instead. </description> 1265 <signature></signature> 1266 <docrelurl>fetch_rss</docrelurl> 1267 </item> 1268 <item name= "get_author_feed_link"> 1269 <description>Retrieve the feed link for a given author. Returns a link to the feed for all posts by a given author. A specific feed can be requested or left blank to get the default feed. </description> 1270 <signature>get_author_feed_link( $author_id, $feed ) </signature> 1271 <docrelurl>get_author_feed_link</docrelurl> 1272 </item> 1273 <item name= "get_bloginfo_rss"> 1274 <description>RSS container for the bloginfo function. You can retrieve anything that you can using the get_bloginfo() function. Everything will be stripped of tags and characters converted, when the values are retrieved for use in the feeds. </description> 1275 <signature>get_bloginfo_rss( $show ) </signature> 1276 <docrelurl>get_bloginfo_rss</docrelurl> 1277 </item> 1278 <item name= "get_category_feed_link"> 1279 <description>This function returns a link to the feed for all posts in the specified category. A particular feed can be requested, but if the feed parameter is left blank, it returns the 'rss2' feed link. </description> 1280 <signature>get_category_feed_link('2', ''); </signature> 1281 <docrelurl>get_category_feed_link</docrelurl> 1282 </item> 1283 <item name= "get_comment_link"> 1284 <description>Retrieve the link to a given comment. </description> 1285 <signature>get_comment_link( $comment, $args ) </signature> 1286 <docrelurl>get_comment_link</docrelurl> 1287 </item> 1288 <item name= "get_comment_author_rss"> 1289 <description>Retrieve the current comment author for use in the feeds. </description> 1290 <signature>get_comment_author_rss() </signature> 1291 <docrelurl>get_comment_author_rss</docrelurl> 1292 </item> 1293 <item name= "get_post_comments_feed_link"> 1294 <description>Retrieve the permalink for the post comments feed. </description> 1295 <signature>get_post_comments_feed_link( $post_id, $feed ) </signature> 1296 <docrelurl>get_post_comments_feed_link</docrelurl> 1297 </item> 1298 <item name= "get_rss"> 1299 <description>Retrieves an RSS feed and parses it, then displays it as a list of links. The get_rss() function only outputs the list items, not the surrounding list tags itself. Uses the MagpieRSS and RSSCache functions for parsing and automatic caching and the Snoopy HTTP client for the actual retrieval. Deprecated note: Switch to using fetch_feed instead. </description> 1300 <signature> 1301 require_once(ABSPATH . WPINC . '/rss-functions.php'); 1302 get_rss($uri, $num = 5); 1303 </signature> 1304 <docrelurl>get_rss</docrelurl> 1305 </item> 1306 <item name= "get_search_comments_feed_link"> 1307 <description>Retrieve the permalink for the comments feed of the search results. </description> 1308 <signature>get_search_comments_feed_link( $search_query, $feed ) </signature> 1309 <docrelurl>get_search_comments_feed_link</docrelurl> 1310 </item> 1311 <item name= "get_search_feed_link"> 1312 <description>Retrieve the permalink for the feed of the search results. </description> 1313 <signature>echo get_search_feed_link( $search_query, $feed ) </signature> 1314 <docrelurl>get_search_feed_link</docrelurl> 1315 </item> 1316 <item name= "get_the_category_rss"> 1317 <description>Retrieve all of the post categories, formatted for use in feeds. All of the categories for the current post in the feed loop, will be retrieved and have feed markup added, so that they can easily be added to the RSS2, Atom, or RSS1 and RSS0.91 RDF feeds. </description> 1318 <signature>get_the_category_rss( $type ); </signature> 1319 <docrelurl>get_the_category_rss</docrelurl> 1320 </item> 1321 <item name= "get_the_title_rss"> 1322 <description>Retrieve the current post title for the feed. </description> 1323 <signature>get_the_title_rss() </signature> 1324 <docrelurl>get_the_title_rss</docrelurl> 1325 </item> 1326 <item name= "post_comments_feed_link"> 1327 <description>Prints out the comment feed link for a post. Link text is placed in the anchor. If no link text is specified, default text is used. If no post ID is specified, the current post is used. </description> 1328 <signature></signature> 1329 <docrelurl>post_comments_feed_link</docrelurl> 1330 </item> 1331 <item name= "rss_enclosure"> 1332 <description>Display the rss enclosure for the current post. Uses the global $post to check whether the post requires a password and if the user has the password for the post. If not then it will return before displaying. Also uses the function get_post_custom() to get the post's 'enclosure' metadata field and parses the value to display the enclosure(s). The enclosure(s) consist of enclosure HTML tag(s) with a URI and other attributes. </description> 1333 <signature>rss_enclosure() </signature> 1334 <docrelurl>rss_enclosure</docrelurl> 1335 </item> 1336 <item name= "the_title_rss"> 1337 <description>Display the post title in the feed. </description> 1338 <signature>the_title_rss() </signature> 1339 <docrelurl>the_title_rss</docrelurl> 1340 </item> 1341 <item name= "the_category_rss"> 1342 <description>Display the post categories in the feed. </description> 1343 <signature>the_category_rss( $type ) </signature> 1344 <docrelurl>the_category_rss</docrelurl> 1345 </item> 1346 <item name= "the_content_rss"> 1347 <description>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. The value of '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. </description> 1348 <signature>the_content_rss( $more_link_text, $stripteaser, $more_file, $cut, $encode_html ) </signature> 1349 <docrelurl>the_content_rss</docrelurl> 1350 </item> 1351 <item name= "the_excerpt_rss"> 1352 <description>Display the post excerpt for the feed. </description> 1353 <signature>the_excerpt_rss() </signature> 1354 <docrelurl>the_excerpt_rss</docrelurl> 1355 </item> 1356 <item name= "wp_rss"> 1357 <description>Retrieves an RSS feed and parses it, then displays it as an unordered list of links. Uses the MagpieRSS and RSSCache functions for parsing and automatic caching and the Snoopy HTTP client for the actual retrieval. Deprecated note: Switch to using fetch_feed instead. </description> 1358 <signature> 1359 include_once(ABSPATH . WPINC . '/rss.php'); 1360 wp_rss($uri, $num); 1361 </signature> 1362 <docrelurl>wp_rss</docrelurl> 1363 </item> 1364 <item name= "add_ping"> 1365 <description>Add a URL to those already pung. </description> 1366 <signature>add_ping( $post_id, $uri ) </signature> 1367 <docrelurl>add_ping</docrelurl> 1368 </item> 1369 <item name= "add_comment_meta"> 1370 <description>Add meta data field to a comment. </description> 1371 <signature>add_comment_meta( $comment_id, $meta_key, $meta_value, $unique ); </signature> 1372 <docrelurl>add_comment_meta</docrelurl> 1373 </item> 1374 <item name= "check_comment"> 1375 <description>check_comment() checks whether a comment passes internal checks set by WordPress Comment_Moderation. </description> 1376 <signature>check_comment( $author, $email, $url, $comment, $user_ip, $user_agent, $comment_type ) </signature> 1377 <docrelurl>check_comment</docrelurl> 1378 </item> 1379 <item name= "comment_text"> 1380 <description>Displays the text of a comment. Use get_comment_text to retrieve the value. </description> 1381 <signature></signature> 1382 <docrelurl>comment_text</docrelurl> 1383 </item> 1384 <item name= "comment_form"> 1385 <description>This tag outputs a complete commenting form for use within a template. Most strings and form fields may be controlled through the $args array passed into the function, while you may also choose to use the comment_form_default_fields filter to modify the array of default fields if you'd just like to add a new one or remove a single field. All fields are also individually passed through a filter of the form comment_form_field_$name where $name is the key used in the array of fields. Please note, that although most parameters are marked as optional, not including them all in your code will produce errors when using define('WP_DEBUG', true); </description> 1386 <signature>comment_form( $args, $post_id ); </signature> 1387 <docrelurl>comment_form</docrelurl> 1388 </item> 1389 <item name= "comments_number"> 1390 <description>Displays the total number of comments, Trackbacks, and Pingbacks for the current post. This tag must be within The Loop. Use get_comments_number() to retrieve the value. </description> 1391 <signature></signature> 1392 <docrelurl>comments_number</docrelurl> 1393 </item> 1394 <item name= "discover_pingback_server_uri"> 1395 <description>Finds a pingback server URI based on the given URL. Checks the xhtml for the rel="pingback" link and x-pingback headers. It does a check for the x-pingback headers first and returns that, if available. The check for the rel="pingback" has more overhead than just the header. </description> 1396 <signature>discover_pingback_server_uri( $url, $deprecated ) </signature> 1397 <docrelurl>discover_pingback_server_uri</docrelurl> 1398 </item> 1399 <item name= "delete_comment_meta"> 1400 <description>delete_comment_meta() allows you to delete any meta values stored against comments, which have been set using add_comment_meta(). Similar method to delete_post_meta(). </description> 1401 <signature></signature> 1402 <docrelurl>delete_comment_meta</docrelurl> 1403 </item> 1404 <item name= "do_all_pings"> 1405 <description>Perform all pingbacks, enclosures, trackbacks, and send to pingback services. </description> 1406 <signature>do_all_pings() </signature> 1407 <docrelurl>do_all_pings</docrelurl> 1408 </item> 1409 <item name= "do_enclose"> 1410 <description>Check content for video and audio links to add as enclosures. Will not add enclosures that have already been added. </description> 1411 <signature>do_enclose( $content, $post_ID ) </signature> 1412 <docrelurl>do_enclose</docrelurl> 1413 </item> 1414 <item name= "do_trackbacks"> 1415 <description>Perform trackbacks. </description> 1416 <signature>do_trackbacks( $post_id ) </signature> 1417 <docrelurl>do_trackbacks</docrelurl> 1418 </item> 1419 <item name= "generic_ping"> 1420 <description>Sends pings to all of the ping site services. </description> 1421 <signature>generic_ping( $post_id ) </signature> 1422 <docrelurl>generic_ping</docrelurl> 1423 </item> 1424 <item name= "get_approved_comments"> 1425 <description>Takes post ID and returns an array of objects that represent comments that have been submitted and approved. </description> 1426 <signature> 1427 $comment_array = get_approved_comments($post_id); 1428 </signature> 1429 <docrelurl>get_approved_comments</docrelurl> 1430 </item> 1431 <item name= "get_avatar"> 1432 <description>Retrieve the avatar for a user who provided a user ID or email address. Most commonly used in the comments section. This function is pluggable, however plugin authors wishing to change the gravatar output should use the get_avatar filter instead, for compatibility purposes. </description> 1433 <signature>echo get_avatar( $comment, 32 ); </signature> 1434 <docrelurl>get_avatar</docrelurl> 1435 </item> 1436 <item name= "get_comment"> 1437 <description>Takes a comment ID and returns the database record for that post. You can specify, by means of the $output parameter, how you would like the results returned. </description> 1438 <signature>get_comment( $id, $output ); </signature> 1439 <docrelurl>get_comment</docrelurl> 1440 </item> 1441 <item name= "get_comment_text"> 1442 <description>Retrieve the text of the current comment. Use comment_text to display the comment text. </description> 1443 <signature>get_comment_text( $comment_ID ) </signature> 1444 <docrelurl>get_comment_text</docrelurl> 1445 </item> 1446 <item name= "get_comment_meta"> 1447 <description>get_comment_meta() allows you to pull any meta values stored against comments, which have been set using add_comment_meta(). Similar method to get_post_meta(). Useful within the comments.php template when displaying comments against a post. </description> 1448 <signature></signature> 1449 <docrelurl>get_comment_meta</docrelurl> 1450 </item> 1451 <item name= "get_comments"> 1452 <description>Retrieve a list of comments. </description> 1453 <signature>get_comments( $args ); </signature> 1454 <docrelurl>get_comments</docrelurl> 1455 </item> 1456 <item name= "wp_list_comments"> 1457 <description>Displays all comments for a post or Page based on a variety of parameters including ones set in the administration area. See also: Migrating Plugins and Themes to 2.7 </description> 1458 <signature></signature> 1459 <docrelurl>wp_list_comments</docrelurl> 1460 </item> 1461 <item name= "get_enclosed"> 1462 <description>Retrieve enclosures already enclosed for a post. </description> 1463 <signature>get_enclosed( $post_id ) </signature> 1464 <docrelurl>get_enclosed</docrelurl> 1465 </item> 1466 <item name= "get_lastcommentmodified"> 1467 <description>The date the last comment was modified. If $cache_lastcommentmodified is set this function returns its value from the cache without hitting the database. </description> 1468 <signature>get_lastcommentmodified( $timezone ) </signature> 1469 <docrelurl>get_lastcommentmodified</docrelurl> 1470 </item> 1471 <item name= "get_pung"> 1472 <description>Retrieve URLs already pinged for a post. </description> 1473 <signature>get_pung( $post_id ) </signature> 1474 <docrelurl>get_pung</docrelurl> 1475 </item> 1476 <item name= "get_to_ping"> 1477 <description>Retrieve URLs that need to be pinged. </description> 1478 <signature>get_to_ping( $post_id ) </signature> 1479 <docrelurl>get_to_ping</docrelurl> 1480 </item> 1481 <item name= "have_comments"> 1482 <description>Determines whether there are any Comments to loop over or not. </description> 1483 <signature>$have_comments = have_comments(); </signature> 1484 <docrelurl>have_comments</docrelurl> 1485 </item> 1486 <item name= "is_trackback"> 1487 <description></description> 1488 <signature>is_trackback(); </signature> 1489 <docrelurl>is_trackback</docrelurl> 1490 </item> 1491 <item name= "pingback"> 1492 <description>Pings back the links found in a post. Includes wp-include/class-IXR.php file if not already included. </description> 1493 <signature>pingback( $content, $post_ID ) </signature> 1494 <docrelurl>pingback</docrelurl> 1495 </item> 1496 <item name= "privacy_ping_filter"> 1497 <description>Check whether blog is public before returning sites. </description> 1498 <signature>privacy_ping_filter( $sites ) </signature> 1499 <docrelurl>privacy_ping_filter</docrelurl> 1500 </item> 1501 <item name= "sanitize_comment_cookies"> 1502 <description>Sanitizes the cookies sent to the user already. Will only do anything if the cookies have already been created for the user. Mostly used after cookies had been sent to use elsewhere. </description> 1503 <signature>sanitize_comment_cookies() </signature> 1504 <docrelurl>sanitize_comment_cookies</docrelurl> 1505 </item> 1506 <item name= "trackback"> 1507 <description>Send a trackback. Updates database when sending trackback to prevent duplicates. </description> 1508 <signature>trackback( $trackback_url, $title, $excerpt, $ID ) </signature> 1509 <docrelurl>trackback</docrelurl> 1510 </item> 1511 <item name= "trackback_url"> 1512 <description>Displays or returns the trackback URL for the current post. This tag must be within The Loop. A trackback URL is where somebody posts a link to their site on your site. In return, they have posted a link to your site on their site and have copied an article you have written. </description> 1513 <signature></signature> 1514 <docrelurl>trackback_url</docrelurl> 1515 </item> 1516 <item name= "trackback_url_list"> 1517 <description>Do trackbacks for a list of URLs. </description> 1518 <signature>trackback_url_list( $tb_list, $post_id ) </signature> 1519 <docrelurl>trackback_url_list</docrelurl> 1520 </item> 1521 <item name= "update_comment_meta"> 1522 <description>The function update_comment_meta() updates the value of an existing comment meta key for the specified comment. This may be used in place of the add_comment_meta() function. The first thing this function will do is make sure that $meta_key already exists on $comment_id. If it does not it will be added. Returns true on success and false on failure. </description> 1523 <signature>update_comment_meta( 3416, 'my_key', 'Brad' ); </signature> 1524 <docrelurl>update_comment_meta</docrelurl> 1525 </item> 1526 <item name= "weblog_ping"> 1527 <description>Send a pingback. </description> 1528 <signature>weblog_ping( $server, $path ) </signature> 1529 <docrelurl>weblog_ping</docrelurl> 1530 </item> 1531 <item name= "wp_allow_comment"> 1532 <description>Validates whether this comment is allowed to be made or not. </description> 1533 <signature>wp_allow_comment( $commentdata ) </signature> 1534 <docrelurl>wp_allow_comment</docrelurl> 1535 </item> 1536 <item name= "wp_count_comments"> 1537 <description>Retrieve a total comment count for a site or post. </description> 1538 <signature>$comments_count = wp_count_comments();</signature> 1539 <docrelurl>wp_count_comments</docrelurl> 1540 </item> 1541 <item name= "wp_delete_comment"> 1542 <description>Trashes or deletes a comment. The comment is moved to trash instead of permanently deleted unless trash is disabled, item is already in the trash, or $force_delete is true. The post comment count will be updated if the comment was approved and has a post ID available. </description> 1543 <signature>wp_delete_comment( $comment_id ) </signature> 1544 <docrelurl>wp_delete_comment</docrelurl> 1545 </item> 1546 <item name= "wp_filter_comment"> 1547 <description>Filters and sanitizes comment data. Sets the comment data 'filtered' field to true when finished. This can be checked as to whether the comment should be filtered and to keep from filtering the same comment more than once. </description> 1548 <signature>wp_filter_comment( $commentdata ) </signature> 1549 <docrelurl>wp_filter_comment</docrelurl> 1550 </item> 1551 <item name= "wp_get_comment_status"> 1552 <description>The status of a comment by ID. </description> 1553 <signature>wp_get_comment_status( $comment_id ) </signature> 1554 <docrelurl>wp_get_comment_status</docrelurl> 1555 </item> 1556 <item name= "wp_get_current_commenter"> 1557 <description>Get current commenter's name, email, and URL. Expects cookies content to already be sanitized. User of this function might wish to recheck the returned array for validity. </description> 1558 <signature>wp_get_current_commenter() </signature> 1559 <docrelurl>wp_get_current_commenter</docrelurl> 1560 </item> 1561 <item name= "wp_insert_comment"> 1562 <description>Inserts a comment to the database. The available $commentdata key names are 'comment_author_IP', 'comment_date', 'comment_date_gmt', 'comment_parent', 'comment_approved', and 'user_id'. </description> 1563 <signature>wp_insert_comment($data);</signature> 1564 <docrelurl>wp_insert_comment</docrelurl> 1565 </item> 1566 <item name= "wp_new_comment"> 1567 <description>Adds a new comment to the database. Filters new comment to ensure that the fields are sanitized and valid before inserting comment into database. Calls 'comment_post' action with comment ID and whether comment is approved by WordPress. Also has 'preprocess_comment' filter for processing the comment data before the function handles it. </description> 1568 <signature>wp_new_comment( $commentdata ) </signature> 1569 <docrelurl>wp_new_comment</docrelurl> 1570 </item> 1571 <item name= "wp_set_comment_status"> 1572 <description>Sets the status of a comment. The 'wp_set_comment_status' action is called after the comment is handled and will only be called, if the comment status is either 'hold', 'approve', or 'spam'. If the comment status is not in the list, then false is returned and if the status is 'delete', then the comment is deleted without calling the action. </description> 1573 <signature>wp_set_comment_status( $comment_id, $comment_status ) </signature> 1574 <docrelurl>wp_set_comment_status</docrelurl> 1575 </item> 1576 <item name= "wp_throttle_comment_flood"> 1577 <description>Determine whether comment should be blocked because of comment flood. </description> 1578 <signature>wp_throttle_comment_flood( $block, $time_lastcomment, $time_newcomment ) </signature> 1579 <docrelurl>wp_throttle_comment_flood</docrelurl> 1580 </item> 1581 <item name= "wp_update_comment"> 1582 <description>Updates an existing comment in the database. Filters the comment and makes sure certain fields are valid before updating. </description> 1583 <signature>wp_update_comment( $commentarr ) </signature> 1584 <docrelurl>wp_update_comment</docrelurl> 1585 </item> 1586 <item name= "wp_update_comment_count"> 1587 <description>Updates the comment count for post(s). When $do_deferred is false (is by default) and the comments have been set to be deferred, $post_id will be added to a queue, which will be updated at a later date and only updated once per post ID. If the comments have not be set up to be deferred, then the post will be updated. When $do_deferred is set to true, then all previous deferred post IDs will be updated along with the current $post_id. </description> 1588 <signature>wp_update_comment_count( $post_id, $do_deferred ) </signature> 1589 <docrelurl>wp_update_comment_count</docrelurl> 1590 </item> 1591 <item name= "comment_ID"> 1592 <description>Displays the numeric ID of the current comment. This tag must be within The Loop, or a comment loop. Use get_comment_ID to retrieve the value. </description> 1593 <signature></signature> 1594 <docrelurl>comment_ID</docrelurl> 1595 </item> 1596 <item name= "comment_author"> 1597 <description>Displays the comment author name; that is, the one supplied by the commenter. If no name is provided (and "User must fill out name and email" is not enabled under Discussion Options), WordPress will assign "Anonymous" as comment author. Use get_comment_author to retrieve the value. </description> 1598 <signature></signature> 1599 <docrelurl>comment_author</docrelurl> 1600 </item> 1601 <item name= "comment_date"> 1602 <description>Displays the date a comment was posted. Use get_comment_date to retrieve the value. </description> 1603 <signature></signature> 1604 <docrelurl>comment_date</docrelurl> 1605 </item> 1606 <item name= "comment_time"> 1607 <description>Displays the time a comment was posted. This tag must be within The Loop, or a comment loop. Use get_comment_time to retrieve the value. </description> 1608 <signature></signature> 1609 <docrelurl>comment_time</docrelurl> 1610 </item> 1611 <item name= "paginate_comments_links"> 1612 <description>Create pagination links for the comments on the current post. Basically this is a macro to paginate_links() which sets the functional options of paginate_links() to make it work for comments. But you may use all the parameters of paginate_links() to style the output of paginate_comments_links(). </description> 1613 <signature>paginate_comments_links( $args ) </signature> 1614 <docrelurl>paginate_comments_links</docrelurl> 1615 </item> 1616 <item name= "previous_comments_link"> 1617 <description>Display the previous comments page link. </description> 1618 <signature>previous_comments_link( $label ) </signature> 1619 <docrelurl>previous_comments_link</docrelurl> 1620 </item> 1621 <item name= "next_comments_link"> 1622 <description>Display link to next comments pages. </description> 1623 <signature>next_comments_link( $label, $max_page ) </signature> 1624 <docrelurl>next_comments_link</docrelurl> 1625 </item> 1626 <item name= "has_filter"> 1627 <description>Check if any filter has been registered for a hook. </description> 1628 <signature></signature> 1629 <docrelurl>has_filter</docrelurl> 1630 </item> 1631 <item name= "add_filter"> 1632 <description>Hooks a function to a specific filter action. Filters are the hooks that WordPress launches to modify text of various types before adding it to the database or sending it to the browser screen. Plugins can specify that one or more of its PHP functions is executed to modify specific types of text at these times, using the Filter API. See the Plugin_API/Filter_Reference for a list of filter hooks. </description> 1633 <signature></signature> 1634 <docrelurl>add_filter</docrelurl> 1635 </item> 1636 <item name= "apply_filters"> 1637 <description>Call the functions added to a filter hook. See the Plugin API for a list of filter hooks. The callback functions attached to filter hook $tag are invoked by calling this function. This function can be used to create a new filter hook by simply calling this function with the name of the new hook specified using the $tag parameter. </description> 1638 <signature></signature> 1639 <docrelurl>apply_filters</docrelurl> 1640 </item> 1641 <item name= "current_filter"> 1642 <description>Retrieve the name of the current filter or action. </description> 1643 <signature>current_filter(); </signature> 1644 <docrelurl>current_filter</docrelurl> 1645 </item> 1646 <item name= "merge_filters"> 1647 <description>Merge the filter functions of a specific filter hook with generic filter functions. It is possible to defined generic filter functions using the filter hook all. These functions are called for every filter tag. This function merges the functions attached to the all hook with the functions of a specific hoook defined by $tag. </description> 1648 <signature></signature> 1649 <docrelurl>merge_filters</docrelurl> 1650 </item> 1651 <item name= "remove_filter"> 1652 <description>This function removes a function attached to a specified filter hook. This method can be used to remove default functions attached to a specific filter hook and possibly replace them with a substitute. See also remove_action(), add_filter() and add_action(). Important: To remove a hook, the $function_to_remove and $priority arguments must match when the hook was added. This goes for both filters and actions. No warning will be given on removal failure. </description> 1653 <signature></signature> 1654 <docrelurl>remove_filter</docrelurl> 1655 </item> 1656 <item name= "remove_all_filters"> 1657 <description>Remove all of the hooks from a filter. </description> 1658 <signature>remove_all_filters( $tag, $priority ); </signature> 1659 <docrelurl>remove_all_filters</docrelurl> 1660 </item> 1661 <item name= "has_action"> 1662 <description>Check if any action has been registered for a hook. </description> 1663 <signature>has_action( $tag, $function_to_check ) </signature> 1664 <docrelurl>has_action</docrelurl> 1665 </item> 1666 <item name= "add_action"> 1667 <description>Hooks a function on to a specific action. See Plugin API/Action Reference for a list of hooks for action. Actions are (usually) triggered when the WordPress core calls do_action(). </description> 1668 <signature></signature> 1669 <docrelurl>add_action</docrelurl> 1670 </item> 1671 <item name= "do_action"> 1672 <description>Executes a hook created by add_action. </description> 1673 <signature>do_action( 'i_am_hook', $a, $b );</signature> 1674 <docrelurl>do_action</docrelurl> 1675 </item> 1676 <item name= "do_action_ref_array"> 1677 <description>Execute functions hooked on a specific action hook, specifying arguments in an array. This function is identical to do_action, but the arguments passed to the functions hooked to $tag are supplied using an array. </description> 1678 <signature></signature> 1679 <docrelurl>do_action_ref_array</docrelurl> 1680 </item> 1681 <item name= "did_action"> 1682 <description>Retrieve the number times an action is fired. </description> 1683 <signature>did_action( $tag ); </signature> 1684 <docrelurl>did_action</docrelurl> 1685 </item> 1686 <item name= "remove_action"> 1687 <description>This function is an alias to remove_filter(). This function removes a function attached to a specified action hook. This method can be used to remove default functions attached to a specific action hook and possibly replace them with a substitute. See also remove_filter(), add_action() and add_filter(). Important: To remove a hook, the $function_to_remove and $priority arguments must match when the hook was added. This goes for both filters and actions. No warning will be given on removal failure. </description> 1688 <signature>remove_action( $tag, $function_to_remove, $priority, $accepted_args ); </signature> 1689 <docrelurl>remove_action</docrelurl> 1690 </item> 1691 <item name= "remove_all_actions"> 1692 <description>Remove all of the hooks from an action. </description> 1693 <signature>remove_all_actions( $tag, $priority ) </signature> 1694 <docrelurl>remove_all_actions</docrelurl> 1695 </item> 1696 <item name= "plugin_basename"> 1697 <description>Gets the basename of a plugin (extracts the name of a plugin from its filename). </description> 1698 <signature></signature> 1699 <docrelurl>plugin_basename</docrelurl> 1700 </item> 1701 <item name= "plugins_url"> 1702 <description>The plugins_url template tag retrieves the url to the plugins directory or to a specific file within that directory. You can hardcode the plugin slug in $path or pass __FILE__ as a second argument to get the correct folder name. </description> 1703 <signature>$url = plugins_url(); </signature> 1704 <docrelurl>plugins_url</docrelurl> 1705 </item> 1706 <item name= "get_plugin_data"> 1707 <description>Parse the plugin contents to retrieve plugin's metadata. The metadata of the plugin's data searches for the following in the plugin's header. All plugin data must be on its own line. For plugin description, it must not have any newlines or only parts of the description will be displayed and the same goes for the plugin data. Plugin data returned array contains the following: </description> 1708 <signature>get_plugin_data( $plugin_file, $markup = true, $translate = true ) </signature> 1709 <docrelurl>get_plugin_data</docrelurl> 1710 </item> 1711 <item name= "register_activation_hook"> 1712 <description>The register_activation_hook function registers a plugin function to be run when the plugin is activated. This is easier than using the activate_pluginname action. </description> 1713 <signature></signature> 1714 <docrelurl>register_activation_hook</docrelurl> 1715 </item> 1716 <item name= "register_deactivation_hook"> 1717 <description>The function register_deactivation_hook (introduced in WordPress 2.0) registers a plugin function to be run when the plugin is deactivated. </description> 1718 <signature></signature> 1719 <docrelurl>register_deactivation_hook</docrelurl> 1720 </item> 1721 <item name= "register_setting"> 1722 <description>Register a setting and its sanitization callback. This is part of the Settings API, which lets you automatically generate wp-admin settings pages by registering your settings and using a few callbacks to control the output. This function can also be used to register settings that will be shown on the default WP settings pages like media or general. Once the setting is registered you can add it to an existing section with add_settings_field() or create a new section with add_settings_section() and add it to that. </description> 1723 <signature>register_setting( 'my_options_group', 'my_option_name', 'intval' ); </signature> 1724 <docrelurl>register_setting</docrelurl> 1725 </item> 1726 <item name= "settings_fields"> 1727 <description>Output nonce, action, and option_page fields for a settings page. Please note that this function must be called inside of the form tag for the options page. </description> 1728 <signature>settings_fields( $option_group ) </signature> 1729 <docrelurl>settings_fields</docrelurl> 1730 </item> 1731 <item name= "unregister_setting"> 1732 <description>Allows clean de-registration of registered settings. Should be used mostly in deactivation hooks. </description> 1733 <signature>unregister_setting( $option_group, $option_name, $sanitize_callback ); </signature> 1734 <docrelurl>unregister_setting</docrelurl> 1735 </item> 1736 <item name= "menu_page_url"> 1737 <description>Get the url to access a particular menu page based on the slug it was registered with. If the slug hasn't been registered properly no url will be returned </description> 1738 <signature>menu_page_url( $menu_slug, $echo ); </signature> 1739 <docrelurl>menu_page_url</docrelurl> 1740 </item> 1741 <item name= "add_shortcode"> 1742 <description>Adds a hook for a shortcode tag. </description> 1743 <signature>add_shortcode( $tag , $func ); </signature> 1744 <docrelurl>add_shortcode</docrelurl> 1745 </item> 1746 <item name= "do_shortcode"> 1747 <description>Searches content for shortcodes and filters shortcodes through their hooks. </description> 1748 <signature>echo do_shortcode( $content ) </signature> 1749 <docrelurl>do_shortcode</docrelurl> 1750 </item> 1751 <item name= "do_shortcode_tag"> 1752 <description>Regular Expression callable for do_shortcode() for calling shortcode hook. </description> 1753 <signature>do_shortcode_tag( $m ) </signature> 1754 <docrelurl>do_shortcode_tag</docrelurl> 1755 </item> 1756 <item name= "get_shortcode_regex"> 1757 <description>Returns regular expression used to search for shortcodes inside posts. This function combines all registered shortcode tags into a single regular expression. </description> 1758 <signature>$pattern = get_shortcode_regex();</signature> 1759 <docrelurl>get_shortcode_regex</docrelurl> 1760 </item> 1761 <item name= "remove_shortcode"> 1762 <description>Removes hook for shortcode. </description> 1763 <signature>remove_shortcode( $tag ); </signature> 1764 <docrelurl>remove_shortcode</docrelurl> 1765 </item> 1766 <item name= "remove_all_shortcodes"> 1767 <description>Clears all shortcode hooks. </description> 1768 <signature>remove_all_shortcodes(); </signature> 1769 <docrelurl>remove_all_shortcodes</docrelurl> 1770 </item> 1771 <item name= "shortcode_atts"> 1772 <description>Combines user shortcode attributes with known attributes and fills in defaults when needed. The result will contain every key from the known attributes, merged with values from shortcode attributes. </description> 1773 <signature>shortcode_atts( $pairs , $atts ); </signature> 1774 <docrelurl>shortcode_atts</docrelurl> 1775 </item> 1776 <item name= "shortcode_parse_atts"> 1777 <description>The attributes list has the attribute name as the key and the value of the attribute as the value in the key/value pair. This allows for easier retrieval of the attributes, since all attributes have to be known. </description> 1778 <signature>shortcode_parse_atts( $text ); </signature> 1779 <docrelurl>shortcode_parse_atts</docrelurl> 1780 </item> 1781 <item name= "strip_shortcodes"> 1782 <description>Deletes all shortcode tags from the given content. </description> 1783 <signature>strip_shortcodes( $content ); </signature> 1784 <docrelurl>strip_shortcodes</docrelurl> 1785 </item> 1786 <item name= "comments_template"> 1787 <description>Loads the comment template. For use in single Post and Page displays. </description> 1788 <signature>comments_template( $file, $separate_comments ); </signature> 1789 <docrelurl>comments_template</docrelurl> 1790 </item> 1791 <item name= "get_footer"> 1792 <description>Includes the footer.php template file from your current theme's directory. if a name is specified then a specialised footer footer-{name}.php will be included. If the theme contains no footer.php file then the footer from the default theme wp-includes/theme-compat/footer.php will be included. </description> 1793 <signature>get_footer( $name ); </signature> 1794 <docrelurl>get_footer</docrelurl> 1795 </item> 1796 <item name= "get_header"> 1797 <description>Includes the header.php template file from your current theme's directory. if a name is specified then a specialised header header-{name}.php will be included. If the theme contains no header.php file then the header from the default theme wp-includes/theme-compat/header.php will be included. </description> 1798 <signature>get_header( $name ); </signature> 1799 <docrelurl>get_header</docrelurl> 1800 </item> 1801 <item name= "get_sidebar"> 1802 <description>Includes the sidebar.php template file from your current theme's directory. If a name ($name) is specified then a specialized sidebar sidebar-{name}.php will be included. If the theme contains no sidebar.php file then the sidebar from the default theme wp-includes/theme-compat/sidebar.php will be included. </description> 1803 <signature>get_sidebar( $name ); </signature> 1804 <docrelurl>get_sidebar</docrelurl> 1805 </item> 1806 <item name= "get_search_form"> 1807 <description>Display search form using searchform.php Theme file. </description> 1808 <signature>get_search_form( $echo ); </signature> 1809 <docrelurl>get_search_form</docrelurl> 1810 </item> 1811 <item name= "add_custom_background"> 1812 <description>Add callbacks for background image display. The parameter $header_callback callback will be required to display the content for the 'wp_head' action. The parameter $admin_header_callback callback will be added to Custom_Background class and that will be added to the 'admin_menu' action. </description> 1813 <signature>add_custom_background( $header_callback, $admin_header_callback, $admin_image_div_callback ) </signature> 1814 <docrelurl>add_custom_background</docrelurl> 1815 </item> 1816 <item name= "add_custom_image_header"> 1817 <description>Add callbacks for image header display. The parameter $header_callback callback will be required to display the content for the 'wp_head' action. The parameter $admin_header_callback callback will be added to Custom_Image_Header class and that will be added to the 'admin_menu' action. </description> 1818 <signature>add_custom_image_header( $header_callback, $admin_header_callback, $admin_image_div_callback ) </signature> 1819 <docrelurl>add_custom_image_header</docrelurl> 1820 </item> 1821 <item name= "add_theme_support"> 1822 <description>Allows a theme or plugin to register support of a certain theme feature. If called from a theme, it should be done in the theme's functions.php file to work. It can also be called from a plugin if attached to a hook. If attached to a hook, it must be after_setup_theme. The init hook may be too late for some features. </description> 1823 <signature>add_theme_support( $feature ); </signature> 1824 <docrelurl>add_theme_support</docrelurl> 1825 </item> 1826 <item name= "body_class"> 1827 <description>Themes have a template tag for the body tag which will help theme authors to style more effectively with CSS. The Template Tag is called body_class. This function gives the body element different classes and can be added, typically, in the header.php's HTML body tag. </description> 1828 <signature></signature> 1829 <docrelurl>body_class</docrelurl> 1830 </item> 1831 <item name= "current_theme_supports"> 1832 <description>Checks a theme's support for a given theme feature. </description> 1833 <signature>current_theme_supports( $feature ); </signature> 1834 <docrelurl>current_theme_supports</docrelurl> 1835 </item> 1836 <item name= "dynamic_sidebar"> 1837 <description>This function calls each of the active widget callbacks in order, which prints the markup for the sidebar. If you have more than one sidebar, you should give this function the name or number of the sidebar you want to print. This function returns true on success and false on failure. The return value should be used to determine whether to display a static sidebar. This ensures that your theme will look good even when the Widgets plug-in is not active. If your sidebars were registered by number, they should be retrieved by number. If they had names when you registered them, use their names to retrieve them. </description> 1838 <signature></signature> 1839 <docrelurl>dynamic_sidebar</docrelurl> 1840 </item> 1841 <item name= "get_404_template"> 1842 <description>Retrieve path of 404 template in current or parent template. </description> 1843 <signature>get_404_template(); </signature> 1844 <docrelurl>get_404_template</docrelurl> 1845 </item> 1846 <item name= "get_archive_template"> 1847 <description>Retrieve path of archive template in current or parent template. </description> 1848 <signature>get_archive_template(); </signature> 1849 <docrelurl>get_archive_template</docrelurl> 1850 </item> 1851 <item name= "get_attachment_template"> 1852 <description>Retrieve path of attachment template in current or parent template. The attachment path first checks if the first part of the mime type exists. The second check is for the second part of the mime type. The last check is for both types separated by an underscore. If neither are found then the file 'attachment.php' is checked and returned. Some examples for the 'text/plain' mime type are 'text.php', 'plain.php', and finally 'text_plain.php'. </description> 1853 <signature>get_attachment_template() </signature> 1854 <docrelurl>get_attachment_template</docrelurl> 1855 </item> 1856 <item name= "get_author_template"> 1857 <description>Retrieve path of author template in current or parent template. </description> 1858 <signature>get_author_template() </signature> 1859 <docrelurl>get_author_template</docrelurl> 1860 </item> 1861 <item name= "get_category_template|get_category_template"> 1862 <description>Retrieve path of category template in current or parent template. Works by retrieving the current category ID, for example 'category-1.php' and will fallback to category.php template, if the category ID file doesn't exist. </description> 1863 <signature>get_category_template() </signature> 1864 <docrelurl>get_category_template</docrelurl> 1865 </item> 1866 <item name= "get_comments_popup_template"> 1867 <description>Retrieve path of comment popup template in current or parent template. Checks for comment popup template in current template, if it exists or in the parent template. If it doesn't exist, then it retrieves the comment-popup.php file from the default theme. The default theme must then exist for it to work. </description> 1868 <signature>get_comments_popup_template() </signature> 1869 <docrelurl>get_comments_popup_template</docrelurl> 1870 </item> 1871 <item name= "get_current_theme"> 1872 <description>Retrieve the name of the current theme. </description> 1873 <signature>get_current_theme() </signature> 1874 <docrelurl>get_current_theme</docrelurl> 1875 </item> 1876 <item name= "get_date_template"> 1877 <description>Retrieve path of date template in current or parent template. </description> 1878 <signature>get_date_template() </signature> 1879 <docrelurl>get_date_template</docrelurl> 1880 </item> 1881 <item name= "get_header_image"> 1882 <description>Retrieve header image for custom header. </description> 1883 <signature>get_header_image() </signature> 1884 <docrelurl>get_header_image</docrelurl> 1885 </item> 1886 <item name= "get_header_textcolor"> 1887 <description>Retrieve text color for custom header. </description> 1888 <signature>get_header_textcolor() </signature> 1889 <docrelurl>get_header_textcolor</docrelurl> 1890 </item> 1891 <item name= "get_home_template"> 1892 <description>Retrieve path of home template in current or parent template. Attempts to locate 'home.php' first before falling back to 'index.php'. </description> 1893 <signature>get_home_template() </signature> 1894 <docrelurl>get_home_template</docrelurl> 1895 </item> 1896 <item name= "get_locale_stylesheet_uri"> 1897 <description>Retrieve localized stylesheet URI. The stylesheet directory for the localized stylesheet files are located, by default, in the base theme directory. The name of the locale file will be the locale followed by '.css'. If that does not exist, then the text direction stylesheet will be checked for existence, for example 'ltr.css'. The theme may change the location of the stylesheet directory by either using the 'stylesheet_directory_uri' filter or the 'locale_stylesheet_uri' filter. If you want to change the location of the stylesheet files for the entire WordPress workflow, then change the former. If you just have the locale in a separate folder, then change the latter. </description> 1898 <signature>get_locale_stylesheet_uri() </signature> 1899 <docrelurl>get_locale_stylesheet_uri</docrelurl> 1900 </item> 1901 <item name= "get_page_template"> 1902 <description>Retrieve path of page template in current or parent template. First attempt is to look for the file in the '_wp_page_template' page meta data. The second attempt, if the first has a file and is not empty, is to look for 'page.php'. </description> 1903 <signature>get_page_template() </signature> 1904 <docrelurl>get_page_template</docrelurl> 1905 </item> 1906 <item name= "get_query_template"> 1907 <description>Retrieve path to file without the use of extension. Used to quickly retrieve the path of file without including the file extension. It will also check the parent template, if the file exists, with the use of locate_template(). Allows for more generic file location without the use of the other get_*_template() functions. Can be used with include() or require() to retrieve path. </description> 1908 <signature>get_query_template( $type, $templates ); </signature> 1909 <docrelurl>get_query_template</docrelurl> 1910 </item> 1911 <item name= "get_search_template"> 1912 <description>Retrieve path of search template in current or parent template. </description> 1913 <signature>get_search_template() </signature> 1914 <docrelurl>get_search_template</docrelurl> 1915 </item> 1916 <item name= "get_single_template"> 1917 <description>Retrieve path of single template in current or parent template. </description> 1918 <signature>get_single_template() </signature> 1919 <docrelurl>get_single_template</docrelurl> 1920 </item> 1921 <item name= "get_stylesheet"> 1922 <description>Retrieve name of the current stylesheet. The theme name that the administrator has currently set the front end theme as. For all intents and purposes, the template name and the stylesheet name are going to be the same for most cases. In the event that you use a child theme, that is the name that will be returned, rather than the parent. </description> 1923 <signature>get_stylesheet(); </signature> 1924 <docrelurl>get_stylesheet</docrelurl> 1925 </item> 1926 <item name= "get_stylesheet_directory"> 1927 <description>Retrieve stylesheet directory Path for the current theme/child theme. Note: Does not contain a trailing slash. Returns an absolute server path (eg: /home/user/public_html/wp-content/themes/my_theme), not a URI. To retrieve the URI of the stylesheet directory use get_stylesheet_directory_uri() instead. </description> 1928 <signature>get_stylesheet_directory() </signature> 1929 <docrelurl>get_stylesheet_directory</docrelurl> 1930 </item> 1931 <item name= "get_stylesheet_uri"> 1932 <description>Retrieve URI of current theme stylesheet. The stylesheet file name is 'style.css' which is appended to get_stylesheet_directory_uri() path. </description> 1933 <signature>get_stylesheet_uri() </signature> 1934 <docrelurl>get_stylesheet_uri</docrelurl> 1935 </item> 1936 <item name= "get_tag_template"> 1937 <description>Retrieve path of tag template in current or parent template. Works by first retrieving the current tag name, for example 'tag-wordpress.php' and then trying tag ID, for example 'tag-1.php' and will finally fallback to tag.php template, if those files don't exist. </description> 1938 <signature>get_tag_template() </signature> 1939 <docrelurl>get_tag_template</docrelurl> 1940 </item> 1941 <item name= "get_taxonomy_template"> 1942 <description>Retrieve path of taxonomy template in current or parent template. Retrieves the taxonomy and term, if term is available. The template is prepended with 'taxonomy-' and followed by both the taxonomy string and the taxonomy string followed by a dash and then followed by the term. The taxonomy and term template is checked and used first, if it exists. Second, just the taxonomy template is checked, and then finally, taxonomy.php template is used. If none of the files exist, then it will fall back on to index.php. </description> 1943 <signature>get_taxonomy_template() </signature> 1944 <docrelurl>get_taxonomy_template</docrelurl> 1945 </item> 1946 <item name= "get_template"> 1947 <description>Retrieve name of the current theme. </description> 1948 <signature>get_template() </signature> 1949 <docrelurl>get_template</docrelurl> 1950 </item> 1951 <item name= "get_template_directory"> 1952 <description>Retrieve template directory Path for the current theme. Note: Does not contain a trailing slash. In the event a child theme is being used, the parent theme directory Path will be returned, use get_stylesheet_directory() to get the child theme directory Path. </description> 1953 <signature>get_template_directory(); </signature> 1954 <docrelurl>get_template_directory</docrelurl> 1955 </item> 1956 <item name= "get_template_directory_uri"> 1957 <description>Retrieve template directory URI for the current theme. Checks for SSL. Note: Does not contain a trailing slash. In the event a child theme is being used, the parent theme directory URI will be returned, use get_stylesheet_directory_uri() to get the child theme directory URI. </description> 1958 <signature>get_template_directory_uri(); </signature> 1959 <docrelurl>get_template_directory_uri</docrelurl> 1960 </item> 1961 <item name= "get_template_part"> 1962 <description>Load a template part into a template (other than header, sidebar, footer). Makes it easy for a theme to reuse sections of code and an easy way for child themes to replace sections of their parent theme. Includes the named template part for a theme or if a name is specified then a specialized part will be included. If the theme contains no {slug}.php file then no template will be included. For the parameter, if the file is called "{slug}-{name}.php". </description> 1963 <signature>get_template_part( 'loop', 'index' ); </signature> 1964 <docrelurl>get_template_part</docrelurl> 1965 </item> 1966 <item name= "get_theme"> 1967 <description>Retrieve theme data. </description> 1968 <signature>get_theme( $theme ) </signature> 1969 <docrelurl>get_theme</docrelurl> 1970 </item> 1971 <item name= "get_theme_data"> 1972 <description>Returns an array of information about a theme file. </description> 1973 <signature>$theme_data = get_theme_data( get_theme_root() . '/' . $theme_name . '/style.css' );</signature> 1974 <docrelurl>get_theme_data</docrelurl> 1975 </item> 1976 <item name= "get_theme_support"> 1977 <description>Allows a theme or plugin to get support of a certain theme feature. </description> 1978 <signature>get_theme_support( $feature ); </signature> 1979 <docrelurl>get_theme_support</docrelurl> 1980 </item> 1981 <item name= "get_theme_mod"> 1982 <description>Retrieve theme modification value for the current theme. If the modification name does not exist, then the $default will be passed through sprintf() with the first string the template directory URI and the second string the stylesheet directory URI. </description> 1983 <signature>get_theme_mod( $name, $default ) </signature> 1984 <docrelurl>get_theme_mod</docrelurl> 1985 </item> 1986 <item name= "get_theme_root"> 1987 <description>Retrieve path to themes directory. Does not have trailing slash. </description> 1988 <signature>get_theme_root() </signature> 1989 <docrelurl>get_theme_root</docrelurl> 1990 </item> 1991 <item name= "get_theme_root_uri"> 1992 <description>Retrieve URI for themes directory. Does not have trailing slash. </description> 1993 <signature>get_theme_root_uri(); </signature> 1994 <docrelurl>get_theme_root_uri</docrelurl> 1995 </item> 1996 <item name= "get_themes"> 1997 <description>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 or index.php. If the theme has a parent theme, it is broken if it is missing style.css; index.php is optional. The broken theme list is saved in the $wp_broken_themes global, which is displayed on the theme list in the administration panels. </description> 1998 <signature>get_themes() </signature> 1999 <docrelurl>get_themes</docrelurl> 2000 </item> 2001 <item name= "header_image"> 2002 <description>Display header image path. </description> 2003 <signature>header_image() </signature> 2004 <docrelurl>header_image</docrelurl> 2005 </item> 2006 <item name= "header_textcolor"> 2007 <description>Display text color for custom header. </description> 2008 <signature>header_textcolor(); </signature> 2009 <docrelurl>header_textcolor</docrelurl> 2010 </item> 2011 <item name= "is_child_theme"> 2012 <description>Whether a child theme is in use. </description> 2013 <signature>is_child_theme(); </signature> 2014 <docrelurl>is_child_theme</docrelurl> 2015 </item> 2016 <item name= "load_template"> 2017 <description>Require once the template file with WordPress environment. The globals are set up for the template file to ensure that the WordPress environment is available from within the function. The query variables are also available. </description> 2018 <signature>load_template( $_template_file ) </signature> 2019 <docrelurl>load_template</docrelurl> 2020 </item> 2021 <item name= "locale_stylesheet"> 2022 <description> 2023 Display localized stylesheet link element. If get_locale_stylesheet_uri() returns a value, locale_stylesheet will echo a valid xhtml tag.</description> 2024 <signature>locale_stylesheet()</signature> 2025 <docrelurl>locale_stylesheet</docrelurl> 2026 </item> 2027 <item name= "locate_template"> 2028 <description>Retrieve the name of the highest priority template file that exists. Searches in the STYLESHEETPATH before TEMPLATEPATH so that themes which inherit from a parent theme can just overload one file. </description> 2029 <signature>locate_template( $template_names, $load, $require_once ) </signature> 2030 <docrelurl>locate_template</docrelurl> 2031 </item> 2032 <item name= "post_class"> 2033 <description> 2034 WordPress theme authors, who want to have finer css control options for their post styling, have the post_class function available. When the post_class function is added to a tag within the loop. This function is typically used in the index.php, single.php, and other template files that feature hierarchical post listings. If you would prefer to have the post classes returned instead of echoed, you would want to use get_post_class(). For css classes intended to help target entire pages, see body_class(), and for classes targeting comment listings, see comment_class(). 2035 </description> 2036 <signature>post_class('',$post_id); </signature> 2037 <docrelurl>post_class</docrelurl> 2038 </item> 2039 <item name= "preview_theme"> 2040 <description>Start preview theme output buffer. Will only preform task if the user has permissions and 'template' and 'preview' query variables exist. Will add 'stylesheet' filter if 'stylesheet' query variable exists. </description> 2041 <signature>preview_theme() </signature> 2042 <docrelurl>preview_theme</docrelurl> 2043 </item> 2044 <item name= "preview_theme_ob_filter"> 2045 <description>Callback function for ob_start() to capture all links in the theme. </description> 2046 <signature>preview_theme_ob_filter( $content ) </signature> 2047 <docrelurl>preview_theme_ob_filter</docrelurl> 2048 </item> 2049 <item name= "preview_theme_ob_filter_callback"> 2050 <description>Manipulates preview theme links in order to control and maintain location. Callback function for preg_replace_callback() to accept and filter matches. </description> 2051 <signature>preview_theme_ob_filter_callback( $matches ) </signature> 2052 <docrelurl>preview_theme_ob_filter_callback</docrelurl> 2053 </item> 2054 <item name= "register_nav_menu"> 2055 <description>Registers a single custom navigation menu in the new custom menu editor of WordPress 3.0. This allows for creation of custom menus in the dashboard for use in your theme. See register_nav_menus() for creating multiple menus at once. </description> 2056 <signature></signature> 2057 <docrelurl>register_nav_menu</docrelurl> 2058 </item> 2059 <item name= "register_nav_menus"> 2060 <description>Registers multiple custom navigation menus in the new custom menu editor of WordPress 3.0. This allows for the creation of custom menus in the dashboard for use in your theme. See register_nav_menu() for creating a single menu, and Navigation Menus for adding theme support. </description> 2061 <signature></signature> 2062 <docrelurl>register_nav_menus</docrelurl> 2063 </item> 2064 <item name= "register_sidebar"> 2065 <description>Builds the definition for a single sidebar and returns the ID. Call on "widgets_init" action. </description> 2066 <signature>register_sidebar( $args ); </signature> 2067 <docrelurl>register_sidebar</docrelurl> 2068 </item> 2069 <item name= "register_sidebars"> 2070 <description>Creates multiple sidebars. Registers one or more sidebars to be used in the current theme. Most themes have only one sidebar. For this reason, the number parameter is optional and defaults to one. The args array parameter can contain a 'name' which will be prepended to the sidebar number if there is more than one sidebar. If no name is specified, 'Sidebar' is used. </description> 2071 <signature></signature> 2072 <docrelurl>register_sidebars</docrelurl> 2073 </item> 2074 <item name= "register_theme_directory"> 2075 <description>Register a directory that contains themes. </description> 2076 <signature>register_theme_directory( $directory ) </signature> 2077 <docrelurl>register_theme_directory</docrelurl> 2078 </item> 2079 <item name= "remove_theme_mod"> 2080 <description>Remove theme modification name from current theme list. If removing the name also removes all elements, then the entire option will be removed. </description> 2081 <signature>remove_theme_mod( $name ) </signature> 2082 <docrelurl>remove_theme_mod</docrelurl> 2083 </item> 2084 <item name= "remove_theme_mods"> 2085 <description>Remove all theme modification options for current theme. </description> 2086 <signature>remove_theme_mods() </signature> 2087 <docrelurl>remove_theme_mods</docrelurl> 2088 </item> 2089 <item name= "require_if_theme_supports"> 2090 <description>Checks a theme's support for a given feature before loading the functions which implement it. </description> 2091 <signature>require_if_theme_supports( $feature, $include ) </signature> 2092 <docrelurl>require_if_theme_supports</docrelurl> 2093 </item> 2094 <item name= "search_theme_directories"> 2095 <description>Search all registered theme directories for complete and valid themes. </description> 2096 <signature>search_theme_directories() </signature> 2097 <docrelurl>search_theme_directories</docrelurl> 2098 </item> 2099 <item name= "set_theme_mod"> 2100 <description>Update theme modification value for the current theme. </description> 2101 <signature>set_theme_mod( $name, $value ) </signature> 2102 <docrelurl>set_theme_mod</docrelurl> 2103 </item> 2104 <item name= "switch_theme"> 2105 <description>Switches current theme to new template and stylesheet names. </description> 2106 <signature>switch_theme( $template, $stylesheet ) </signature> 2107 <docrelurl>switch_theme</docrelurl> 2108 </item> 2109 <item name= "validate_current_theme"> 2110 <description>Checks that current theme files 'index.php' and 'style.css' exists. Does not check the 'default' theme. The 'default' theme should always exist or should have another theme renamed to that template name and directory path. Will switch theme to default if current theme does not validate. You can use the 'validate_current_theme' filter to return false to disable this functionality. </description> 2111 <signature>validate_current_theme() </signature> 2112 <docrelurl>validate_current_theme</docrelurl> 2113 </item> 2114 <item name= "unregister_nav_menu"> 2115 <description>Unregisters a custom navigation menu for a theme location. </description> 2116 <signature></signature> 2117 <docrelurl>unregister_nav_menu</docrelurl> 2118 </item> 2119 <item name= "wp_get_archives"> 2120 <description>This function displays a date-based archives list. This tag can be used anywhere within a template. </description> 2121 <signature>wp_get_archives('type=monthly&limit=12'); </signature> 2122 <docrelurl>wp_get_archives</docrelurl> 2123 </item> 2124 <item name= "wp_get_nav_menu_items"> 2125 <description>Returns the items from a navigation menu created in the Appearance → Menus panel. Given a menu name, id or slug, the function returns the menu items from that navigation menu. The menu items returned are in fact the actual nav_menu_item type posts which contain references to the normal posts/pages they are associated with. </description> 2126 <signature></signature> 2127 <docrelurl>wp_get_nav_menu_items</docrelurl> 2128 </item> 2129 <item name= "wp_nav_menu"> 2130 <description>Displays a navigation menu created in the Appearance → Menus panel. Given a theme_location parameter, the function displays the menu assigned to that location, or nothing if no such location exists or no menu is assigned to it. If not given a theme_location parameter, the function displays </description> 2131 <signature>wp_nav_menu( array('menu' => 'Project Nav' )); </signature> 2132 <docrelurl>wp_nav_menu</docrelurl> 2133 </item> 2134 <item name= "wp_page_menu"> 2135 <description>Displays a list of WordPress Pages as links, and affords the opportunity to have Home added automatically to the list of Pages displayed. This Tag is useful to customize the Sidebar or Header, but may be used in other Templates as well. </description> 2136 <signature></signature> 2137 <docrelurl>wp_page_menu</docrelurl> 2138 </item> 2139 <item name= "wp_title"> 2140 <description> 2141 Displays or returns the title of the page. A separator string can be defined, and beginning with Version 2.5, that separator can be designated to print before or after the title of the page. This tag can be used anywhere within a template as long as it's outside The Loop on the main page, though is typically used in the "title" element for the head of a page. The title text depends on the query: </description> 2142 <signature></signature> 2143 <docrelurl>wp_title</docrelurl> 2144 </item> 2145 <item name= "add_magic_quotes"> 2146 <description>Walks an array while sanitizing the contents. </description> 2147 <signature>add_magic_quotes( $array ) </signature> 2148 <docrelurl>add_magic_quotes</docrelurl> 2149 </item> 2150 <item name= "addslashes_gpc"> 2151 <description>Adds slashes to escape strings. Slashes will first be removed if magic-quotes-gpc is set, see magic_quotes for more details. </description> 2152 <signature>addslashes_gpc( $gpc ) </signature> 2153 <docrelurl>addslashes_gpc</docrelurl> 2154 </item> 2155 <item name= "antispambot"> 2156 <description>Converts email addresses characters to HTML entities to block spam bots. </description> 2157 <signature>antispambot( $emailaddy, $mailto ) </signature> 2158 <docrelurl>antispambot</docrelurl> 2159 </item> 2160 <item name= "attribute_escape"> 2161 <description>This function is deprecated as of WordPress 2.8.0. Please use esc_attr instead. This function escapes or encodes HTML special characters (including single and double quotes) for use in HTML attributes. It works like the standard PHP htmlspecialchars except that it doesn't double-encode HTML entities (i.e. & will remain unchanged, rather than encoded to &amp;). attribute_escape can be found in /wp-includes/formatting.php. </description> 2162 <signature>echo attribute_escape($text); </signature> 2163 <docrelurl>attribute_escape</docrelurl> 2164 </item> 2165 <item name= "backslashit"> 2166 <description>Adds backslashes before letters and before a number at the start of a string. </description> 2167 <signature>backslashit( $string ) </signature> 2168 <docrelurl>backslashit</docrelurl> 2169 </item> 2170 <item name= "balanceTags"> 2171 <description>Will balance the tags if forced to or the option is set to balance tags. The option 'use_balanceTags' is used for whether the tags will be balanced. Either the $force parameter or 'use_balanceTags' option need to be true before the tags will be balanced. </description> 2172 <signature>balanceTags( $text, $force ); </signature> 2173 <docrelurl>balanceTags</docrelurl> 2174 </item> 2175 <item name= "clean_pre"> 2176 <description> 2177 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. 2178 </description> 2179 <signature>clean_pre( $matches ) </signature> 2180 <docrelurl>clean_pre</docrelurl> 2181 </item> 2182 <item name= "clean_url"> 2183 <description>Checks and cleans a URL. A number of characters are removed from the URL. If the URL is for displaying (the default behaviour) ampersands (&) are also replaced. The 'clean_url' filter is applied to the returned cleaned URL. </description> 2184 <signature>clean_url( $url, $protocols, $context ) </signature> 2185 <docrelurl>clean_url</docrelurl> 2186 </item> 2187 <item name= "convert_chars"> 2188 <description>Converts a number of characters from a string. Metadata tags are converted into correct XHTML and Unicode characters are converted to the valid range. </description> 2189 <signature>convert_chars( $content, $deprecated ) </signature> 2190 <docrelurl>convert_chars</docrelurl> 2191 </item> 2192 <item name= "convert_smilies"> 2193 <description>Convert text equivalent of smilies to images. Will only convert smilies if the option 'use_smilies' is true and the globals used in the function aren't empty. </description> 2194 <signature>convert_smilies( $text ) </signature> 2195 <docrelurl>convert_smilies</docrelurl> 2196 </item> 2197 <item name= "ent2ncr"> 2198 <description>Converts named entities into numbered entities. </description> 2199 <signature>ent2ncr( $text ) </signature> 2200 <docrelurl>ent2ncr</docrelurl> 2201 </item> 2202 <item name= "esc_attr"> 2203 <description> 2204 Encodes < > & " ' (less than, greater than, ampersand, double quote, single quote). Will never double encode entities. Always use when escaping user-input, in forms especially. 2205 </description> 2206 <signature>echo esc_attr( $text ) </signature> 2207 <docrelurl>esc_attr</docrelurl> 2208 </item> 2209 <item name= "esc_textarea"> 2210 <description>Encodes text for use inside a "textarea" element. </description> 2211 <signature>esc_textarea( $text ); </signature> 2212 <docrelurl>esc_textarea</docrelurl> 2213 </item> 2214 <item name= "force_balance_tags"> 2215 <description>Balances tags of string using a modified stack. Ignores the 'use_balanceTags' option. </description> 2216 <signature>force_balance_tags( $text ) </signature> 2217 <docrelurl>force_balance_tags</docrelurl> 2218 </item> 2219 <item name= "format_to_edit"> 2220 <description>Acts on text which is about to be edited. Unless $richedit is set, it is simply a holder for the 'format_to_edit' filter. If $richedit is set true htmlspecialchars will be run on the content, converting special characters to HTML entities. </description> 2221 <signature>format_to_edit( $content, $richedit ) </signature> 2222 <docrelurl>format_to_edit</docrelurl> 2223 </item> 2224 <item name= "format_to_post"> 2225 <description>Holder for the 'format_to_post' filter. </description> 2226 <signature>format_to_post( $content ) </signature> 2227 <docrelurl>format_to_post</docrelurl> 2228 </item> 2229 <item name= "funky_javascript_fix"> 2230 <description>Fixes javascript bugs in browsers. Converts unicode characters to HTML numbered entities. </description> 2231 <signature>funky_javascript_fix( $text ) </signature> 2232 <docrelurl>funky_javascript_fix</docrelurl> 2233 </item> 2234 <item name= "htmlentities2"> 2235 <description>Convert entities, while preserving already-encoded entities. </description> 2236 <signature>htmlentities2( $myHTML ) </signature> 2237 <docrelurl>htmlentities2</docrelurl> 2238 </item> 2239 <item name= "is_email"> 2240 <description>Verifies that an email is valid. </description> 2241 <signature>is_email( $email ) </signature> 2242 <docrelurl>is_email</docrelurl> 2243 </item> 2244 <item name= "js_escape"> 2245 <description>Escape single quotes. Convert double quotes. Fix line endings. The filter 'js_escape' is also applied here. js_escape has been deprecated since 2.8. Use esc_js instead. </description> 2246 <signature>js_escape( $text ) </signature> 2247 <docrelurl>js_escape</docrelurl> 2248 </item> 2249 <item name= "make_clickable"> 2250 <description>Convert plain text URI to HTML links. Converts URI, www, ftp, and email addresses. Finishes by fixing links within links. </description> 2251 <signature>make_clickable( $ret ) </signature> 2252 <docrelurl>make_clickable</docrelurl> 2253 </item> 2254 <item name= "popuplinks"> 2255 <description>Adds target='_blank' and rel='external' to all HTML Anchor tags to open links in new windows. Comment text in popup windows should be filtered through this. Right now it's a moderately dumb function, ideally it would detect whether a target or rel attribute was already there and adjust its actions accordingly. </description> 2256 <signature>popuplinks( $text ) </signature> 2257 <docrelurl>popuplinks</docrelurl> 2258 </item> 2259 <item name= "remove_accents"> 2260 <description>Converts all accent characters to ASCII characters. If there are no accent characters, then the string given is just returned. </description> 2261 <signature>remove_accents( $string ) </signature> 2262 <docrelurl>remove_accents</docrelurl> 2263 </item> 2264 <item name= "sanitize_email"> 2265 <description>Strips out all characters that are not allowable in an email. </description> 2266 <signature>sanitize_email( $email ) </signature> 2267 <docrelurl>sanitize_email</docrelurl> 2268 </item> 2269 <item name= "sanitize_file_name"> 2270 <description>Sanitizes a filename replacing whitespace with dashes Removes special characters that are illegal in filenames on certain operating systems and special characters requiring special escaping to manipulate at the command line. Replaces spaces and consecutive dashes with a single dash. Trim period, dash and underscore from beginning and end of filename. </description> 2271 <signature>sanitize_file_name( $name ) </signature> 2272 <docrelurl>sanitize_file_name</docrelurl> 2273 </item> 2274 <item name= "sanitize_html_class"> 2275 <description>Santizes a html classname to ensure it only contains valid characters. Strips the string down to A-Z,a-z,0-9,_,-. If this results in an empty string, then the function will return the alternative value supplied. </description> 2276 <signature>$post_class = sanitize_html_class( $post->post_title );</signature> 2277 <docrelurl>sanitize_html_class</docrelurl> 2278 </item> 2279 <item name= "sanitize_key"> 2280 <description>Sanitize a string key. Keys are used as internal identifiers. Lowercase alphanumeric characters, dashes and underscores are allowed. </description> 2281 <signature>sanitize_key( $key ); </signature> 2282 <docrelurl>sanitize_key</docrelurl> 2283 </item> 2284 <item name= "sanitize_text_field"> 2285 <description> 2286 Sanitize a string from user input or from the db. Checks for invalid UTF-8, Convert single < characters to entity, strip all tags, remove line breaks, tabs and extra white space, strip octets. 2287 </description> 2288 <signature></signature> 2289 <docrelurl>sanitize_text_field</docrelurl> 2290 </item> 2291 <item name= "sanitize_title"> 2292 <description>Sanitizes title or use fallback title. Specifically, HTML and PHP tags are stripped. Further actions can be added via the plugin API. If $title is empty and $fallback_title is set, the latter will be used. Despite the name of this function, the returned value is intended to be suitable for use in a URL, not as a human-readable title. </description> 2293 <signature>sanitize_title( $title, $fallback_title ) </signature> 2294 <docrelurl>sanitize_title</docrelurl> 2295 </item> 2296 <item name= "sanitize_title_with_dashes"> 2297 <description>Sanitizes title, replacing whitespace with dashes. Limits the output to alphanumeric characters, underscore (_) and dash (-). Whitespace becomes a dash. Note that it does not replace special accented characters (see plugins such as [1] to fix that). </description> 2298 <signature>sanitize_title_with_dashes( $title ) </signature> 2299 <docrelurl>sanitize_title_with_dashes</docrelurl> 2300 </item> 2301 <item name= "sanitize_user"> 2302 <description>Sanitize username stripping out unsafe characters. If $strict is true, only alphanumeric characters plus these: _, space, ., -, *, and @ are returned. Removes tags, octets, entities, and if strict is enabled, will remove all non-ASCII characters. After sanitizing, it passes the username, raw username (the username in the parameter), and the strict parameter as parameters for the filter. </description> 2303 <signature>sanitize_user( $username, $strict ) </signature> 2304 <docrelurl>sanitize_user</docrelurl> 2305 </item> 2306 <item name= "seems_utf8"> 2307 <description>Checks to see if a string is utf8 encoded. </description> 2308 <signature>seems_utf8( $str ); </signature> 2309 <docrelurl>seems_utf8</docrelurl> 2310 </item> 2311 <item name= "stripslashes_deep"> 2312 <description>Navigates through an array and removes slashes from the values. If an array is passed, the array_map() function causes a callback to pass the value back to the function. The slashes from each value will be removed using the stripslashes() function. </description> 2313 <signature>stripslashes_deep( $value ); </signature> 2314 <docrelurl>stripslashes_deep</docrelurl> 2315 </item> 2316 <item name= "trailingslashit"> 2317 <description>Appends a trailing slash. Will remove trailing slash if it exists already before adding a trailing slash. This prevents double slashing a string or path. The primary use of this is for paths and thus should be used for paths. It is not restricted to paths and offers no specific path support. </description> 2318 <signature>trailingslashit( $string ) </signature> 2319 <docrelurl>trailingslashit</docrelurl> 2320 </item> 2321 <item name= "untrailingslashit"> 2322 <description>Removes trailing slash if it exists. The primary use of this is for paths and thus should be used for paths. It is not restricted to paths and offers no specific path support. </description> 2323 <signature>untrailingslashit( $string ); </signature> 2324 <docrelurl>untrailingslashit</docrelurl> 2325 </item> 2326 <item name= "url_shorten"> 2327 <description>Shortens URLs. Removes http://, www., and truncates the remaining URL to 35 characters, including '...' if the URL is longer than that. WordPress uses it to display URLs on the link management screen. </description> 2328 <signature></signature> 2329 <docrelurl>url_shorten</docrelurl> 2330 </item> 2331 <item name= "utf8_uri_encode"> 2332 <description>Encode the Unicode values to be used in the URI. </description> 2333 <signature>utf8_uri_encode( $utf8_string, $length ) </signature> 2334 <docrelurl>utf8_uri_encode</docrelurl> 2335 </item> 2336 <item name= "wpautop"> 2337 <description> 2338 Changes double line-breaks in the text into HTML paragraphs (<p>...</p>). WordPress uses it to filter the content and the excerpt. 2339 </description> 2340 <signature> wpautop($some_long_text);</signature> 2341 <docrelurl>wpautop</docrelurl> 2342 </item> 2343 <item name= "wptexturize"> 2344 <description> 2345 This returns given text with transformations of quotes to smart quotes, apostrophes, dashes, ellipses, the trademark symbol, and the multiplication symbol.</description> 2346 <signature></signature> 2347 <docrelurl>wptexturize</docrelurl> 2348 </item> 2349 <item name= "wp_filter_kses"> 2350 <description>Sanitize content with allowed HTML Kses rules. wp_filter_kses should generally be preferred over wp_kses_data because wp_magic_quotes escapes $_GET, $_POST, $_COOKIE, $_SERVER, and $_REQUEST fairly early in the hook system, shortly after 'plugins_loaded' but earlier then 'init' or 'wp_loaded'. </description> 2351 <signature>wp_filter_kses( $data ) </signature> 2352 <docrelurl>wp_filter_kses</docrelurl> 2353 </item> 2354 <item name= "wp_filter_post_kses"> 2355 <description>Sanitize content for allowed HTML tags for post content. Post content refers to the page contents of the 'post' type and not $_POST data from forms. </description> 2356 <signature>wp_filter_post_kses( $data ) </signature> 2357 <docrelurl>wp_filter_post_kses</docrelurl> 2358 </item> 2359 <item name= "wp_filter_nohtml_kses"> 2360 <description>Strips all of the HTML in the content. </description> 2361 <signature>wp_filter_nohtml_kses( $data ) </signature> 2362 <docrelurl>wp_filter_nohtml_kses</docrelurl> 2363 </item> 2364 <item name= "wp_iso_descrambler"> 2365 <description>Converts an email subject to ASCII. </description> 2366 <signature>wp_iso_descrambler( $string ) </signature> 2367 <docrelurl>wp_iso_descrambler</docrelurl> 2368 </item> 2369 <item name= "wp_kses"> 2370 <description>This function makes sure that only the allowed HTML element names, attribute names and attribute values plus only sane HTML entities will occur in $string. You have to remove any slashes from PHP's magic quotes before you call this function. </description> 2371 <signature></signature> 2372 <docrelurl>wp_kses</docrelurl> 2373 </item> 2374 <item name= "wp_kses_array_lc"> 2375 <description>Goes through an array and changes the keys to all lower case. </description> 2376 <signature>wp_kses_array_lc( $inarray ) </signature> 2377 <docrelurl>wp_kses_array_lc</docrelurl> 2378 </item> 2379 <item name= "wp_kses_attr"> 2380 <description> 2381 Removes all attributes, if none are allowed for this element. If some are allowed it calls wp_kses_hair() to split them further, and then it builds up new HTML code from the data that wp_kses_hair() returns. It also removes '<' and '>' characters, if there are any left. One more thing it does is to check if the tag has a closing XHTML slash, and if it does, it puts one in the returned code as well. 2382 </description> 2383 <signature>wp_kses_attr( $element, $attr, $allowed_html, $allowed_protocols ) </signature> 2384 <docrelurl>wp_kses_attr</docrelurl> 2385 </item> 2386 <item name= "wp_kses_bad_protocol"> 2387 <description>Sanitize string from bad protocols. This function removes all non-allowed protocols from the beginning of $string. It ignores whitespace and the case of the letters, and it does understand HTML entities. It does its work in a while loop, so it won't be fooled by a string like 'javascript:javascript:alert(57)'. </description> 2388 <signature>wp_kses_bad_protocol( $string, $allowed_protocols ); </signature> 2389 <docrelurl>wp_kses_bad_protocol</docrelurl> 2390 </item> 2391 <item name= "wp_kses_bad_protocol_once"> 2392 <description>Sanitizes content from bad protocols and other characters. This function searches for URL protocols at the beginning of $string, while handling whitespace and HTML entities. </description> 2393 <signature>wp_kses_bad_protocol_once( $string, $allowed_protocols ) </signature> 2394 <docrelurl>wp_kses_bad_protocol_once</docrelurl> 2395 </item> 2396 <item name= "wp_kses_bad_protocol_once2"> 2397 <description>Callback for wp_kses_bad_protocol_once() regular expression. This function processes URL protocols, checks to see if they're in the white-list or not, and returns different data depending on the answer. </description> 2398 <signature>wp_kses_bad_protocol_once2( $matches ) </signature> 2399 <docrelurl>wp_kses_bad_protocol_once2</docrelurl> 2400 </item> 2401 <item name= "wp_kses_check_attr_val"> 2402 <description>Performs different checks for attribute values. The currently implemented checks are 'maxlen', 'minlen', 'maxval', 'minval' and 'valueless' with even more checks to come soon. </description> 2403 <signature>wp_kses_check_attr_val( $value, $vless, $checkname, $checkvalue ) </signature> 2404 <docrelurl>wp_kses_check_attr_val</docrelurl> 2405 </item> 2406 <item name= "wp_kses_decode_entities"> 2407 <description>Convert all entities to their character counterparts. This function decodes numeric HTML entities (like A and A). It doesn't do anything with other entities like ä, but we don't need them in the URL protocol whitelisting system anyway. </description> 2408 <signature>wp_kses_decode_entities( $string ) </signature> 2409 <docrelurl>wp_kses_decode_entities</docrelurl> 2410 </item> 2411 <item name= "wp_kses_hair"> 2412 <description>Builds an attribute list from string containing attributes. This function does a lot of work. It parses an attribute list into an array with attribute data, and tries to do the right thing even if it gets weird input. It will add quotes around attribute values that don't have any quotes or apostrophes around them, to make it easier to produce HTML code that will conform to W3C's HTML specification. It will also remove bad URL protocols from attribute values. It also reduces duplicate attributes by using the attribute defined first (foo='bar' foo='baz' will result in foo='bar'). </description> 2413 <signature>wp_kses_hair( $attr, $allowed_protocols ) </signature> 2414 <docrelurl>wp_kses_hair</docrelurl> 2415 </item> 2416 <item name= "wp_kses_hook"> 2417 <description>You add any kses hooks here. There is currently only one kses WordPress hook and it is called here. All parameters are passed to the hooks and expected to recieve a string. </description> 2418 <signature>wp_kses_hook( $string, $allowed_html, $allowed_protocols ) </signature> 2419 <docrelurl>wp_kses_hook</docrelurl> 2420 </item> 2421 <item name= "wp_kses_html_error"> 2422 <description>Handles parsing errors in wp_kses_hair(). The general plan is to remove everything to and including some whitespace, but it deals with quotes and apostrophes as well. </description> 2423 <signature>wp_kses_html_error( $string ) </signature> 2424 <docrelurl>wp_kses_html_error</docrelurl> 2425 </item> 2426 <item name= "wp_kses_js_entities"> 2427 <description>Removes the HTML JavaScript entities found in early versions of Netscape 4. </description> 2428 <signature>wp_kses_js_entities( $string ) </signature> 2429 <docrelurl>wp_kses_js_entities</docrelurl> 2430 </item> 2431 <item name= "wp_kses_no_null"> 2432 <description>Removes any NULL characters in $string. </description> 2433 <signature>wp_kses_no_null( $string ) </signature> 2434 <docrelurl>wp_kses_no_null</docrelurl> 2435 </item> 2436 <item name= "wp_kses_normalize_entities"> 2437 <description>Converts and fixes HTML entities. This function normalizes HTML entities. It will convert 'AT&T' to the correct 'AT&T', ':' to ':', '&#XYZZY;' to '&#XYZZY;' and so on. </description> 2438 <signature>wp_kses_normalize_entities( $string ) </signature> 2439 <docrelurl>wp_kses_normalize_entities</docrelurl> 2440 </item> 2441 <item name= "wp_kses_normalize_entities2"> 2442 <description>Callback for wp_kses_normalize_entities() regular expression. This function helps wp_kses_normalize_entities() to only accept 16 bit values and nothing more for &#number; entities. </description> 2443 <signature>wp_kses_normalize_entities2( $matches ) </signature> 2444 <docrelurl>wp_kses_normalize_entities2</docrelurl> 2445 </item> 2446 <item name= "wp_kses_split"> 2447 <description>Searches for HTML tags, no matter how malformed. It also matches stray ">" characters. </description> 2448 <signature>wp_kses_split( $string, $allowed_html, $allowed_protocols ) </signature> 2449 <docrelurl>wp_kses_split</docrelurl> 2450 </item> 2451 <item name= "wp_kses_split2"> 2452 <description> 2453 Callback for wp_kses_split() for fixing malformed HTML tags. This function does a lot of work. It rejects some very malformed elements. It returns an empty string, if the element isn't allowed (look ma, no strip_tags()!). Otherwise it splits the tag into an element and an attribute list. After the tag is split into an element and an attribute list, it is run through another filter which will remove illegal attributes and once that is completed, will be returned. 2454 </description> 2455 <signature>wp_kses_split2( $string, $allowed_html, $allowed_protocols ) </signature> 2456 <docrelurl>wp_kses_split2</docrelurl> 2457 </item> 2458 <item name= "wp_kses_stripslashes"> 2459 <description>Strips slashes from in front of quotes. This function changes the character sequence \" to just ". It leaves all other slashes alone. It's really weird, but the quoting from preg_replace(//e) seems to require this. </description> 2460 <signature>wp_kses_stripslashes( $string ) </signature> 2461 <docrelurl>wp_kses_strip_slashes</docrelurl> 2462 </item> 2463 <item name= "wp_kses_version"> 2464 <description>This function returns the kses version number. </description> 2465 <signature>wp_kses_version() </signature> 2466 <docrelurl>wp_kses_version</docrelurl> 2467 </item> 2468 <item name= "wp_make_link_relative"> 2469 <description>Convert full URL paths to absolute paths. Removes the http or https protocols and the domain. Keeps the path '/' at the beginning, so it isn't a true relative link, but from the web root base. </description> 2470 <signature>wp_make_link_relative( $link ) </signature> 2471 <docrelurl>wp_make_link_relative</docrelurl> 2472 </item> 2473 <item name= "wp_rel_nofollow"> 2474 <description>Adds rel="nofollow" string to all HTML entities A elements in content. </description> 2475 <signature>wp_rel_nofollow( $text ) </signature> 2476 <docrelurl>wp_rel_nofollow</docrelurl> 2477 </item> 2478 <item name= "wp_richedit_pre"> 2479 <description>Formats text for the rich text editor. The filter 'richedit_pre' is applied here. If $text is empty the filter will be applied to an empty string. </description> 2480 <signature>wp_richedit_pre( $text ) </signature> 2481 <docrelurl>wp_richedit_pre</docrelurl> 2482 </item> 2483 <item name= "wp_specialchars"> 2484 <description> 2485 This function is deprecated as of WordPress 2.8.0. Please use esc_html instead. Converts a number of special characters into their HTML entities. Differs from htmlspecialchars as existing HTML entities will not be encoded. Specifically changes: & to &, < to < and > to >. $quotes can be set to 'single' to encode ' to ', 'double' to encode " to ", or '1' to do both. Default is 0 where no quotes are encoded. 2486 </description> 2487 <signature>wp_specialchars( $text, $quotes ) </signature> 2488 <docrelurl>wp_specialchars</docrelurl> 2489 </item> 2490 <item name= "wp_trim_words"> 2491 <description>This function trims text to a certain number of words and returns the trimmed text. </description> 2492 <signature>wp_trim_words( $text, $num_words = 55, $more = null ); </signature> 2493 <docrelurl>wp_trim_words</docrelurl> 2494 </item> 2495 <item name= "zeroise"> 2496 <description>Add leading zeros when necessary. If you set the threshold to '4' and the number is '10', then you will get back '0010'. If you set the threshold to '4' and the number is '5000', then you will get back '5000'. Uses sprintf to append the amount of zeros based on the $threshold parameter and the size of the number. If the number is large enough, then no zeros will be appended. </description> 2497 <signature>zeroise( $number, $threshold ); </signature> 2498 <docrelurl>zeroise</docrelurl> 2499 </item> 2500 <item name= "current_time"> 2501 <description>Returns the blog's current local time in one of two formats, either MySQL's timestamp data type format (i.e. YYYY-MM-DD HH:MM:SS) or the Unix timestamp format (i.e. epoch). The optional secondary parameter can be used to retrieve GMT time instead of the blog's local time. The local time returned is based on the timezone set on the blog's General Settings page, which is UTC by default. Contrary to the struck-out statements below, current_time() does indeed return the proper times regardless of the PHP server's date.timezone setting. This is accomplished by overriding the server's default setting by calling date_default_timezone_set('UTC') from wp-settings.php during the init phase, allowing WordPress to always return the actual UTC time and local time for the timezone declared by the blog's administrator regardless of the server's settings. In other words, current_time('timestamp') should be used in lieu of time() to return the blog's local time rather than the server's local time. WARNING: current_time('timestamp',1) returns (as a timestamp) the server time, not (as expected) GMT! Because this is exactly what PHP's time() returns, current_time('timestamp',1) is superfluous and unnecessary -- use time(). WARNING: current_time('timestamp',0) returns the timestamp GMT + gmt_offset(server) + gmt_offset(browser) -- a meaningless construct. It is difficult to imagine any use for the 'timestamp' parameter value. See bottom example on this page for a workaround to get the properly timed timestamp. </description> 2502 <signature> 2503 $blogtime = current_time('mysql'); 2504 list( $today_year, $today_month, $today_day, $hour, $minute, $second ) = split( '([^0-9])', $blogtime ); 2505 </signature> 2506 <docrelurl>current_time</docrelurl> 2507 </item> 2508 <item name= "date_i18n"> 2509 <description>Retrieve the date in localized format, based on timestamp. If the locale specifies the locale month and weekday, then the locale will take over the format for the date. If it isn't, then the date format string will be used instead. i18n is an abbreviation for Internationalization. (There are 18 letters between the first "i" and last "n".) </description> 2510 <signature>echo date_i18n( $dateformatstring, $unixtimestamp, $gmt ) </signature> 2511 <docrelurl>date_i18n</docrelurl> 2512 </item> 2513 <item name= "get_calendar"> 2514 <description>Displays the calendar (defaults to current month/year). Days with posts are styled as such. This tag can be used anywhere within a template. </description> 2515 <signature>get_calendar(); </signature> 2516 <docrelurl>get_calendar</docrelurl> 2517 </item> 2518 <item name= "get_date_from_gmt"> 2519 <description>Converts a GMT date into the correct format for the blog. Requires and returns in the Y-m-d H:i:s format. Simply adds the value of the 'gmt_offset' option. </description> 2520 <signature>get_date_from_gmt( $string, $format ) </signature> 2521 <docrelurl>get_date_from_gmt</docrelurl> 2522 </item> 2523 <item name= "get_lastpostdate"> 2524 <description>Retrieve the date the the last post was published. The server timezone is the default and is the difference between GMT and server time. The 'blog' value is the date when the last post was posted. The 'gmt' is when the last post was posted in GMT formatted date. </description> 2525 <signature>get_lastpostdate( $timezone ) </signature> 2526 <docrelurl>get_lastpostdate</docrelurl> 2527 </item> 2528 <item name= "get_lastpostmodified"> 2529 <description>Retrieve last post modified date depending on timezone. The server timezone is the default and is the difference between GMT and server time. The 'blog' value is just when the last post was modified. The 'gmt' is when the last post was modified in GMT time. </description> 2530 <signature>get_lastpostmodified( $timezone ); </signature> 2531 <docrelurl>get_lastpostmodified</docrelurl> 2532 </item> 2533 <item name= "get_day_link"> 2534 <description>Returns the daily archive URL to a specific year, month and day for use in PHP. It does NOT display the URL. If year, month and day parameters are set to '', the tag returns the URL for the current day's archive. </description> 2535 <signature></signature> 2536 <docrelurl>get_day_link</docrelurl> 2537 </item> 2538 <item name= "get_gmt_from_date"> 2539 <description>Returns a date in the GMT equivalent. Requires and returns a date in the Y-m-d H:i:s format. Simply subtracts the value of the 'gmt_offset' option. </description> 2540 <signature>get_gmt_from_date( $string ) </signature> 2541 <docrelurl>get_gmt_from_date</docrelurl> 2542 </item> 2543 <item name= "get_month_link"> 2544 <description>Returns the monthly archive URL to a specific year and month for use in PHP. It does NOT display the URL. If year and month parameters are set to '', the tag returns the URL for the current month's archive. </description> 2545 <signature>$oct_04 = get_month_link('2004', '10'); </signature> 2546 <docrelurl>get_month_link</docrelurl> 2547 </item> 2548 <item name= "the_time"> 2549 <description>Returns the time of the current post for use in PHP. It does not display the time. To display the time of a post, use the_time(). This tag must be used within The Loop. </description> 2550 <signature>echo get_the_time(); </signature> 2551 <docrelurl>get_the_time</docrelurl> 2552 </item> 2553 <item name= "get_the_time"> 2554 <description>Returns the time of the current post for use in PHP. It does not display the time. To display the time of a post, use the_time(). This tag must be used within The Loop. </description> 2555 <signature>echo get_the_time(); </signature> 2556 <docrelurl>get_the_time</docrelurl> 2557 </item> 2558 <item name= "the_modified_time"> 2559 <description>This tag displays the time (and date) a post was last modified and is similar to the functionality of the_time(), which displays the time (and date) a post was created. This tag must be used within The Loop. If no format parameter is specified, the Default date format (please note that says Date format) setting from Administration > Settings > General is used for the display format. If the post or page is not yet modified, the modified time is the same as the creation time. If you want to display both the modified time and the creation time, you may want to use an if statement (e.g. if (get_the_modified_time() != get_the_time())) to avoid showing the same time/date twice. Use get_the_modified_time() to retrieve the value. </description> 2560 <signature></signature> 2561 <docrelurl>the_modified_time</docrelurl> 2562 </item> 2563 <item name= "get_the_modified_time"> 2564 <description>Retrieve the time at which the post was last modified. </description> 2565 <signature>get_the_modified_time( $d ); </signature> 2566 <docrelurl>get_the_modified_time</docrelurl> 2567 </item> 2568 <item name= "get_weekstartend"> 2569 <description>Get the week start and end from the MySQL DATETIME or date string. </description> 2570 <signature>get_weekstartend( $mysqlstring, $start_of_week ) </signature> 2571 <docrelurl>get_weekstartend</docrelurl> 2572 </item> 2573 <item name= "get_year_link"> 2574 <description>Returns the yearly archive URL to a specific year for use in PHP. It does NOT display the URL. If year is set to '', the tag returns the URL for the current year's archive. </description> 2575 <signature>$year03 = get_year_link(2003); </signature> 2576 <docrelurl>get_year_link</docrelurl> 2577 </item> 2578 <item name= "human_time_diff"> 2579 <description>Determines the difference between two timestamps. The difference is returned in a human readable format such as "1 hour", "5 mins", "2 days". </description> 2580 <signature>human_time_diff( $from, $to ); </signature> 2581 <docrelurl>human_time_diff</docrelurl> 2582 </item> 2583 <item name= "is_new_day"> 2584 <description>This Conditional Tag checks if today is a new day. This is a boolean function, meaning it returns TRUE when new day or FALSE if not a new day. </description> 2585 <signature>is_new_day(); </signature> 2586 <docrelurl>is_new_day</docrelurl> 2587 </item> 2588 <item name= "iso8601_timezone_to_offset"> 2589 <description>Computes an offset in seconds from an ISO 8601 timezone. </description> 2590 <signature>iso8601_timezone_to_offset( $timezone ) </signature> 2591 <docrelurl>iso8601_timezone_to_offset</docrelurl> 2592 </item> 2593 <item name= "iso8601_to_datetime"> 2594 <description>Converts an iso8601 date to MySQL DATETIME format used by post_date[_gmt]. </description> 2595 <signature>iso8601_to_datetime( $date_string, $timezone ) </signature> 2596 <docrelurl>iso8601_to_datetime</docrelurl> 2597 </item> 2598 <item name= "mysql2date"> 2599 <description>Translates dates from mysql format to any format acceptable by the php date() function </description> 2600 <signature></signature> 2601 <docrelurl>mysql2date</docrelurl> 2602 </item> 2603 <item name= "is_serialized"> 2604 <description>Check value to find if it was serialized. If $data is not a string, then returned value will always be false. Serialized data is always a string. </description> 2605 <signature>is_serialized( $data ) </signature> 2606 <docrelurl>is_serialized</docrelurl> 2607 </item> 2608 <item name= "is_serialized_string"> 2609 <description>Check whether serialized data is of string type. </description> 2610 <signature>is_serialized_string( $data ) </signature> 2611 <docrelurl>is_serialized_string</docrelurl> 2612 </item> 2613 <item name= "maybe_serialize"> 2614 <description>Serialize data, if needed. </description> 2615 <signature>maybe_serialize( $data ); </signature> 2616 <docrelurl>maybe_serialize</docrelurl> 2617 </item> 2618 <item name= "maybe_unserialize"> 2619 <description>Unserialize value only if it was serialized. </description> 2620 <signature>maybe_unserialize( $original ) </signature> 2621 <docrelurl>maybe_unserialize</docrelurl> 2622 </item> 2623 <item name= "add_option"> 2624 <description>A safe way of adding a named option/value pair to the options database table. It does nothing if the option already exists. After the option is saved, it can be accessed with get_option(), changed with update_option(), and deleted with delete_option(). You do not need to serialize values. If the value needs to be serialized, then it will be serialized before it is inserted into the database. You can create options without values and then add values later. Calling add_option first checks whether the option has already been added, and returns false if an option with the same name exists. Next, it checks to make the option name is not one of the protected names alloptions or notoptions, and dies with an error message if attempting to overwrite a protected option. If the option name is not protected, and does not already exist, the option will be created. </description> 2625 <signature>add_option( $option, $value, $deprecated, $autoload ); </signature> 2626 <docrelurl>add_option</docrelurl> 2627 </item> 2628 <item name= "delete_option"> 2629 <description>A safe way of removing a named option/value pair from the options database table. </description> 2630 <signature>delete_option( $option ); </signature> 2631 <docrelurl>delete_option</docrelurl> 2632 </item> 2633 <item name= "form_option"> 2634 <description>Echo option value after sanitizing for forms. </description> 2635 <signature>form_option( $option ) </signature> 2636 <docrelurl>form_option</docrelurl> 2637 </item> 2638 <item name= "get_alloptions"> 2639 <description>Retrieve all autoload options or all options, if no autoloaded ones exist. This is different from wp_load_alloptions() in that this function does not cache its results and will retrieve all options from the database every time it is called. </description> 2640 <signature>get_alloptions() </signature> 2641 <docrelurl>get_alloptions</docrelurl> 2642 </item> 2643 <item name= "get_site_option"> 2644 <description>Retrieve option value based on name of option. In multisite, return network option, blog option otherwise. </description> 2645 <signature>get_site_option( $option, $default , $use_cache ) </signature> 2646 <docrelurl>get_site_option</docrelurl> 2647 </item> 2648 <item name= "get_site_url"> 2649 <description>The get_site_url() template tag retrieves the site url for a given site. Returns the 'siteurl' option with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is overridden. </description> 2650 <signature>get_site_url( $blog_id, $path, $scheme ); </signature> 2651 <docrelurl>get_site_url</docrelurl> 2652 </item> 2653 <item name= "get_user_option"> 2654 <description>Retrieve user option that can be either global, user, or blog. If the user ID is not given, then the current user will be used instead. If the user ID is given, then the user data will be retrieved. The filter for the result will also pass the original option name and finally the user data object as the third parameter. The option will first check for the non-global name, then the global name, and if it still doesn't find it, it will try the blog option. The option can either be modified or set by a plugin. </description> 2655 <signature>get_user_option( $option, $user ) </signature> 2656 <docrelurl>get_user_option</docrelurl> 2657 </item> 2658 <item name= "get_option"> 2659 <description>A safe way of getting values for a named option from the options database table. If the desired option does not exist, or no value is associated with it, FALSE will be returned. </description> 2660 <signature></signature> 2661 <docrelurl>get_option</docrelurl> 2662 </item> 2663 <item name= "update_option"> 2664 <description>Use the function update_option() to update a named option/value pair to the options database table. The option_name value is escaped with $wpdb->escape before the INSERT statement. This function may be used in place of add_option, although it is not as flexible. update_option will check to see if the option already exists. If it does not, it will be added with add_option('option_name', 'option_value'). Unless you need to specify the optional arguments of add_option(), update_option() is a useful catch-all for both adding and updating options. Note: This function cannot be used to change whether an option is to be loaded (or not loaded) by wp_load_alloptions. In that case, a delete_option() should be followed by use of the add_option() function. </description> 2665 <signature>update_option( $option, $newvalue ); </signature> 2666 <docrelurl>update_option</docrelurl> 2667 </item> 2668 <item name= "update_user_option"> 2669 <description>Update user option with global blog capability. User options are just like user metadata except that they have support for global blog options. If the 'global' parameter is false, which it is by default, it will prepend the WordPress table prefix to the option name. </description> 2670 <signature>update_user_option( $user_id, $option_name, $newvalue, $global ) </signature> 2671 <docrelurl>update_user_option</docrelurl> 2672 </item> 2673 <item name= "add_menu_page"> 2674 <description>Add a top level menu page. Specifically, creates a new top level menu section in the admin menu sidebar and registers a hook to callback your function for outputting the page content when the linked menu page is requested. Returns the $hookname. </description> 2675 <signature>add_menu_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url, $position ); </signature> 2676 <docrelurl>add_menu_page</docrelurl> 2677 </item> 2678 <item name= "remove_menu_page"> 2679 <description>Remove a top level admin menu. Please be aware that this would not prevent a user from accessing these screens directly. Removing a menu does not replace the need to filter a user's permissions as appropriate. </description> 2680 <signature>remove_menu_page( $menu_slug ) </signature> 2681 <docrelurl>remove_menu_page</docrelurl> 2682 </item> 2683 <item name= "add_submenu_page"> 2684 <description>Add a sub menu page. This function takes a capability which will be used to determine whether or not a page is included in the menu. The function which is hooked in to handle the output of the page must check that the user has the required capability as well. This function should normally be hooked in with one of the the admin_menu actions depending on the menu where the sub menu is to appear: </description> 2685 <signature>add_submenu_page( $parent_slug, $page_title, $menu_title, $capability, $menu_slug, $function ); </signature> 2686 <docrelurl>add_submenu_page</docrelurl> 2687 </item> 2688 <item name= "remove_submenu_page"> 2689 <description>Remove an admin submenu. Please be aware that this would not prevent a user from accessing these screens directly. Removing a menu does not replace the need to filter a user's permissions as appropriate. </description> 2690 <signature>remove_submenu_page( $menu_slug, $submenu_slug ) </signature> 2691 <docrelurl>remove_submenu_page</docrelurl> 2692 </item> 2693 <item name= "add_utility_page"> 2694 <description>Add a top level menu page at the 'utility' level. This new menu will appear in the group including the default WordPress Appearance, Plugins, Users, Tools and Settings. Specifically, creates a new top level menu section in the admin menu sidebar and registers a hook to callback your function for outputting the page content when the linked menu page is requested. Returns the $hookname. </description> 2695 <signature> 2696 add_utility_page( $page_title, $menu_title, $capability, $menu_slug, $function, $icon_url ); 2697 </signature> 2698 <docrelurl>add_utility_page</docrelurl> 2699 </item> 2700 <item name= "add_node"> 2701 <description>This function is a method of the $wp_admin_bar global object (see: WP_Admin_Bar), and can be used to add a new item to the Toolbar. You can also use it to change the properties of an item that is already in the Toolbar. The Toolbar replaces the Admin Bar since WordPress Version 3.3. Toolbar items are also called "nodes". Nodes can be parents for other nodes, which creates dropdown menus. Group nodes together with add_group() to create distinct sections in a Toolbar menu. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2702 <signature>$wp_admin_bar->add_node( $args ); </signature> 2703 <docrelurl>add_node</docrelurl> 2704 </item> 2705 <item name= "remove_node"> 2706 <description>This function removes an item from the Toolbar. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2707 <signature>$wp_admin_bar->remove_node( $id ); </signature> 2708 <docrelurl>remove_node</docrelurl> 2709 </item> 2710 <item name= "add_group"> 2711 <description>This function adds a new group to the Toolbar. Groups allow you to group Toolbar items together into distinct sections of a toolbar menu. The Toolbar replaces the Admin Bar since WordPress Version 3.3. Toolbar items are also called "nodes". Nodes can be parents for other nodes, which creates dropdown menus. When adding a group you're actually adding a group node. Group nodes are not visible in the Toolbar, but nodes added to it are. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2712 <signature>$wp_admin_bar->add_group( $args ); </signature> 2713 <docrelurl>add_group</docrelurl> 2714 </item> 2715 <item name= "get_node"> 2716 <description>This function returns a Toolbar object with all the properties of a single Toolbar item. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2717 <signature>$wp_admin_bar->get_node( $id ); </signature> 2718 <docrelurl>get_node</docrelurl> 2719 </item> 2720 <item name= "get_nodes"> 2721 <description>This function returns an array of all the Toolbar items on the current page. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2722 <signature>$wp_admin_bar->get_nodes(); </signature> 2723 <docrelurl>get_nodes</docrelurl> 2724 </item> 2725 <item name= "get_nodes"> 2726 <description>This function returns an array of all the Toolbar items on the current page. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2727 <signature>$wp_admin_bar->get_nodes(); </signature> 2728 <docrelurl>get_nodes</docrelurl> 2729 </item> 2730 <item name= "get_nodes"> 2731 <description>This function returns an array of all the Toolbar items on the current page. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2732 <signature>$wp_admin_bar->get_nodes(); </signature> 2733 <docrelurl>get_nodes</docrelurl> 2734 </item> 2735 <item name= "get_nodes"> 2736 <description>This function returns an array of all the Toolbar items on the current page. Toolbar items are also called "nodes". The Toolbar replaces the Admin Bar since WordPress Version 3.3. note: This function is a method of the WP_Admin_Bar class and $wp_admin_bar global object, which may not exist except during the 'admin_bar_menu' or 'wp_before_admin_bar_render' hooks. </description> 2737 <signature>$wp_admin_bar->get_nodes(); </signature> 2738 <docrelurl>get_nodes</docrelurl> 2739 </item> 2740 <item name= "checked"> 2741 <description>Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the checked attribute to the current radio button or checkbox. This is essentially the same as comparing values with if(), but results in more concise code. </description> 2742 <signature></signature> 2743 <docrelurl>checked</docrelurl> 2744 </item> 2745 <item name= "disabled"> 2746 <description>Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the disabled attribute to a form input field. </description> 2747 <signature></signature> 2748 <docrelurl>disabled</docrelurl> 2749 </item> 2750 <item name= "selected"> 2751 <description>For use in dropdown form fields. Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the selected attribute to the current option tag. </description> 2752 <signature></signature> 2753 <docrelurl>selected</docrelurl> 2754 </item> 2755 <item name= "selected"> 2756 <description>For use in dropdown form fields. Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the selected attribute to the current option tag. </description> 2757 <signature></signature> 2758 <docrelurl>selected</docrelurl> 2759 </item> 2760 <item name= "selected"> 2761 <description>For use in dropdown form fields. Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the selected attribute to the current option tag. </description> 2762 <signature></signature> 2763 <docrelurl>selected</docrelurl> 2764 </item> 2765 <item name= "selected"> 2766 <description>For use in dropdown form fields. Compares two given values (for example, a saved option vs. one chosen in a form) and, if the values are the same, adds the selected attribute to the current option tag. </description> 2767 <signature></signature> 2768 <docrelurl>selected</docrelurl> 2769 </item> 2770 <item name= "check_admin_referer"> 2771 <description>Tests if the current request was referred from an admin page, or (given $action parameter) if the current request carries a valid nonce. Used to avoid security exploits. </description> 2772 <signature>check_admin_referer( $action, $query_arg ); </signature> 2773 <docrelurl>check_admin_referer</docrelurl> 2774 </item> 2775 <item name= "check_ajax_referer"> 2776 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Verifies the AJAX request to prevent processing requests external of the blog. </description> 2777 <signature>check_ajax_referer( $action, $query_arg, $die ) </signature> 2778 <docrelurl>check_ajax_referer</docrelurl> 2779 </item> 2780 <item name= "wp_create_nonce"> 2781 <description>Creates a random, one time use token. </description> 2782 <signature>wp_create_nonce( $action ); </signature> 2783 <docrelurl>wp_create_nonce</docrelurl> 2784 </item> 2785 <item name= "wp_explain_nonce"> 2786 <description>Retrieve nonce action 'Are you sure' message. The action is split by verb and noun. The action format is as follows: verb-action_extra. The verb is before the first dash and has the format of letters and no spaces and numbers. The noun is after the dash and before the underscore, if an underscore exists. The noun is also only letters. The filter will be called for any action, which is not defined by WordPress. You may use the filter for your plugin to explain nonce actions to the user, when they get the "Are you sure?" message. The filter is in the format of 'explain_nonce_$verb-$noun' with the $verb replaced by the found verb and the $noun replaced by the found noun. The two parameters that are given to the hook are the localized 'Are you sure you want to do this?' message with the extra text (the text after the underscore). </description> 2787 <signature>wp_explain_nonce( $action ) </signature> 2788 <docrelurl>wp_explain_nonce</docrelurl> 2789 </item> 2790 <item name= "wp_get_original_referer"> 2791 <description>Retrieve original referer that was posted, if it exists. </description> 2792 <signature>wp_get_original_referer() </signature> 2793 <docrelurl>wp_get_original_referer</docrelurl> 2794 </item> 2795 <item name= "wp_get_referer"> 2796 <description>Retrieve referer from '_wp_http_referer', HTTP referer, or current page respectively. </description> 2797 <signature>wp_get_referer() </signature> 2798 <docrelurl>wp_get_referer</docrelurl> 2799 </item> 2800 <item name= "wp_nonce_ays"> 2801 <description>Display 'Are You Sure?' message to confirm the action being taken. If the action has the nonce explain message, then it will be displayed along with the 'Are you sure?' message. </description> 2802 <signature>wp_nonce_ays( $action ) </signature> 2803 <docrelurl>wp_nonce_ays</docrelurl> 2804 </item> 2805 <item name= "wp_nonce_field"> 2806 <description>Retrieve or display nonce hidden field for forms. The nonce field is used to validate that the contents of the form came from the location on the current site and not somewhere else. The nonce does not offer absolute protection, but should protect against most cases. It is very important to use nonce fields in forms. If you set $echo to false and set $referer to true, then you will need to retrieve the referer field using wp_referer_field(). If you have the $referer set to true and are echoing the nonce field, it will also echo the referer field. The $action and $name are optional, but if you want to have better security, it is strongly suggested to set those two parameters. It is easier to just call the function without any parameters, because validation of the nonce doesn't require any parameters, but since crackers know what the default is it won't be difficult for them to find a way around your nonce and cause damage. The input name will be whatever $name value you gave. The input value will be the nonce creation value. </description> 2807 <signature>wp_nonce_field( $action, $name, $referer, $echo ) </signature> 2808 <docrelurl>wp_nonce_field</docrelurl> 2809 </item> 2810 <item name= "wp_nonce_url"> 2811 <description>Retrieve URL with nonce added to URL query. </description> 2812 <signature>wp_nonce_url( $actionurl, $action ); </signature> 2813 <docrelurl>wp_nonce_url</docrelurl> 2814 </item> 2815 <item name= "wp_original_referer_field"> 2816 <description>Retrieve or display original referer hidden field for forms. The input name is '_wp_original_http_referer' and will be either the same value of wp_referer_field(), if that was posted already or it will be the current page, if it doesn't exist. </description> 2817 <signature>wp_original_referer_field( $echo, $jump_back_to ); </signature> 2818 <docrelurl>wp_original_referer_field</docrelurl> 2819 </item> 2820 <item name= "wp_referer_field"> 2821 <description>Retrieve or display referer hidden field for forms. The referer link is the current Request URI from the server super global. The input name is '_wp_http_referer', in case you wanted to check manually. </description> 2822 <signature>wp_referer_field( $echo ) </signature> 2823 <docrelurl>wp_referer_field</docrelurl> 2824 </item> 2825 <item name= "wp_verify_nonce"> 2826 <description>Verify that correct nonce was used with time limit. </description> 2827 <signature>wp_verify_nonce( $nonce, $action ); </signature> 2828 <docrelurl>wp_verify_nonce</docrelurl> 2829 </item> 2830 <item name= "xmlrpc_getpostcategory"> 2831 <description>Retrieve the post category or categories from XMLRPC XML. If the category element is not found, then the default post category will be used. The return type then would be what $post_default_category. If the category is found, then it will always be an array. </description> 2832 <signature>xmlrpc_getpostcategory( $content ); </signature> 2833 <docrelurl>xmlrpc_getpostcategory</docrelurl> 2834 </item> 2835 <item name= "xmlrpc_getposttitle"> 2836 <description>Retrieve post title from XMLRPC XML. If the title element is not part of the XML, then the default post title from the $post_default_title will be used instead. </description> 2837 <signature>xmlrpc_getposttitle( $content ) </signature> 2838 <docrelurl>xmlrpc_getposttitle</docrelurl> 2839 </item> 2840 <item name= "xmlrpc_removepostdata"> 2841 <description>XMLRPC XML content without title and category elements. </description> 2842 <signature>xmlrpc_removepostdata( $content ) </signature> 2843 <docrelurl>xmlrpc_removepostdata</docrelurl> 2844 </item> 2845 <item name= "user_pass_ok"> 2846 <description>Check that the user login name and password is correct. </description> 2847 <signature>user_pass_ok( $user_login, $user_pass ) </signature> 2848 <docrelurl>user_pass_ok</docrelurl> 2849 </item> 2850 <item name= "__"> 2851 <description>Retrieves the translated string from the translate(). </description> 2852 <signature>$translated_text = __( $text, $domain ); </signature> 2853 <docrelurl>_2</docrelurl> 2854 </item> 2855 <item name= "_x"> 2856 <description>Retrieve translated string with gettext context Quite a few times, there will be collisions with similar translatable text found in more than two places but with different translated context. By including the context in the pot file translators can translate the two strings differently. </description> 2857 <signature>_x( $text, $context, $domain ) </signature> 2858 <docrelurl>_x</docrelurl> 2859 </item> 2860 <item name= "_n"> 2861 <description>Retrieve the plural or single form based on the amount. If the domain is not set in the $l10n list, then a comparison will be made and either $plural or $single parameters returned. If the domain does exist, then the parameters $single, $plural, and $number will first be passed to the domain's ngettext() method. Then it will be passed to the 'ngettext' filter hook along with the same parameters. The expected type will be a string. </description> 2862 <signature>_n( $single, $plural, $number, $domain ) </signature> 2863 <docrelurl>_n</docrelurl> 2864 </item> 2865 <item name= "_nx"> 2866 <description>A hybrid of _n() and _x(). It supports contexts and plurals. </description> 2867 <signature>_nx( $single, $plural, $number, $context, $domain ) </signature> 2868 <docrelurl>_nx</docrelurl> 2869 </item> 2870 <item name= "_e"> 2871 <description>Displays the returned translated text from translate(). </description> 2872 <signature>_e( $text, $domain ) </signature> 2873 <docrelurl>_e</docrelurl> 2874 </item> 2875 <item name= "_ex"> 2876 <description>Displays translated string with gettext context </description> 2877 <signature>_ex( $text, $context, $domain ) </signature> 2878 <docrelurl>_ex</docrelurl> 2879 </item> 2880 <item name= "_ngettext"> 2881 <description>This function is deprecated as of WordPress 2.8.0. Please use _n() instead. Retrieve the plural or single form based on the amount. If the domain is not set in the $l10n list, then a comparsion will be made and either $plural or $single parameters returned. If the domain does exist, then the parameters $single, $plural, and $number will first be passed to the domain's ngettext method. Then it will be passed to the 'ngettext' filter hook along with the same parameters. The expected type will be a string. </description> 2882 <signature>__ngettext( $single, $plural, $number, $domain ) </signature> 2883 <docrelurl>_2ngettext</docrelurl> 2884 </item> 2885 <item name= "esc_attr__"> 2886 <description>Retrieves the translation of $text and escapes it for safe use in an attribute. If there is no translation, or the domain isn't loaded the original text is returned. </description> 2887 <signature>esc_attr__( $text, $domain ) </signature> 2888 <docrelurl>esc_attr_2</docrelurl> 2889 </item> 2890 <item name= "esc_attr_e"> 2891 <description> 2892 Displays translated text that has been escaped for safe use in an attribute. Encodes < > & " ' (less than, greater than, ampersand, double quote, single quote). Will never double encode entities. If you need the values for use in PHP, use esc_attr(). 2893 </description> 2894 <signature>esc_attr_e( $text, $domain ) </signature> 2895 <docrelurl>esc_attr_e</docrelurl> 2896 </item> 2897 <item name= "get_locale"> 2898 <description>Gets the current locale. If the locale is set, then it will filter the locale in the 'locale' filter hook and return the value. If the locale is not set already, then the WPLANG constant is used if it is defined. Then it is filtered through the 'locale' filter hook and the value for the locale global set and the locale is returned. The process to get the locale should only be done once but the locale will always be filtered using the 'locale' hook. </description> 2899 <signature>get_locale() </signature> 2900 <docrelurl>get_locale</docrelurl> 2901 </item> 2902 <item name= "load_default_textdomain"> 2903 <description>Loads default translated strings based on locale. Loads the .mo file in WP_LANG_DIR constant path from WordPress root. The translated (.mo) file is named based off of the locale. </description> 2904 <signature>load_default_textdomain() </signature> 2905 <docrelurl>load_default_textdomain</docrelurl> 2906 </item> 2907 <item name= "load_plugin_textdomain"> 2908 <description>Loads the plugin's translated strings. If the path is not given then it will be the root of the plugin directory. The .mo file should be named based on the domain followed by a dash, and then the locale exactly. The locale is the language code and/or country code you defined in the constant WPLANG in the file wp-config.php. For example, the locale for German is 'de_DE', and the locale for Danish is 'da_DK'. If your plugin's text domain is "my-plugin" the Danish .mo and.po files should be named "my-plugin-da_DK.mo" and "my-plugin-da_DK.po" Call this function in your plugin as early as the plugins_loaded action. If you call load_plugin_textdomain multiple times for the same domain, the translations will be merged. If both sets have the same string, the translation from the original value will be taken. </description> 2909 <signature>load_plugin_textdomain( $domain, $abs_rel_path, $plugin_rel_path ) </signature> 2910 <docrelurl>load_plugin_textdomain</docrelurl> 2911 </item> 2912 <item name= "load_textdomain"> 2913 <description>Loads MO file into the list of domains. If the domain already exists, the inclusion will fail. If the MO file is not readable, the inclusion will fail. On success, the mofile will be placed in the $l10n global by $domain and will be an gettext_reader object. </description> 2914 <signature>load_textdomain( $domain, $mofile ) </signature> 2915 <docrelurl>load_textdomain</docrelurl> 2916 </item> 2917 <item name= "load_theme_textdomain"> 2918 <description>Loads the theme's translated strings. If the current locale exists as a .mo file in the theme's root directory, it will be included in the translated strings by the $domain. The .mo files must be named based on the locale exactly, sv_SE.mo for example. </description> 2919 <signature>load_theme_textdomain( $domain, $path ) </signature> 2920 <docrelurl>load_theme_textdomain</docrelurl> 2921 </item> 2922 <item name= "spawn_cron"> 2923 <description>Send request to run cron through HTTP request that doesn't halt page loading. Will not run more than once every 60 seconds. </description> 2924 <signature>spawn_cron( $local_time ); </signature> 2925 <docrelurl>spawn_cron</docrelurl> 2926 </item> 2927 <item name= "wp_clear_scheduled_hook"> 2928 <description>Un-schedules all previously-scheduled cron jobs using a particular hook name. </description> 2929 <signature></signature> 2930 <docrelurl>wp_clear_scheduled_hook</docrelurl> 2931 </item> 2932 <item name= "wp_cron"> 2933 <description>Run scheduled callbacks or spawn cron for all scheduled events. </description> 2934 <signature>wp_cron() </signature> 2935 <docrelurl>wp_cron</docrelurl> 2936 </item> 2937 <item name= "wp_get_schedule"> 2938 <description>Retrieve Cron schedule for hook with arguments. </description> 2939 <signature>wp_get_schedule( $hook, $args ); </signature> 2940 <docrelurl>wp_get_schedule</docrelurl> 2941 </item> 2942 <item name= "wp_get_schedules"> 2943 <description>Retrieve supported and filtered Cron recurrences. The supported recurrences are 'hourly', 'twicedaily', and 'daily'. A plugin may add more by hooking into the 'cron_schedules' filter. The filter accepts an array of arrays. The outer array has a key that is the name of the schedule or for example 'weekly'. The value is an array with two keys, one is 'interval' and the other is 'display'. The 'interval' is a number in seconds of when the cron job should run. So for 'hourly', the time is 3600 or 60*60. For weekly, the value would be 60*60*24*7 or 604800. The value of 'interval' would then be 604800. </description> 2944 <signature>wp_get_schedules(); </signature> 2945 <docrelurl>wp_get_schedules</docrelurl> 2946 </item> 2947 <item name= "wp_next_scheduled"> 2948 <description>Returns the next timestamp for a cron event. </description> 2949 <signature>$timestamp = wp_next_scheduled( $hook, $args ); </signature> 2950 <docrelurl>wp_next_scheduled</docrelurl> 2951 </item> 2952 <item name= "wp_reschedule_event"> 2953 <description>This function is used internally by WordPress to reschedule a recurring event. You'll likely never need to use this function manually, it is documented here for completeness. </description> 2954 <signature></signature> 2955 <docrelurl>wp_reschedule_event</docrelurl> 2956 </item> 2957 <item name= "wp_schedule_event"> 2958 <description>Schedules a hook which will be executed by the WordPress actions core on a specific interval, specified by you. The action will trigger when someone visits your WordPress site, if the scheduled time has passed. See the Plugin API for a list of hooks. </description> 2959 <signature></signature> 2960 <docrelurl>wp_schedule_event</docrelurl> 2961 </item> 2962 <item name= "wp_schedule_single_event"> 2963 <description>Schedules a hook which will be executed once by the WordPress actions core at a time which you specify. The action will fire off when someone visits your WordPress site, if the schedule time has passed. </description> 2964 <signature></signature> 2965 <docrelurl>wp_schedule_single_event</docrelurl> 2966 </item> 2967 <item name= "wp_unschedule_event"> 2968 <description>Un-schedules a previously-scheduled cron job. </description> 2969 <signature></signature> 2970 <docrelurl>wp_unschedule_event</docrelurl> 2971 </item> 2972 <item name= "add_query_arg"> 2973 <description>Retrieve a modified URL (with) query string. You can rebuild the URL and append a new query variable to the URL query by using this function. You can also retrieve the full URL with query data. Adding a single key & value or an associative array. Setting a key value to false removes it from the query. Omitting the old query or the uri (second or third parameter) uses the $_SERVER value. </description> 2974 <signature>add_query_arg( $param1, $param2, $old_query_or_uri ); </signature> 2975 <docrelurl>add_query_arg</docrelurl> 2976 </item> 2977 <item name= "admin_url"> 2978 <description>The admin_url template tag retrieves the url to the admin area for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden. In case of WordPress Network setup, use network_admin_url() instead. </description> 2979 <signature>admin_url( $path, $scheme ); </signature> 2980 <docrelurl>admin_url</docrelurl> 2981 </item> 2982 <item name= "bool_from_yn"> 2983 <description>Whether input is yes or no. Must be 'y' to be true. </description> 2984 <signature>bool_from_yn( $yn ) </signature> 2985 <docrelurl>bool_from_yn</docrelurl> 2986 </item> 2987 <item name= "cache_javascript_headers"> 2988 <description>Set the headers for caching for 10 days with JavaScript content type. </description> 2989 <signature>cache_javascript_headers() </signature> 2990 <docrelurl>cache_javascript_headers</docrelurl> 2991 </item> 2992 <item name= "content_url"> 2993 <description>The content_url template tag retrieves the url to the content area for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. </description> 2994 <signature>content_url( $path ); </signature> 2995 <docrelurl>content_url</docrelurl> 2996 </item> 2997 <item name= "get_bloginfo"> 2998 <description>The get_bloginfo() function returns information about your site which can then be used elsewhere in your PHP code. This function, as well as bloginfo(), can also be used to display your site information. </description> 2999 <signature></signature> 3000 <docrelurl>get_bloginfo</docrelurl> 3001 </item> 3002 <item name= "get_num_queries"> 3003 <description>Retrieve the number of database queries during the WordPress execution. </description> 3004 <signature>echo get_num_queries();</signature> 3005 <docrelurl>get_num_queries</docrelurl> 3006 </item> 3007 <item name= "get_query_var"> 3008 <description>Retrieve variable in the WP_Query class of the global $wp_query object. </description> 3009 <signature>get_query_var( $var ) </signature> 3010 <docrelurl>get_query_var</docrelurl> 3011 </item> 3012 <item name= "home_url"> 3013 <description>The home_url template tag retrieves the home url for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden. In case of WordPress Network setup, use network_home_url() instead. </description> 3014 <signature>home_url( $path, $scheme ); </signature> 3015 <docrelurl>home_url</docrelurl> 3016 </item> 3017 <item name= "includes_url"> 3018 <description>The includes_url template tag retrieves the url to the includes area for the current site with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. </description> 3019 <signature>includes_url( $path ); </signature> 3020 <docrelurl>includes_url</docrelurl> 3021 </item> 3022 <item name= "is_blog_installed"> 3023 <description>Test whether blog is already installed. The cache will be checked first. If you have a cache plugin, which saves the cache values, then this will work. If you use the default WordPress cache, and the database goes away, then you might have problems. Checks for the option siteurl for whether WordPress is installed. </description> 3024 <signature>is_blog_installed() </signature> 3025 <docrelurl>is_blog_installed</docrelurl> 3026 </item> 3027 <item name= "is_main_site"> 3028 <description>Test if site is main site, given site id </description> 3029 <signature>is_main_site( $blog_id ) </signature> 3030 <docrelurl>is_main_site</docrelurl> 3031 </item> 3032 <item name= "is_main_query"> 3033 <description>This function enables someone to hook into `pre_get_posts` and modify *only* the main query. This is a boolean function, meaning it returns either TRUE or FALSE. </description> 3034 <signature>is_main_query(); </signature> 3035 <docrelurl>is_main_query</docrelurl> 3036 </item> 3037 <item name= "is_ssl"> 3038 <description>Checks if SSL is being used. </description> 3039 <signature>is_ssl() </signature> 3040 <docrelurl>is_ssl</docrelurl> 3041 </item> 3042 <item name= "log_app"> 3043 <description>Logs messages to a file. You can log all atom actions within wordpress by simply calling this function </description> 3044 <signature>log_app( $label, $msg) </signature> 3045 <docrelurl>log_app</docrelurl> 3046 </item> 3047 <item name= "make_url_footnote"> 3048 <description>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. </description> 3049 <signature>make_url_footnote( $content ) </signature> 3050 <docrelurl>make_url_footnote</docrelurl> 3051 </item> 3052 <item name= "nocache_headers"> 3053 <description>Sets the headers to prevent caching for the different browsers. Different browsers support different nocache headers, so several headers must be sent so that all of them get the point that no caching should occur. </description> 3054 <signature>nocache_headers() </signature> 3055 <docrelurl>nocache_headers</docrelurl> 3056 </item> 3057 <item name= "remove_query_arg"> 3058 <description>Removes an item or list from the query string. </description> 3059 <signature>remove_query_arg( $key, $query ) </signature> 3060 <docrelurl>remove_query_arg</docrelurl> 3061 </item> 3062 <item name= "site_url"> 3063 <description>The site_url template tag retrieves the site url for the current site (where the WordPress core files) with the appropriate protocol, 'https' if is_ssl() and 'http' otherwise. If scheme is 'http' or 'https', is_ssl() is overridden. Use this to get the "wordpress address" as defined in general settings. Use home_url() to get the "site address" as defined in general settings. In case of WordPress Network setup, use network_site_url() instead. </description> 3064 <signature>site_url( $path, $scheme ); </signature> 3065 <docrelurl>site_url</docrelurl> 3066 </item> 3067 <item name= "status_header"> 3068 <description>Set HTTP status header. </description> 3069 <signature>status_header( $header ) </signature> 3070 <docrelurl>status_header</docrelurl> 3071 </item> 3072 <item name= "wp"> 3073 <description>Setup the WordPress query. </description> 3074 <signature>wp( $query_vars ) </signature> 3075 <docrelurl>wp</docrelurl> 3076 </item> 3077 <item name= "wp_check_filetype"> 3078 <description>Retrieve the file type from the file name. You can optionally define the mime array, if needed. </description> 3079 <signature>wp_check_filetype( $filename, $mimes ) </signature> 3080 <docrelurl>wp_check_filetype</docrelurl> 3081 </item> 3082 <item name= "wp_clearcookie"> 3083 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Clears the authentication cookie, logging the user out. This function is deprecated. Use wp_clear_auth_cookie() instead. </description> 3084 <signature>wp_clearcookie(); </signature> 3085 <docrelurl>wp_clearcookie</docrelurl> 3086 </item> 3087 <item name= "wp_die"> 3088 <description>Kill WordPress execution and display HTML message with error message. A call to this function complements the die() PHP function. The difference is that HTML will be displayed to the user. It is recommended to use this function only when the execution should not continue any further. It is not recommended to call this function very often and try to handle as many errors as possible silently. </description> 3089 <signature>wp_die( $message, $title, $args ) </signature> 3090 <docrelurl>wp_die</docrelurl> 3091 </item> 3092 <item name= "wp_footer"> 3093 <description>Fire the 'wp_footer' action. Put this template tag immediately before "body" tag in a theme template (ex. footer.php, index.php).</description> 3094 <signature></signature> 3095 <docrelurl>wp_footer</docrelurl> 3096 </item> 3097 <item name= "wp_get_cookie_login"> 3098 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Gets the user cookie login. This function is deprecated and should no longer be extended as it won't be used anywhere in WordPress. Also, plugins shouldn't use it either. </description> 3099 <signature>wp_get_cookie_login() </signature> 3100 <docrelurl>wp_get_cookie_login</docrelurl> 3101 </item> 3102 <item name= "wp_get_http_headers"> 3103 <description>Retrieve HTTP Headers from URL. </description> 3104 <signature>wp_get_http_headers( $url, $deprecated ) </signature> 3105 <docrelurl>wp_get_http_headers</docrelurl> 3106 </item> 3107 <item name= "wp_hash"> 3108 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Get hash of given string. </description> 3109 <signature>wp_hash( $data, $scheme ) </signature> 3110 <docrelurl>wp_hash</docrelurl> 3111 </item> 3112 <item name= "wp_head"> 3113 <description> 3114 Fire the 'wp_head' action. Put this template tag immediately before "head" tag in a theme template (ex. header.php, index.php). 3115 </description> 3116 <signature></signature> 3117 <docrelurl>wp_head</docrelurl> 3118 </item> 3119 <item name= "wp_mail"> 3120 <description>Send mail, similar to PHP's mail. The default sender name is "WordPress" and the default sender email address is wordpress@yoursite.com. These may be overridden by including a header like: </description> 3121 <signature>wp_mail('test@test.com', 'subject', 'message', $headers, $attachments);</signature> 3122 <docrelurl>wp_mail</docrelurl> 3123 </item> 3124 <item name= "wp_mkdir_p"> 3125 <description>Recursive directory creation based on full path. Will attempt to set permissions on folders. </description> 3126 <signature>wp_mkdir_p( $target ) </signature> 3127 <docrelurl>wp_mkdir_p</docrelurl> 3128 </item> 3129 <item name= "wp_new_user_notification"> 3130 <description>Notify the blog admin of a new user, normally via email and also send an email with login/password to the new user. This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. </description> 3131 <signature>wp_new_user_notification( $user_id, $plaintext_pass ) </signature> 3132 <docrelurl>wp_new_user_notification</docrelurl> 3133 </item> 3134 <item name= "wp_notify_moderator"> 3135 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Notifies the moderator of the blog about a new comment that is awaiting approval. </description> 3136 <signature>wp_notify_moderator( $comment_id ) </signature> 3137 <docrelurl>wp_notify_moderator</docrelurl> 3138 </item> 3139 <item name= "wp_notify_postauthor"> 3140 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Sanitizes a URL for use in a redirect. </description> 3141 <signature>wp_notify_postauthor( $comment_id, $comment_type ) </signature> 3142 <docrelurl>wp_notify_postauthor</docrelurl> 3143 </item> 3144 <item name= "wp_parse_args"> 3145 <description>wp_parse_args is a generic utility for merging together an array of arguments and an array of default values. It can also be given a URL query type string which will be converted into an array (i.e. "id=5&status=draft"). It is used throughout WordPress to avoid having to worry about the logic of defaults and input, and produces a stable pattern for passing arguments around. Functions like query_posts, wp_list_comments and get_terms are common examples of the simplifying power of wp_parse_args. Functions that have an $args based setting are able to infinitely expand the number of values that can potentially be passed into them, avoiding the annoyance of super-long function calls because there are too many arguments to keep track of, many of whose only function is to override usually-good defaults on rare occasions. </description> 3146 <signature></signature> 3147 <docrelurl>wp_parse_args</docrelurl> 3148 </item> 3149 <item name= "wp_redirect"> 3150 <description>Redirects the user to a specified absolute URI. </description> 3151 <signature> 3152 wp_redirect( $location, $status ); 3153 exit; 3154 </signature> 3155 <docrelurl>wp_redirect</docrelurl> 3156 </item> 3157 <item name= "wp_reset_postdata"> 3158 <description>After looping through a separate query, this function restores the $post global to the current post in the main query. </description> 3159 <signature>wp_reset_postdata(); </signature> 3160 <docrelurl>wp_reset_postdata</docrelurl> 3161 </item> 3162 <item name= "wp_reset_query"> 3163 <description>This function destroys the previous query used on a custom Loop. Function should be called after The Loop to ensure conditional tags work as expected. </description> 3164 <signature>wp_reset_query(); </signature> 3165 <docrelurl>wp_reset_query</docrelurl> 3166 </item> 3167 <item name= "wp_remote_fopen"> 3168 <description>Returns the contents of a remote URI. Tries to retrieve the HTTP content with fopen first and then using cURL, if fopen can't be used. </description> 3169 <signature></signature> 3170 <docrelurl>wp_remote_fopen</docrelurl> 3171 </item> 3172 <item name= "wp_salt"> 3173 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Get salt to add to hashes to help prevent attacks. The secret key is located in two places: the database in case the secret key isn't defined in the second place, which is in the wp-config.php file. If you are going to set the secret key, then you must do so in the wp-config.php file. The secret key in the database is randomly generated and will be appended to the secret key that is in wp-config.php file in some instances. It is important to have the secret key defined or changed in wp-config.php. If you have installed WordPress 2.5 or later, then you will have the SECRET_KEY defined in the wp-config.php already. You will want to change the value in it because hackers will know what it is. If you have upgraded to WordPress 2.5 or later version from a version before WordPress 2.5, then you should add the constant to your wp-config.php file. Salting passwords helps against tools which has stored hashed values of common dictionary strings. The added values makes it harder to crack if given salt string is not weak. </description> 3174 <signature>wp_salt( $scheme ) </signature> 3175 <docrelurl>wp_salt</docrelurl> 3176 </item> 3177 <item name= "wp_set_auth_cookie"> 3178 <description>This function can be replaced via plugins. If plugins do not redefine these functions, then this will be used instead. Sets the authentication cookies based User ID. The $remember parameter increases the time that the cookie will be kept. The default the cookie is kept without remembering is two days. When $remember is set, the cookies will be kept for 14 days or two weeks. </description> 3179 <signature>wp_set_auth_cookie( $user_id, $remember, $secure ) </signature> 3180 <docrelurl>wp_set_auth_cookie</docrelurl> 3181 </item> 3182 <item name= "wp_upload_bits"> 3183 <description>Create a file in the upload folder with given content. If there is an error, then the key 'error' will exist with the error message. If success, then the key 'file' will have the unique file path, the 'url' key will have the link to the new file. and the 'error' key will be set to false. This function will not move an uploaded file to the upload folder. It will create a new file with the content in $bits parameter. If you move the upload file, read the content of the uploaded file, and then you can give the filename and content to this function, which will add it to the upload folder. The permissions will be set on the new file automatically by this function. </description> 3184 <signature>wp_upload_bits( $name, $deprecated, $bits, $time ) </signature> 3185 <docrelurl>wp_upload_bits</docrelurl> 3186 </item> 3187 <item name= "wp_upload_dir"> 3188 <description>Returns an array of key => value pairs containing path information on the currently configured uploads directory. </description> 3189 <signature>$upload_dir = wp_upload_dir(); </signature> 3190 <docrelurl>wp_upload_dir</docrelurl> 3191 </item> 3192 <item name= "display_space_usage"> 3193 <description>Displays the amount of disk space used by a site. </description> 3194 <signature>display_space_usage(); </signature> 3195 <docrelurl>display_space_usage</docrelurl> 3196 </item> 3197 <item name= "grant_super_admin"> 3198 <description>Add a user to the Super admin user list in WordPress Multisite </description> 3199 <signature></signature> 3200 <docrelurl>grant_super_admin</docrelurl> 3201 </item> 3202 <item name= "revoke_super_admin"> 3203 <description>Remove a user from the Super admin user list in WordPress Multisite </description> 3204 <signature></signature> 3205 <docrelurl>revoke_super_admin</docrelurl> 3206 </item> 3207 <item name= "add_blog_option"> 3208 <description>Add an option for a particular blog. </description> 3209 <signature></signature> 3210 <docrelurl>add_blog_option</docrelurl> 3211 </item> 3212 <item name= "delete_blog_option"> 3213 <description>Delete an option for a particular blog. </description> 3214 <signature></signature> 3215 <docrelurl>delete_blog_option</docrelurl> 3216 </item> 3217 <item name= "get_blogaddress_by_domain"> 3218 <description>Get a full blog URL, given a domain and a path. </description> 3219 <signature></signature> 3220 <docrelurl>get_blogaddress_by_domain</docrelurl> 3221 </item> 3222 <item name= "get_blogaddress_by_id"> 3223 <description>Get a full blog URL, given a blog id. </description> 3224 <signature></signature> 3225 <docrelurl>get_blogaddress_by_id</docrelurl> 3226 </item> 3227 <item name= "get_blogaddress_by_name"> 3228 <description>Get a full blog URL, given a blog name. </description> 3229 <signature></signature> 3230 <docrelurl>get_blogaddress_by_name</docrelurl> 3231 </item> 3232 <item name= "get_blog_details"> 3233 <description>Gets the details of the blog. </description> 3234 <signature></signature> 3235 <docrelurl>get_blog_details</docrelurl> 3236 </item> 3237 <item name= "get_blog_option"> 3238 <description>Retrieve option value based on setting name and blog_id. If the option does not exist or does not have a value, then the return value will be false. This is useful to check whether you need to install an option and is commonly used during installation of plugin options and to test whether upgrading is required. There is a filter called 'blog_option_$option' with the $option being replaced with the option name. The filter takes two parameters. $value and $blog_id. It returns $value. The 'option_$option' filter in get_option() is not called. Uses apply_filters() Calls 'blog_option_$optionname' with the option name value. </description> 3239 <signature>get_blog_option( $blog_id, $setting , $default ) </signature> 3240 <docrelurl>get_blog_option</docrelurl> 3241 </item> 3242 <item name= "get_blog_status"> 3243 <description>Get a blog details field. </description> 3244 <signature></signature> 3245 <docrelurl>get_blog_status</docrelurl> 3246 </item> 3247 <item name= "get_id_from_blogname"> 3248 <description>Given a blog's (subdomain or directory) name, retrieve it's id. </description> 3249 <signature></signature> 3250 <docrelurl>get_id_from_blogname</docrelurl> 3251 </item> 3252 <item name= "get_last_updated"> 3253 <description>Get a list of most recently updated blogs. </description> 3254 <signature></signature> 3255 <docrelurl>get_last_updated</docrelurl> 3256 </item> 3257 <item name= "is_archived"> 3258 <description>Check if a particular blog is archived. </description> 3259 <signature></signature> 3260 <docrelurl>is_archived</docrelurl> 3261 </item> 3262 <item name= "refresh_blog_details"> 3263 <description>Clear the blog details cache. </description> 3264 <signature></signature> 3265 <docrelurl>refresh_blog_details</docrelurl> 3266 </item> 3267 <item name= "restore_current_blog"> 3268 <description>Restore the current blog, after calling switch_to_blog() </description> 3269 <signature></signature> 3270 <docrelurl>restore_current_blog</docrelurl> 3271 </item> 3272 <item name= "switch_to_blog"> 3273 <description>Switch the current blog to a different blog. switch_to_blog(), is useful if you need to pull posts or other information from other blogs. You can switch back afterwards using restore_current_blog(). Things that aren't switched: </description> 3274 <signature></signature> 3275 <docrelurl>switch_to_blog</docrelurl> 3276 </item> 3277 <item name= "update_archived"> 3278 <description>Update the 'archived' status of a particular blog. </description> 3279 <signature></signature> 3280 <docrelurl>update_archived</docrelurl> 3281 </item> 3282 <item name= "update_blog_details"> 3283 <description>Update the details for a blog. Updates the blogs table for a given blog id. </description> 3284 <signature></signature> 3285 <docrelurl>update_blog_details</docrelurl> 3286 </item> 3287 <item name= "update_blog_option"> 3288 <description>Update an option for a particular blog. </description> 3289 <signature></signature> 3290 <docrelurl>update_blog_option</docrelurl> 3291 </item> 3292 <item name= "update_blog_status"> 3293 <description>Update a blog details field. </description> 3294 <signature>update_blog_status( $blog_id, $pref, $value, $refresh ) </signature> 3295 <docrelurl>update_blog_status</docrelurl> 3296 </item> 3297 <item name= "wpmu_update_blogs_date"> 3298 <description>Update the last_updated field for the current blog. </description> 3299 <signature>wpmu_update_blogs_date(); </signature> 3300 <docrelurl>wpmu_update_blogs_date</docrelurl> 3301 </item> 3302 <item name= "ms_upload_constants"> 3303 <description>Defines Multisite upload constants. </description> 3304 <signature>ms_upload_constants(); </signature> 3305 <docrelurl>ms_upload_constants</docrelurl> 3306 </item> 3307 <item name= "add_user_to_blog"> 3308 <description>Associates a user to a blog, with the ability to set access permission. </description> 3309 <signature>add_user_to_blog( $blog_id, $user_id, $role ) </signature> 3310 <docrelurl>add_user_to_blog</docrelurl> 3311 </item> 3312 <item name= "create_empty_blog"> 3313 <description>Creates a new, empty blog. </description> 3314 <signature></signature> 3315 <docrelurl>create_empty_blog</docrelurl> 3316 </item> 3317 <item name= "domain_exists"> 3318 <description>Check whether a blogname is already taken. Used during the new site registration process to ensure that each blogname is unique. </description> 3319 <signature>domain_exists( $domain, $path, $site_id ); </signature> 3320 <docrelurl>domain_exists</docrelurl> 3321 </item> 3322 <item name= "force_ssl_content"> 3323 <description>Whether to force SSL on content. </description> 3324 <signature>force_ssl_content( $force ); </signature> 3325 <docrelurl>force_ssl_content</docrelurl> 3326 </item> 3327 <item name= "get_active_blog_for_user"> 3328 <description>Get one of a user's active blogs Returns the user's primary blog, if she has one and it is active. If it's inactive, function returns another active blog of the user. If none are found, the user is added as a Subscriber to the Dashboard Blog and that blog is returned. </description> 3329 <signature>get_active_blog_for_user( $user_id ); </signature> 3330 <docrelurl>get_active_blog_for_user</docrelurl> 3331 </item> 3332 <item name= "get_admin_users_for_domain"> 3333 <description>Get the admin for a domain/path combination. </description> 3334 <signature>get_admin_users_for_domain( $sitedomain, $path ); </signature> 3335 <docrelurl>get_admin_users_for_domain</docrelurl> 3336 </item> 3337 <item name= "get_blog_post"> 3338 <description>Gets post information. </description> 3339 <signature></signature> 3340 <docrelurl>get_blog_post</docrelurl> 3341 </item> 3342 <item name= "get_current_site"> 3343 <description>Gets the current site based on the value of the $current_site global variable. </description> 3344 <signature>get_current_site(); </signature> 3345 <docrelurl>get_current_site</docrelurl> 3346 </item> 3347 <item name= "get_dashboard_blog"> 3348 <description>Get the "dashboard blog", the blog where users without a blog edit their profile data. </description> 3349 <signature>get_dashboard_blog(); </signature> 3350 <docrelurl>get_dashboard_blog</docrelurl> 3351 </item> 3352 <item name= "get_dirsize"> 3353 <description>Get the size of a directory. A helper function that is used primarily to check whether a blog has exceeded its allowed upload space. </description> 3354 <signature>get_dirsize( $directory ); </signature> 3355 <docrelurl>get_dirsize</docrelurl> 3356 </item> 3357 <item name= "get_most_recent_post_of_user"> 3358 <description>Get the most recent post of a user. Walks through each of a user's blogs to find the post with the most recent post_date_gmt. </description> 3359 <signature>get_most_recent_post_of_user( $user_id ); </signature> 3360 <docrelurl>get_most_recent_post_of_user</docrelurl> 3361 </item> 3362 <item name= "get_user_id_from_string"> 3363 <description>Get a numeric user ID from either an email address or a login. If a number is sent to the function, that number is returned as the id. </description> 3364 <signature>get_user_id_from_string( $string ); </signature> 3365 <docrelurl>get_user_id_from_string</docrelurl> 3366 </item> 3367 <item name= "global_terms"> 3368 <description>Maintains a canonical list of terms by syncing terms created for each blog with the global terms table. </description> 3369 <signature>global_terms( $term_id, $deprecated ); </signature> 3370 <docrelurl>global_terms</docrelurl> 3371 </item> 3372 <item name= "insert_blog"> 3373 <description>Store basic site info in the blogs table. This function creates a row in the wp_blogs table and returns the new blog's ID. It is the first step in creating a new blog. </description> 3374 <signature>insert_blog( $domain, $path, $site_id ); </signature> 3375 <docrelurl>insert_blog</docrelurl> 3376 </item> 3377 <item name= "install_blog"> 3378 <description>Install an empty blog. Creates the new blog tables and options. If calling this function directly, be sure to use switch_to_blog() first, so that $wpdb points to the new blog. </description> 3379 <signature>install_blog( $blog_id, $blog_title ); </signature> 3380 <docrelurl>install_blog</docrelurl> 3381 </item> 3382 <item name= "is_blog_user"> 3383 <description>Checks if the current user belong to a given blog. </description> 3384 <signature>is_blog_user( $blog_id ); </signature> 3385 <docrelurl>is_blog_user</docrelurl> 3386 </item> 3387 <item name= "is_email_address_unsafe"> 3388 <description>Checks an email address against a list of banned domains. This function checks against the Banned Email Domains list at wp-admin/network/settings.php. The check is only run on self-registrations; user creation at wp-admin/network/users.php bypasses this check. </description> 3389 <signature>is_email_address_unsafe( $user_email ); </signature> 3390 <docrelurl>is_email_address_unsafe</docrelurl> 3391 </item> 3392 <item name= "is_user_spammy"> 3393 <description>Check to see whether a user is marked as a spammer, based on username </description> 3394 <signature>is_user_spammy( $username ); </signature> 3395 <docrelurl>is_user_spammy</docrelurl> 3396 </item> 3397 <item name= "newblog_notify_siteadmin"> 3398 <description>Notifies the network admin that a new site has been activated. Filter 'newblog_notify_siteadmin' to change the content of the notification email. </description> 3399 <signature>newblog_notify_siteadmin( $blog_id, $deprecated ); </signature> 3400 <docrelurl>newblog_notify_siteadmin</docrelurl> 3401 </item> 3402 <item name= "redirect_this_site"> 3403 <description>Ensure that the current site's domain is listed in the allowed redirect host list. </description> 3404 <signature>redirect_this_site( $deprecated ); </signature> 3405 <docrelurl>redirect_this_site</docrelurl> 3406 </item> 3407 <item name= "update_blog_public"> 3408 <description>Update this blog's 'public' setting in the global blogs table. Public blogs have a setting of 1, private blogs are 0. </description> 3409 <signature>update_blog_public( $old_value, $value ); </signature> 3410 <docrelurl>update_blog_public</docrelurl> 3411 </item> 3412 <item name= "users_can_register_signup_filter"> 3413 <description>Check whether users can self-register, based on Network settings. </description> 3414 <signature>users_can_register_signup_filter(); </signature> 3415 <docrelurl>users_can_register_signup_filter</docrelurl> 3416 </item> 3417 <item name= "welcome_user_msg_filter"> 3418 <description>Ensure that the welcome message is not empty. Currently unused. </description> 3419 <signature>welcome_user_msg_filter( $text ); </signature> 3420 <docrelurl>welcome_user_msg_filter</docrelurl> 3421 </item> 3422 <item name= "wpmu_create_blog"> 3423 <description>Creates a new blog (multisite). </description> 3424 <signature></signature> 3425 <docrelurl>wpmu_create_blog</docrelurl> 3426 </item> 3427 <item name= "wpmu_create_user"> 3428 <description>Create a user using strict username sanitization: only alphanumeric, _, ., -, and/or @ are allowed. This function runs when a user self-registers as well as when a Super Admin creates a new user. Hook to 'wpmu_new_user' for events that should affect all new users, but only on Multisite (otherwise use 'user_register'). </description> 3429 <signature>wpmu_create_user( $user_name, $password, $email ); </signature> 3430 <docrelurl>wpmu_create_user</docrelurl> 3431 </item> 3432 <item name= "wpmu_signup_user"> 3433 <description>Record user signup information for future activation. This function is used when user registration is open but new site registration is not. </description> 3434 <signature>wpmu_signup_user( $user, $user_email, $meta ); </signature> 3435 <docrelurl>wpmu_signup_user</docrelurl> 3436 </item> 3437 <item name= "wpmu_signup_user_notification"> 3438 <description>Notify user of signup success. This is the notification function used when no new site has been requested. Filter 'wpmu_signup_user_notification' to bypass this function or replace it with your own notification behavior. Filter 'wpmu_signup_user_notification_email' and 'wpmu_signup_user_notification_subject' to change the content and subject line of the email sent to newly registered users. </description> 3439 <signature>wpmu_signup_user_notification( $user, $user_email, $key, $meta ); </signature> 3440 <docrelurl>wpmu_signup_user_notification</docrelurl> 3441 </item> 3442 <item name= "wpmu_welcome_user_notification"> 3443 <description>Notify a user that her account activation has been successful. Filter 'wpmu_welcome_user_notification' to disable or bypass. Filter 'update_welcome_user_email' and 'update_welcome_user_subject' to modify the content and subject line of the notification email. </description> 3444 <signature>wpmu_welcome_user_notification( $user_id, $password, $meta ); </signature> 3445 <docrelurl>wpmu_welcome_user_notification</docrelurl> 3446 </item> 3447 <item name= "get_current_site_name"> 3448 <description>Gets the current site name based on the value of the $current_site global variable. </description> 3449 <signature>get_current_site_name( $current_site ); </signature> 3450 <docrelurl>get_current_site_name</docrelurl> 3451 </item> 3452 <item name= "is_subdomain_install"> 3453 <description>Whether a sub-domain configuration is enabled. This function was added in version 3.0.0. </description> 3454 <signature>is_subdomain_install(); </signature> 3455 <docrelurl>is_subdomain_install</docrelurl> 3456 </item> 3457 <item name= "ms_not_installed"> 3458 <description>Displays a failure message. Used when a blog's tables do not exist. Checks for a missing $wpdb->site table as well. </description> 3459 <signature>ms_not_installed(); </signature> 3460 <docrelurl>ms_not_installed</docrelurl> 3461 </item> 3462 </items> 793 3463 </globalfunctions> 794 3464 </php>
Note: See TracChangeset
for help on using the changeset viewer.