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

Fix inline documentation syntax in `wp_xmlrpc_server`. 

See #32246.

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


git-svn-id: http://core.svn.wordpress.org/trunk@32561 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2015-05-25 06:25:25 +00:00
parent bd8fafea54
commit 4c37f68b79
10 changed files with 616 additions and 377 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
wp-admin/includes/ajax-actions.php
View File

@ -2902,6 +2902,7 @@ function wp_ajax_update_plugin() {
'oldVersion' => '',
'newVersion' => '',
);
$plugin_data = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin );
if ( $plugin_data['Version'] ) {
$status['oldVersion'] = sprintf( __( 'Version %s' ), $plugin_data['Version'] );
@ -2921,10 +2922,15 @@ function wp_ajax_update_plugin() {
wp_update_plugins();
}
$upgrader = new Plugin_Upgrader( new Automatic_Upgrader_Skin() );
$skin = new Automatic_Upgrader_Skin();
$upgrader = new Plugin_Upgrader( $skin );
$result = $upgrader->bulk_upgrade( array( $plugin ) );
if ( is_array( $result ) ) {
if ( is_array( $result ) && empty( $result[$plugin] ) && is_wp_error( $skin->result ) ) {
$result = $skin->result;
}
if ( is_array( $result ) && !empty( $result[ $plugin ] ) ) {
$plugin_update_data = current( $result );
/*
@ -2939,7 +2945,8 @@ function wp_ajax_update_plugin() {
wp_send_json_error( $status );
}
$plugin_data = get_plugin_data( WP_PLUGIN_DIR . '/' . $plugin );
$plugin_data = get_plugins( '/' . $result[ $plugin ]['destination_name'] );
$plugin_data = reset( $plugin_data );
if ( $plugin_data['Version'] ) {
$status['newVersion'] = sprintf( __( 'Version %s' ), $plugin_data['Version'] );

2
wp-admin/options-discussion.php
View File

@ -66,7 +66,7 @@ include( ABSPATH . 'wp-admin/admin-header.php' );
<br />
<label for="default_ping_status">
<input name="default_ping_status" type="checkbox" id="default_ping_status" value="open" <?php checked('open', get_option('default_ping_status')); ?> />
<?php _e('Allow link notifications from other blogs (pingbacks and trackbacks)'); ?></label>
<?php _e('Allow link notifications from other blogs (pingbacks and trackbacks) on new articles'); ?></label>
<br />
<label for="default_comment_status">
<input name="default_comment_status" type="checkbox" id="default_comment_status" value="open" <?php checked('open', get_option('default_comment_status')); ?> />

9
wp-cron.php
View File

@ -64,7 +64,9 @@ $gmt_time = microtime( true );
if ( isset($keys[0]) && $keys[0] > $gmt_time )
die();
$doing_cron_transient = get_transient( 'doing_cron');
// The cron lock: a unix timestamp from when the cron was spawned.
$doing_cron_transient = get_transient( 'doing_cron' );
// Use global $doing_wp_cron lock otherwise use the GET lock. If no lock, trying grabbing a new lock.
if ( empty( $doing_wp_cron ) ) {
@ -79,7 +81,10 @@ if ( empty( $doing_wp_cron ) ) {
}
}
// Check lock
/*
* The cron lock (a unix timestamp set when the cron was spawned),
* must match $doing_wp_cron (the "key").
*/
if ( $doing_cron_transient != $doing_wp_cron )
return;

430
wp-includes/class-wp-xmlrpc-server.php
View File

@ -200,7 +200,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters.
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $number1 A number to add.
* @type int $number2 A second number to add.
@ -512,7 +512,7 @@ class wp_xmlrpc_server extends IXR_Server {
'option' => 'default_comment_status'
),
'default_ping_status' => array(
'desc' => __( 'Allow link notifications from other blogs (pingbacks and trackbacks)' ),
'desc' => __( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new articles' ),
'readonly' => false,
'option' => 'default_ping_status'
)
@ -534,7 +534,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.6.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type string $username Username.
* @type string $password Password.
@ -1100,33 +1100,47 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @param array $args {
* Method parameters, in this order:
* @link http://en.wikipedia.org/wiki/RSS_enclosure for information on RSS enclosures.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type array $content_struct can contain:
* - post_type (default: 'post')
* - post_status (default: 'draft')
* - post_title
* - post_author
* - post_excerpt
* - post_content
* - post_date_gmt | post_date
* - post_format
* - post_password
* - comment_status - can be 'open' | 'closed'
* - ping_status - can be 'open' | 'closed'
* - sticky
* - post_thumbnail - ID of a media item to use as the post thumbnail/featured image
* - custom_fields - array, with each element containing 'key' and 'value'
* - terms - array, with taxonomy names as keys and arrays of term IDs as values
* - terms_names - array, with taxonomy names as keys and arrays of term names as values
* - enclosure
* - any other fields supported by wp_insert_post()
* @param array $args {
* Method arguments. Note: top-level arguments must be ordered as documented.
*
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type array $content_struct {
* Content struct for adding a new post. See wp_insert_post() for information on
* additional post fields
*
* @type string $post_type Post type. Default 'post'.
* @type string $post_status Post status. Default 'draft'
* @type string $post_title Post title.
* @type int $post_author Post author ID.
* @type string $post_excerpt Post excerpt.
* @type string $post_content Post content.
* @type string $post_date_gmt Post date in GMT.
* @type string $post_date Post date.
* @type string $post_password Post password (20-character limit).
* @type string $comment_status Post comment enabled status. Accepts 'open' or 'closed'.
* @type string $ping_status Post ping status. Accepts 'open' or 'closed'.
* @type bool $sticky Whether the post should be sticky. Automatically false if
* `$post_status` is 'private'.
* @type int $post_thumbnail ID of an image to use as the post thumbnail/featured image.
* @type array $custom_fields Array of meta key/value pairs to add to the post.
* @type array $terms Associative array with taxonomy names as keys and arrays
* of term IDs as values.
* @type array $terms_names Associative array with taxonomy names as keys and arrays
* of term names as values.
* @type array $enclosure {
* Array of feed enclosure data to add to post meta.
*
* @type string $url URL for the feed enclosure.
* @type int $length Size in bytes of the enclosure.
* @type string $type Mime-type for the enclosure.
* }
* }
* }
* @return string|IXR_Error post_id
* @return int|IXR_Error Post ID on success, IXR_Error instance otherwise.
*/
public function wp_newPost( $args ) {
if ( ! $this->minimum_args( $args, 4 ) )
@ -1435,7 +1449,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 3.4.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
@ -1474,11 +1488,13 @@ class wp_xmlrpc_server extends IXR_Server {
}
}
// convert the date field back to IXR form
// Convert the date field back to IXR form.
$post['post_date'] = $this->_convert_date( $post['post_date'] );
// ignore the existing GMT date if it is empty or a non-GMT date was supplied in $content_struct,
// since _insert_post will ignore the non-GMT date if the GMT date is set
/*
* Ignore the existing GMT date if it is empty or a non-GMT date was supplied in $content_struct,
* since _insert_post() will ignore the non-GMT date if the GMT date is set.
*/
if ( $post['post_date_gmt'] == '0000-00-00 00:00:00' || isset( $content_struct['post_date'] ) )
unset( $post['post_date_gmt'] );
else
@ -1499,17 +1515,17 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses wp_delete_post()
* @see wp_delete_post()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type int $post_id
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type int $post_id Post ID.
* }
* @return true|IXR_Error true on success
* @return true|IXR_Error True on success, IXR_Error instance on failure.
*/
public function wp_deletePost( $args ) {
if ( ! $this->minimum_args( $args, 4 ) )
@ -1556,13 +1572,17 @@ class wp_xmlrpc_server extends IXR_Server {
* groups are 'post' (all basic fields), 'taxonomies', 'custom_fields',
* and 'enclosure'.
*
* @uses get_post()
* @param array $args Method parameters. Contains:
* - int $blog_id (unused)
* - string $username
* - string $password
* - int $post_id
* - array $fields optional
* @see get_post()
*
* @param array $args {
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type int $post_id Post ID.
* @type array $fields The subset of post type fields to return.
* }
* @return array|IXR_Error Array contains (based on $fields parameter):
* - 'post_id'
* - 'post_title'
@ -1605,7 +1625,7 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @param array $fields Array of post fields.
* @param array $fields Array of post fields. Default array contains 'post', 'terms', and 'custom_fields'.
* @param string $method Method name.
*/
$fields = apply_filters( 'xmlrpc_default_post_fields', array( 'post', 'terms', 'custom_fields' ), 'wp.getPost' );
@ -1633,23 +1653,21 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* The optional $filter parameter modifies the query used to retrieve posts.
* Accepted keys are 'post_type', 'post_status', 'number', 'offset',
* 'orderby', and 'order'.
* @see wp_get_recent_posts()
* @see wp_getPost() for more on `$fields`
* @see get_posts() for more on `$filter` values
*
* The optional $fields parameter specifies what fields will be included
* in the response array.
* @param array $args {
* Method arguments. Note: arguments must be ordered as documented.
*
* @uses wp_get_recent_posts()
* @see wp_getPost() for more on $fields
* @see get_posts() for more on $filter values
*
* @param array $args Method parameters. Contains:
* - int $blog_id (unused)
* - string $username
* - string $password
* - array $filter optional
* - array $fields optional
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type array $filter Optional. Modifies the query used to retrieve posts. Accepts 'post_type',
* 'post_status', 'number', 'offset', 'orderby', and 'order'.
* Default empty array.
* @type array $fields Optional. The subset of post type fields to return in the response array.
* }
* @return array|IXR_Error Array contains a collection of posts.
*/
public function wp_getPosts( $args ) {
@ -1715,7 +1733,7 @@ class wp_xmlrpc_server extends IXR_Server {
if ( ! $posts_list )
return array();
// holds all the posts data
// Holds all the posts data.
$struct = array();
foreach ( $posts_list as $post ) {
@ -1733,20 +1751,19 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses wp_insert_term()
* @param array $args Method parameters. Contains:
* - int $blog_id (unused)
* - string $username
* - string $password
* - array $content_struct
* The $content_struct must contain:
* - 'name'
* - 'taxonomy'
* Also, it can optionally contain:
* - 'parent'
* - 'description'
* - 'slug'
* @return string|IXR_Error term_id
* @see wp_insert_term()
*
* @param array $args {
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type array $content_struct Content struct for adding a new term. The struct must contain
* the term 'name' and 'taxonomy'. Optional accepted values include
* 'parent', 'description', and 'slug'.
* }
* @return int|IXR_Error The term ID on success, or an IXR_Error object on failure.
*/
public function wp_newTerm( $args ) {
if ( ! $this->minimum_args( $args, 4 ) )
@ -1819,21 +1836,20 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses wp_update_term()
* @param array $args Method parameters. Contains:
* - int $blog_id (unused)
* - string $username
* - string $password
* - string $term_id
* - array $content_struct
* The $content_struct must contain:
* - 'taxonomy'
* Also, it can optionally contain:
* - 'name'
* - 'parent'
* - 'description'
* - 'slug'
* @return true|IXR_Error True, on success.
* @see wp_update_term()
*
* @param array $args {
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type int $term_id Term ID.
* @type array $content_struct Content struct for editing a term. The struct must contain the
* term ''taxonomy'. Optional accepted values include 'name', 'parent',
* 'description', and 'slug'.
* }
* @return true|IXR_Error True on success, IXR_Error instance on failure.
*/
public function wp_editTerm( $args ) {
if ( ! $this->minimum_args( $args, 5 ) )
@ -1918,18 +1934,18 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses wp_delete_term()
* @see wp_delete_term()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type string $taxnomy_name
* @type string $term_id
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type string $taxnomy_name Taxonomy name.
* @type int $term_id Term ID.
* }
* @return bool|IXR_Error If it suceeded true else a reason why not
* @return bool|IXR_Error True on success, IXR_Error instance on failure.
*/
public function wp_deleteTerm( $args ) {
if ( ! $this->minimum_args( $args, 5 ) )
@ -1980,18 +1996,18 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses get_term()
* @see get_term()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type string $taxnomy
* @type string $term_id
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type string $taxnomy Taxonomy name.
* @type string $term_id Term ID.
* }
* @return array|IXR_Error Array contains:
* @return array|IXR_Error IXR_Error on failure, array on success, containing:
* - 'term_id'
* - 'name'
* - 'slug'
@ -2046,18 +2062,19 @@ class wp_xmlrpc_server extends IXR_Server {
* The optional $filter parameter modifies the query used to retrieve terms.
* Accepted keys are 'number', 'offset', 'orderby', 'order', 'hide_empty', and 'search'.
*
* @uses get_terms()
* @see get_terms()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type string $taxnomy
* @type array $filter (optional)
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type string $taxnomy Taxonomy name.
* @type array $filter Optional. Modifies the query used to retrieve posts. Accepts 'number',
* 'offset', 'orderby', 'order', 'hide_empty', and 'search'. Default empty array.
* }
* @return array|IXR_Error terms
* @return array|IXR_Error An associative array of terms data on success, IXR_Error instance otherwise.
*/
public function wp_getTerms( $args ) {
if ( ! $this->minimum_args( $args, 4 ) )
@ -2126,18 +2143,20 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses get_taxonomy()
* @see get_taxonomy()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type string $taxnomy
* @type array $fields (optional)
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type string $taxnomy Taxonomy name.
* @type array $fields Optional. Array of taxonomy fields to limit to in the return.
* Accepts 'labels', 'cap', 'menu', and 'object_type'.
* Default empty array.
* }
* @return array|IXR_Error (@see get_taxonomy())
* @return array|IXR_Error An array of taxonomy data on success, IXR_Error instance otherwise.
*/
public function wp_getTaxonomy( $args ) {
if ( ! $this->minimum_args( $args, 4 ) )
@ -2185,16 +2204,19 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses get_taxonomies()
* @see get_taxonomies()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type int $blog_id Blog ID (unused).
* @type string $username Username.
* @type string $password Password.
* @type array $filter Optional. An array of arguments for retrieving taxonomies.
* @type array $fields Optional. The subset of taxonomy fields to return.
* }
* @return array taxonomies
* @return array|IXR_Error An associative array of taxonomy data with returned fields determined
* by `$fields`, or an IXR_Error instance on failure.
*/
public function wp_getTaxonomies( $args ) {
if ( ! $this->minimum_args( $args, 3 ) )
@ -2249,7 +2271,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @uses get_userdata()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2326,7 +2348,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @see wp_getUser() for more on $fields and return values
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2401,7 +2423,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @uses get_userdata()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2446,7 +2468,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @uses wp_update_user()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2524,7 +2546,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $page_id
@ -2570,7 +2592,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2618,9 +2640,10 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 2.2.0
*
* @see wp_xmlrpc_server::mw_newPost()
*
* @param array $args {
* See {@link wp_xmlrpc_server::mw_newPost()}
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2653,7 +2676,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2709,7 +2732,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $page_id
@ -2767,7 +2790,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @global wpdb $wpdb
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2825,7 +2848,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2866,7 +2889,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2914,7 +2937,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -2990,7 +3013,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3038,7 +3061,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.2.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3083,7 +3106,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3131,7 +3154,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3194,7 +3217,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3254,12 +3277,12 @@ class wp_xmlrpc_server extends IXR_Server {
* - 'author_email'
* - 'content'
* - 'date_created_gmt'
* - 'status'. Common statuses are 'approve', 'hold', 'spam'. See {@link get_comment_statuses()} for more details
* - 'status'. Common statuses are 'approve', 'hold', 'spam'. See get_comment_statuses() for more details
*
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3267,12 +3290,6 @@ class wp_xmlrpc_server extends IXR_Server {
* @type int $comment_ID
* @type array $content_struct
* }
* @param array $args Contains:
* - blog_id (unused)
* - username
* - password
* - comment_id
* - content_struct
* @return true|IXR_Error True, on success.
*/
public function wp_editComment( $args ) {
@ -3356,7 +3373,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3467,7 +3484,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.7.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3499,7 +3516,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3539,7 +3556,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3571,7 +3588,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3603,7 +3620,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.6.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3635,7 +3652,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.6.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3695,7 +3712,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 2.6.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3739,7 +3756,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 3.1.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3788,21 +3805,21 @@ class wp_xmlrpc_server extends IXR_Server {
*
* The defaults are as follows:
* - 'number' - Default is 5. Total number of media items to retrieve.
* - 'offset' - Default is 0. See {@link WP_Query::query()} for more.
* - 'offset' - Default is 0. See WP_Query::query() for more.
* - 'parent_id' - Default is ''. The post where the media item is attached. Empty string shows all media items. 0 shows unattached media items.
* - 'mime_type' - Default is ''. Filter by mime type (e.g., 'image/jpeg', 'application/pdf')
*
* @since 3.1.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
* @type string $password
* @type array $struct
* }
* @return array|IXR_Error Contains a collection of media items. See {@link wp_xmlrpc_server::wp_getMediaItem()} for a description of each item contents
* @return array|IXR_Error Contains a collection of media items. See wp_xmlrpc_server::wp_getMediaItem() for a description of each item contents
*/
public function wp_getMediaLibrary($args) {
$this->escape($args);
@ -3841,7 +3858,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 3.1.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3889,9 +3906,10 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses get_post_type_object()
* @see get_post_type_object()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -3956,9 +3974,10 @@ class wp_xmlrpc_server extends IXR_Server {
*
* @since 3.4.0
*
* @uses get_post_types()
* @see get_post_types()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4017,7 +4036,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @see wp_getPost() for more on $fields
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4096,7 +4115,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @uses wp_restore_post_revision()
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4154,7 +4173,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4229,7 +4248,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4269,7 +4288,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $post_ID
@ -4320,7 +4339,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type string $appkey (unused)
* @type int $blog_id (unused)
@ -4409,7 +4428,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type string $appkey (unused)
* @type int $blog_id (unused)
@ -4479,7 +4498,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $post_ID
@ -4554,7 +4573,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $post_ID
@ -4634,7 +4653,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -4973,7 +4992,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5000,9 +5019,10 @@ class wp_xmlrpc_server extends IXR_Server {
$postdata = get_post( $post_ID, ARRAY_A );
// If there is no post data for the give post id, stop
// now and return an error. Other wise a new post will be
// created (which was the old behavior).
/*
* If there is no post data for the give post id, stop now and return an error.
* Otherwise a new post will be created (which was the old behavior).
*/
if ( ! $postdata || empty( $postdata[ 'ID' ] ) )
return new IXR_Error( 404, __( 'Invalid post ID.' ) );
@ -5195,9 +5215,9 @@ class wp_xmlrpc_server extends IXR_Server {
$to_ping = implode(' ', $to_ping);
}
// Do some timestamp voodoo
// Do some timestamp voodoo.
if ( !empty( $content_struct['date_created_gmt'] ) )
// We know this is supposed to be GMT, so we're going to slap that Z on there by force
// We know this is supposed to be GMT, so we're going to slap that Z on there by force.
$dateCreated = rtrim( $content_struct['date_created_gmt']->getIso(), 'Z' ) . 'Z';
elseif ( !empty( $content_struct['dateCreated']) )
$dateCreated = $content_struct['dateCreated']->getIso();
@ -5210,7 +5230,7 @@ class wp_xmlrpc_server extends IXR_Server {
$post_date_gmt = $postdata['post_date_gmt'];
}
// We've got all the data -- post it:
// We've got all the data -- post it.
$newpost = compact('ID', 'post_content', 'post_title', 'post_category', 'post_status', 'post_excerpt', 'comment_status', 'ping_status', 'post_date', 'post_date_gmt', 'to_ping', 'post_name', 'post_password', 'post_parent', 'menu_order', 'post_author', 'tags_input', 'page_template');
$result = wp_update_post($newpost, true);
@ -5232,7 +5252,8 @@ class wp_xmlrpc_server extends IXR_Server {
$this->set_custom_fields($post_ID, $content_struct['custom_fields']);
if ( isset ( $content_struct['wp_post_thumbnail'] ) ) {
// empty value deletes, non-empty value adds/updates
// Empty value deletes, non-empty value adds/updates.
if ( empty( $content_struct['wp_post_thumbnail'] ) ) {
delete_post_thumbnail( $post_ID );
} else {
@ -5242,14 +5263,13 @@ class wp_xmlrpc_server extends IXR_Server {
unset( $content_struct['wp_post_thumbnail'] );
}
// Handle enclosures
// Handle enclosures.
$thisEnclosure = isset($content_struct['enclosure']) ? $content_struct['enclosure'] : null;
$this->add_enclosure_if_new($post_ID, $thisEnclosure);
$this->attach_uploads( $ID, $post_content );
// Handle post formats if assigned, validation is handled
// earlier in this function
// Handle post formats if assigned, validation is handled earlier in this function.
if ( isset( $content_struct['wp_post_format'] ) )
set_post_format( $post_ID, $content_struct['wp_post_format'] );
@ -5272,7 +5292,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type int $post_ID
@ -5403,7 +5423,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5521,7 +5541,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5576,7 +5596,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @global wpdb $wpdb
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5696,7 +5716,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5756,7 +5776,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $blog_id (unused)
* @type string $username
@ -5800,7 +5820,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $post_ID
* @type string $username
@ -5849,7 +5869,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $post_ID
* @type string $username
@ -5969,7 +5989,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @since 1.5.0
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type int $post_ID
* @type string $username
@ -6020,7 +6040,7 @@ class wp_xmlrpc_server extends IXR_Server {
* @global string $wp_version
*
* @param array $args {
* Method parameters, in this order:
* Method arguments. Note: arguments must be ordered as documented.
*
* @type string $pagelinkedfrom
* @type string $pagelinkedto

47
wp-includes/comment.php
View File

@ -161,7 +161,8 @@ function get_approved_comments( $post_id, $args = array() ) {
*
* @since 2.0.0
*
* @global wpdb $wpdb WordPress database abstraction object.
* @global wpdb $wpdb WordPress database abstraction object.
* @global object $comment
*
* @param object|string|int $comment Comment to retrieve.
* @param string $output Optional. OBJECT or ARRAY_A or ARRAY_N constants.
@ -297,7 +298,7 @@ class WP_Comment_Query {
*
* @param callable $name Method to call.
* @param array $arguments Arguments to pass when calling.
* @return mixed|bool Return value of the callback, false otherwise.
* @return mixed|false Return value of the callback, false otherwise.
*/
public function __call( $name, $arguments ) {
if ( 'get_search_sql' === $name ) {
@ -377,7 +378,6 @@ class WP_Comment_Query {
* @type array $type__not_in Exclude comments from a given array of comment types. Default empty.
* @type int $user_id Include comments for a specific user ID. Default empty.
* }
* @return WP_Comment_Query WP_Comment_Query instance.
*/
public function __construct( $query = '' ) {
$this->query_var_defaults = array(
@ -469,7 +469,7 @@ class WP_Comment_Query {
*
* @global wpdb $wpdb WordPress database abstraction object.
*
* @return array The list of comments.
* @return int|array The list of comments.
*/
public function get_comments() {
global $wpdb;
@ -901,8 +901,10 @@ class WP_Comment_Query {
/**
* Used internally to generate an SQL string for searching across multiple columns
*
* @access protected
* @since 3.1.0
* @access protected
*
* @global wpdb $wpdb
*
* @param string $string
* @param array $cols
@ -930,7 +932,7 @@ class WP_Comment_Query {
* @global wpdb $wpdb WordPress database abstraction object.
*
* @param string $orderby Alias for the field to order by.
* @return string|bool Value to used in the ORDER clause. False otherwise.
* @return string|false Value to used in the ORDER clause. False otherwise.
*/
protected function parse_orderby( $orderby ) {
global $wpdb;
@ -1032,6 +1034,7 @@ function get_comment_statuses() {
* @since 1.5.0
*
* @global wpdb $wpdb WordPress database abstraction object.
* @staticvar array $cache_lastcommentmodified
*
* @param string $timezone Which timezone to use in reference to 'gmt', 'blog',
* or 'server' locations.
@ -1294,7 +1297,7 @@ function sanitize_comment_cookies() {
* @global wpdb $wpdb WordPress database abstraction object.
*
* @param array $commentdata Contains information on the comment
* @return mixed Signifies the approval status (0|1|'spam')
* @return int|string Signifies the approval status (0|1|'spam')
*/
function wp_allow_comment( $commentdata ) {
global $wpdb;
@ -1482,6 +1485,8 @@ function separate_comments(&$comments) {
*
* @uses Walker_Comment
*
* @global WP_Query $wp_query
*
* @param array $comments Optional array of comment objects. Defaults to $wp_query->comments
* @param int $per_page Optional comments per page.
* @param boolean $threaded Optional control over flat or threaded comments.
@ -1527,6 +1532,8 @@ function get_comment_pages_count( $comments = null, $per_page = null, $threaded
*
* @since 2.7.0
*
* @global wpdb $wpdb
*
* @param int $comment_ID Comment ID.
* @param array $args Optional args.
* @return int|null Comment page number or null on error.
@ -1649,8 +1656,10 @@ function wp_blacklist_check($author, $email, $url, $comment, $user_ip, $user_age
*
* @since 2.5.0
*
* @global wpdb $wpdb
*
* @param int $post_id Optional. Post ID.
* @return object Comment stats.
* @return object|array Comment stats.
*/
function wp_count_comments( $post_id = 0 ) {
global $wpdb;
@ -2111,7 +2120,7 @@ function wp_get_current_commenter() {
* @type string $comment_type Comment type. Default empty.
* @type int $user_id ID of the user who submitted the comment. Default 0.
* }
* @return int|bool The new comment's ID on success, false on failure.
* @return int|false The new comment's ID on success, false on failure.
*/
function wp_insert_comment( $commentdata ) {
global $wpdb;
@ -2260,6 +2269,8 @@ function wp_throttle_comment_flood($block, $time_lastcomment, $time_newcomment)
*
* @see wp_insert_comment()
*
* @global wpdb $wpdb
*
* @param array $commentdata Contains information on the comment. See wp_insert_comment()
* for information on accepted arguments.
* @return int|false The ID of the comment on success, false on failure.
@ -2361,6 +2372,8 @@ function wp_new_comment( $commentdata ) {
*
* @since 1.0.0
*
* global wpdb $wpdb
*
* @param int $comment_id Comment ID.
* @param string $comment_status New comment status, either 'hold', 'approve', 'spam', or 'trash'.
* @param bool $wp_error Whether to return a WP_Error object if there is a failure. Default is false.
@ -2547,7 +2560,7 @@ function wp_defer_comment_counting($defer=null) {
*
* @param int $post_id Post ID
* @param bool $do_deferred Whether to process previously deferred post comment counts
* @return bool|null True on success, false on failure
* @return bool|void True on success, false on failure
*/
function wp_update_comment_count($post_id, $do_deferred=false) {
static $_deferred = array();
@ -2790,7 +2803,8 @@ function generic_ping( $post_id = 0 ) {
* Pings back the links found in a post.
*
* @since 0.71
* @uses $wp_version
*
* @global string $wp_version
*
* @param string $content Post content to check for links.
* @param int $post_ID Post ID.
@ -2903,7 +2917,7 @@ function privacy_ping_filter($sites) {
* @param string $title Title of post.
* @param string $excerpt Excerpt of post.
* @param int $ID Post ID.
* @return mixed Database query from update.
* @return int|false|void Database query from update.
*/
function trackback($trackback_url, $title, $excerpt, $ID) {
global $wpdb;
@ -2933,7 +2947,8 @@ function trackback($trackback_url, $title, $excerpt, $ID) {
* Send a pingback.
*
* @since 1.2.0
* @uses $wp_version
*
* @global string $wp_version
*
* @param string $server Host of blog to connect to.
* @param string $path Path to send the ping.
@ -3030,9 +3045,9 @@ function update_comment_cache($comments) {
* @access private
* @since 2.7.0
*
* @param object $posts Post data object.
* @param object $query Query object.
* @return object
* @param WP_Post $posts Post data object.
* @param WP_Query $query Query object.
* @return array
*/
function _close_comments_for_old_posts( $posts, $query ) {
if ( empty( $posts ) || ! $query->is_singular() || ! get_option( 'close_comments_for_old_posts' ) )

27
wp-includes/cron.php
View File

@ -18,6 +18,7 @@
* @param int $timestamp Timestamp for when to run the event.
* @param string $hook Action hook to execute when cron is run.
* @param array $args Optional. Arguments to pass to the hook's callback function.
* @return void|false
*/
function wp_schedule_single_event( $timestamp, $hook, $args = array()) {
// don't schedule a duplicate if there's already an identical event due within 10 minutes of it
@ -66,7 +67,7 @@ function wp_schedule_single_event( $timestamp, $hook, $args = array()) {
* @param string $recurrence How often the event should recur.
* @param string $hook Action hook to execute when cron is run.
* @param array $args Optional. Arguments to pass to the hook's callback function.
* @return false|null False on failure, null when complete with scheduling event.
* @return false|void False when does not schedule event.
*/
function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array()) {
$crons = _get_cron_array();
@ -99,7 +100,7 @@ function wp_schedule_event( $timestamp, $recurrence, $hook, $args = array()) {
* @param string $recurrence How often the event should recur.
* @param string $hook Action hook to execute when cron is run.
* @param array $args Optional. Arguments to pass to the hook's callback function.
* @return false|null False on failure. Null when event is rescheduled.
* @return false|void False when does not schedule event.
*/
function wp_reschedule_event( $timestamp, $recurrence, $hook, $args = array() ) {
$crons = _get_cron_array();
@ -195,7 +196,7 @@ function wp_clear_scheduled_hook( $hook, $args = array() ) {
*
* @param string $hook Action hook to execute when cron is run.
* @param array $args Optional. Arguments to pass to the hook's callback function.
* @return bool|int The UNIX timestamp of the next time the scheduled event will occur.
* @return false|int The UNIX timestamp of the next time the scheduled event will occur.
*/
function wp_next_scheduled( $hook, $args = array() ) {
$crons = _get_cron_array();
@ -213,11 +214,8 @@ function wp_next_scheduled( $hook, $args = array() ) {
* Send request to run cron through HTTP request that doesn't halt page loading.
*
* @since 2.1.0
*
* @return null Cron could not be spawned, because it is not needed to run.
*/
function spawn_cron( $gmt_time = 0 ) {
if ( ! $gmt_time )
$gmt_time = microtime( true );
@ -225,9 +223,12 @@ function spawn_cron( $gmt_time = 0 ) {
return;
/*
* multiple processes on multiple web servers can run this code concurrently
* try to make this as atomic as possible by setting doing_cron switch
*/
* Get the cron lock, which is a unix timestamp of when the last cron was spawned
* and has not finished running.
*
* Multiple processes on multiple web servers can run this code concurrently,
* this lock attempts to make spawning as atomic as possible.
*/
$lock = get_transient('doing_cron');
if ( $lock > $gmt_time + 10 * MINUTE_IN_SECONDS )
@ -266,6 +267,7 @@ function spawn_cron( $gmt_time = 0 ) {
return;
}
// Set the cron lock with the current unix timestamp, when the cron is being spawned.
$doing_wp_cron = sprintf( '%.22F', $gmt_time );
set_transient( 'doing_cron', $doing_wp_cron );
@ -306,11 +308,8 @@ function spawn_cron( $gmt_time = 0 ) {
* Run scheduled callbacks or spawn cron for all scheduled events.
*
* @since 2.1.0
*
* @return null When doesn't need to run Cron.
*/
function wp_cron() {
// Prevent infinite loops caused by lack of wp-cron.php
if ( strpos($_SERVER['REQUEST_URI'], '/wp-cron.php') !== false || ( defined('DISABLE_WP_CRON') && DISABLE_WP_CRON ) )
return;
@ -388,7 +387,7 @@ function wp_get_schedules() {
*
* @param string $hook Action hook to execute when cron is run.
* @param array $args Optional. Arguments to pass to the hook's callback function.
* @return string|bool False, if no schedule. Schedule on success.
* @return string|false False, if no schedule. Schedule on success.
*/
function wp_get_schedule($hook, $args = array()) {
$crons = _get_cron_array();
@ -412,7 +411,7 @@ function wp_get_schedule($hook, $args = array()) {
* @since 2.1.0
* @access private
*
* @return array CRON info array.
* @return false|array CRON info array.
*/
function _get_cron_array() {
$cron = get_option('cron');

3
wp-includes/default-filters.php
View File

@ -382,6 +382,9 @@ add_action( 'customize_controls_enqueue_scripts', 'wp_plupload_default_settings'
// Nav menu
add_filter( 'nav_menu_item_id', '_nav_menu_item_id_use_once', 10, 2 );
// Widgets
add_action( 'init', 'wp_widgets_init', 1 );
// Admin Bar
// Don't remove. Wrong way to disable.
add_action( 'template_redirect', '_wp_admin_bar_init', 0 );

183
wp-includes/default-widgets.php
View File

@ -18,6 +18,10 @@ class WP_Widget_Pages extends WP_Widget {
parent::__construct('pages', __('Pages'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/**
@ -67,6 +71,11 @@ class WP_Widget_Pages extends WP_Widget {
}
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -81,6 +90,9 @@ class WP_Widget_Pages extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
//Defaults
$instance = wp_parse_args( (array) $instance, array( 'sortby' => 'post_title', 'title' => '', 'exclude' => '') );
@ -118,8 +130,11 @@ class WP_Widget_Links extends WP_Widget {
parent::__construct('links', __('Links'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
$show_description = isset($instance['description']) ? $instance['description'] : false;
$show_name = isset($instance['name']) ? $instance['name'] : false;
$show_rating = isset($instance['rating']) ? $instance['rating'] : false;
@ -151,6 +166,11 @@ class WP_Widget_Links extends WP_Widget {
) ) );
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$new_instance = (array) $new_instance;
$instance = array( 'images' => 0, 'name' => 0, 'description' => 0, 'rating' => 0 );
@ -169,6 +189,9 @@ class WP_Widget_Links extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
//Defaults
@ -227,8 +250,11 @@ class WP_Widget_Search extends WP_Widget {
parent::__construct( 'search', _x( 'Search', 'Search widget' ), $widget_ops );
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
@ -243,6 +269,9 @@ class WP_Widget_Search extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $instance
*/
public function form( $instance ) {
$instance = wp_parse_args( (array) $instance, array( 'title' => '') );
$title = $instance['title'];
@ -251,6 +280,11 @@ class WP_Widget_Search extends WP_Widget {
<?php
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$new_instance = wp_parse_args((array) $new_instance, array( 'title' => ''));
@ -272,6 +306,10 @@ class WP_Widget_Archives extends WP_Widget {
parent::__construct('archives', __('Archives'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
$c = ! empty( $instance['count'] ) ? '1' : '0';
$d = ! empty( $instance['dropdown'] ) ? '1' : '0';
@ -354,6 +392,11 @@ class WP_Widget_Archives extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$new_instance = wp_parse_args( (array) $new_instance, array( 'title' => '', 'count' => 0, 'dropdown' => '') );
@ -364,6 +407,9 @@ class WP_Widget_Archives extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$instance = wp_parse_args( (array) $instance, array( 'title' => '', 'count' => 0, 'dropdown' => '') );
$title = strip_tags($instance['title']);
@ -394,8 +440,11 @@ class WP_Widget_Meta extends WP_Widget {
parent::__construct('meta', __('Meta'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty($instance['title']) ? __( 'Meta' ) : $instance['title'], $instance, $this->id_base );
@ -430,6 +479,11 @@ class WP_Widget_Meta extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -437,6 +491,9 @@ class WP_Widget_Meta extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$instance = wp_parse_args( (array) $instance, array( 'title' => '' ) );
$title = strip_tags($instance['title']);
@ -458,8 +515,11 @@ class WP_Widget_Calendar extends WP_Widget {
parent::__construct('calendar', __('Calendar'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
@ -473,6 +533,11 @@ class WP_Widget_Calendar extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -480,6 +545,9 @@ class WP_Widget_Calendar extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$instance = wp_parse_args( (array) $instance, array( 'title' => '' ) );
$title = strip_tags($instance['title']);
@ -503,8 +571,11 @@ class WP_Widget_Text extends WP_Widget {
parent::__construct('text', __('Text'), $widget_ops, $control_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? '' : $instance['title'], $instance, $this->id_base );
@ -526,6 +597,11 @@ class WP_Widget_Text extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -537,6 +613,9 @@ class WP_Widget_Text extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$instance = wp_parse_args( (array) $instance, array( 'title' => '', 'text' => '' ) );
$title = strip_tags($instance['title']);
@ -564,8 +643,11 @@ class WP_Widget_Categories extends WP_Widget {
parent::__construct('categories', __('Categories'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
/** This filter is documented in wp-includes/default-widgets.php */
$title = apply_filters( 'widget_title', empty( $instance['title'] ) ? __( 'Categories' ) : $instance['title'], $instance, $this->id_base );
@ -644,6 +726,11 @@ class WP_Widget_Categories extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -654,6 +741,9 @@ class WP_Widget_Categories extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
//Defaults
$instance = wp_parse_args( (array) $instance, array( 'title' => '') );
@ -695,7 +785,11 @@ class WP_Widget_Recent_Posts extends WP_Widget {
add_action( 'switch_theme', array($this, 'flush_widget_cache') );
}
public function widget($args, $instance) {
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
$cache = array();
if ( ! $this->is_preview() ) {
$cache = wp_cache_get( 'widget_recent_posts', 'widget' );
@ -773,6 +867,11 @@ class WP_Widget_Recent_Posts extends WP_Widget {
}
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -791,6 +890,9 @@ class WP_Widget_Recent_Posts extends WP_Widget {
wp_cache_delete('widget_recent_posts', 'widget');
}
/**
* @param array $instance
*/
public function form( $instance ) {
$title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
$number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5;
@ -829,7 +931,6 @@ class WP_Widget_Recent_Comments extends WP_Widget {
}
public function recent_comments_style() {
/**
* Filter the Recent Comments default widget styles.
*
@ -850,6 +951,13 @@ class WP_Widget_Recent_Comments extends WP_Widget {
wp_cache_delete('widget_recent_comments', 'widget');
}
/**
* @global array $comments
* @global object $comment
*
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
global $comments, $comment;
@ -927,6 +1035,11 @@ class WP_Widget_Recent_Comments extends WP_Widget {
}
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = $old_instance;
$instance['title'] = strip_tags($new_instance['title']);
@ -940,6 +1053,9 @@ class WP_Widget_Recent_Comments extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$title = isset( $instance['title'] ) ? esc_attr( $instance['title'] ) : '';
$number = isset( $instance['number'] ) ? absint( $instance['number'] ) : 5;
@ -966,8 +1082,11 @@ class WP_Widget_RSS extends WP_Widget {
parent::__construct( 'rss', __('RSS'), $widget_ops, $control_ops );
}
public function widget($args, $instance) {
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
if ( isset($instance['error']) && $instance['error'] )
return;
@ -1019,15 +1138,23 @@ class WP_Widget_RSS extends WP_Widget {
unset($rss);
}
public function update($new_instance, $old_instance) {
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$testurl = ( isset( $new_instance['url'] ) && ( !isset( $old_instance['url'] ) || ( $new_instance['url'] != $old_instance['url'] ) ) );
return wp_widget_rss_process( $new_instance, $testurl );
}
public function form($instance) {
if ( empty($instance) )
/**
* @param array $instance
*/
public function form( $instance ) {
if ( empty( $instance ) ) {
$instance = array( 'title' => '', 'url' => '', 'items' => 10, 'error' => false, 'show_summary' => 0, 'show_author' => 0, 'show_date' => 0 );
}
$instance['number'] = $this->number;
wp_widget_rss_form( $instance );
@ -1261,6 +1388,10 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
parent::__construct('tag_cloud', __('Tag Cloud'), $widget_ops);
}
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
$current_taxonomy = $this->_get_current_taxonomy($instance);
if ( !empty($instance['title']) ) {
@ -1301,6 +1432,11 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = array();
$instance['title'] = strip_tags(stripslashes($new_instance['title']));
@ -1308,6 +1444,9 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$current_taxonomy = $this->_get_current_taxonomy($instance);
?>
@ -1345,7 +1484,11 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
parent::__construct( 'nav_menu', __('Custom Menu'), $widget_ops );
}
public function widget($args, $instance) {
/**
* @param array $args
* @param array $instance
*/
public function widget( $args, $instance ) {
// Get menu
$nav_menu = ! empty( $instance['nav_menu'] ) ? wp_get_nav_menu_object( $instance['nav_menu'] ) : false;
@ -1384,6 +1527,11 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
echo $args['after_widget'];
}
/**
* @param array $new_instance
* @param array $old_instance
* @return array
*/
public function update( $new_instance, $old_instance ) {
$instance = array();
if ( ! empty( $new_instance['title'] ) ) {
@ -1395,6 +1543,9 @@ class WP_Widget_Tag_Cloud extends WP_Widget {
return $instance;
}
/**
* @param array $instance
*/
public function form( $instance ) {
$title = isset( $instance['title'] ) ? $instance['title'] : '';
$nav_menu = isset( $instance['nav_menu'] ) ? $instance['nav_menu'] : '';
@ -1475,5 +1626,3 @@ function wp_widgets_init() {
*/
do_action( 'widgets_init' );
}
add_action('init', 'wp_widgets_init', 1);

277
wp-includes/formatting.php
View File

@ -21,13 +21,22 @@
* Code within certain html blocks are skipped.
*
* @since 0.71
* @uses $wp_cockneyreplace Array of formatted entities for certain common phrases
*
* @global array $wp_cockneyreplace Array of formatted entities for certain common phrases
* @global array $shortcode_tags
* @staticvar array $static_characters
* @staticvar array $static_replacements
* @staticvar array $dynamic_characters
* @staticvar array $dynamic_replacements
* @staticvar array $default_no_texturize_tags
* @staticvar array $default_no_texturize_shortcodes
* @staticvar bool $run_texturize
*
* @param string $text The text to be formatted
* @param bool $reset Set to true for unit testing. Translated patterns will reset.
* @param bool $reset Set to true for unit testing. Translated patterns will reset.
* @return string The string replaced with html entities
*/
function wptexturize($text, $reset = false) {
function wptexturize( $text, $reset = false ) {
global $wp_cockneyreplace, $shortcode_tags;
static $static_characters, $static_replacements, $dynamic_characters, $dynamic_replacements,
$default_no_texturize_tags, $default_no_texturize_shortcodes, $run_texturize = true;
@ -297,9 +306,7 @@ function wptexturize($text, $reset = false) {
$text = implode( '', $textarr );
// Replace each & with &#038; unless it already looks like an entity.
$text = preg_replace('/&(?!#(?:\d+|x[a-f0-9]+);|[a-z1-4]{1,8};)/i', '&#038;', $text);
return $text;
return preg_replace( '/&(?!#(?:\d+|x[a-f0-9]+);|[a-z1-4]{1,8};)/i', '&#038;', $text );
}
/**
@ -313,10 +320,10 @@ function wptexturize($text, $reset = false) {
* @access private
*
* @param string $text Text to check. Must be a tag like `<html>` or `[shortcode]`.
* @param array $stack List of open tag elements.
* @param array $disabled_elements The tag names to match against. Spaces are not allowed in tag names.
* @param array $stack List of open tag elements.
* @param array $disabled_elements The tag names to match against. Spaces are not allowed in tag names.
*/
function _wptexturize_pushpop_element($text, &$stack, $disabled_elements) {
function _wptexturize_pushpop_element( $text, &$stack, $disabled_elements ) {
// Is it an opening tag or closing tag?
if ( '/' !== $text[1] ) {
$opening_tag = true;
@ -370,7 +377,7 @@ function _wptexturize_pushpop_element($text, &$stack, $disabled_elements) {
* after paragraphing. Default true.
* @return string Text which has been converted into correct paragraph tags.
*/
function wpautop($pee, $br = true) {
function wpautop( $pee, $br = true ) {
$pre_tags = array();
if ( trim($pee) === '' )
@ -419,7 +426,7 @@ function wpautop($pee, $br = true) {
$pee = preg_replace('!(</' . $allblocks . '>)!', "$1\n\n", $pee);
// Standardize newline characters to "\n".
$pee = str_replace(array("\r\n", "\r"), "\n", $pee);
$pee = str_replace(array("\r\n", "\r"), "\n", $pee);
// Collapse line breaks before and after <option> elements so they don't get autop'd.
if ( strpos( $pee, '<option' ) !== false ) {
@ -462,24 +469,24 @@ function wpautop($pee, $br = true) {
}
// Under certain strange conditions it could create a P of entirely whitespace.
$pee = preg_replace('|<p>\s*</p>|', '', $pee);
$pee = preg_replace('|<p>\s*</p>|', '', $pee);
// Add a closing <p> inside <div>, <address>, or <form> tag if missing.
$pee = preg_replace('!<p>([^<]+)</(div|address|form)>!', "<p>$1</p></$2>", $pee);
// If an opening or closing block element tag is wrapped in a <p>, unwrap it.
$pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee);
$pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee);
// In some cases <li> may get wrapped in <p>, fix them.
$pee = preg_replace("|<p>(<li.+?)</p>|", "$1", $pee);
$pee = preg_replace("|<p>(<li.+?)</p>|", "$1", $pee);
// If a <blockquote> is wrapped with a <p>, move it inside the <blockquote>.
$pee = preg_replace('|<p><blockquote([^>]*)>|i', "<blockquote$1><p>", $pee);
$pee = str_replace('</blockquote></p>', '</p></blockquote>', $pee);
// If an opening or closing block element tag is preceded by an opening <p> tag, remove it.
$pee = preg_replace('!<p>\s*(</?' . $allblocks . '[^>]*>)!', "$1", $pee);
// If an opening or closing block element tag is followed by a closing <p> tag, remove it.
$pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*</p>!', "$1", $pee);
@ -489,7 +496,7 @@ function wpautop($pee, $br = true) {
$pee = preg_replace_callback('/<(script|style).*?<\/\\1>/s', '_autop_newline_preservation_helper', $pee);
// Replace any new line characters that aren't preceded by a <br /> with a <br />.
$pee = preg_replace('|(?<!<br />)\s*\n|', "<br />\n", $pee);
$pee = preg_replace('|(?<!<br />)\s*\n|', "<br />\n", $pee);
// Replace newline placeholders with newlines.
$pee = str_replace('<WPPreserveNewline />', "\n", $pee);
@ -497,7 +504,7 @@ function wpautop($pee, $br = true) {
// If a <br /> tag is after an opening or closing block tag, remove it.
$pee = preg_replace('!(</?' . $allblocks . '[^>]*>)\s*<br />!', "$1", $pee);
// If a <br /> tag is before a subset of opening or closing block tags, remove it.
$pee = preg_replace('!<br />(\s*</?(?:p|li|div|dl|dd|dt|th|pre|td|ul|ol)[^>]*>)!', '$1', $pee);
$pee = preg_replace( "|\n</p>$|", '</p>', $pee );
@ -519,7 +526,7 @@ function wpautop($pee, $br = true) {
* @return string
*/
function _autop_newline_preservation_helper( $matches ) {
return str_replace("\n", "<WPPreserveNewline />", $matches[0]);
return str_replace( "\n", "<WPPreserveNewline />", $matches[0] );
}
/**
@ -529,6 +536,8 @@ function _autop_newline_preservation_helper( $matches ) {
*
* @since 2.9.0
*
* @global array $shortcode_tags
*
* @param string $pee The content.
* @return string The filtered content.
*/
@ -589,7 +598,7 @@ function shortcode_unautop( $pee ) {
* @param string $str The string to be checked
* @return bool True if $str fits a UTF-8 model, false otherwise.
*/
function seems_utf8($str) {
function seems_utf8( $str ) {
mbstring_binary_safe_encoding();
$length = strlen($str);
reset_mbstring_encoding();
@ -621,10 +630,12 @@ function seems_utf8($str) {
* @since 1.2.2
* @access private
*
* @param string $string The text which is to be encoded.
* @param int $quote_style Optional. Converts double quotes if set to ENT_COMPAT, both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES. Also compatible with old values; converting single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default is ENT_NOQUOTES.
* @param string $charset Optional. The character encoding of the string. Default is false.
* @param boolean $double_encode Optional. Whether to encode existing html entities. Default is false.
* @staticvar string|false $_charset
*
* @param string $string The text which is to be encoded.
* @param int $quote_style Optional. Converts double quotes if set to ENT_COMPAT, both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES. Also compatible with old values; converting single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default is ENT_NOQUOTES.
* @param string $charset Optional. The character encoding of the string. Default is false.
* @param bool $double_encode Optional. Whether to encode existing html entities. Default is false.
* @return string The encoded text with HTML entities.
*/
function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = false, $double_encode = false ) {
@ -701,8 +712,14 @@ function _wp_specialchars( $string, $quote_style = ENT_NOQUOTES, $charset = fals
*
* @since 2.8.0
*
* @param string $string The text which is to be decoded.
* @param mixed $quote_style Optional. Converts double quotes if set to ENT_COMPAT, both single and double if set to ENT_QUOTES or none if set to ENT_NOQUOTES. Also compatible with old _wp_specialchars() values; converting single quotes if set to 'single', double if set to 'double' or both if otherwise set. Default is ENT_NOQUOTES.
* @param string $string The text which is to be decoded.
* @param string|int $quote_style Optional. Converts double quotes if set to ENT_COMPAT,
* both single and double if set to ENT_QUOTES or
* none if set to ENT_NOQUOTES.
* Also compatible with old _wp_specialchars() values;
* converting single quotes if set to 'single',
* double if set to 'double' or both if otherwise set.
* Default is ENT_NOQUOTES.
* @return string The decoded text without HTML entities.
*/
function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
@ -758,8 +775,11 @@ function wp_specialchars_decode( $string, $quote_style = ENT_NOQUOTES ) {
*
* @since 2.8.0
*
* @param string $string The text which is to be checked.
* @param boolean $strip Optional. Whether to attempt to strip out invalid UTF8. Default is false.
* @staticvar bool $is_utf8
* @staticvar bool $utf8_pcre
*
* @param string $string The text which is to be checked.
* @param bool $strip Optional. Whether to attempt to strip out invalid UTF8. Default is false.
* @return string The checked text.
*/
function wp_check_invalid_utf8( $string, $strip = false ) {
@ -807,7 +827,7 @@ function wp_check_invalid_utf8( $string, $strip = false ) {
* @since 1.5.0
*
* @param string $utf8_string
* @param int $length Max length of the string
* @param int $length Max length of the string
* @return string String with Unicode encoded for URI.
*/
function utf8_uri_encode( $utf8_string, $length = 0 ) {
@ -870,7 +890,7 @@ function utf8_uri_encode( $utf8_string, $length = 0 ) {
* @param string $string Text that might have accent characters
* @return string Filtered string with replaced "nice" characters.
*/
function remove_accents($string) {
function remove_accents( $string ) {
if ( !preg_match('/[\x80-\xff]/', $string) )
return $string;
@ -1187,7 +1207,7 @@ function sanitize_file_name( $filename ) {
* @since 2.0.0
*
* @param string $username The username to be sanitized.
* @param bool $strict If set limits $username to specific characters. Default false.
* @param bool $strict If set limits $username to specific characters. Default false.
* @return string The sanitized username, after passing through filters.
*/
function sanitize_user( $username, $strict = false ) {
@ -1253,9 +1273,9 @@ function sanitize_key( $key ) {
*
* @since 1.0.0
*
* @param string $title The string to be sanitized.
* @param string $title The string to be sanitized.
* @param string $fallback_title Optional. A title to use if $title is empty.
* @param string $context Optional. The operation for which the string is sanitized
* @param string $context Optional. The operation for which the string is sanitized
* @return string The sanitized string.
*/
function sanitize_title( $title, $fallback_title = '', $context = 'save' ) {
@ -1303,9 +1323,9 @@ function sanitize_title_for_query( $title ) {
*
* @since 1.2.0
*
* @param string $title The title to be sanitized.
* @param string $title The title to be sanitized.
* @param string $raw_title Optional. Not used.
* @param string $context Optional. The operation for which the string is sanitized.
* @param string $context Optional. The operation for which the string is sanitized.
* @return string The sanitized title.
*/
function sanitize_title_with_dashes( $title, $raw_title = '', $context = 'display' ) {
@ -1372,7 +1392,7 @@ function sanitize_title_with_dashes( $title, $raw_title = '', $context = 'displa
* @since 2.5.1
*
* @param string $orderby Order by clause to be validated.
* @return string|bool Returns $orderby if valid, false otherwise.
* @return string|false Returns $orderby if valid, false otherwise.
*/
function sanitize_sql_orderby( $orderby ) {
if ( preg_match( '/^\s*(([a-z0-9_]+|`[a-z0-9_]+`)(\s+(ASC|DESC))?\s*(,\s*(?=[a-z0-9_`])|$))+$/i', $orderby ) || preg_match( '/^\s*RAND\(\s*\)\s*$/i', $orderby ) ) {
@ -1391,7 +1411,7 @@ function sanitize_sql_orderby( $orderby ) {
*
* @since 2.8.0
*
* @param string $class The classname to be sanitized
* @param string $class The classname to be sanitized
* @param string $fallback Optional. The value to return if the sanitization ends up as an empty string.
* Defaults to an empty string.
* @return string The sanitized value
@ -1427,11 +1447,11 @@ function sanitize_html_class( $class, $fallback = '' ) {
*
* @since 0.71
*
* @param string $content String of characters to be converted.
* @param string $content String of characters to be converted.
* @param string $deprecated Not used.
* @return string Converted string.
*/
function convert_chars($content, $deprecated = '') {
function convert_chars( $content, $deprecated = '' ) {
if ( !empty( $deprecated ) )
_deprecated_argument( __FUNCTION__, '0.71' );
@ -1493,8 +1513,8 @@ function convert_chars($content, $deprecated = '') {
*
* @since 0.71
*
* @param string $text Text to be balanced
* @param bool $force If true, forces balancing, ignoring the value of the option. Default false.
* @param string $text Text to be balanced
* @param bool $force If true, forces balancing, ignoring the value of the option. Default false.
* @return string Balanced text
*/
function balanceTags( $text, $force = false ) {
@ -1645,8 +1665,8 @@ function force_balance_tags( $text ) {
*
* @since 0.71
*
* @param string $content The text about to be edited.
* @param bool $richedit Whether the $content should not pass through htmlspecialchars(). Default false (meaning it will be passed).
* @param string $content The text about to be edited.
* @param bool $richedit Whether the $content should not pass through htmlspecialchars(). Default false (meaning it will be passed).
* @return string The text after the filter (and possibly htmlspecialchars()) has been run.
*/
function format_to_edit( $content, $richedit = false ) {
@ -1676,12 +1696,12 @@ function format_to_edit( $content, $richedit = false ) {
*
* @since 0.71
*
* @param mixed $number Number to append zeros to if not greater than threshold.
* @param int $threshold Digit places number needs to be to not have zeros added.
* @param int $number Number to append zeros to if not greater than threshold.
* @param int $threshold Digit places number needs to be to not have zeros added.
* @return string Adds leading zeros to number if needed.
*/
function zeroise($number, $threshold) {
return sprintf('%0'.$threshold.'s', $number);
function zeroise( $number, $threshold ) {
return sprintf( '%0' . $threshold . 's', $number );
}
/**
@ -1692,7 +1712,7 @@ function zeroise($number, $threshold) {
* @param string $string Value to which backslashes will be added.
* @return string String with backslashes inserted.
*/
function backslashit($string) {
function backslashit( $string ) {
if ( isset( $string[0] ) && $string[0] >= '0' && $string[0] <= '9' )
$string = '\\\\' . $string;
return addcslashes( $string, 'A..Za..z' );
@ -1760,7 +1780,7 @@ function addslashes_gpc($gpc) {
* @param mixed $value The value to be stripped.
* @return mixed Stripped value.
*/
function stripslashes_deep($value) {
function stripslashes_deep( $value ) {
if ( is_array($value) ) {
$value = array_map('stripslashes_deep', $value);
} elseif ( is_object($value) ) {
@ -1784,9 +1804,8 @@ function stripslashes_deep($value) {
* @param array|string $value The array or string to be encoded.
* @return array|string $value The encoded array (or string from the callback).
*/
function urlencode_deep($value) {
$value = is_array($value) ? array_map('urlencode_deep', $value) : urlencode($value);
return $value;
function urlencode_deep( $value ) {
return is_array( $value ) ? array_map( 'urlencode_deep', $value ) : urlencode( $value );
}
/**
@ -1807,7 +1826,7 @@ function rawurlencode_deep( $value ) {
* @since 0.71
*
* @param string $email_address Email address.
* @param int $hex_encoding Optional. Set to 1 to enable hex encoding.
* @param int $hex_encoding Optional. Set to 1 to enable hex encoding.
* @return string Converted email address.
*/
function antispambot( $email_address, $hex_encoding = 0 ) {
@ -1823,9 +1842,7 @@ function antispambot( $email_address, $hex_encoding = 0 ) {
}
}
$email_no_spam_address = str_replace( '@', '&#64;', $email_no_spam_address );
return $email_no_spam_address;
return str_replace( '@', '&#64;', $email_no_spam_address );
}
/**
@ -1840,7 +1857,7 @@ function antispambot( $email_address, $hex_encoding = 0 ) {
* @param array $matches Single Regex Match.
* @return string HTML A element with URI address.
*/
function _make_url_clickable_cb($matches) {
function _make_url_clickable_cb( $matches ) {
$url = $matches[2];
if ( ')' == $matches[3] && strpos( $url, '(' ) ) {
@ -1877,7 +1894,7 @@ function _make_url_clickable_cb($matches) {
* @param array $matches Single Regex Match.
* @return string HTML A element with URL address.
*/
function _make_web_ftp_clickable_cb($matches) {
function _make_web_ftp_clickable_cb( $matches ) {
$ret = '';
$dest = $matches[2];
$dest = 'http://' . $dest;
@ -1905,7 +1922,7 @@ function _make_web_ftp_clickable_cb($matches) {
* @param array $matches Single Regex Match.
* @return string HTML A element with email address.
*/
function _make_email_clickable_cb($matches) {
function _make_email_clickable_cb( $matches ) {
$email = $matches[2] . '@' . $matches[3];
return $matches[1] . "<a href=\"mailto:$email\">$email</a>";
}
@ -1976,8 +1993,7 @@ function make_clickable( $text ) {
}
// Cleanup of accidental links within links
$r = preg_replace( '#(<a([ \r\n\t]+[^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i', "$1$3</a>", $r );
return $r;
return preg_replace( '#(<a([ \r\n\t]+[^>]+?>|>))<a [^>]+?>([^>]+?)</a></a>#i', "$1$3</a>", $r );
}
/**
@ -2006,7 +2022,7 @@ function make_clickable( $text ) {
* @access private
*
* @param string $string The string to split.
* @param int $goal The desired chunk length.
* @param int $goal The desired chunk length.
* @return array Numeric array of chunks.
*/
function _split_str_by_whitespace( $string, $goal ) {
@ -2048,8 +2064,7 @@ function wp_rel_nofollow( $text ) {
// This is a pre save filter, so text is already escaped.
$text = stripslashes($text);
$text = preg_replace_callback('|<a (.+?)>|i', 'wp_rel_nofollow_callback', $text);
$text = wp_slash($text);
return $text;
return wp_slash( $text );
}
/**
@ -2076,9 +2091,10 @@ function wp_rel_nofollow_callback( $matches ) {
* Looks up one smiley code in the $wpsmiliestrans global array and returns an
* `<img>` string for that smiley.
*
* @global array $wpsmiliestrans
* @since 2.8.0
*
* @global array $wpsmiliestrans
*
* @param array $matches Single match. Smiley code to convert to image.
* @return string Image string for smiley.
*/
@ -2121,7 +2137,8 @@ function translate_smiley( $matches ) {
* used in the function isn't empty.
*
* @since 0.71
* @uses $wp_smiliessearch
*
* @global string|array $wp_smiliessearch
*
* @param string $text Content to convert smilies from text.
* @return string Converted content with text smilies replaced with images.
@ -2172,8 +2189,8 @@ function convert_smilies( $text ) {
*
* @since 0.71
*
* @param string $email Email address to verify.
* @param boolean $deprecated Deprecated.
* @param string $email Email address to verify.
* @param bool $deprecated Deprecated.
* @return string|bool Either false or the valid email address.
*/
function is_email( $email, $deprecated = false ) {
@ -2265,14 +2282,13 @@ function is_email( $email, $deprecated = false ) {
* @param string $string Subject line
* @return string Converted string to ASCII
*/
function wp_iso_descrambler($string) {
function wp_iso_descrambler( $string ) {
/* this may only work with iso-8859-1, I'm afraid */
if (!preg_match('#\=\?(.+)\?Q\?(.+)\?\=#i', $string, $matches)) {
return $string;
} else {
$subject = str_replace('_', ' ', $matches[2]);
$subject = preg_replace_callback('#\=([0-9a-f]{2})#i', '_wp_iso_convert', $subject);
return $subject;
return preg_replace_callback( '#\=([0-9a-f]{2})#i', '_wp_iso_convert', $subject );
}
}
@ -2359,7 +2375,7 @@ function get_date_from_gmt( $string, $format = 'Y-m-d H:i:s' ) {
* @param string $timezone Either 'Z' for 0 offset or '±hhmm'.
* @return int|float The offset in seconds.
*/
function iso8601_timezone_to_offset($timezone) {
function iso8601_timezone_to_offset( $timezone ) {
// $timezone is either 'Z' or '[+|-]hhmm'
if ($timezone == 'Z') {
$offset = 0;
@ -2378,10 +2394,10 @@ function iso8601_timezone_to_offset($timezone) {
* @since 1.5.0
*
* @param string $date_string Date and time in ISO 8601 format {@link http://en.wikipedia.org/wiki/ISO_8601}.
* @param string $timezone Optional. If set to GMT returns the time minus gmt_offset. Default is 'user'.
* @param string $timezone Optional. If set to GMT returns the time minus gmt_offset. Default is 'user'.
* @return string The date and time in MySQL DateTime format - Y-m-d H:i:s.
*/
function iso8601_to_datetime($date_string, $timezone = 'user') {
function iso8601_to_datetime( $date_string, $timezone = 'user' ) {
$timezone = strtolower($timezone);
if ($timezone == 'gmt') {
@ -2416,7 +2432,7 @@ function iso8601_to_datetime($date_string, $timezone = 'user') {
* @param string $text Content to replace links to open in a new window.
* @return string Content that has filtered links.
*/
function popuplinks($text) {
function popuplinks( $text ) {
$text = preg_replace('/<a (.+?)>/i', "<a $1 target='_blank' rel='external'>", $text);
return $text;
}
@ -2532,7 +2548,7 @@ function sanitize_email( $email ) {
* @since 1.5.0
*
* @param int $from Unix timestamp from which the difference begins.
* @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
* @param int $to Optional. Unix timestamp to end the time difference. Default becomes time() if not set.
* @return string Human readable time difference.
*/
function human_time_diff( $from, $to = '' ) {
@ -2603,7 +2619,7 @@ function human_time_diff( $from, $to = '' ) {
* @param string $text Optional. The excerpt. If set to empty, an excerpt is generated.
* @return string The excerpt.
*/
function wp_trim_excerpt($text = '') {
function wp_trim_excerpt( $text = '' ) {
$raw_excerpt = $text;
if ( '' == $text ) {
$text = get_the_content('');
@ -2652,9 +2668,9 @@ function wp_trim_excerpt($text = '') {
*
* @since 3.3.0
*
* @param string $text Text to trim.
* @param int $num_words Number of words. Default 55.
* @param string $more Optional. What to append if $text needs to be trimmed. Default '&hellip;'.
* @param string $text Text to trim.
* @param int $num_words Number of words. Default 55.
* @param string $more Optional. What to append if $text needs to be trimmed. Default '&hellip;'.
* @return string Trimmed text.
*/
function wp_trim_words( $text, $num_words = 55, $more = null ) {
@ -2701,7 +2717,7 @@ function wp_trim_words( $text, $num_words = 55, $more = null ) {
* @param string $text The text within which entities will be converted.
* @return string Text with converted entities.
*/
function ent2ncr($text) {
function ent2ncr( $text ) {
/**
* Filter text before named entities are converted into numbered entities.
@ -2990,7 +3006,7 @@ function ent2ncr($text) {
* @param string $text The text to be formatted.
* @return string The formatted text after filter is applied.
*/
function wp_richedit_pre($text) {
function wp_richedit_pre( $text ) {
if ( empty( $text ) ) {
/**
* Filter text returned for the rich text editor.
@ -3028,7 +3044,7 @@ function wp_richedit_pre($text) {
* @param string $output The text to be formatted.
* @return string Formatted text after filter applied.
*/
function wp_htmledit_pre($output) {
function wp_htmledit_pre( $output ) {
if ( !empty($output) )
$output = htmlspecialchars($output, ENT_NOQUOTES, get_option( 'blog_charset' ) ); // convert only < > &
@ -3052,8 +3068,9 @@ function wp_htmledit_pre($output) {
* @since 2.8.1
* @access private
*
* @param string|array $search The value being searched for, otherwise known as the needle. An array may be used to designate multiple needles.
* @param string $subject The string being searched and replaced on, otherwise known as the haystack.
* @param string|array $search The value being searched for, otherwise known as the needle.
* An array may be used to designate multiple needles.
* @param string $subject The string being searched and replaced on, otherwise known as the haystack.
* @return string The string with the replaced svalues.
*/
function _deep_replace( $search, $subject ) {
@ -3075,6 +3092,9 @@ function _deep_replace( $search, $subject ) {
* is preparing an array for use in an IN clause.
*
* @since 2.8.0
*
* @global wpdb $wpdb
*
* @param string|array $data Unescaped data
* @return string|array Escaped data
*/
@ -3092,10 +3112,12 @@ function esc_sql( $data ) {
*
* @since 2.8.0
*
* @param string $url The URL to be cleaned.
* @param array $protocols Optional. An array of acceptable protocols.
* Defaults to 'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet', 'mms', 'rtsp', 'svn' if not set.
* @param string $_context Private. Use esc_url_raw() for database usage.
* @param string $url The URL to be cleaned.
* @param array $protocols Optional. An array of acceptable protocols.
* Defaults to 'http', 'https', 'ftp', 'ftps', 'mailto',
* 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet', 'mms',
* 'rtsp', 'svn' if not set.
* @param string $_context Private. Use esc_url_raw() for database usage.
* @return string The cleaned $url after the 'clean_url' filter is applied.
*/
function esc_url( $url, $protocols = null, $_context = 'display' ) {
@ -3149,8 +3171,8 @@ function esc_url( $url, $protocols = null, $_context = 'display' ) {
*
* @since 2.8.0
*
* @param string $url The URL to be cleaned.
* @param array $protocols An array of acceptable protocols.
* @param string $url The URL to be cleaned.
* @param array $protocols An array of acceptable protocols.
* @return string The cleaned URL.
*/
function esc_url_raw( $url, $protocols = null ) {
@ -3167,7 +3189,7 @@ function esc_url_raw( $url, $protocols = null ) {
* @param string $myHTML The text to be converted.
* @return string Converted text.
*/
function htmlentities2($myHTML) {
function htmlentities2( $myHTML ) {
$translation_table = get_html_translation_table( HTML_ENTITIES, ENT_QUOTES );
$translation_table[chr(38)] = '&';
return preg_replace( "/&(?![A-Za-z]{0,4}\w{2,3};|#[0-9]{2,3};)/", "&amp;", strtr($myHTML, $translation_table) );
@ -3284,7 +3306,7 @@ function esc_textarea( $text ) {
* @param string $tag_name
* @return string
*/
function tag_escape($tag_name) {
function tag_escape( $tag_name ) {
$safe_tag = strtolower( preg_replace('/[^a-zA-Z0-9_:]/', '', $tag_name) );
/**
* Filter a string cleaned and escaped for output as an HTML tag.
@ -3321,11 +3343,13 @@ function wp_make_link_relative( $link ) {
*
* @since 2.0.5
*
* @global wpdb $wpdb
*
* @param string $option The name of the option.
* @param string $value The unsanitised value.
* @param string $value The unsanitised value.
* @return string Sanitized value.
*/
function sanitize_option($option, $value) {
function sanitize_option( $option, $value ) {
global $wpdb;
$original_value = $value;
@ -3523,9 +3547,7 @@ function sanitize_option($option, $value) {
* @param string $option The option name.
* @param string $original_value The original value passed to the function.
*/
$value = apply_filters( "sanitize_option_{$option}", $value, $option, $original_value );
return $value;
return apply_filters( "sanitize_option_{$option}", $value, $option, $original_value );
}
/**
@ -3537,7 +3559,7 @@ function sanitize_option($option, $value) {
* @since 2.2.1
*
* @param string $string The string to be parsed.
* @param array $array Variables will be stored in this array.
* @param array $array Variables will be stored in this array.
*/
function wp_parse_str( $string, &$array ) {
parse_str( $string, $array );
@ -3587,7 +3609,7 @@ function wp_pre_kses_less_than_callback( $matches ) {
* @since 2.5.0
* @link http://www.php.net/sprintf
*
* @param string $pattern The string which formatted args are inserted.
* @param string $pattern The string which formatted args are inserted.
* @param mixed $args ,... Arguments to be formatted into the $pattern string.
* @return string The formatted string.
*/
@ -3662,10 +3684,10 @@ function wp_sprintf( $pattern ) {
* @since 2.5.0
*
* @param string $pattern Content containing '%l' at the beginning.
* @param array $args List items to prepend to the content and replace '%l'.
* @param array $args List items to prepend to the content and replace '%l'.
* @return string Localized list items and rest of the content.
*/
function wp_sprintf_l($pattern, $args) {
function wp_sprintf_l( $pattern, $args ) {
// Not a match
if ( substr($pattern, 0, 2) != '%l' )
return $pattern;
@ -3720,9 +3742,9 @@ function wp_sprintf_l($pattern, $args) {
*
* @since 2.5.0
*
* @param string $str String to get the excerpt from.
* @param integer $count Maximum number of characters to take.
* @param string $more Optional. What to append if $str needs to be trimmed. Defaults to empty string.
* @param string $str String to get the excerpt from.
* @param int $count Maximum number of characters to take.
* @param string $more Optional. What to append if $str needs to be trimmed. Defaults to empty string.
* @return string The excerpt.
*/
function wp_html_excerpt( $str, $count, $more = null ) {
@ -3745,9 +3767,11 @@ function wp_html_excerpt( $str, $count, $more = null ) {
*
* @since 2.7.0
*
* @global string $_links_add_base
*
* @param string $content String to search for links in.
* @param string $base The base URL to prefix to links.
* @param array $attrs The attributes which should be processed.
* @param string $base The base URL to prefix to links.
* @param array $attrs The attributes which should be processed.
* @return string The processed content.
*/
function links_add_base_url( $content, $base, $attrs = array('src', 'href') ) {
@ -3763,10 +3787,12 @@ function links_add_base_url( $content, $base, $attrs = array('src', 'href') ) {
* @since 2.7.0
* @access private
*
* @global string $_links_add_base
*
* @param string $m The matched link.
* @return string The processed link.
*/
function _links_add_base($m) {
function _links_add_base( $m ) {
global $_links_add_base;
//1 = attribute name 2 = quotation mark 3 = URL
return $m[1] . '=' . $m[2] .
@ -3787,9 +3813,11 @@ function _links_add_base($m) {
*
* @since 2.7.0
*
* @global string $_links_add_target
*
* @param string $content String to search for links in.
* @param string $target The Target to add to the links.
* @param array $tags An array of tags to apply to.
* @param string $target The Target to add to the links.
* @param array $tags An array of tags to apply to.
* @return string The processed content.
*/
function links_add_target( $content, $target = '_blank', $tags = array('a') ) {
@ -3805,6 +3833,8 @@ function links_add_target( $content, $target = '_blank', $tags = array('a') ) {
* @since 2.7.0
* @access private
*
* @global string $_links_add_target
*
* @param string $m The matched link.
* @return string The processed link.
*/
@ -3839,8 +3869,8 @@ function normalize_whitespace( $str ) {
*
* @since 2.9.0
*
* @param string $string String containing HTML tags
* @param bool $remove_breaks optional Whether to remove left over line breaks and white space chars
* @param string $string String containing HTML tags
* @param bool $remove_breaks Optional. Whether to remove left over line breaks and white space chars
* @return string The processed string.
*/
function wp_strip_all_tags($string, $remove_breaks = false) {
@ -3867,7 +3897,7 @@ function wp_strip_all_tags($string, $remove_breaks = false) {
* @param string $str
* @return string
*/
function sanitize_text_field($str) {
function sanitize_text_field( $str ) {
$filtered = wp_check_invalid_utf8( $str );
if ( strpos($filtered, '<') !== false ) {
@ -3905,7 +3935,7 @@ function sanitize_text_field($str) {
*
* @since 3.1.0
*
* @param string $path A path.
* @param string $path A path.
* @param string $suffix If the filename ends in suffix this will also be cut off.
* @return string
*/
@ -3919,6 +3949,8 @@ function wp_basename( $path, $suffix = '' ) {
* Violating our coding standards for a good function name.
*
* @since 3.0.0
*
* @staticvar string|false $dblq
*/
function capital_P_dangit( $text ) {
// Simple replacement for titles
@ -4035,7 +4067,7 @@ function wp_unslash( $value ) {
* @since 3.6.0
*
* @param string $content A string which might contain a URL.
* @return string The found URL.
* @return string|false The found URL.
*/
function get_url_in_content( $content ) {
if ( empty( $content ) ) {
@ -4058,6 +4090,8 @@ function get_url_in_content( $content ) {
*
* @since 4.0.0
*
* @staticvar string $spaces
*
* @return string The spaces regexp.
*/
function wp_spaces_regexp() {
@ -4086,6 +4120,8 @@ function wp_spaces_regexp() {
* Print the important emoji-related styles.
*
* @since 4.2.0
*
* @staticvar bool $printed
*/
function print_emoji_styles() {
static $printed = false;
@ -4113,6 +4149,11 @@ img.emoji {
<?php
}
/**
*
* @global string $wp_version
* @staticvar bool $printed
*/
function print_emoji_detection_script() {
global $wp_version;
static $printed = false;

2
wp-includes/version.php
View File

@ -4,7 +4,7 @@
*
* @global string $wp_version
*/
$wp_version = '4.3-alpha-32568';
$wp_version = '4.3-alpha-32591';
/**
* Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.