Drew Jaynes
1d95dcfa2c
Docs: Remove superfluous `@package WordPress` and `@subpackage` notations used outside of file headers in a variety of core files.
...
Per the inline documentation standards for PHP, there should only be one `@package` and/or `@subpackage` notation per file, and only in the file header.
See #41017 .
Built from https://develop.svn.wordpress.org/trunk@40988
git-svn-id: http://core.svn.wordpress.org/trunk@40838 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 16:58:42 +00:00
Drew Jaynes
ae017f435a
Docs: Convert an `@uses` tag in the class DocBlock for `Walker_Nav_Menu_Edit` to `@see`.
...
See #41017 .
Built from https://develop.svn.wordpress.org/trunk@40987
git-svn-id: http://core.svn.wordpress.org/trunk@40837 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 16:49:40 +00:00
Drew Jaynes
bd2173f42c
Docs: Remove an unnecessary `@package` tag from the DocBlock for `post_preview()`.
...
See #41017 .
Built from https://develop.svn.wordpress.org/trunk@40986
git-svn-id: http://core.svn.wordpress.org/trunk@40836 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 16:39:41 +00:00
Drew Jaynes
ba40430e89
Docs: Add a valid return type for `post_preview()` and improve the DocBlock summary.
...
See #41017 .
Built from https://develop.svn.wordpress.org/trunk@40985
git-svn-id: http://core.svn.wordpress.org/trunk@40835 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 16:37:42 +00:00
Boone Gorges
26fcea496d
Introduce `most_used` taxonomy label, for text on 'Most Used' metabox tab.
...
Props mdifelice, jlambe.
Fixes #41150 .
Built from https://develop.svn.wordpress.org/trunk@40984
git-svn-id: http://core.svn.wordpress.org/trunk@40834 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 14:46:41 +00:00
Drew Jaynes
5fa2de51ef
General: Ensure `$description` gets initialized in `get_the_archive_description()` if the post type archive conditional is true and the description isn't set.
...
Props henrywright.
See #38487 .
Built from https://develop.svn.wordpress.org/trunk@40983
git-svn-id: http://core.svn.wordpress.org/trunk@40833 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 14:23:41 +00:00
Boone Gorges
cb81009729
Allow user searches to match the `display_name` field.
...
Props bcole808, pcarvalho.
Fixes #39643 .
Built from https://develop.svn.wordpress.org/trunk@40982
git-svn-id: http://core.svn.wordpress.org/trunk@40832 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 14:22:41 +00:00
Boone Gorges
6995731f12
Allow metadata to be updated via `wp_update_comment()`.
...
Passing an array of `comment_meta` into `wp_update_comment()` will
now update corresponding metadata. Similar functionality already
exists in `wp_insert_comment()`.
Props dshanske, kraftbj.
Fixes #36784 .
Built from https://develop.svn.wordpress.org/trunk@40981
git-svn-id: http://core.svn.wordpress.org/trunk@40831 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 13:36:41 +00:00
Boone Gorges
def98d511a
Users: Allow data to be filtered before updating or creating a user.
...
Props DaveFX.
Fixes #40545 .
Built from https://develop.svn.wordpress.org/trunk@40980
git-svn-id: http://core.svn.wordpress.org/trunk@40830 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 13:30:42 +00:00
Boone Gorges
ed9d4b9408
Taxonomy: Ignore cached term value when it doesn't match the queried taxonomy.
...
When a cache entry is found that matches the requested `$term_id`, but
doesn't match an explicitly provided `$taxonomy`, that cache entry
should be ignored.
Props GunGeekATX.
Fixes #40671 .
Built from https://develop.svn.wordpress.org/trunk@40979
git-svn-id: http://core.svn.wordpress.org/trunk@40829 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 11:46:41 +00:00
Boone Gorges
848bcf3b28
Introduce `$comment_count` param for `WP_Query`.
...
This parameter allows querying for posts with a specific value of
`comment_count`. It is also possible to query for posts that match
a `comment_count` comparison by passing an array with 'value' and
'compare' operators (eg `array( 'compare' => '>', 'value' => 5 )`).
Props ramon fincken.
Fixes #28399 .
Built from https://develop.svn.wordpress.org/trunk@40978
git-svn-id: http://core.svn.wordpress.org/trunk@40828 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 11:25:44 +00:00
Drew Jaynes
d6f7788935
Remove an unnecessary initialization of `$description` due to the else condition in `get_the_archive_description()`.
...
See [40976]. See #38487 .
Built from https://develop.svn.wordpress.org/trunk@40977
git-svn-id: http://core.svn.wordpress.org/trunk@40827 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 05:19:41 +00:00
Drew Jaynes
f6b5c794bf
General: Add support for the post type archive description to `get_the_archive_description()`, and thereby also `the_archive_description()`.
...
Props henrywright.
Fixes #38487 .
Built from https://develop.svn.wordpress.org/trunk@40976
git-svn-id: http://core.svn.wordpress.org/trunk@40826 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 05:15:46 +00:00
Drew Jaynes
0fe9fb4a16
Link Template: Clarify documentation for the `$id` parameter in `get_post_permalink()`, `get_edit_post_link()`, `edit_post_link()`, and `get_delete_post_link()`, to reflect that either a post ID or `WP_Post` object is accepted.
...
Separately, use `$post` for checking the post status and retrieving the page_uri in `get_post_permalink()` instead of referencing back to the original `$id` parameter.
Props GunGeekATX for the initial patch.
Fixes #40780 .
Built from https://develop.svn.wordpress.org/trunk@40975
git-svn-id: http://core.svn.wordpress.org/trunk@40825 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 03:29:42 +00:00
Drew Jaynes
903d23be34
Users: Introduce the `manage_users_extra_tablenav` action, fired immediately outside the closing "actions" div in the Users list table tablenav.
...
A similar `manage_posts_extra_tablenav` hook fires in the same location and context in the Posts list table tablenav.
Props GunGeekATX, adamsilverstein.
Fixes #36990 .
Built from https://develop.svn.wordpress.org/trunk@40974
git-svn-id: http://core.svn.wordpress.org/trunk@40824 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-07-01 03:02:41 +00:00
Drew Jaynes
25370ba481
Docs: Add a `@property-read` notation for the read-only `WP_Term::$data` property.
...
See [35269], #34348 and #41017 .
Built from https://develop.svn.wordpress.org/trunk@40973
git-svn-id: http://core.svn.wordpress.org/trunk@40823 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 17:04:40 +00:00
Drew Jaynes
4b0e64aa8c
Docs: Add missing `@since`, `@access`, and `@global` notations to the DocBlock for `WP_Query::parse_search_order()`.
...
Props dixitadusara.
Fixes #41045 .
Built from https://develop.svn.wordpress.org/trunk@40972
git-svn-id: http://core.svn.wordpress.org/trunk@40822 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 16:08:44 +00:00
Drew Jaynes
66e6776a5e
Docs: Add full parameter and return documentation for `WP_Text_Diff_Renderer_Table::interleave_changed_lines()`.
...
Props coffee2code.
Fixes #38520 .
Built from https://develop.svn.wordpress.org/trunk@40971
git-svn-id: http://core.svn.wordpress.org/trunk@40821 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 05:29:41 +00:00
Drew Jaynes
b13aa27cf4
Docs: Use third-person singular verbs in the summaries for `wp_unschedule_hook()` and `wp_clear_scheduled_hook()`.
...
See #41017 .
Built from https://develop.svn.wordpress.org/trunk@40970
git-svn-id: http://core.svn.wordpress.org/trunk@40820 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 04:54:41 +00:00
Drew Jaynes
36759db92e
Docs: Clarify accepted types and values for `$menu` parameters in several contexts:
...
* `wp_nav_menu()`
* `wp_get_nav_menu_object()` and its filter `wp_get_nav_menu_object`
* `is_nav_menu()`
* `wp_delete_nav_menu()`
* `wp_get_nav_menu_items()`
Props dimadin.
Fixes #38166 .
Built from https://develop.svn.wordpress.org/trunk@40969
git-svn-id: http://core.svn.wordpress.org/trunk@40819 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 04:49:40 +00:00
Drew Jaynes
7001a3cce6
Tests: Add `@method` notations to factor class DocBlocks as a way to indicate expected return types from factory methods for the benefit of IDEs.
...
Props jdgrimes.
Fixes #37867 .
Built from https://develop.svn.wordpress.org/trunk@40968
git-svn-id: http://core.svn.wordpress.org/trunk@40818 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 04:36:41 +00:00
Drew Jaynes
d829ec4cf2
Docs: Provide best practice guidance for achieving parity between `$menu_slug` values supplied when adding menu and submenu pages, and later trying to compare those initial values against sanitized screen IDs derived from `$menu_slug`.
...
At the heart of the matter, the `$menu_slug` parameter in `add_menu_page()` and `add_submenu_page()` is not sanitized with `sanitize_key()`. When the screen object is later built for the admin page, the screen ID is derived from that `$menu_slug` value, though passed through `sanitize_key()`, which can produce unexpected results in comparison check.
Changing the sanitization code to provide actual parity is out of the question at this juncture, so updating the docs to describe how to avoid this edge case is the next best option.
Props GregRoss.
Fixes #35305 .
Built from https://develop.svn.wordpress.org/trunk@40967
git-svn-id: http://core.svn.wordpress.org/trunk@40817 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 04:18:43 +00:00
Drew Jaynes
af5b2ca7f5
Docs: Add more useful summaries to the DocBlocks for boolean `$is_*` properties in `WP_Query`.
...
Props megane9988 for the initial patch.
Fixes #34726 .
Built from https://develop.svn.wordpress.org/trunk@40966
git-svn-id: http://core.svn.wordpress.org/trunk@40816 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 03:44:46 +00:00
Sergey Biryukov
641a4b643f
Cron API: Introduce `wp_unschedule_hook()` to clear all events attached to a hook.
...
This complements `wp_clear_scheduled_hook()`, which only clears events attached with specific arguments.
Props arena, mordauk, jrf.
Fixes #18997 .
Built from https://develop.svn.wordpress.org/trunk@40965
git-svn-id: http://core.svn.wordpress.org/trunk@40815 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-30 00:22:44 +00:00
Drew Jaynes
1fb8cbe8de
Docs: Don't reference non-existent hooks inline in the DocBlock descriptions for the following template functions:
...
* `get_index_template()`
* `get_404_template()`
* `get_author_template()`
* `get_category_template()`
* `get_tag_template()`
* `get_taxonomy_template()`
* `get_date_template()`
* `get_home_template()`
* `get_front_page_template()`
* `get_page_template()`
* `get_search_template()`
* `get_single_template()`
* `get_embed_template()`
* `get_singular_template()`
* `get_attachment_template()`
As mentioned when these dynamic hook references were originally fixed in [33274], we can't link to non-existent hooks inline because the Code Reference auto-linker won't pick up on the dynamic-ness of the hook, it'll just try to link to a hook reference that doesn't exist. In these cases, we need to be generic and provide context for the value of `$type`.
See [38418] for where the original fix was reversed. See this changeset for reversing the reversal.
Props donutz, milana_cap.
Fixes #41198 .
Built from https://develop.svn.wordpress.org/trunk@40964
git-svn-id: http://core.svn.wordpress.org/trunk@40814 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-29 16:05:41 +00:00
Drew Jaynes
8ccc74c054
Docs: Don't reference non-existent hooks inline in the DocBlock description for `get_archive_template()`.
...
Also removes extra curly braces from the dynamic hook references added in [40962] to aid future re-parsing.
See #41198 .
Built from https://develop.svn.wordpress.org/trunk@40963
git-svn-id: http://core.svn.wordpress.org/trunk@40813 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-29 15:47:40 +00:00
Drew Jaynes
1e32ebe87d
Docs: Don't reference non-existent hooks inline in the DocBlock description for `get_post_type_archive_template()`.
...
Props milana_cap.
See #41198 .
Built from https://develop.svn.wordpress.org/trunk@40962
git-svn-id: http://core.svn.wordpress.org/trunk@40812 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-29 15:39:40 +00:00
James Nylen
8f6088ba6e
REST API: Add a filter to allow modifying the response *after* embedded data is added.
...
Fixes #38964 .
Built from https://develop.svn.wordpress.org/trunk@40961
git-svn-id: http://core.svn.wordpress.org/trunk@40811 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-29 13:17:43 +00:00
Sergey Biryukov
165807d39f
Administration: In `WP_List_Table::comments_bubble()`, replace the mdash with its HTML entity for consistency with the similar code in other list tables.
...
Props afercia.
See #40659 , #32152 .
Built from https://develop.svn.wordpress.org/trunk@40960
git-svn-id: http://core.svn.wordpress.org/trunk@40810 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-29 00:04:43 +00:00
Sergey Biryukov
11bae4ded3
Docs: Add a `@global` entry for `$post` variable in `wp_post_preview_js()`.
...
Props avinapatel.
Fixes #41194 .
Built from https://develop.svn.wordpress.org/trunk@40959
git-svn-id: http://core.svn.wordpress.org/trunk@40809 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-28 12:55:43 +00:00
Sergey Biryukov
c6289b7440
Docs: Add missing backtick character in `export_wp()` DocBlock.
...
Props pbiron.
Fixes #41178 .
Built from https://develop.svn.wordpress.org/trunk@40958
git-svn-id: http://core.svn.wordpress.org/trunk@40808 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-27 00:58:41 +00:00
Sergey Biryukov
01a6f4d38e
Administration: In taxonomy list tables, display a dash instead of a blank space and add "No description" as a screen reader text when the term description is blank.
...
Props pratikgandhi, yahil.
Fixes #40659 .
Built from https://develop.svn.wordpress.org/trunk@40957
git-svn-id: http://core.svn.wordpress.org/trunk@40807 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-27 00:34:41 +00:00
Sergey Biryukov
25e94961b4
Administration: In user list tables, display a dash instead of a blank space and add "Unknown" as a screen reader text when the user's first name and last name are blank.
...
Props Girishpanchal, yahil.
Fixes #40628 .
Built from https://develop.svn.wordpress.org/trunk@40956
git-svn-id: http://core.svn.wordpress.org/trunk@40806 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-27 00:27:39 +00:00
Sergey Biryukov
d08982bdbc
Docs: Remove inaccurate parts of `get_header`, `get_footer`, and `get_sidebar` hooks documentation.
...
These sentences suggested that the hooks allow a specific template file to be used in place of the default file, which is not the case.
Props desrosj.
Fixes #40892 .
Built from https://develop.svn.wordpress.org/trunk@40955
git-svn-id: http://core.svn.wordpress.org/trunk@40805 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-26 20:56:42 +00:00
Sergey Biryukov
62947553c5
Login and Registration: Prevent the `enable_login_autofocus` filter DocBlock from spilling into JS code.
...
Props chris@vendiadvertising.com .
Fixes #41176 .
Built from https://develop.svn.wordpress.org/trunk@40954
git-svn-id: http://core.svn.wordpress.org/trunk@40804 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-26 20:37:42 +00:00
Felix Arntz
5650910c50
Multisite: Remove full stops from radio and checkbox labels in the Network Settings screen.
...
This change brings consistency with the regular site administration panel settings pages: Radio and checkbox labels do not use full stops there, so those in the network administration panel should not either.
Props Ankit K Gupta.
Fixes #39319 .
Built from https://develop.svn.wordpress.org/trunk@40953
git-svn-id: http://core.svn.wordpress.org/trunk@40803 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-26 19:20:40 +00:00
Drew Jaynes
78dba2fefd
Docs: List out accepted values for the `$field` parameter in `get_the_author_meta()`.
...
Props choongsavvii.
Fixes #38258 .
Built from https://develop.svn.wordpress.org/trunk@40952
git-svn-id: http://core.svn.wordpress.org/trunk@40802 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-26 18:24:40 +00:00
Drew Jaynes
faab7f4533
Docs: Improve and clarify the DocBlock summary for `wpmu_log_new_registrations()`.
...
Props daymobrew.
Fixes #39922 .
Built from https://develop.svn.wordpress.org/trunk@40951
git-svn-id: http://core.svn.wordpress.org/trunk@40801 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-26 18:05:41 +00:00
Drew Jaynes
474711aac1
Docs: Adjust notation for the `$context` parameter in the DocBlocks for the `wp_kses_allowed_html()` function and its associated `wp_kses_allowed_html` filter.
...
`$context|$allowedtags` can be either a string or array.
Props bor0.
Fixes #40575 .
Built from https://develop.svn.wordpress.org/trunk@40950
git-svn-id: http://core.svn.wordpress.org/trunk@40800 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 22:16:40 +00:00
Drew Jaynes
75acd01f98
Docs: Notate `format_for_editor()` as the replacement function in the DocBlock for the deprecated `wp_richedit_pre()`.
...
Props rabmalin.
See #41121 . Fixes #40709 .
Built from https://develop.svn.wordpress.org/trunk@40949
git-svn-id: http://core.svn.wordpress.org/trunk@40799 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 22:10:41 +00:00
Drew Jaynes
07f01a2e10
Docs: Replace a variety of http links referenced in inline docs with their https counterparts (where possible).
...
Props johnpgreen.
Fixes #40732 .
Built from https://develop.svn.wordpress.org/trunk@40948
git-svn-id: http://core.svn.wordpress.org/trunk@40798 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 22:06:41 +00:00
Drew Jaynes
97ef1ca74b
Docs: Add missing deprecation, introduction, and summary information to the DocBlock for `WP_Admin_Bar::recursive_render()`.
...
Props coffee2code.
Fixes #40840 .
Built from https://develop.svn.wordpress.org/trunk@40947
git-svn-id: http://core.svn.wordpress.org/trunk@40797 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 21:58:41 +00:00
Drew Jaynes
3a3e133aaf
Docs: Clarify that the `$post` parameters for the `get_the_modified_date` and `get_the_modified_time` filters can also be of type `null`.
...
Props dlh.
Fixes #40845 .
Built from https://develop.svn.wordpress.org/trunk@40946
git-svn-id: http://core.svn.wordpress.org/trunk@40796 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 21:50:40 +00:00
Drew Jaynes
30719312fb
Docs: Add a clarification to the description about what the `$output` parameter in the `embed_html` filter doc represents.
...
Props musus.
Fixes #37752 .
Built from https://develop.svn.wordpress.org/trunk@40945
git-svn-id: http://core.svn.wordpress.org/trunk@40795 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 21:46:39 +00:00
Drew Jaynes
22f76adc8c
Docs: Add full documentation for members in the labels object returned by get_taxonomy_labels().
...
Props truongwp.
Fixes #41108 .
Built from https://develop.svn.wordpress.org/trunk@40944
git-svn-id: http://core.svn.wordpress.org/trunk@40794 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 21:42:43 +00:00
Drew Jaynes
f6bf00d378
Docs: Add a note to the DocBlock for `wp_signon()` mentioning that it doesn't handle setting the current user.
...
Also outlines the conditions that must be met for is_user_logged_in() to work with it.
Part props SergeyBiryukov.
Fixes #28116 .
Built from https://develop.svn.wordpress.org/trunk@40943
git-svn-id: http://core.svn.wordpress.org/trunk@40793 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 20:08:40 +00:00
Drew Jaynes
de7499f88f
Docs: Add full documentation for arguments accepted by `wp_get_nav_menu_items()`.
...
Also provide differentiation between arguments as passed to `get_posts()` vs used for ordering outputted menu items.
By and large, arguments in the `$args` array are intended to directly affect how nav_menu_item posts are retrieved. When the default ARRAY_A is used for 'output', the 'order' and 'orderby' arguments are essentially ignored, instead giving preference to a hard-coded order of 'ASC' and an orderby value derived from the non-get_posts() argument 'output_key'.
Fixes #15533 .
Built from https://develop.svn.wordpress.org/trunk@40942
git-svn-id: http://core.svn.wordpress.org/trunk@40792 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 19:37:39 +00:00
Weston Ruter
b7ca48fff0
Widgets: Add accessibility mode support for TinyMCE-enhanced Text and Media widgets (Video, Audio, Images).
...
Amends [40640], [40631].
Props westonruter, afercia.
See #35243 , #32417 .
Fixes #40986 .
Built from https://develop.svn.wordpress.org/trunk@40941
git-svn-id: http://core.svn.wordpress.org/trunk@40791 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 18:48:41 +00:00
John Blackbourn
a507248146
Users: Use more appropriate HTTP status codes for errors relating to user management.
...
Also re-uses one error message string.
Props tuanmh
Fixes #40230
Built from https://develop.svn.wordpress.org/trunk@40940
git-svn-id: http://core.svn.wordpress.org/trunk@40790 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 18:46:44 +00:00
Weston Ruter
46551a898a
Widgets: Forcibly limit Video widget to only accept oEmbed URLs from YouTube and Vimeo (for now).
...
Amends [40640].
Props timmydcrawford.
See #34115 , #39994 .
Fixes #40935 .
Built from https://develop.svn.wordpress.org/trunk@40939
git-svn-id: http://core.svn.wordpress.org/trunk@40789 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2017-06-25 07:24:41 +00:00