WordPress.org
Get WordPress

Make WordPress Core

Changeset 8950


Ignore:
Timestamp:
09/22/2008 03:52:41 AM (16 years ago)
Author:
azaozz
Message:

More inline documentation for widgets.php, props jacobsantos, see #7661

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/wp-includes/widgets.php

    r8945 r8950  
    378378 * @see wp_unregister_widget_control()
    379379 *
    380  * @param int $id Widget ID
     380 * @param int $id Widget ID.
    381381 */
    382382function unregister_widget_control($id) {
    … …  
    638638
    639639/**
    640  * {@internal Missing Short Description}}
    641  *
    642  * {@internal Missing Long Description}}
     640 * Display pages widget.
    643641 *
    644642 * @since 2.2.0
    … …  
    673671
    674672/**
    675  * {@internal Missing Short Description}}
    676  *
    677  * {@internal Missing Long Description}}
     673 * Display and process pages widget options form.
    678674 *
    679675 * @since 2.2.0
    … …  
    721717
    722718/**
    723  * {@internal Missing Short Description}}
    724  *
    725  * {@internal Missing Long Description}}
     719 * Display links widget.
    726720 *
    727721 * @since 2.2.0
    … …  
    741735
    742736/**
    743  * {@internal Missing Short Description}}
    744  *
    745  * {@internal Missing Long Description}}
     737 * Display search widget.
    746738 *
    747739 * @since 2.2.0
    … …  
    770762
    771763/**
    772  * {@internal Missing Short Description}}
    773  *
    774  * {@internal Missing Long Description}}
     764 * Display archives widget.
    775765 *
    776766 * @since 2.2.0
    … …  
    804794
    805795/**
    806  * {@internal Missing Short Description}}
    807  *
    808  * {@internal Missing Long Description}}
     796 * Display and process archives widget options form.
    809797 *
    810798 * @since 2.2.0
    … …  
    836824
    837825/**
    838  * {@internal Missing Short Description}}
    839  *
    840  * {@internal Missing Long Description}}
    841  *
    842  * @since 2.2.0
    843  *
    844  * @param array $args Widget Arguments
     826 * Display meta widget.
     827 *
     828 * Displays log in/out, RSS feed links, etc.
     829 *
     830 * @since 2.2.0
     831 *
     832 * @param array $args Widget arguments.
    845833 */
    846834function wp_widget_meta($args) {
    … …  
    864852
    865853/**
    866  * {@internal Missing Short Description}}
    867  *
    868  * {@internal Missing Long Description}}
     854 * Display and process meta widget options form.
    869855 *
    870856 * @since 2.2.0
    … …  
    887873
    888874/**
    889  * {@internal Missing Short Description}}
    890  *
    891  * {@internal Missing Long Description}}
     875 * Display calendar widget.
    892876 *
    893877 * @since 2.2.0
    … …  
    909893
    910894/**
    911  * {@internal Missing Short Description}}
    912  *
    913  * {@internal Missing Long Description}}
     895 * Display and process calendar widget options form.
    914896 *
    915897 * @since 2.2.0
    … …  
    966948
    967949/**
    968  * {@internal Missing Short Description}}
    969  *
    970  * {@internal Missing Long Description}}
     950 * Display and process text widget options form.
    971951 *
    972952 * @since 2.2.0
    … …  
    10371017
    10381018/**
    1039  * {@internal Missing Short Description}}
    1040  *
    1041  * {@internal Missing Long Description}}
     1019 * Register text widget on startup.
    10421020 *
    10431021 * @since 2.2.0
    … …  
    10681046
    10691047/**
    1070  * {@internal Missing Short Description}}
    1071  *
    1072  * {@internal Missing Long Description}}
    1073  *
    1074  * @since 2.2.0
    1075  *
    1076  * @param unknown_type $args
    1077  * @param unknown_type $number
    1078  */
    1079 // See large comment section at end of this file
     1048 * Display categories widget.
     1049 *
     1050 * Allows multiple category widgets.
     1051 *
     1052 * @since 2.2.0
     1053 *
     1054 * @param array $args Widget arguments.
     1055 * @param int $number Widget number.
     1056 */
    10801057function wp_widget_categories($args, $widget_args = 1) {
    10811058    extract($args, EXTR_SKIP);
    … …  
    11331110
    11341111/**
    1135  * {@internal Missing Short Description}}
    1136  *
    1137  * {@internal Missing Long Description}}
    1138  *
    1139  * @since 2.2.0
    1140  *
    1141  * @param unknown_type $number
     1112 * Display and process categories widget options form.
     1113 *
     1114 * @since 2.2.0
     1115 *
     1116 * @param int $widget_args Widget number.
    11421117 */
    11431118function wp_widget_categories_control( $widget_args ) {
    … …  
    12281203
    12291204/**
    1230  * {@internal Missing Short Description}}
    1231  *
    1232  * {@internal Missing Long Description}}
     1205 * Register categories widget on startup.
    12331206 *
    12341207 * @since 2.3.0
    … …  
    12631236
    12641237/**
    1265  * {@internal Missing Short Description}}
    1266  *
    1267  * {@internal Missing Long Description}}
     1238 * Upgrade previous category widget to current version.
    12681239 *
    12691240 * @since 2.3.0
    12701241 *
    1271  * @return unknown
     1242 * @return array
    12721243 */
    12731244function wp_widget_categories_upgrade() {
    … …  
    12991270
    13001271/**
    1301  * {@internal Missing Short Description}}
    1302  *
    1303  * {@internal Missing Long Description}}
    1304  *
    1305  * @since 2.2.0
    1306  *
    1307  * @param unknown_type $args
    1308  * @return unknown
     1272 * Display recent entries widget.
     1273 *
     1274 * @since 2.2.0
     1275 *
     1276 * @param array $args Widget arguments.
     1277 * @return int Displayed cache.
    13091278 */
    13101279function wp_widget_recent_entries($args) {
    … …  
    13471316 * Remove recent entries widget items cache.
    13481317 *
    1349  * {@internal Missing Long Description}}
    1350  *
    13511318 * @since 2.2.0
    13521319 */
    … …  
    13601327
    13611328/**
    1362  * {@internal Missing Short Description}}
    1363  *
    1364  * {@internal Missing Long Description}}
     1329 * Display and process recent entries widget options form.
    13651330 *
    13661331 * @since 2.2.0
    … …  
    13931358
    13941359/**
    1395  * {@internal Missing Short Description}}
    1396  *
    1397  * {@internal Missing Long Description}}
    1398  *
    1399  * @since 2.2.0
    1400  *
    1401  * @param unknown_type $args
     1360 * Display recent comments widget.
     1361 *
     1362 * @since 2.2.0
     1363 *
     1364 * @param array $args Widget arguments.
    14021365 */
    14031366function wp_widget_recent_comments($args) {
    … …  
    14321395 * Remove the cache for recent comments widget.
    14331396 *
    1434  * {@internal Missing Long Description}}
    1435  *
    14361397 * @since 2.2.0
    14371398 */
    … …  
    14431404
    14441405/**
    1445  * {@internal Missing Short Description}}
    1446  *
    1447  * {@internal Missing Long Description}}
     1406 * Display and process recent comments widget options form.
    14481407 *
    14491408 * @since 2.2.0
    … …  
    14771436 * Display the style for recent comments widget.
    14781437 *
    1479  * {@internal Missing Long Description}}
    1480  *
    14811438 * @since 2.2.0
    14821439 */
    … …  
    14881445
    14891446/**
    1490  * {@internal Missing Short Description}}
    1491  *
    1492  * {@internal Missing Long Description}}
     1447 * Register recent comments with control and hook for 'wp_head' action.
    14931448 *
    14941449 * @since 2.2.0
    … …  
    15041459
    15051460/**
    1506  * {@internal Missing Short Description}}
    1507  *
    1508  * {@internal Missing Long Description}}
    1509  *
    1510  * @since 2.2.0
    1511  *
    1512  * @param unknown_type $args
    1513  * @param unknown_type $number
    1514  */
    1515 // See large comment section at end of this file
     1461 * Display RSS widget.
     1462 *
     1463 * Allows for multiple widgets to be displayed.
     1464 *
     1465 * @since 2.2.0
     1466 *
     1467 * @param array $args Widget arguments.
     1468 * @param int $number Widget number.
     1469 */
    15161470function wp_widget_rss($args, $widget_args = 1) {
    15171471    extract($args, EXTR_SKIP);
    … …  
    15651519}
    15661520
     1521/**
     1522 * Display the RSS entries in a list.
     1523 *
     1524 * @since 2.5.0
     1525 *
     1526 * @param string|array|object $rss RSS url.
     1527 * @param array $args Widget arguments.
     1528 */
    15671529function wp_widget_rss_output( $rss, $args = array() ) {
    15681530    if ( is_string( $rss ) ) {
    … …  
    16491611
    16501612/**
    1651  * wp_widget_rss_control() - {@internal Missing Short Description}}
    1652  *
    1653  * {@internal Missing Long Description}}
    1654  *
    1655  * @since 2.2.0
    1656  *
    1657  * @param unknown_type $widget_args
     1613 * Display and process RSS widget control form.
     1614 *
     1615 * @since 2.2.0
     1616 *
     1617 * @param int $widget_args Widget number.
    16581618 */
    16591619function wp_widget_rss_control($widget_args) {
    … …  
    17271687 * 'show_date'.
    17281688 *
    1729  * @since unknown
     1689 * @since 2.5.0
    17301690 *
    17311691 * @param array|string $args Values for input fields.
    … …  
    18141774 * All respectively in the order of the array elements.
    18151775 *
    1816  * @since unknown
     1776 * @since 2.5.0
    18171777 *
    18181778 * @param array $widget_rss RSS widget feed data. Expects unescaped data.
    … …  
    18491809
    18501810/**
    1851  * Register RSS widget to allow multiple RSS widgets.
     1811 * Register RSS widget to allow multiple RSS widgets on startup.
    18521812 *
    18531813 * @since 2.2.0
    … …  
    19241884
    19251885/**
    1926  * Register all of the default WordPress widgets.
     1886 * Register all of the default WordPress widgets on startup.
    19271887 *
    19281888 * Calls 'widgets_init' action after all of the WordPress widgets have been
    … …  
    19751935add_action('init', 'wp_widgets_init', 1);
    19761936
    1977 /* Pattern for multi-widget (allows multiple instances such as the text widget).
    1978 
    1979 // Displays widget on blag
    1980 // $widget_args: number
    1981 //    number: which of the several widgets of this type do we mean
     1937/*
     1938 * Pattern for multi-widget (allows multiple instances such as the text widget).
     1939 *
     1940 * Make sure to close the comments after copying.
     1941
     1942/**
     1943 * Displays widget.
     1944 *
     1945 * Supports multiple widgets.
     1946 *
     1947 * @param array $args Widget arguments.
     1948 * @param array|int $widget_args Widget number. Which of the several widgets of this type do we mean.
     1949 * /
    19821950function widget_many( $args, $widget_args = 1 ) {
    19831951    extract( $args, EXTR_SKIP );
    … …  
    19991967}
    20001968
    2001 // Displays form for a particular instance of the widget.  Also updates the data after a POST submit
    2002 // $widget_args: number
    2003 //    number: which of the several widgets of this type do we mean
     1969/**
     1970 * Displays form for a particular instance of the widget.
     1971 *
     1972 * Also updates the data after a POST submit.
     1973 *
     1974 * @param array|int $widget_args Widget number. Which of the several widgets of this type do we mean.
     1975 * /
    20041976function widget_many_control( $widget_args = 1 ) {
    20051977    global $wp_registered_widgets;
    … …  
    20692041}
    20702042
    2071 // Registers each instance of our widget on startup
     2043/**
     2044 * Registers each instance of our widget on startup.
     2045 * /
    20722046function widget_many_register() {
    20732047    if ( !$options = get_option('widget_many') )
Note: See TracChangeset for help on using the changeset viewer.