Commit Graph

29845 Commits

Author SHA1 Message Date
Drew Jaynes 2c2cf3b037 Convert the `$args` parameter documentation in `wp_xmlrpc_server->wp_getPost()` into a hash notation.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32573 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:44:21 +00:00
Drew Jaynes a52e959d8e Add missing argument descriptions in the DocBlock for `wp_xmlrpc_server->wp_deletePost()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32572 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:40:23 +00:00
Dion Hulse d8dc5d9f63 Updates: Correctly identify more failed update cases. This checks for a WP_Error being raised during an individual update, in addition to just the bootstrap error cases.
The error message in these cases is still not displayed in the UI.

See #32473, #32435


git-svn-id: https://develop.svn.wordpress.org/trunk@32571 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 08:44:09 +00:00
Dion Hulse 8d64dc4e6b Shiny Updates: Handle the case where the plugin is installed into a different directory than it previously existed in.
A good example of this is when the plugin being updated is currently installed as 'Plugin-Name' but the canonical directory is 'plugin-name', but it can also occur when the plugin is installed in 'super-cool-plugin' and it's canonical name is 'average-plugin'.

Fixes #32465 for trunk


git-svn-id: https://develop.svn.wordpress.org/trunk@32570 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 08:04:55 +00:00
Konstantin Obenland 065cdadce9 Improve description for link notification option.
Makes it clear that the option only applies to new articles.

Props chriscct7.
Fixes #22961.



git-svn-id: https://develop.svn.wordpress.org/trunk@32569 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 07:54:06 +00:00
Scott Taylor 39ef6a72c5 Use `void` instead of `null` where appropriate when pipe-delimiting `@return` types. If a `@return` only contains `void`, remove it.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32568 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 05:39:47 +00:00
Scott Taylor abca40cf44 Add missing doc blocks to `comment-template.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32567 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 05:18:59 +00:00
Scott Taylor d174df13ae Add missing doc blocks to `class.wp-(scripts|styles).php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32566 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 05:04:39 +00:00
Drew Jaynes f270cd90c5 Add missing or incomplete argument and return descriptions for `wp_xmlrpc_server->wp_editPost()`.
Also includes many small syntax fixes for inline documentation throughout the file.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32565 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:46:45 +00:00
Drew Jaynes 4b70ff7721 Add missing parameter and return descriptions to the DocBlock for `wp_xmlrpc_server->_convert_date_gmt()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32564 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:40:35 +00:00
Drew Jaynes e3b95fa4d6 Add missing parameter and return descriptions to the DocBlock for `wp_xmlrpc_server->_convert_date()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32563 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:39:30 +00:00
Drew Jaynes 366c5abe4d Fix inline documentation syntax in the DocBlock for `wp_xmlrpc_server->_prepare_taxonomy()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32562 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:37:57 +00:00
Drew Jaynes 839eb02ec0 Fix some inline documentation syntax in the DocBlock for `wp_xmlrpc_server->minimum_args()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32561 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:36:43 +00:00
Drew Jaynes b0f632a406 Use a valid parameter type of string for the `$name` parameter in the `xmlrpc_call` hook docs.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32560 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:35:33 +00:00
Drew Jaynes 967f52add2 Add missing argument descriptions for the `$args` hash notation in `wp_xmlrpc_server->wp_getUsersBlogs()`.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32559 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:32:06 +00:00
Drew Jaynes ee71a2ea33 Properly notate the inline link to the `xmlrpc_blog_options` filter in the description for `wp_xmlrpc_server->initialise_blog_option_info()`.
See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@32558 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:29:45 +00:00
Drew Jaynes 644b0e27a3 Add a proper return description for the `wp_xmlrpc_server->addTwoNumbers()` method.
See [30181]. See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@32557 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:25:38 +00:00
Drew Jaynes 206debf59e Add proper descriptions for the `$methods`, `$blog_options`, and `$error` properties in `wp_xmlrpc_server`.
See [30181]. See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@32556 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:22:40 +00:00
Drew Jaynes b9b734b994 Add a proper description comment for the `WP_Image_Editor_Imagick->$image` property.
See [30180]. See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@32555 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:19:49 +00:00
Drew Jaynes 3bf89080cf Add a proper description comment for the `WP_Image_Editor_GD->$image` property.
See [30180]. See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@32554 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 19:09:58 +00:00
Boone Gorges 94a9896b05 Introduced `$field` argument to `get_term_link()`.
This new argument allows developers to specify which term field should be
matched by the value of the `$term` parameter (in particular, 'name' and
'term_taxonomy_id' are now supported).

Props sudar, mordauk.
Fixes #14156.

git-svn-id: https://develop.svn.wordpress.org/trunk@32553 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 18:28:22 +00:00
Boone Gorges 6cb6f3916a Unit tests for `get_term_link()`.
See #14156.

git-svn-id: https://develop.svn.wordpress.org/trunk@32552 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-23 18:12:27 +00:00
Scott Taylor 7f62f34c8e Add missing doc blockss in `class-wp.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32551 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 20:04:38 +00:00
Scott Taylor 4ab280361c Upgrade the doc blocks in `class-wp-xmlrpc-server.php`. Rehabilitate some unfortunate use of tabbing.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32550 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 19:36:22 +00:00
Scott Taylor 4eb0e01825 Cleanup missing doc blocks for `class-wp-walker.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32549 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 17:58:42 +00:00
Drew Jaynes 366d1843f0 Add a missing `@since` version to a function introduced in [32541].
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32548 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 17:37:23 +00:00
Scott Taylor 88947981c3 Add missing doc blocks to `class-wp-theme.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32547 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 17:30:44 +00:00
Scott Taylor f67ecbdadc Add missing doc blocks to `wp-image-editor*.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32546 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 06:17:16 +00:00
Scott Taylor 46752a491e When calling `unset()`, it is unnecessary to immediately precede it with a call to `isset()`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32545 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 05:46:47 +00:00
Scott Taylor 06ea5c78be Clean up doc blocks for `class-wp-embed.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32544 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 05:14:30 +00:00
Scott Taylor f5bfbf2cad Clean up `@global` doc blocks/imports for `class-wp-editor.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32543 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 05:09:38 +00:00
Scott Taylor febd12c957 Clean up `@global` doc blocks/imports for `class-wp-customizer-*.php` and friends.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32542 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 05:05:19 +00:00
Scott Taylor 7a683940d7 Create a function, `wp_roles()`, to DRY the inline instantiation of the `$wp_roles` global.
Add missing doc blocks for `capabilities.php`.

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32541 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 04:46:36 +00:00
Scott Taylor 0864ba691a Add missing doc blocks for `canonical.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32540 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 04:25:27 +00:00
Scott Taylor de7b6c76ab Add/standardize missing doc blocks for `cache.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32539 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 04:23:15 +00:00
Scott Taylor 339d3be328 Add missing doc blocks to `author-template.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32538 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 04:13:35 +00:00
Scott Taylor d723ecc5f5 Add missing doc blocks to `admin-bar.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32537 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 03:59:13 +00:00
Scott Taylor 55ce3d19ea Add missing doc blocks to `class-wp-editor.php`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32536 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 03:51:50 +00:00
Scott Taylor 9333337992 In `class-wp-customize-*`, clarify/add some `@param`/`@return` blocks. Disambiguate some functions that are trying to return the `void` response of another function they call internally.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32535 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 22:04:29 +00:00
Scott Taylor 369903cd85 In `class-wp-admin-bar.php`, clarify/add some doc blocks.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32534 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 21:38:41 +00:00
Scott Taylor 4a362fdb7c In `class-oembed.php`, clarify/add some `return` docs.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32533 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 21:30:31 +00:00
Scott Taylor 5261e8022a In `category.php`:
* Clarify some `return` docs.
* In `_make_cat_compat()`, ensure that `WP_Error` is not decorated

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32532 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 21:17:42 +00:00
Scott Taylor 51717c41af In `category-template.php`:
* Clarify/add some `return` docs.
* In `walk_category_tree()` and `walk_category_dropdown_tree()`, make behavior consistent and don't pass `$walker` by-reference - it is no longer necessary to do that with object instances.

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32531 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 21:04:32 +00:00
Scott Taylor 5ae33c082f In `capabilities.php`, clarify/add some `return` docs.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32530 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:46:25 +00:00
Scott Taylor e501a4227c In `canonical.php`:
* Clarify some docs
* `redirect_canonical()` inconsistently returns `null` or `false` when bailing - can simply return.

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32529 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:29:19 +00:00
Scott Taylor 63ab0981fc In `cache.php`, clarify some `return` docs. Some `WP_Object_Cache` methods return `void`, so those wrapper functions don't need to return at all.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32528 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:21:22 +00:00
Scott Taylor 4eb97de4cf In `bookmark.php`, clarify some `return` docs.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32527 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:12:41 +00:00
Scott Taylor ff1eabd7e1 In `author-template.php`, clarify/add some `return` docs.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32526 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:09:44 +00:00
Scott Taylor cb145bd1c0 In `admin-bar.php`, most functions simply return when a conditional is not met. `wp_admin_bar_render()` shouldn't explicitly return `false`.
See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32525 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 20:09:00 +00:00
Boone Gorges f0d6031d9b Streamline support for multiple post types in `get_posts_by_author_sql()`.
* Don't accept a comma-separated list, only a single post type or an array of post types. This is easier to document.
* Add changelog entries to all calling functions.

Props DrewAPicture.
Fixes #32243.

git-svn-id: https://develop.svn.wordpress.org/trunk@32524 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 19:48:19 +00:00