Commit Graph

123 Commits

Author SHA1 Message Date
Sergey Biryukov
920f29616a Docs: Use 3-digit, x.x.x-style semantic versioning for _doing_it_wrong(), _deprecated_function(), _deprecated_argument(), and _deprecated_file() throughout core.
Props metodiew.
Fixes #36495.

git-svn-id: https://develop.svn.wordpress.org/trunk@37985 602fd350-edb4-49c9-b593-d223f7449a82
2016-07-06 12:39:01 +00:00
Nikolay Bachiyski
6e9a0fb948 Admin: Escape attachment name in case it contains special characters
git-svn-id: https://develop.svn.wordpress.org/trunk@37774 602fd350-edb4-49c9-b593-d223f7449a82
2016-06-21 14:18:27 +00:00
Sergey Biryukov
2e79b18178 Themes: Make default "read more" link more accessible.
Add an `aria-label` with the post title to make it available for screen readers.

Props Kau-Boy.
Fixes #36572.

git-svn-id: https://develop.svn.wordpress.org/trunk@37706 602fd350-edb4-49c9-b593-d223f7449a82
2016-06-14 22:45:10 +00:00
Peter Wilson
db0195c936 DOCS: Replace HTTP links with HTTPS.
Replaces unsecure links in documentation and translator comments with their secure versions.

Props johnpgreen, netweb

Fixes #36993


git-svn-id: https://develop.svn.wordpress.org/trunk@37674 602fd350-edb4-49c9-b593-d223f7449a82
2016-06-10 04:49:09 +00:00
Drew Jaynes
9531107084 Docs: Apply inline @see tags to hooks referenced in DocBlocks in a variety of wp-includes/* files.
Applying these specially-crafted `@see` tags allows the Code Reference parser to recognize and link these elements as actions and filters.

Fixes #36921.


git-svn-id: https://develop.svn.wordpress.org/trunk@37544 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-23 19:01:40 +00:00
Drew Jaynes
421522e8b8 Docs: Standardize filter docs in wp-includes/post-template.php to use third-person singular verbs per the inline documentation standards for PHP.
See #36913.


git-svn-id: https://develop.svn.wordpress.org/trunk@37501 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-22 18:27:48 +00:00
Drew Jaynes
520ed6b725 Docs: Remove/replace invalid inline @link tags in DocBlocks in wp-includes/*.
Fixes #36910.


git-svn-id: https://develop.svn.wordpress.org/trunk@37487 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-22 17:39:00 +00:00
Dominik Schilling (ocean90)
4bd7394a2e Themes: Revert [36112]
Adding the `singular` class per default to the list of body classes is breaking the layout of Twenty Eleven and other themes. Twenty Eleven adds the `.singular` class only to single pages if the page doesn't use specific page templates.

Props flixos90, swissspidy.
Fixes #36510.

git-svn-id: https://develop.svn.wordpress.org/trunk@37249 602fd350-edb4-49c9-b593-d223f7449a82
2016-04-19 21:23:20 +00:00
Drew Jaynes
08ec976d15 Docs: Use a third-person singular verb for the get_the_excerpt() DocBlock summary.
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@36942 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 17:51:42 +00:00
Weston Ruter
6740130925 Customize: Restore body class removed in [36837] for when custom logo is present.
The class name is `wp-custom-logo` and it will be toggled by JS in the Customizer preview when the custom logo is added or removed.

See #33755.
Fixes #35945.


git-svn-id: https://develop.svn.wordpress.org/trunk@36903 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-09 19:32:33 +00:00
Konstantin Obenland
43ff969765 Customize: Site logos are custom logos.
Brings the nomenclature closer to custom headers and backgrounds.

See https://wordpress.slack.com/archives/core/p1456955151003150
See #35945. 


git-svn-id: https://develop.svn.wordpress.org/trunk@36837 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-03 19:55:15 +00:00
Konstantin Obenland
b73a1c9aa9 Customize: Introduce Logo support for themes.
Allows a common theme feature to have a common implementation provided by core and available in a consistent location for users.
See https://make.wordpress.org/core/2016/02/24/theme-logo-support/

Props kwight, enejb, jeherve, bhubbard, samhotchkiss, zinigor, eliorivero, adamsilverstein, melchoyce, ryan, mikeschroder, westonruter, pento, karmatosed, celloexpressions, obenland. 
See #33755.



git-svn-id: https://develop.svn.wordpress.org/trunk@36698 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-24 22:09:54 +00:00
Mel Choyce
8a9d0e3499 Forms: Swap "Submit" button label for "Enter" on password-protected pages.
Props karmatosed, SergeyBiryukov

See #35042.


git-svn-id: https://develop.svn.wordpress.org/trunk@36685 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-24 16:24:36 +00:00
Pascal Birchler
3541f7b90b Posts: Correctly pass $post to post_password_required() in get_the_excerpt().
Corrects the relevant test.

Props sebastian.pisula for initial patch.
Fixes #35486.

git-svn-id: https://develop.svn.wordpress.org/trunk@36329 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-16 10:13:27 +00:00
Pascal Birchler
20580bed82 Post: After [36319], add $post parameter to the get_the_excerpt filter.
Props sebastian.pisula.
Fixes #35474.

git-svn-id: https://develop.svn.wordpress.org/trunk@36321 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-15 19:27:57 +00:00
Pascal Birchler
57978063cf Posts: Add a $post parameter to get_the_excerpt().
This allows getting the excerpt for a specific post, similar to how most other template tags work.
A deprecation notice is thrown if a boolean value is passed, which is deprecated since 2.3 and has not been used for a long time.
Adds unit tests.

Fixes #27246.

git-svn-id: https://develop.svn.wordpress.org/trunk@36319 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-15 14:47:00 +00:00
John Blackbourn
a9b9aa65b9 Themes: Add singular to the list of body classes when viewing a single post object.
Adds tests

Fixes #35164
Props danielpataki, johnbillion


git-svn-id: https://develop.svn.wordpress.org/trunk@36112 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-28 17:20:07 +00:00
Sergey Biryukov
c2d8c86b93 Docs: Capitalize 'URL' correctly in the_guid() DocBlock. Fix a typo.
See #32246.

git-svn-id: https://develop.svn.wordpress.org/trunk@35920 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-14 05:20:25 +00:00
Sergey Biryukov
e01a52e878 Post Template: Pass the post ID to the_guid and get_the_guid filters.
Props danielbachhuber for initial patch.
Fixes #35015.

git-svn-id: https://develop.svn.wordpress.org/trunk@35867 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-11 16:38:15 +00:00
Konstantin Obenland
2be61281f0 Template: Defining a default value for show_home breaks back compat.
To add a home link to the fallback menu output many themes only check if that
argument is set. Including Twenty Ten and Twenty Eleven. They check with
`isset()` so child themes and other instances using `wp_page_menu()` have a
chance to disable the home link by setting it to `false`.

Fixes #11095.



git-svn-id: https://develop.svn.wordpress.org/trunk@35737 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-25 18:54:51 +00:00
Sergey Biryukov
0dd41231fa Docs: After [35399], correct $class parameter type and description for post_class filter.
See #34452.

git-svn-id: https://develop.svn.wordpress.org/trunk@35400 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-26 15:11:53 +00:00
Sergey Biryukov
d8ddd686d5 In get_post_class(), ensure that we always coerce the class list passed to the function to an array, even when it's empty.
This is consistent with `get_body_class()`, see [18176].

See #34452.

git-svn-id: https://develop.svn.wordpress.org/trunk@35399 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-26 15:08:47 +00:00
Sergey Biryukov
8a105470b4 Docs: Correct $class parameter type and description for body_class filter.
Props JPry.
Fixes #34452.

git-svn-id: https://develop.svn.wordpress.org/trunk@35398 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-26 15:02:53 +00:00
Drew Jaynes
b0093711e4 Docs: Normalize spacing in the wp_get_attachment_link hook doc following [35065].
See #34257. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35066 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 16:43:19 +00:00
Drew Jaynes
e73fbb948c Docs: Adjust documentation for the $size parameter in the wp_get_attachment_link hook doc to clarify the required order of width and height values when an array is passed.
Also adds the `array` type to the parameter documentation (already supported).

See #34257.


git-svn-id: https://develop.svn.wordpress.org/trunk@35065 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 16:41:54 +00:00
Drew Jaynes
f948ce0902 Docs: Fix the syntax for marking parameters optional and add defaults in the DocBlock for wp_get_attachment_link().
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35057 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 16:14:03 +00:00
Drew Jaynes
9a3fcf9fee Docs: Adjust documentation for the $size parameter in wp_get_attachment_link() to clarify the required order of width and height values when passing an array.
Also adds the `array` type to the parameter documentation (already supported).

Props jaspermdegroot.
See #34257.


git-svn-id: https://develop.svn.wordpress.org/trunk@35050 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 15:55:12 +00:00
Konstantin Obenland
7e923cc0fe Template: Add fallback for empty containers.
Since [14031] the container can be omitted in `wp_nav_menu()`. It can not
however in `wp_page_menu()`, which creates a conflict if it is set as
the fallback, Let's make sure there is always a valid container tag.

Fixes #33974.



git-svn-id: https://develop.svn.wordpress.org/trunk@34950 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-08 18:26:13 +00:00
Konstantin Obenland
cb4554b3df Posts: Add post class for password protected posts.
Up until now password protected posts would only get a identifying class when
the password was still required. This adds a class for the case when that
requirement has been met.

For the other visibility types we already have `status-publish`
and `status-private`.

Props mdgl, F4rkie, wonderboymusic for initial patches.
Fixes #21899.



git-svn-id: https://develop.svn.wordpress.org/trunk@34881 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-06 21:53:20 +00:00
Drew Jaynes
1aaa0aa607 Docs: Adjust the line wrap indentation on the $link parameter description for the wp_post_revision_title_expanded hook, introduced in [34842].
See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@34843 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-06 01:29:04 +00:00
Helen Hou-Sandi
8baf0e0737 Revisions: Add a wp_post_revision_title_expanded filter.
This allows for content to be added to revision lists, such as in the revisions metabox.

fixes #9681.


git-svn-id: https://develop.svn.wordpress.org/trunk@34842 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-06 00:58:17 +00:00
Drew Jaynes
f6ce56219a Docs: Fix a few syntatical issues with inline documentation in wp-includes/post-template.php.
Props welcher.
See #30224.


git-svn-id: https://develop.svn.wordpress.org/trunk@34768 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-02 06:37:48 +00:00
Scott Taylor
a155c5dcfd After [34200], force 'before' and 'after' to <ul> and </ul> when wp_nav_menu() falls back to wp_page_menu().
See #11095.


git-svn-id: https://develop.svn.wordpress.org/trunk@34653 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-27 23:38:32 +00:00
Scott Taylor
d416922cbf Remove some unused globals and/or their docs.
See ##33491.


git-svn-id: https://develop.svn.wordpress.org/trunk@34446 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-22 20:26:17 +00:00
Scott Taylor
f4445d75c4 Add a 'menu_id' argument to wp_page_menu() so that fallback menus have the same attributes as wp_nav_menu().
Props lancewillett, ocean90, wonderboymusic.
Fixes #31656.


git-svn-id: https://develop.svn.wordpress.org/trunk@34330 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-19 18:06:49 +00:00
Scott Taylor
b862280404 After [34280], rename menu_tag arg to container, fix docs.
Props DrewAPicture.
Fixes #10968.


git-svn-id: https://develop.svn.wordpress.org/trunk@34307 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-18 19:04:18 +00:00
Scott Taylor
30921dd396 Add an argument to wp_page_menu(), 'menu_tag', which defaults to div but can be overridden to allow HTML5 tags like nav.
Props paulwilde, stebbiv, wonderboymusic.
Fixes #10968.


git-svn-id: https://develop.svn.wordpress.org/trunk@34280 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-18 06:06:17 +00:00
Sergey Biryukov
45c6094dce Docs: Update the DocBlock for wp_page_menu() to include 'before', 'after', and 'walker' arguments added in [34200].
Align the `$defaults` array and include the default value for `'show_home'`.

Props stevegrunwell.
Fixes #11095.

git-svn-id: https://develop.svn.wordpress.org/trunk@34243 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-16 16:46:08 +00:00
Scott Taylor
b5b07ca329 Allow wp_page_menu() to accept 'walker', 'before', and 'after' to allow custom markup.
Fixes #11095.


git-svn-id: https://develop.svn.wordpress.org/trunk@34200 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-15 15:05:34 +00:00
Scott Taylor
c0d850878a Create a function, get_preview_post_link(), to DRY the logic for applying the 'preview_post_link' filter to a URL.
Props TomHarrigan, wonderboymusic.
Fixes #24345.


git-svn-id: https://develop.svn.wordpress.org/trunk@34170 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-15 04:14:23 +00:00
Scott Taylor
1ccae571d9 Move Walker_Page and Walker_PageDropdown into their own files via svn cp. Remove them from post-template.php. Load them in post.php.
`post-template.php` loads after `post.php` in `wp-settings.php`. It could probably also be loaded in `post.php`, but avoiding that for the moment.

See #33413.


git-svn-id: https://develop.svn.wordpress.org/trunk@34109 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-14 02:58:40 +00:00
Scott Taylor
2d5945f0fc In wp_link_pages(), ensure that $prev is greater than 0.
Props betzster.
Fixes #25273.


git-svn-id: https://develop.svn.wordpress.org/trunk@34108 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-14 02:45:33 +00:00
Scott Taylor
b52b5893c4 Pass $r and $pages to the 'wp_dropdown_pages' and 'wp_list_pages' filters.
Props bigdawggi, SergeyBiryukov.
Fixes #23734.


git-svn-id: https://develop.svn.wordpress.org/trunk@34103 602fd350-edb4-49c9-b593-d223f7449a82
2015-09-14 01:31:12 +00:00
Scott Taylor
f804d9a91d In wp_get_attachment_link(), accept an id or WP_Post as the first parameter.
Props several27, DrewAPicture.
Fixes #33277.


git-svn-id: https://develop.svn.wordpress.org/trunk@33669 602fd350-edb4-49c9-b593-d223f7449a82
2015-08-20 20:31:34 +00:00
Dominik Schilling (ocean90)
5f9ef8fed3 Customizer: Improve handling of posts with no title.
Use the `#%d (no title)` string as a fallback which is already used on the nav menus screen.
Add a translator comment to all occurrences of the `#%d (no title)` string.

see #32576.

git-svn-id: https://develop.svn.wordpress.org/trunk@32892 602fd350-edb4-49c9-b593-d223f7449a82
2015-06-20 19:49:43 +00:00
Boone Gorges
dba2b6a9c0 Introduce class argument to wp_dropdown_pages().
This new argument allows devs to specify the 'class' attribute of the select
element.

Props ramiy, voldemortensen.
Fixes #30082.

git-svn-id: https://develop.svn.wordpress.org/trunk@32727 602fd350-edb4-49c9-b593-d223f7449a82
2015-06-12 13:04:04 +00:00
Scott Taylor
a3f9ed1494 Add missing doc blocks to post-template.php.
Correct some types for `@param` and `@return`.
`is_page_template()` can return the conditional instead of if/else true/false.

See #32444.


git-svn-id: https://develop.svn.wordpress.org/trunk@32617 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-27 16:25:17 +00:00
Dominik Schilling (ocean90)
af4f52bf40 Don't print the custom-background class in body_class() when a default color is in use.
`.custom-background` should only be added if a background color or an image divert from their defaults. This behavior exists already in `_custom_background_cb()`.

props slobodanmanic, nitkr, valendesigns, obenland.
see [21054], [21001].
fixes #28687.

git-svn-id: https://develop.svn.wordpress.org/trunk@32081 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-08 17:28:23 +00:00
Drew Jaynes
239115a7d2 Variously inline documentation syntactical fixes in wp-includes/post-template.php.
See #31888.


git-svn-id: https://develop.svn.wordpress.org/trunk@32046 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-05 16:49:18 +00:00
Sergey Biryukov
4738590d5e Avoid duplicate classes for different terms with UTF-8 slugs in post_class() and body_class().
Fall back to term ID if the sanitized slug is numeric or only contains hyphens.

props SergeyBiryukov, A5hleyRich, sgrant, davideugenepratt.
fixes #30883.

git-svn-id: https://develop.svn.wordpress.org/trunk@31979 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-02 01:04:22 +00:00