Drew Jaynes 2aa0a42661 Docs: Add a file header to wp-includes/class-wp-widget.php, created when the WP_Widget class was moved to its own file in [33746]. ...

It's important for every file in WordPress, regardless of makeup or architecture, to have its own file header, even if the file contains nothing but a class. When parsed, files and classes are mutually exclusive and should be documented with this in mind.

See [33746]. See #33413.

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


git-svn-id: http://core.svn.wordpress.org/trunk@33723 1a063a9b-81f0-0310-95a4-ce76da25c4cd

2015-08-26 07:45:21 +00:00

..

certificates

…

css

TinyMCE: fix accessibility for the keyboard shortcuts help dialog.

2015-07-26 19:14:26 +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

Media:

2015-08-25 12:13:23 +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

Don't capitalize words in a sentence after comma.

2015-07-04 00:50:25 +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

…

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

…

cache.php

Docs: Standardize @deprecated tag formatting in the DocBlock for WP_Object_Cache:reset().

2015-08-20 22:39:24 +00:00

canonical.php

…

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 Walker_CategoryDropdown::start_el(), cast values to strings before deciding whether to append 'selected' attribute.

2015-08-21 01:11:26 +00:00

category.php

…

class-feed.php

…

class-http.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55: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

Add oEmbed support for ReverbNation.

2015-08-26 00:29: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

Comments: move WP_Comment_Query into its own file. comment.php loads the new files, so this is 100% BC if someone is loading comment.php directly. New files created using svn cp.

2015-08-26 04:27:21 +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

Site Icon: Add crop preview to the media modal.

2015-07-20 15:57:25 +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

In _WP_Editors::editor_settings(), $first_run is unused.

2015-08-21 18:30:24 +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

…

class-wp-http-cookie.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +00:00

class-wp-http-curl.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +00:00

class-wp-http-encoding.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +00:00

class-wp-http-ixr-client.php

…

class-wp-http-proxy.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +00:00

class-wp-http-streams.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55: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-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-theme.php

…

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

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-walker.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +00:00

class-wp-widget-factory.php

Widgets: move classes into their own files, widgets.php loads the new files, so this is 100% BC if someone is loading widgets.php directly. New files created using svn cp.

2015-08-26 02:40:23 +00:00

class-wp-widget.php

Docs: Add a file header to wp-includes/class-wp-widget.php, created when the WP_Widget class was moved to its own file in [33746].

2015-08-26 07:45:21 +00:00

class-wp-xmlrpc-server.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +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

…

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

Comments: move WP_Comment_Query into its own file. comment.php loads the new files, so this is 100% BC if someone is loading comment.php directly. New files created using svn cp.

2015-08-26 04:27:21 +00:00

comment-template.php

Restore rel='nofollow' for comment reply links to reduce extra crawling by search engines.

2015-07-02 11:09:25 +00:00

comment.php

Comments: move WP_Comment_Query into its own file. comment.php loads the new files, so this is 100% BC if someone is loading comment.php directly. New files created using svn cp.

2015-08-26 04:27:21 +00:00

compat.php

…

cron.php

…

date.php

…

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

Customizer: Ensure that all existing menus are shown in the Custom Menu widget's dropdown.

2015-07-29 16:03:24 +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

…

feed-atom.php

…

feed-rdf.php

…

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-rss.php

…

feed.php

Site icon: Rearrange function parameters to avoid frequently passing empty values.

2015-08-10 20:15:26 +00:00

formatting.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +00:00

functions.php

When wp_json_encode() calls json_encode(), the latter will generate warnings if the string contains non-UTF-8 characters. No-one likes warnings, so we need to do something about that.

2015-08-26 03:26:21 +00:00

functions.wp-scripts.php

…

functions.wp-styles.php

…

general-template.php

Site Icon: Improvements to Site Icon API.

2015-08-11 16:25:27 +00:00

http-functions.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +00:00

http.php

HTTP: move classes into their own files, http.php loads the new files, so this is 100% BC if someone is loading http.php directly. New files created using svn cp.

2015-08-26 03:55:21 +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

In get_home_url(), import the $pagenow global to avoid having to check if it exists before comparing against it.

2015-08-25 21:03:20 +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

Ensure that attachment_url_to_postid() matches cross-scheme when front-end and back-end schemes are different.

2015-08-22 16:39:25 +00:00

meta.php

Docs: Correct the phpDoc type to a boolean for the $single parameter in the get_{$meta_type}_metadata hook docs.

2015-08-20 19:36:25 +00:00

ms-blogs.php

…

ms-default-constants.php

…

ms-default-filters.php

…

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

…

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

…

ms-settings.php

…

nav-menu-template.php

Customizer: Restore default fallback_cb arg for wp_nav_menu() calls in customizer preview.

2015-08-04 21:57:25 +00:00

nav-menu.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +00:00

option.php

Pass option name to option and transient filters with dynamic names.

2015-08-25 21:42:20 +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

Add 'wp_verify_nonce_failed' action that fires when nonce verification fails.

2015-08-26 00:06:21 +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-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

…

post.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +00:00

query.php

foreach is a statement, not a function.

2015-08-25 20:28:22 +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.php

Term Splitting: Switch to a faster cron unschedule process to benefit sites with thousands of affected jobs. Fix the cron hook name in the failsafe rescheduler.

2015-08-25 04:32: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

Clarify doc entry for _wp_customize_include()

2015-08-21 17:45:25 +00:00

update.php

…

user-functions.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

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

Docs: Add a file header to wp-includes/class-wp-widget.php, created when the WP_Widget class was moved to its own file in [33746].

2015-08-26 07:45:21 +00:00

widget-functions.php

Widgets: move classes into their own files, widgets.php loads the new files, so this is 100% BC if someone is loading widgets.php directly. New files created using svn cp.

2015-08-26 02:40:23 +00:00

widgets.php

Widgets: move classes into their own files, widgets.php loads the new files, so this is 100% BC if someone is loading widgets.php directly. New files created using svn cp.

2015-08-26 02:40:23 +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

…