Commit Graph

157 Commits

Author SHA1 Message Date
Drew Jaynes
14ca371c1c Docs: Standardize filter docs in wp-includes/general-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@37498 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-22 18:25:45 +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
Drew Jaynes
195572596b Docs: Standardize on 'backward compatibility/compatible' nomenclature in core inline docs.
Also use 'back-compat' in some inline comments where backward compatibility is the subject and shorthand feels more natural.

Note: 'backwards compatibility/compatibile' can also be considered correct, though it's primary seen in regular use in British English.

Props ocean90.
Fixes #36835.


git-svn-id: https://develop.svn.wordpress.org/trunk@37431 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-13 18:40:19 +00:00
Drew Jaynes
c7bed4f8c6 Docs: Remove inline @see tags from function, class, and method references in inline docs.
Known functions, classes, and methods are now auto-linked in Code Reference pages following #meta1483.

Note: Hook references are still linked via inline `@see` tags due to the unlikelihood of reliably matching for known hooks based on a RegEx pattern.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@37342 602fd350-edb4-49c9-b593-d223f7449a82
2016-05-02 03:59:56 +00:00
Drew Jaynes
26f2705558 Docs: Clarify the return descriptions for get_the_time(), get_post_time(), and get_post_modified_time() to specify when an integer in the form of a Unix timestamp should be expected.
See [30674]. See #30989.


git-svn-id: https://develop.svn.wordpress.org/trunk@37265 602fd350-edb4-49c9-b593-d223f7449a82
2016-04-20 15:54:20 +00:00
Konstantin Obenland
ef53a0db39 Template: Remove $size reference from get_custom_logo().
Argument was removed in [37077] in favor of `with` and `height` arguments.

Props ocean90.
Fixes #36327.



git-svn-id: https://develop.svn.wordpress.org/trunk@37135 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-30 17:19:41 +00:00
Sergey Biryukov
e86930f864 Remove several one-time variables from wp_get_archives(), added in [24] and [190].
Props pbearne for initial patch.
Fixes #36243.

git-svn-id: https://develop.svn.wordpress.org/trunk@37005 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-16 10:19:43 +00:00
Sergey Biryukov
efeff26a67 Docs: Update default $size value for get_custom_logo filter after [36950].
Props wido.
See #33755.

git-svn-id: https://develop.svn.wordpress.org/trunk@36975 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-13 09:13:50 +00:00
Konstantin Obenland
cda0901425 Template: Explicitly set full as the default custom logo size.
See #33755.


git-svn-id: https://develop.svn.wordpress.org/trunk@36950 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 19:02:25 +00:00
Konstantin Obenland
6f69ca857e Tests: Introduce multisite unit tests.
Makes sure custom logo functions work for other sites within a network.
Fixes a bug in `get_custom_logo()` where the correct logo was returned, but
linked to the wrong site.

H/t ocean90.
See #33755, #36086.


git-svn-id: https://develop.svn.wordpress.org/trunk@36949 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 18:56:56 +00:00
Drew Jaynes
606d131f52 Docs: Improve the 4.5.0 changelog entry in the hook doc for the get_archives_link filter, introduced in [36418].
See #35573. See #35986.


git-svn-id: https://develop.svn.wordpress.org/trunk@36939 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 17:46:44 +00:00
Drew Jaynes
d2a3bea2f7 Docs: Improve the $blog_id parameter description in the DocBlock for the_custom_logo(), introduced in [36698].
See #33755. See #35986.


git-svn-id: https://develop.svn.wordpress.org/trunk@36938 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 17:45:20 +00:00
Drew Jaynes
71bd9dc422 Docs: Improve the $blog_id parameter description in the DocBlock for get_custom_logo(), introduced in [36698].
See #33755. See #35986.


git-svn-id: https://develop.svn.wordpress.org/trunk@36937 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 17:44:23 +00:00
Drew Jaynes
5f72981462 Docs: Improve inline documentation for has_custom_logo(), introduced in [36698].
See #33755. See #35986.


git-svn-id: https://develop.svn.wordpress.org/trunk@36936 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-10 17:43:32 +00:00
Konstantin Obenland
6d951b3c5d Customize: Only add custom logo’s header text control if needed.
Dissolves `WP_CustomLogo` and adopts a structure similar to custom header and background (See `_delete_attachment_theme_mod()`).
The option to hide header text only gets added if it’s not already part of custom header, and only if selectors have been registered when theme support for custom logos was declared. Themes can add `postMessage` support for it as well.

Example:
{{{
add_theme_support( 'custom-logo', array(
    'size' => ‘large’,
    'header-text' => array( 'site-title', 'site-description' ),
) );
}}}

See #33755.


git-svn-id: https://develop.svn.wordpress.org/trunk@36915 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-09 23:43:49 +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
Dominik Schilling (ocean90)
c119ce9ac2 I18N: Don't use the locale for the HTML language attribute.
Locales are codes to identify a language in WordPress which can be different from the specification for language tags, see https://www.w3.org/International/articles/language-tags/.
An example is `de_DE_formal` or `nl_NL_formal` where the subtag `formal` isn't officially supported.

To give translators the possibility to specify the language tag of their language introduce a string `html_lang_attribute` which can be translated into the language tag which conforms to the specification.

Props SergeyBiryukov.
Fixes #33511.

git-svn-id: https://develop.svn.wordpress.org/trunk@36802 602fd350-edb4-49c9-b593-d223f7449a82
2016-03-02 16:10:00 +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
Drew Jaynes
177351364c Embeds: Introduce embed templates into the template hierarchy via theme-compat.
Splits wp-includes/embed-template.php, introduced in 4.4, into five new templates that can be individually overridden by themes:

* embed.php
* embed-404.php
* embed-content.php
* header-embed.php
* footer-embed.php

Also introduces a new template tag for outputting the site title, `the_embed_site_title()`.

The five new templates live in theme-compat, allowing for graceful fallbacks should themes prefer not to override any or all of them.

Props swissspidy, imath, ocean90, DrewAPicture.
See #34561.


git-svn-id: https://develop.svn.wordpress.org/trunk@36693 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-24 20:56:18 +00:00
Aaron Jorbin
31e4c5c5d9 Make Custom Taxonomy Feeds Auto-discoverable
This helps improve the parity between custom taxonomies and built in taxonomies. It is one small step to #makeCustomTaxonomyFeedsGreatAgain.

Fixes #23677
Props mdgl, stevenkword



git-svn-id: https://develop.svn.wordpress.org/trunk@36671 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-24 02:35:23 +00:00
Dominik Schilling (ocean90)
2d25c6ce26 Template: Update label for the username field in wp_login_form() after [36617].
See #9568.

git-svn-id: https://develop.svn.wordpress.org/trunk@36620 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-22 23:37:21 +00:00
Andrea Fercia
15a26902a6 Accessibility: Improve color contrast updating any #999 gray used for text or icons to a darker gray.
Fixes #35660.

git-svn-id: https://develop.svn.wordpress.org/trunk@36587 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-19 18:43:04 +00:00
Dominik Schilling (ocean90)
c80ed70337 In wp_title() fix a 7 year old typo.
Props joelerr.
Fixes #34879.

git-svn-id: https://develop.svn.wordpress.org/trunk@36540 602fd350-edb4-49c9-b593-d223f7449a82
2016-02-16 22:27:05 +00:00
Boone Gorges
c974ac77c4 Pass additional params to 'get_archive_links' filter.
Props sebastian.pisula.
Fixes #35573.

git-svn-id: https://develop.svn.wordpress.org/trunk@36418 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-28 04:45:46 +00:00
Drew Jaynes
535d080317 Docs: List out possible values for the $show parameter in the description for get_bloginfo().
Fixes #35581.


git-svn-id: https://develop.svn.wordpress.org/trunk@36382 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-22 20:21:40 +00:00
Drew Jaynes
ad00ffffe4 Docs: Improve documentation for bloginfo() including cross-reference info for the $show parameter passed through to get_bloginfo().
See #35581.


git-svn-id: https://develop.svn.wordpress.org/trunk@36380 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-22 20:16:11 +00:00
Andrea Fercia
fa998d9b8c Accessibility: remove the title attribute from the get_search_form() HTML5 search field.
It was added in [23801] as a workaround for issues with very old browser/screen reader combos (Jaws7/IE6).
No more necessary today. Reduces redundancy and noise for screen reader users.

See #16539.
Fixes #33952.

git-svn-id: https://develop.svn.wordpress.org/trunk@36222 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-08 19:00:39 +00:00
Konstantin Obenland
0d6514b28b Template: Always display the site title on the front page.
Limits using the page title to the blog page when the site has a static front page,
bringing it N’Sync with `wp_title()`.

Props peterwilsoncc.
Fixes #34962.



git-svn-id: https://develop.svn.wordpress.org/trunk@36168 602fd350-edb4-49c9-b593-d223f7449a82
2016-01-04 17:15:31 +00:00
Sergey Biryukov
7e3d2c3e4c Docs: Improve documentation for wp_admin_css_color().
Props kiranpotphode.
Fixes #34857.

git-svn-id: https://develop.svn.wordpress.org/trunk@36107 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-27 16:32:00 +00:00
John Blackbourn
858cf7d215 Docs: Miscellaneous docblock code quality tweaks.
See #32246


git-svn-id: https://develop.svn.wordpress.org/trunk@36074 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-23 07:52:04 +00:00
John Blackbourn
da011967e7 Login: Revert [34213] and [35897]. It has become apparent that there is a need for a separate function (and corresponding filter) which allows for the login form action URL to differ from the URL used to access the login form, so that plugins or implementations which change the login URL do not need to worry about handling the form submission at the same URL.
For now, we'll revert to the pre-4.4 behaviour of hard-coding the login form action URL as `wp-login.php` and look at implementing a separate function and corresponding filter in 4.5.

Props KrissieV, salcode, JPry
Fixes #34925
See #35103


git-svn-id: https://develop.svn.wordpress.org/trunk@36042 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-21 03:22:32 +00:00
Pascal Birchler
5d302ca4d2 Login: After [34213], use the login_post scheme again for login forms.
See #34925.

git-svn-id: https://develop.svn.wordpress.org/trunk@35897 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-13 14:02:04 +00:00
Sergey Biryukov
7dbca374a6 Docs: Remove @todo entry from get_archives_link(), as all optional arguments are now documented.
See #34856.

git-svn-id: https://develop.svn.wordpress.org/trunk@35887 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-12 15:54:11 +00:00
Sergey Biryukov
9689976129 Docs: Document optional parameters in get_archives_link().
Props kiranpotphode.
Fixes #34856.

git-svn-id: https://develop.svn.wordpress.org/trunk@35886 602fd350-edb4-49c9-b593-d223f7449a82
2015-12-12 15:51:57 +00:00
Konstantin Obenland
bbe6aa01aa Template: Use template-loader.php as cononical source of truth for conditional ordering.
Reverts [35700] which didn't account for author archives without posts.
Determination of the correct title is now based on the same order of
conditionals that template loader uses to select the right template.

H/t ocean90.
Fixes #34516.



git-svn-id: https://develop.svn.wordpress.org/trunk@35706 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-19 17:08:33 +00:00
Konstantin Obenland
17ba0ec012 Template: Get the author name directly from $authordata.
Since [25574] `$authordata` gets set up in `WP::register_globals()` - no need
to take a detour over the queried object.

Props greenshady for initial patch.
Fixes #34516.


git-svn-id: https://develop.svn.wordpress.org/trunk@35700 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-19 00:05:37 +00:00
Konstantin Obenland
46d6c9198e Template: Un-deprecate wp_title().
Before it can be deprecated we should identify alternative usages and define
a path forward for them.

See [35294], #31078.



git-svn-id: https://develop.svn.wordpress.org/trunk@35624 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-11 23:49:31 +00:00
Jeremy Felt
9d48f6c7c3 Site Icon: Wrap site icon retrieval with switch_to_blog() as needed.
When the site icon for another site is requested, retrieving its ID via `get_blog_option()` is not enough. `switch_to_blog()` is used to set proper context when required.

Adds multsite tests for `has_site_icon()`.

Props imath.
Fixes #34312.


git-svn-id: https://develop.svn.wordpress.org/trunk@35572 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-08 02:03:34 +00:00
Jeremy Felt
99c7b9b881 Site Icon: Use new wp_get_attachment_image_url() to retrieve URL.
`wp_get_attachment_image_url()` is a nice replacement for `wp_get_attachment_image_src()` here after its introduction in 4.4.

Props imath.
See #34312.


git-svn-id: https://develop.svn.wordpress.org/trunk@35571 602fd350-edb4-49c9-b593-d223f7449a82
2015-11-08 01:58:56 +00:00
Sergey Biryukov
9f0076436b Editor: After [33927], make sure user_can_richedit() returns true for Microsoft Edge.
Props usermrpapa.
Fixes #34431.

git-svn-id: https://develop.svn.wordpress.org/trunk@35384 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-24 18:12:10 +00:00
Sergey Biryukov
a001771ec4 Site Icon: Introduce get_site_icon_url filter for the icon URL.
Remove `oembed_site_icon_url` filter added in [34903].

Props swissspidy.
Fixes #34411.

git-svn-id: https://develop.svn.wordpress.org/trunk@35379 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-23 21:16:30 +00:00
Drew Jaynes
6c178fd1ab Docs: Add documentation in the form of a hash notation for default arguments accepted by wp_login_form().
Props ramiy for the initial patch.
Fixes #34364.


git-svn-id: https://develop.svn.wordpress.org/trunk@35328 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-21 15:37:23 +00:00
Drew Jaynes
1871d57dc5 Docs: Adjust syntax in the hook doc summaries for the document_title_separator and document_title_parts filters, introduced in [35294].
See #31078. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35301 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-20 18:35:46 +00:00
Drew Jaynes
b11b651d24 Docs: Fix indentation and improve usefulness of inline comments surrounding the if/elseif conditions for assigning document titles in wp_get_document_title().
See #31078. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35300 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-20 18:30:59 +00:00
Drew Jaynes
8ec6153115 Docs: Update the hook doc for the pre_get_document_title filter to explain ''what'' value is filterable rather than ''why'' the value is filterable :-)
The hook was introduced in [35294].

See #31078. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35298 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-20 18:13:13 +00:00
Konstantin Obenland
d625bd2428 Themes: Improve document title output.
Introduces more flexibility in filtering all parts of the document title,the
separator, and a way to short-circuit title generation. Plugins can now also
check for theme support and reliably filter the entire output. See #18548.
Deprecates `wp_title()`.

Fixes #31078.



git-svn-id: https://develop.svn.wordpress.org/trunk@35294 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-20 16:20:04 +00:00
Sergey Biryukov
c0c0305749 Replace get_bloginfo( 'wpurl' ) with site_url() in rsd_link().
Ensure the correct scheme is used for the `application/rsd+xml` link URL.

Props johnbillion.
See #34280.

git-svn-id: https://develop.svn.wordpress.org/trunk@35105 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-13 01:48:32 +00:00
John Blackbourn
91583fe499 Add missing @since params and update the docs for site_icon_url() and has_site_icon().
See #32246


git-svn-id: https://develop.svn.wordpress.org/trunk@35090 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 23:27:18 +00:00
Drew Jaynes
6e4fdc4cbf Docs: Improve documentation for get_site_icon_url(), introduced in [32994].
Adds a missing `@since` version, fixes optional parameter syntax, adds default values, and fixes the return description.

See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@35064 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-12 16:37:13 +00:00
John Blackbourn
4703e75f31 shttp is not a protocol.
See #27115


git-svn-id: https://develop.svn.wordpress.org/trunk@34784 602fd350-edb4-49c9-b593-d223f7449a82
2015-10-02 22:47:41 +00:00