Upstream
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Docs: Improve inline documentation syntax throughout `WP_Widget`. 

Fixes #36298.

Built from https://develop.svn.wordpress.org/trunk@37065


git-svn-id: http://core.svn.wordpress.org/trunk@37032 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2016-03-23 05:32:27 +00:00
parent 893871a5d1
commit c5a5c7c9d1
2 changed files with 20 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
wp-includes/class-wp-widget.php
View File

@ -37,7 +37,7 @@ class WP_Widget {
public $name; public $name;
/** /**
* Option array passed to {@see wp_register_sidebar_widget()}. * Option array passed to wp_register_sidebar_widget().
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -46,7 +46,7 @@ class WP_Widget {
public $widget_options; public $widget_options;
/** /**
* Option array passed to {@see wp_register_widget_control()}. * Option array passed to wp_register_widget_control().
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -84,7 +84,9 @@ class WP_Widget {
*/ */
public $updated = false; public $updated = false;
// Member functions that you must over-ride. //
// Member functions that must be overriden by subclasses.
//
/** /**
* Echoes the widget content. * Echoes the widget content.
@ -183,7 +185,8 @@ class WP_Widget {
/** /**
* Constructs name attributes for use in form() fields * Constructs name attributes for use in form() fields
* *
* This function should be used in form() methods to create name attributes for fields to be saved by update() * This function should be used in form() methods to create name attributes for fields
* to be saved by update()
* *
* @since 2.8.0 * @since 2.8.0
* @since 4.4.0 Array format field names are now accepted. * @since 4.4.0 Array format field names are now accepted.
@ -201,10 +204,10 @@ class WP_Widget {
} }
/** /**
* Constructs id attributes for use in {@see WP_Widget::form()} fields. * Constructs id attributes for use in WP_Widget::form() fields.
* *
* This function should be used in form() methods to create id attributes * This function should be used in form() methods to create id attributes
* for fields to be saved by {@see WP_Widget::update()}. * for fields to be saved by WP_Widget::update().
* *
* @since 2.8.0 * @since 2.8.0
* @since 4.4.0 Array format field IDs are now accepted. * @since 4.4.0 Array format field IDs are now accepted.
@ -250,7 +253,7 @@ class WP_Widget {
} }
/** /**
* Set the internal order number for the widget instance. * Sets the internal order number for the widget instance.
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -300,7 +303,7 @@ class WP_Widget {
} }
/** /**
* Determine whether the current request is inside the Customizer preview. * Determines whether the current request is inside the Customizer preview.
* *
* If true -- the current request is inside the Customizer preview, then * If true -- the current request is inside the Customizer preview, then
* the object cache gets suspended and widgets should check this to decide * the object cache gets suspended and widgets should check this to decide
@ -320,14 +323,14 @@ class WP_Widget {
} }
/** /**
* Generate the actual widget content (Do NOT override). * Generates the actual widget content (Do NOT override).
* *
* Finds the instance and calls {@see WP_Widget::widget()}. * Finds the instance and calls WP_Widget::widget().
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
* *
* @param array $args Display arguments. See {@see WP_Widget::widget()} for information * @param array $args Display arguments. See WP_Widget::widget() for information
* on accepted arguments. * on accepted arguments.
* @param int|array $widget_args { * @param int|array $widget_args {
* Optional. Internal order number of the widget instance, or array of multi-widget arguments. * Optional. Internal order number of the widget instance, or array of multi-widget arguments.
@ -379,7 +382,7 @@ class WP_Widget {
} }
/** /**
* Deal with changed settings (Do NOT override). * Handles changed settings (Do NOT override).
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -464,7 +467,7 @@ class WP_Widget {
} }
/** /**
* Generate the widget control form (Do NOT override). * Generates the widget control form (Do NOT override).
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -531,7 +534,7 @@ class WP_Widget {
} }
/** /**
* Register an instance of the widget class. * Registers an instance of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -546,7 +549,7 @@ class WP_Widget {
} }
/** /**
* Save the settings for all instances of the widget class. * Saves the settings for all instances of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public
@ -559,7 +562,7 @@ class WP_Widget {
} }
/** /**
* Get the settings for all instances of the widget class. * Retrieves the settings for all instances of the widget class.
* *
* @since 2.8.0 * @since 2.8.0
* @access public * @access public

2
wp-includes/version.php
View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.5-beta4-37064'; $wp_version = '4.5-beta4-37065';
/** /**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.