WordPress 中文文档

Function Reference

出自WordPress Chinese 中文文档

跳转到: 导航, 搜索

The files of WordPress define many useful PHP functions. Some of the functions, known as Template Tags, are defined especially for use in WordPress Themes. There are also some functions related to actions and filters (the Plugin API), which are therefore used primarily for developing Plugins. The rest are used to create the core WordPress functionality.

Many of the core WordPress functions are useful to Plugin and Theme developers. So, this article lists most of the core functions, excluding Template Tags. At the bottom of the page, there is a section listing other resources for finding information about WordPress functions. In addition to this information, the WordPress phpdoc site details all the WordPress functions by version since 2.6.1.

Note: This reference applies to Version 2.1 and later versions of WordPress, and does not include functions that have been deprecated as of that version of WordPress. An incomplete page for the 2.0.x versions of WordPress can be found at Function Reference 2.0.x.

div style=border:blue 1px solid;padding:10px; background: #E6CCFF

You can help make this page more complete!

Here are some things you can do to help:

  • Add documentation to un-documented functions, by creating sub-pages or at least by adding short comments in the lists below. If you create a subpage for a function, please include information and examples of usage of that function, if possible, per the examples found in Template Tags.
  • List more functions here, following the category structure.
  • Remove functions from the list, if you think they could not possibly be useful to plugin developers, or if they have been deprecated.
  • Correct errors by moving functions to better categories where appropriate, and of course fixing typos. Note that it is OK for a function to appear in more than one category.

Read Contributing to WordPress to find out more about how you can contribute to the effort!

/div

!-- remove the DIV above after there's enough example content --

Functions by category

Post, Page, and Attachment Functions

These functions are contained in ttformatting.php/tt, ttmedia.php/tt, ttpost.php/tt. See also Template Tags.

Posts

Post insertion and removal

Pages

Custom field/postmeta functions

Attachment functions

Others

Category, Tag and Taxonomy Functions

Functions surrounding the WordPress Terms tables, encompassing categories and tags for classifying posts, pages, links, etc.

Category functions in ttcategory.php/tt

Tag Functions in ttcategory.php/tt

Term Functions in tttaxonomy.php/tt

Other Category Functions


User and Author Functions

These functions are in ttuser.php, pluggable.php, registration.php/tt. See also Template Tags.

Feed Functions

These functions are in ttfunctions.php/tt, ttfeed.php/tt, ttrss.php/tt

Comment, Ping, and Trackback Functions

These functions are found in ttcomment.php/tt, ttfunctions.php/tt, ttpost.php/tt. See also Template Tags.

Action, Filter, and Plugin Functions

These functions are contained in ttplugin.php/tt. See also Plugin API.

Theme-Related Functions

These functions are found in tttheme.php/tt.


Formatting Functions

These functions are contained in ttformatting.php/tt, ttfunctions.php/tt, ttkses.php/tt.

Miscellaneous Functions

These functions are contained in ttformatting.php/tt, ttfunctions.php/tt, ttbookmarks.php/tt, ttcron.php/tt, ttl10n.php/tt, ttuser.php/tt, ttpluggable.php/tt

Time/Date Functions

Serialization

Options

XMLRPC

Localization See also Translating WordPress.

Cron (Scheduling)

Miscellaneous

Classes

The following classes were created by WordPress developers, and are found in files ttcapabilities.php/tt, ttclasses.php/tt, ttclass-snoopy.php/tt, ttlocale.php/tt, ttquery.php/tt, ttrewrite.php/tt, ttscript-loader.php/tt, ttwp-db.php/tt:

  • WP - general request handling
  • ttWP_Ajax_Response/tt - AJAX handling
  • ttWP_Object_Cache/tt (formerly ttWP_Cache/tt) - Object cache (and functions ttwp_cache_add, wp_cache_close, wp_cache_delete, wp_cache_flush, wp_cache_get, wp_cache_init, wp_cache_replace, wp_cache_set/tt)
  • WP_Error - error handling (and function ttis_wp_error/tt)
  • ttWP_Locale/tt - handles date and time locales
  • ttWP_Query/tt - Request parsing and manipulation, posts fetching (with functions ttget_query_var, query_posts, have_posts, in_the_loop, rewind_posts, the_post, wp_old_slug_redirect, setup_postdata/tt, as well as the Conditional Tags ttis_*/tt)
  • ttWP_Rewrite/tt - Rewrite rules (and functions ttadd_rewrite_rule, add_rewrite_tag, add_feed, add_rewrite_endpoint, url_to_postid/tt)
  • WP_Roles, WP_Role, WP_User - Users and capabilities - ttmap_meta_cap, current_user_can, get_role, add_role, remove_role/tt
  • ttWP_Scripts/tt - JavaScript loading (and functions ttwp_print_scripts, wp_register_script, wp_deregister_script wp_enqueue_script/tt)
  • ttWP_Styles/tt - CSS stylesheet loading (and functions tt wp_print_styles, wp_register_style, wp_deregister_style, wp_enqueue_style /tt)
  • Display tree-like data - ttWalker, Walker_Page, Walker_PageDropdown, Walker_Category, Walker_CategoryDropdown/tt
  • ttwpdb/tt - Database interface

The following classes were created by outside developers, and are found in files ttclass-IXR.php/tt, ttclass-pop3.php/tt, ttclass-snoopy.php/tt, ttgettext.php/tt, ttrss.php/tt, ttstreams.php/tt:

  • IXR - XML-RPC Classes, including ttIXR_Value, IXR_Message, IXR_Server, IXR_IntrospectionServer, IXR_Request, IXR_Client, IXR_ClientMulticall, IXR_Error, IXR_Date, IXR_Base64/tt
  • Snoopy - HTTP client
  • ttgettext_reader/tt (part of PHP-gettext) - Localization Class
  • RSS Classes (MagpieRSS and RSSCache) (and functions ttfetch_rss, is_info, is_success, is_redirect, is_error, is_client_error, is_server_error, parse_w3cdtf, wp_rss, get_rss/tt)
  • ttPOP3/tt: SquirrelMail wrapper
  • ttStreamReader, StringReader, FileReader, CachedFileReader/tt

Official and Unofficial References

  • WordPress.org PHPDoc - Nearly all the functions in WordPress now have PHPDoc headers. This site shows all the PHPDoc.
  • Trac Browser - WordPress source code - Click on Tags to find a specific version, or Trunk to look at the latest WordPress source
  • PHPXref for WordPress - Cross reference of WordPress files, functions, and variables, which seems to point to the latest released version. This redalt.com PHPXref site has the bleeding-edge Trunk version, as well as 1.5 and 2.0, but the Trunk version may not be updating any more. So, there is now a new Trunk Xref site on ftwr.co.uk available.
  • WordPress Function History Table - List of what version each WordPress function was added in; PlanetOzh recommends: see related WordPress Functions Implementation History Tool for more information (and for a more usable tool)
  • WordPress Variable Report - A list of WordPress functions, listing what version of PHP every function requires (and if there's a compatible function available), what varables/arguments in functions are unused, and what functions/variables each class contains (and their default values).
  • WordPress Hooks Table - A list of WordPress actions and filters, cross-referenced to the files they are in

div style=background: #fee; border: 1px dotted #c66; margin: 1em 0; padding: 1em 0; text-align: center;This page is marked as incomplete. You can help Codex by expanding it./div

wordpress