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
..
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
ID3 Update getID3 to 1.9.9 2015-06-28 00:17:25 +00:00
images
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
SimplePie
Text 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-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-IXR.php Deprecate php4 style constructors 2015-06-28 15:27:24 +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 Introduce 'rss_tag_pre' action, which fires between the xml and rss tags in a feed. 2014-07-07 10:18:15 +00:00
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 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 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