Commit Graph

30053 Commits

Author SHA1 Message Date
Drew Jaynes b5b9cda58d Convert the `$args` parameter documentation for `wp_xmlrpc_server->wp_newPost()` into a hash notation.
Also adds more in-depth documentation and a link for information on enclosures.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32581 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 19:58:54 +00:00
Drew Jaynes eb60152449 Improve inline documentation for the cron lock behavior.
Props ericlewis.
Fixes #32478.


git-svn-id: https://develop.svn.wordpress.org/trunk@32580 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 17:25:52 +00:00
Drew Jaynes 2c32effa02 In most `wp_xmlrpc_server` methods that accept an array of arguments, the argument order is important.
With the converstion to hash notations from simple lists in the inline documentation, it's especially important to make that requirement clear.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32579 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 17:18:47 +00:00
Drew Jaynes 0474aa9374 Convert the `$args` parameter documentation in `wp_xmlrpc_server->wp_deleteTerm()` into a hash notation.
Also clarifies the return description.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32578 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 17:01:37 +00:00
Drew Jaynes 633677efb0 Convert the `$args` parameter documentation in `wp_xmlrpc_server->wp_editTerm()` to a hash notation.
Also clarifies the return description.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32577 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:59:26 +00:00
Drew Jaynes d07e39be55 Convert the `$args` parameter documentation in `wp_xmlrpc_server->wp_newTerm()` into a hash notation.
Also clarifies the return description.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32576 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:55:38 +00:00
Drew Jaynes e117da47eb Convert the `$args` parameter for `wp_xmlrpc_server->wp_getPosts()` into a hash notation.
Also considates documentation to the argument descriptions themselves.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32575 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:50:53 +00:00
Drew Jaynes 6548f58224 Define the default values for the `$fields` parameter in the `xmlrpc_default_post_fields` hook docs.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@32574 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 16:45:53 +00:00
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