WordPress/wp-includes
Scott Taylor e73ee5ac98 Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity.
* Takes inspiration from `WP_Post` and adds sanity to comment caching. 
* Clarifies when the current global value for `$comment` is returned. The current implementation in `get_comment()` introduces side effects and an occasion stale global value for `$comment` when comment caches are cleaned.
* Strongly-types `@param` docs
* This class is marked `final` for now

Props wonderboymusic, nacin.

See #32619.

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


git-svn-id: http://core.svn.wordpress.org/trunk@33860 1a063a9b-81f0-0310-95a4-ce76da25c4cd
2015-09-03 18:17:24 +00:00
..
ID3 Update getID3 to 1.9.9 2015-06-28 00:17:25 +00:00
SimplePie
Text Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
certificates
css Provide more helpful feedback than just "Cheatin' uh?" for permission errors in `wp-admin/user-new.php`. 2015-09-03 08:46:52 +00:00
fonts Dashicons: Fix font ID in SVG file. 2015-07-23 10:03:24 +00:00
images Smilies: Update our few remaining smilies to better align with Twemoji, and add frownie.png until Twemoji provide a build containing it. 2015-04-10 06:20:26 +00:00
js Make curly quotes in playlist item title translatable. 2015-09-01 13:50:21 +00:00
pomo Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
theme-compat Drop the hyphen from e-mail and standardize on email. 2015-08-28 03:17:21 +00:00
widgets De-Jorbin [33814]. 2015-09-01 15:48:22 +00:00
admin-bar.php Fix the summary and parameter description for `wp_admin_bar_customize_menu()` added in 4.3. 2015-07-13 19:58:25 +00:00
atomlib.php Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
author-template.php Pass the original `$user_id` variable to the filter in `get_the_author_meta()`. 2015-05-25 13:06:25 +00:00
bookmark-template.php Sanitize the class passed to `wp_list_bookmarks()` and allow passing an array. 2015-06-22 20:55:28 +00:00
bookmark.php In `bookmark.php`, clarify some `return` docs. 2015-05-21 20:13:25 +00:00
cache.php Fix copy pasta in `wp_cache_decr()` doc block. 2015-08-30 03:04:21 +00:00
canonical.php Avoid PHP notices in `redirect_canonical()` and `_wp_menu_item_classes_by_context()` if `$_SERVER['HTTP_HOST']` is not set. 2015-08-28 03:31:20 +00:00
capabilities-functions.php Roles: move classes into their own file. `capbilities.php` loads the new files, so this is 100% BC if someone is loading `capbilities.php` directly. New files created using `svn cp`. 2015-08-26 04:58:21 +00:00
capabilities.php Roles: move classes into their own file. `capbilities.php` loads the new files, so this is 100% BC if someone is loading `capbilities.php` directly. New files created using `svn cp`. 2015-08-26 04:58:21 +00:00
category-template.php In `wp_list_categories()`, 'current_category' should accept an array of values. 2015-08-29 19:46:23 +00:00
category.php Use `void` instead of `null` where appropriate when pipe-delimiting `@return` types. If a `@return` only contains `void`, remove it. 2015-05-24 05:40:25 +00:00
class-IXR.php Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
class-feed.php After [32656], add `@access` annotations to methods that have no doc block in `wp-includes/*`. 2015-05-29 21:37:24 +00:00
class-http.php Docs: Add a missing file header for wp-includes/class-http.php. 2015-09-03 03:39:21 +00:00
class-json.php Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
class-oembed.php Space out. 2015-08-31 21:25:21 +00:00
class-phpass.php Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
class-phpmailer.php Remove debug cruft from [33124]. 2015-07-09 07:56:24 +00:00
class-pop3.php Deprecate php4 style constructors 2015-06-28 15:27:24 +00:00
class-simplepie.php
class-smtp.php Update PHPMailer to 5.2.10 from 5.2.7. 2015-07-08 17:16:25 +00:00
class-snoopy.php
class-wp-admin-bar.php Toolbar: Disambiguate links to the dashboard vs. to the customizer. 2015-07-08 20:03:24 +00:00
class-wp-ajax-response.php
class-wp-comment-query.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
class-wp-comment.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
class-wp-customize-control.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
class-wp-customize-manager.php Provide more helpful feedback than just "Cheatin' uh?" for permission errors in `wp-includes/class-wp-customize-manager.php`. 2015-09-03 09:21:23 +00:00
class-wp-customize-nav-menus.php Customizer: Use existing decoupled strings in Menu Locations section. See [31941] and [31951]. 2015-08-25 21:53:20 +00:00
class-wp-customize-panel.php Customizer: Switch buttons to match the focus order with the visual order. 2015-07-29 22:10:24 +00:00
class-wp-customize-section.php Customizer: Hide the transport list when it's empty, especially for screen readers. 2015-07-15 19:59:25 +00:00
class-wp-customize-setting.php Customizer: Ensure that all existing menus are shown in the Custom Menu widget's dropdown. 2015-07-29 16:03:24 +00:00
class-wp-customize-widgets.php Customizer: Use `hash_equals()` for widgets. 2015-08-04 04:51:50 +00:00
class-wp-editor.php TinyMCE: disable the native fullscreen plugin on mobile devices by default. 2015-08-31 22:45:22 +00:00
class-wp-embed.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
class-wp-error.php Use `void` instead of `null` where appropriate when pipe-delimiting `@return` types. If a `@return` only contains `void`, remove it. 2015-05-24 05:40:25 +00:00
class-wp-http-cookie.php Docs: Add a missing file header to wp-includes/class-wp-http-cookie.php, introduced in [33748]. 2015-09-03 03:19:21 +00:00
class-wp-http-curl.php Docs: Add a missing file header for wp-includes/class-wp-http-curl.php, introduced in [33748]. 2015-09-03 03:23:21 +00:00
class-wp-http-encoding.php Docs: Add a missing file header for wp-includes/class-wp-http-encoding.php, introduced in [33748]. 2015-09-03 03:28:21 +00:00
class-wp-http-ixr-client.php Add missing doc blocks to `wp-image-editor*.php`. 2015-05-22 06:18:25 +00:00
class-wp-http-proxy.php Docs: Add a missing file header to wp-includes/class-wp-http-proxy.php, introduced in [33748]. 2015-09-03 03:30:21 +00:00
class-wp-http-streams.php Docs: Add a missing file header to wp-includes/class-wp-http-streams.php, introduced in [33748]. 2015-09-03 03:33:21 +00:00
class-wp-image-editor-gd.php Replace `@returns` with `@return` in PHP docblocks. 2015-07-02 21:05:24 +00:00
class-wp-image-editor-imagick.php Replace `@returns` with `@return` in PHP docblocks. 2015-07-02 21:05:24 +00:00
class-wp-image-editor.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
class-wp-meta-query.php Meta: move `WP_Meta_Query` into its own file. `meta.php` loads the new files, so this is 100% BC if someone is loading `meta.php` directly. New files created using `svn cp`. 2015-08-26 13:02:21 +00:00
class-wp-post.php Posts: move `WP_Post` into its own file. `post.php` loads the new files, so this is 100% BC if someone is loading `post.php` directly. New files created using `svn cp`. 2015-08-26 12:40:21 +00:00
class-wp-rewrite.php Rewrite: move `WP_Rewrite` into its own file. `rewrite.php` loads the new files, so this is 100% BC if someone is loading `rewrite.php` directly. New files created using `svn cp`. 2015-08-26 04:42:20 +00:00
class-wp-role.php Roles: move classes into their own file. `capbilities.php` loads the new files, so this is 100% BC if someone is loading `capbilities.php` directly. New files created using `svn cp`. 2015-08-26 04:58:21 +00:00
class-wp-roles.php Roles: move classes into their own file. `capbilities.php` loads the new files, so this is 100% BC if someone is loading `capbilities.php` directly. New files created using `svn cp`. 2015-08-26 04:58:21 +00:00
class-wp-tax-query.php Taxonomy: move `WP_Tax_Query` into its own file. `taxonomy.php` loads the new files, so this is 100% BC if someone is loading `taxonomy.php` directly. New files created using `svn cp`. 2015-08-26 12:49:21 +00:00
class-wp-theme.php Add `@static*` annotations where they are missing. 2015-05-29 15:43:29 +00:00
class-wp-user-query.php Users: move `WP_User_Query` into its own file. `user.php` loads the new files, so this is 100% BC if someone is loading `user.php` directly (a lot of plugins do). New files created using `svn cp`. 2015-08-26 04:20:21 +00:00
class-wp-user.php Docs: Add missing parameter documentation to the the DocBlock for `WP_User::__set()`. 2015-09-01 21:47:21 +00:00
class-wp-walker.php Docs: Add a missing summary to the DocBlock for `Walker::get_number_of_root_elements()`. 2015-09-02 19:51:21 +00:00
class-wp-widget-factory.php Docs: Clarify the file header summary for class-wp-widget-factory.php, introduced in [33746]. 2015-09-03 02:54:22 +00:00
class-wp-widget.php Docs: Improve the file header for class-wp-widget.php to describe what the file contains. 2015-09-03 02:50:21 +00:00
class-wp-xmlrpc-server.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
class-wp.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
class.wp-dependencies.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
class.wp-scripts.php After [32656], add `@access` annotations to methods that have no doc block in `wp-includes/*`. 2015-05-29 21:37:24 +00:00
class.wp-styles.php Add a missing `$html` parameter variable in the hook docs for the `style_loader_tag` filter. 2015-07-13 21:03:24 +00:00
comment-functions.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
comment-template.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
comment.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
compat.php Add doc blocks to functions that are missing them. 2015-05-31 03:18:25 +00:00
cron.php Fix inline documentation syntax in `wp_xmlrpc_server`. 2015-05-25 06:25:25 +00:00
date.php Simplify the weeks-per-year calculation `WP_Date_Query::validate_date_values()`. 2015-08-29 01:47:21 +00:00
default-constants.php After [33698], wrap the time constants in a DocBlock template. 2015-08-25 21:21:21 +00:00
default-filters.php Term splitting routine should be run in a separate process, triggered via wp-cron. 2015-08-14 03:59:26 +00:00
default-widgets.php Move widget classes to their own files in `wp-includes/widgets`: 2015-09-01 13:49:21 +00:00
deprecated.php Docs: Standardize `@deprecated` tag formatting and add missing DocBlock summaries to deprecated functions in wp-includes/deprecated.php. 2015-08-20 22:11:26 +00:00
feed-atom-comments.php `if` is a statment, not a function. 2015-06-16 20:01:25 +00:00
feed-atom.php
feed-rdf.php
feed-rss.php Serve RSS feeds with the proper mime-type: `application/rss+xml`. The reason for hacking around browsers by using `text/xml` appears to no longer be relevant. 2015-05-09 06:39:24 +00:00
feed-rss2-comments.php Feeds: Revert [32765] because of objections raised in #4575. 2015-07-15 19:58:24 +00:00
feed-rss2.php Feeds: Revert [32765] because of objections raised in #4575. 2015-07-15 19:58:24 +00:00
feed.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
formatting.php Correctly encode spaces in URLs passed to `esc_url()` instead of removing them. 2015-09-02 17:20:21 +00:00
functions.php Introduce `wp_removable_query_args()`, which returns an array of single-use query variables which can be removed from a URL. 2015-09-02 11:29:23 +00:00
functions.wp-scripts.php After [32596] and [32597], ensure that `wp_scripts|styles()` is called to ensure an instance is created of `WP_Scripts|Styles()` before calling `->do_items()`. 2015-06-12 16:54:24 +00:00
functions.wp-styles.php After [32596] and [32597], ensure that `wp_scripts|styles()` is called to ensure an instance is created of `WP_Scripts|Styles()` before calling `->do_items()`. 2015-06-12 16:54:24 +00:00
general-template.php Correct `@since` version for [33838]. 2015-09-01 03:14:21 +00:00
http-functions.php Docs: Clarify the file header summary for wp-includes/http-functions.php, introduced in [33748]. 2015-09-03 03:37:20 +00:00
http.php Docs: Add inline DocBlocks for the `require_once()` calls that now bring in top-level HTTP API functionality and HTTP API classes. 2015-09-03 04:36:30 +00:00
kses.php Allow these CSS properties in KSES: `min-height', 'max-height', 'min-width', 'max-width'` 2015-08-25 21:46:20 +00:00
l10n.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
link-template.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
load.php Pinking shears. 2015-08-17 21:39:25 +00:00
locale.php Make `WP_Locale::rtl_src_admin_notice()` translatable. 2015-06-30 20:21:24 +00:00
media-template.php Media: 2015-08-25 12:13:23 +00:00
media.php Make curly quotes in playlist item title translatable. 2015-09-01 13:50:21 +00:00
meta-functions.php Meta: move `WP_Meta_Query` into its own file. `meta.php` loads the new files, so this is 100% BC if someone is loading `meta.php` directly. New files created using `svn cp`. 2015-08-26 13:02:21 +00:00
meta.php Meta: move `WP_Meta_Query` into its own file. `meta.php` loads the new files, so this is 100% BC if someone is loading `meta.php` directly. New files created using `svn cp`. 2015-08-26 13:02:21 +00:00
ms-blogs.php Fix doc blocks for `ms-*.php` files. 2015-05-26 21:51:31 +00:00
ms-default-constants.php Fix doc blocks for `ms-*.php` files. 2015-05-26 21:51:31 +00:00
ms-default-filters.php Fix doc blocks for `ms-*.php` files. 2015-05-26 21:51:31 +00:00
ms-deprecated.php Docs: Standardize `@deprecated` tag formatting and add missing summaries to deprecated functions in wp-includes/ms-deprecated.php. 2015-08-20 22:36:25 +00:00
ms-files.php `if` is a statment, not a function. 2015-06-16 20:01:25 +00:00
ms-functions.php Exclude individual site directories when calculating space used for the main site. 2015-07-13 00:07:24 +00:00
ms-load.php Fix doc blocks for `ms-*.php` files. 2015-05-26 21:51:31 +00:00
ms-settings.php
nav-menu-template.php Avoid PHP notices in `redirect_canonical()` and `_wp_menu_item_classes_by_context()` if `$_SERVER['HTTP_HOST']` is not set. 2015-08-28 03:31:20 +00:00
nav-menu.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
option.php User Settings: allow dashes in `get|set_user_setting()` in PHP and `get|setUserSetting()` in JS. 2015-09-01 03:57:21 +00:00
pluggable-deprecated.php Docs: Standardize `@deprecated` tag formatting for deprecated functions in wp-includes/pluggable-deprecated.php. 2015-08-20 22:15:25 +00:00
pluggable.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
plugin.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
post-formats.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
post-functions.php In `get_post_type_labels()`, ensure that filtered labels contain all required default values. 2015-08-28 03:39:21 +00:00
post-template.php In `wp_get_attachment_link()`, accept an `id` or `WP_Post` as the first parameter. 2015-08-20 20:32:26 +00:00
post-thumbnail-template.php Add missing doc blocks to `post-thumbnail-template.php`. 2015-05-27 16:29:28 +00:00
post.php Posts: move `WP_Post` into its own file. `post.php` loads the new files, so this is 100% BC if someone is loading `post.php` directly. New files created using `svn cp`. 2015-08-26 12:40:21 +00:00
query.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
registration-functions.php
registration.php
revision.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
rewrite-constants.php Rewrite: move `WP_Rewrite` into its own file. `rewrite.php` loads the new files, so this is 100% BC if someone is loading `rewrite.php` directly. New files created using `svn cp`. 2015-08-26 04:42:20 +00:00
rewrite-functions.php Rewrite: move `WP_Rewrite` into its own file. `rewrite.php` loads the new files, so this is 100% BC if someone is loading `rewrite.php` directly. New files created using `svn cp`. 2015-08-26 04:42:20 +00:00
rewrite.php Rewrite: move `WP_Rewrite` into its own file. `rewrite.php` loads the new files, so this is 100% BC if someone is loading `rewrite.php` directly. New files created using `svn cp`. 2015-08-26 04:42:20 +00:00
rss-functions.php
rss.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
script-loader.php Editor: word count: Remove indentation from the translator comment. 2015-07-30 17:08:24 +00:00
session.php
shortcodes.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
taxonomy-functions.php Taxonomy: move `WP_Tax_Query` into its own file. `taxonomy.php` loads the new files, so this is 100% BC if someone is loading `taxonomy.php` directly. New files created using `svn cp`. 2015-08-26 12:49:21 +00:00
taxonomy.php Taxonomy: move `WP_Tax_Query` into its own file. `taxonomy.php` loads the new files, so this is 100% BC if someone is loading `taxonomy.php` directly. New files created using `svn cp`. 2015-08-26 12:49:21 +00:00
template-loader.php Add singular.php to template hierarchy 2015-06-18 19:01:26 +00:00
template.php Docs: Update the DocBlock descriptions for a variety of template functions to better reflect that the dynamic `$type_template` hook can be used to filter the template path. 2015-07-14 22:27:24 +00:00
theme.php Themes: Get the correct theme when template and stylesheet were both passed as arguments. 2015-08-30 21:45:23 +00:00
update.php Add missing doc blocks to `update.php`: 2015-05-28 15:29:28 +00:00
user-functions.php Drop the hyphen from e-mail and standardize on email. 2015-08-28 03:17:21 +00:00
user.php Users: move `WP_User_Query` into its own file. `user.php` loads the new files, so this is 100% BC if someone is loading `user.php` directly (a lot of plugins do). New files created using `svn cp`. 2015-08-26 04:20:21 +00:00
vars.php Some doc blocks should use `bool` instead of `true|false` 2015-06-27 00:45:24 +00:00
version.php Introduce `WP_Comment` class to model/strongly-type rows from the comments database table. Inclusion of this class is a pre-req for some more general comment cleanup and sanity. 2015-09-03 18:17:24 +00:00
widget-functions.php Docs: Clarify the file header summary for widget-functions.php, introduced in [33746]. 2015-09-03 02:58:20 +00:00
widgets.php Docs: Clarify the file header summary for wp-includes/widgets.php, the top-level file for the core Widgets API. 2015-09-03 03:14:20 +00:00
wlwmanifest.xml
wp-db.php `foreach` is a statement, not a function. 2015-08-25 20:28:22 +00:00
wp-diff.php