WordPress/wp-includes
Drew Jaynes 2e1ebd7b97 Adjust DocBlocks for `get_|the_post_thumbnail()` to clarify the difference between the 'thumbnail' and 'post-thumbnail' image sizes.
Also fleshes out parameter documentation for the two functions.

Props magicroundabout for the initial patch.
Fixes #31351.

Built from https://develop.svn.wordpress.org/trunk@31853


git-svn-id: http://core.svn.wordpress.org/trunk@31832 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-03-20 19:57:26 +00:00
..
ID3 Update getID3 library to 1.9.8. 2014-09-11 19:07:17 +00:00
SimplePie
Text
certificates WP_HTTP: Revert r30491 which updated the bundled root certificates. There's a report that this is breaking under certain PHP/OpenSSL versions (which we've encountered before), and we're safer with a slighty out of date CA bundle than breaking HTTPS communication on affected sites. 2014-12-07 03:13:22 +00:00
css Toolbar: Protect against Firefox font rendering interference by themes. 2015-03-18 22:04:27 +00:00
fonts Dashicons: Update to the latest files. 2014-12-09 19:34:23 +00:00
images `grunt imagemin`for [31745]. 2015-03-12 22:01:26 +00:00
js TinyMCE: revert stripping of tags from pasted URLs on `beforeSetContent` [31817] and [31819]. Clean up URLs on `pastePreProcess`. 2015-03-19 07:08:26 +00:00
pomo Replace `array_shift()` with `reset()` where appropriate for performance. 2015-03-19 03:56:27 +00:00
theme-compat Improve various hook and filter docs so they are correctly parsed for the code reference. 2014-12-06 21:32:24 +00:00
admin-bar.php Add theme browsing and theme switching to the Customizer 2015-02-24 20:31:24 +00:00
atomlib.php
author-template.php When passing `$full` to `get_posts_by_author_sql()`, make sure a 'post_type' clause is included in results. 2015-03-07 01:15:28 +00:00
bookmark-template.php Ensure inline code is markdown-escaped as such, and that code snippets in descriptions are properly indented. 2014-11-24 04:42:22 +00:00
bookmark.php The keyword `elseif` should be used instead of `else if` so that all control keywords look like single words. 2015-01-08 07:05:25 +00:00
cache.php Declare `multisite` as a field for `WP_Object_Cache`. 2015-03-09 02:18:27 +00:00
canonical.php If the URL being visited has non-breaking spaces at the end of it, they were probably inserted by an errant URL copy/paste. Instead of showing a 404 for no obvious reason, let's just trim them. 2015-03-20 01:02:28 +00:00
capabilities.php Introduce delete_site meta capability. 2015-03-08 02:10:30 +00:00
category-template.php Update the DocBlock for `wp_dropdown_categories()` to reflect that the entire `$args` parameter array is optional instead of individual arugments. 2015-02-06 09:04:22 +00:00
category.php Add inline `@see` tags to the docs for the `get_categories_taxonomy` hook. 2014-11-17 17:37:23 +00:00
class-IXR.php XML-RPC: Send 405 Method Not Allowed for GET requests. 2014-12-30 20:41:23 +00:00
class-feed.php In PHP 5.0.0, `is_a()` became deprecated in favour of the `instanceof` operator. Calling `is_a()` would result in an `E_STRICT` warning. 2015-01-16 01:06:24 +00:00
class-http.php `self` should be used for accessing local static members. 2015-03-09 02:22:26 +00:00
class-json.php
class-oembed.php RIP3 Revision3 2015-03-11 02:07:25 +00:00
class-phpass.php Prevent high resource usage when hashing large passwords. props mdawaffe, pento 2014-11-20 16:03:24 +00:00
class-phpmailer.php
class-pop3.php
class-simplepie.php Fix some documentation typos in various core files. 2014-08-13 03:56:17 +00:00
class-smtp.php PHPMailer: Merge upstream commit (PR274). 2014-09-29 10:28:17 +00:00
class-snoopy.php
class-wp-admin-bar.php
class-wp-ajax-response.php `WP_Ajax_Response` has one property only, `$responses`. It was public until [28508], when it became `private` in name only. Is it worth 4 magic methods to pretend that this property is `private`? It is not. 2015-01-11 00:13:23 +00:00
class-wp-customize-control.php Customizer: Introduce `WP_Customize_Media_Control`. 2015-03-10 18:02:28 +00:00
class-wp-customize-manager.php Customizer: Introduce `WP_Customize_Media_Control`. 2015-03-10 18:02:28 +00:00
class-wp-customize-panel.php Add a missing file header to wp-includes/class-wp-customize-panel.php, separate out the class DocBlock for `WP_Customize_Panel`. 2015-02-25 08:09:25 +00:00
class-wp-customize-section.php Add a missing file header and clean up class DocBlocks in wp-includes/class-wp-customize-section.php. 2015-02-25 08:13:26 +00:00
class-wp-customize-setting.php Customizer: Return the original value when filtering theme mods/options and the current blog has changed. 2015-03-10 23:05:27 +00:00
class-wp-customize-widgets.php Customizer: Fix previewing and applying widgets when previewing another theme. 2015-03-10 22:39:28 +00:00
class-wp-editor.php TinyMCE: remove block_formats setting, this is now the default in TinyMCE 4.1.9. 2015-03-11 22:57:28 +00:00
class-wp-embed.php Allow inline editing of `width` and `height` parameters while previewing an embed in the media modal: 2015-03-05 06:00:26 +00:00
class-wp-error.php In PHP 5.0.0, `is_a()` became deprecated in favour of the `instanceof` operator. Calling `is_a()` would result in an `E_STRICT` warning. 2015-01-16 01:06:24 +00:00
class-wp-http-ixr-client.php Improve various `@param` docs for `src/wp-includes/*`. 2014-12-01 01:34:24 +00:00
class-wp-image-editor-gd.php In the `->multi_resize()` method of the `WP_Image_Editor` subclasses, when looping through potential crops, we need to make sure the crop isn't the exact same dimensions as the original image before copying it as a new crop. 2015-02-27 19:38:27 +00:00
class-wp-image-editor-imagick.php In the `->multi_resize()` method of the `WP_Image_Editor` subclasses, when looping through potential crops, we need to make sure the crop isn't the exact same dimensions as the original image before copying it as a new crop. 2015-02-27 19:38:27 +00:00
class-wp-image-editor.php Fix some `@param` docs that have chars too close them. 2015-01-10 06:57:22 +00:00
class-wp-theme.php In PHP 5.0.0, `is_a()` became deprecated in favour of the `instanceof` operator. Calling `is_a()` would result in an `E_STRICT` warning. 2015-01-16 01:06:24 +00:00
class-wp-walker.php `Walker::$has_children` should be public for backward compatibility. 2015-01-11 01:56:22 +00:00
class-wp-xmlrpc-server.php Fix a typo in [30138]. 2015-01-25 09:48:21 +00:00
class-wp.php [31210] broke Supportflow on dotorg, which declares these methods as `protected`. Switch to `protected` for the noop methods. The subclasses can make them more visible using `public`. 2015-01-16 18:37:24 +00:00
class.wp-dependencies.php Ensure inline code is markdown-escaped as such, and that code snippets in descriptions are properly indented. 2014-11-24 04:58:22 +00:00
class.wp-scripts.php Add support for IE conditional comments for WP_Scripts to match the functionality of WP_Styles, including unit tests. Props filosofo, aaroncampbell, ethitter, georgestephanis, valendesigns. Fixes #16024. 2015-01-17 01:37:22 +00:00
class.wp-styles.php Ensure that inline styles attached to conditional stylesheets are also conditional. 2015-01-03 04:10:21 +00:00
comment-template.php Comments: Move HTML tags for screen reader text into translatable strings. 2015-03-18 21:52:27 +00:00
comment.php Move the default arguments hash notation for `WP_Comment_Query` to the new constructor, where the argument definitions were moved in [31793]. 2015-03-16 20:18:28 +00:00
compat.php In PHP 5.0.0, `is_a()` became deprecated in favour of the `instanceof` operator. Calling `is_a()` would result in an `E_STRICT` warning. 2015-01-16 01:06:24 +00:00
cron.php Improve various `@param` docs for `src/wp-includes/*`. 2014-12-01 01:34:24 +00:00
date.php Empty `return` statements are unnecessary at the end of functions. 2015-03-08 23:09:27 +00:00
default-constants.php Remove obsolete inline comment. 2015-01-06 01:57:22 +00:00
default-filters.php Emoji: Rename the email and feed filter functions to be `_` prefixed, and `@ignore`-d in the PHPDocs. 2015-03-16 10:46:26 +00:00
default-widgets.php Add missing labels to Archives and Categories dropdown widgets. 2015-02-23 16:32:25 +00:00
deprecated.php Empty `return` statements are unnecessary at the end of functions. 2015-03-08 23:09:27 +00:00
feed-atom-comments.php
feed-atom.php
feed-rdf.php Improve various hook and filter docs so they are correctly parsed for the code reference. 2014-12-06 21:32:24 +00:00
feed-rss.php
feed-rss2-comments.php Improve various hook and filter docs so they are correctly parsed for the code reference. 2014-12-06 21:32:24 +00:00
feed-rss2.php Improve various hook and filter docs so they are correctly parsed for the code reference. 2014-12-06 21:32:24 +00:00
feed.php Emoji: Rename the email and feed filter functions to be `_` prefixed, and `@ignore`-d in the PHPDocs. 2015-03-16 10:46:26 +00:00
formatting.php Add more verbose inline documentation inside of `wpautop()` to more clearly explain what's going on. 2015-03-20 19:47:27 +00:00
functions.php Add emoji support, with Twemoji fallback. 2015-03-11 22:49:28 +00:00
functions.wp-scripts.php Add support for IE conditional comments for WP_Scripts to match the functionality of WP_Styles, including unit tests. Props filosofo, aaroncampbell, ethitter, georgestephanis, valendesigns. Fixes #16024. 2015-01-17 01:37:22 +00:00
functions.wp-styles.php Make `_wp_scripts_maybe_doing_it_wrong( $function )` "private". 2015-01-16 02:42:22 +00:00
general-template.php Provide a secondary sort order for `wp_get_archives()` when `type=postbypost`. 2015-02-13 17:00:27 +00:00
http.php Improve various `@param` docs. 2014-11-30 23:24:25 +00:00
kses.php Add `<s>` to `$allowedtags` in KSES. 2015-01-16 16:07:23 +00:00
l10n.php Avoid a PHP notice in `wp_install_language_form()` and `wp_dropdown_languages()` if the language doesn't have a ISO 639-1 code. 2015-02-13 11:23:26 +00:00
link-template.php Press This: bump bookmarklet's version. See #31657. 2015-03-17 01:19:27 +00:00
load.php Add useremail and userslugs as global cache groups. fixes #31243. 2015-02-06 03:24:23 +00:00
locale.php Adding a `@return` annotation to constructors is generally not recommended as a constructor does not have a meaningful return value. Constructors do not have meaningful return values, anything that is returned from here is discarded. 2015-01-10 06:54:23 +00:00
media-template.php Media: UI tweaks for Insert from URL. 2015-03-06 15:03:25 +00:00
media.php Add hook documentation for the `get_media_embedded_in_content_allowed` filter, introduced in [31574]. 2015-03-20 19:29:27 +00:00
meta.php Modify `meta_query orderby syntax to use array keys as clause "handles". 2015-02-05 19:38:23 +00:00
ms-blogs.php Remove leading space from the definition of a global cache group. 2015-02-06 03:26:22 +00:00
ms-default-constants.php
ms-default-filters.php There are some random `add_action()` and `add_filter()` calls littered around some files in `wp-includes/`. These should be moved to `wp-includes/default-filters.php` with the rest of the registered hooks. It seems like this was the best practice for awhile and then we randomly stopped. This file loads way before any of the includes, so the hooks will be registered for any request that loads WordPress, even `SHORTINIT` - a lot of the hooks registered won't run anyways (that's already the case). 2015-01-12 16:40:23 +00:00
ms-deprecated.php [31210] broke Supportflow on dotorg, which declares these methods as `protected`. Switch to `protected` for the noop methods. The subclasses can make them more visible using `public`. 2015-01-16 18:37:24 +00:00
ms-files.php
ms-functions.php Use response code 200 when an existing network user joins a site via invitation. 2015-02-22 22:30:25 +00:00
ms-load.php Return HTTP status code 500 by default in ms_not_installed() 2015-03-07 05:35:26 +00:00
ms-settings.php
nav-menu-template.php There are some random `add_action()` and `add_filter()` calls littered around some files in `wp-includes/`. These should be moved to `wp-includes/default-filters.php` with the rest of the registered hooks. It seems like this was the best practice for awhile and then we randomly stopped. This file loads way before any of the includes, so the hooks will be registered for any request that loads WordPress, even `SHORTINIT` - a lot of the hooks registered won't run anyways (that's already the case). 2015-01-12 16:40:23 +00:00
nav-menu.php Nav menus: Return to calling links "Custom Links". 2015-03-12 06:15:27 +00:00
option.php Allow `$autoload` setting to be changed for existing options using `update_option()`. 2015-03-06 13:57:26 +00:00
pluggable-deprecated.php Improve the `@param` docs for `src/wp-includes/pluggable*`. 2014-11-30 22:19:25 +00:00
pluggable.php Restore line breaks before comment text in comment notification emails. 2015-03-13 18:29:27 +00:00
plugin.php Avoid function calls on each iteration of a `for` loop. 2015-03-08 23:01:26 +00:00
post-formats.php Replace `array_shift()` with `reset()` where appropriate for performance. 2015-03-19 03:56:27 +00:00
post-template.php Allow `is_page_template()` to accept an array, as many other conditional tags do. 2015-03-12 16:28:27 +00:00
post-thumbnail-template.php Adjust DocBlocks for `get_|the_post_thumbnail()` to clarify the difference between the 'thumbnail' and 'post-thumbnail' image sizes. 2015-03-20 19:57:26 +00:00
post.php Replace `array_shift()` with `reset()` where appropriate for performance. 2015-03-19 03:56:27 +00:00
query.php Replace `array_shift()` with `reset()` where appropriate for performance. 2015-03-19 03:56:27 +00:00
registration-functions.php
registration.php
revision.php Improve various `@param` docs. 2014-11-30 22:56:25 +00:00
rewrite.php Replace hardcoded usage of `comment-page` with the comment pagination base. 2015-02-14 03:48:27 +00:00
rss-functions.php
rss.php Fill in the `@param` types for the args for functions missing them in `wp-admin/includes/deprecated.php` (pour one out). 2014-11-03 06:08:22 +00:00
script-loader.php Press This: 2015-03-16 20:51:26 +00:00
session.php Fix some internal types that are passed to functions to avoid changing the acceptable types passed as arguments to those functions: 2015-01-16 22:51:21 +00:00
shortcodes.php Remove a stray period introduced in [31242]. 2015-01-19 08:47:24 +00:00
taxonomy.php Ensure that the `$exclusions` parameter of 'list_terms_exclusions' filter is always a string. 2015-03-18 18:23:26 +00:00
template-loader.php
template.php In PHP 5.0.0, `is_a()` became deprecated in favour of the `instanceof` operator. Calling `is_a()` would result in an `E_STRICT` warning. 2015-01-16 01:06:24 +00:00
theme.php Customizer: Add title attributes to iframes. 2015-03-10 21:20:26 +00:00
update.php Don't try to call `wp_clean_plugins_cache();` twice in `wp_clean_update_cache()`. 2015-03-18 22:07:28 +00:00
user.php Improved 'orderby' meta syntax in `WP_User_Query`. 2015-03-07 18:38:27 +00:00
vars.php
version.php WordPress 4.2-beta2 2015-03-19 19:19:27 +00:00
widgets.php Trigger `_doing_it_wrong()` if `register_sidebar()` is not passed an `id` 2015-03-20 18:30:27 +00:00
wlwmanifest.xml
wp-db.php WPDB: HHVM doesn't support passing a DB link to `mysqli_get_client_version()`. While we usually pass a DB link to every `ext/mysql` and `mysqli` function call, we don't really need to do that here, as there's no way for the client library to change mid page load. 2015-03-15 12:20:26 +00:00
wp-diff.php Add a missing description for the `$_diff_threshold` property in the `WP_Text_Diff_Renderer_Table` class. 2015-01-29 11:36:22 +00:00