Sergey Biryukov
6bdc961d5f
Docs: Improve comments in some wp-admin
files per the documentation standards.
...
Follow-up to [47084].
Props passoniate, apedog.
Fixes #49223 , #49227 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47119 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-29 00:33:45 +00:00
Sergey Biryukov
191f798201
Docs: Remove extra trailing spaces from wp_add_privacy_policy_content()
DocBlock to fix WPCS issues, apply minor formatting changes for consistency.
...
Follow-up to [47112].
See #49282 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47113 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-27 01:04:08 +00:00
Andrew Ozz
9224e14e67
Privacy: Cleanup .wp-policy-help
CSS remnants and add back-compat when hiding the tutorial content before copying.
...
Props garrett-eclipse.
Fixes #49282 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47112 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-26 23:00:54 +00:00
Sergey Biryukov
8295b56d9c
Docs: Correct @return
value for parent_dropdown()
.
...
Follow-up to [47100].
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47102 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-22 00:31:17 +00:00
Sergey Biryukov
8133a247bd
Docs: Adjust @return
value of parent_dropdown()
for consistency with other dropdown functions.
...
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47100 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-22 00:20:21 +00:00
Sergey Biryukov
80e4ef45f1
Docs: Correct @return
value for update_core()
and Core_Upgrader::upgrade()
.
...
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47099 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-22 00:17:24 +00:00
Sergey Biryukov
9b5ac0f6b6
I18N: Add missing placeholders to some translators comments in wp-admin
.
...
Props ramiy.
Fixes #49248 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47093 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-20 15:41:50 +00:00
Sergey Biryukov
5f937b4c70
I18N: Correct translator comments in WP_Users_List_Table::get_views()
to provide information about each placeholder.
...
Props ramiy.
Fixes #49242 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47089 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-20 14:06:57 +00:00
Sergey Biryukov
a8f4ed69de
Docs: Update links to https://secure.php.net/ , they now redirect to https://www.php.net/ .
...
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47088 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-20 03:12:12 +00:00
Sergey Biryukov
5d8f784daa
Networks and Sites: Clarify the recommendation to remove the www
prefix from the site domain before creating a network.
...
The `siteurl` option reference was not quite clear, and the string actually refers to the domain name, not the full URL.
Props kharisblank, tobifjellner, ramiy.
Fixes #49214 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47085 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-18 01:13:12 +00:00
Sergey Biryukov
89dc54ee0c
Docs: Improve comments in some wp-admin
files per the documentation standards.
...
Props passoniate.
Fixes #49215 , #49216 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47084 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-18 00:52:28 +00:00
Sergey Biryukov
bd59d22a81
Coding Standards: Remove unnecessary // phpcs:ignore
instances in WP_Debug_Data
.
...
`WP_Theme::__get()` accepts `Name`, `Version`, and `Author` theme properties in lower case too.
Additionally, remove one short ternary instance, not allowed per the coding standards.
See #49222 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47083 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-18 00:24:57 +00:00
Sergey Biryukov
92fc229ca0
Site Health: Avoid "Undefined property" PHP notices in wp_dashboard_site_health()
when the status result transient does not exist yet.
...
Props dlh for initial patch.
See #47606 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47069 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-13 17:25:26 +00:00
Sergey Biryukov
d9501dd5d5
Networks and Sites: Use warning
styles for 'Caution' and 'Warning' messages during Multisite installation.
...
Props dlh.
Fixes #49186 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47067 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-13 16:58:06 +00:00
Sergey Biryukov
9b38bca65f
Docs: Improve documentation for wp_save_image_file()
and related functions.
...
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47065 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-12 16:54:56 +00:00
Sergey Biryukov
396cc8205b
Site Health: Introduce Site Health Status dashboard widget.
...
The widget informs administrators of any potential issues that should be addressed to improve the performance or security of their website, and directs them to the Site Health screen for more details.
Props Clorith, hedgefield, guddu1315.
See #47606 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47063 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-12 13:31:49 +00:00
Sergey Biryukov
4c2ee4e9ff
Docs: In various @return
tags, list the expected type first, instead of false
.
...
Follow-up to [46696].
See #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47060 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-11 18:30:58 +00:00
Sergey Biryukov
f9e52f8cd3
Docs: Synchronize @return
descriptions for ::handle_row_actions()
methods in list tables.
...
Make sure `WP_Comments_List_Table::handle_row_actions()` and `WP_MS_Sites_List_Table::handle_row_actions()` return a string, for consistency with other classes.
See #49170 , #48303 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47059 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-11 17:56:15 +00:00
Sergey Biryukov
1824604fc0
Docs: Correct @return
description for WP_List_Table::handle_row_actions()
.
...
Props pbiron.
Fixes #49170 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47058 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-11 17:55:49 +00:00
Sergey Biryukov
5dbe5a8355
Docs: Correct @return
type for Theme_Upgrader::check_parent_theme_filter()
.
...
Props diddledan.
Fixes #48570 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47057 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-11 02:44:17 +00:00
Sergey Biryukov
b459cddeaf
I18N: Replace php.ini
, post_max_size
, and upload_max_filesize
with placeholders in "File is empty" error message.
...
Props ramiy.
Fixes #48868 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47043 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-06 16:14:30 +00:00
Sergey Biryukov
50ed776846
Docs: Fix typo in media_post_single_attachment_fields_to_edit()
description.
...
Props mukesh27.
Fixes #49131 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47039 602fd350-edb4-49c9-b593-d223f7449a82
2020-01-04 17:58:37 +00:00
Sergey Biryukov
c9a366e857
Docs: Fix typo in _crop_image_resource()
DocBlock.
...
Props mukesh27.
Fixes #49103 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47024 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-31 12:32:19 +00:00
Sergey Biryukov
004023d493
Coding Standards: Fix WPCS issue in [47015].
...
See #49082 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47016 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-26 15:51:33 +00:00
Sergey Biryukov
c231e66c0a
Docs: Fix typo in wp_dashboard_cached_rss_widget()
documentation.
...
Props mukesh27.
Fixes #49082 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47015 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-26 14:40:10 +00:00
Sergey Biryukov
67502b3dcd
Docs: Correct the note about the CORE_UPGRADE_SKIP_NEW_BUNDLED
constant in $_new_bundled_files
global description.
...
In order to tell WordPress not to install new bundled themes on update, `CORE_UPGRADE_SKIP_NEW_BUNDLED` should be set to `true`, as the name suggests, not `false`.
Follow-up to [39064].
Props tomgreer, knutsp, crdunst.
See #49056 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47007 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-23 17:58:02 +00:00
Sergey Biryukov
c273108570
Docs: Improve documentation for admin menu functions:
...
* `get_admin_page_parent()`
* `get_admin_page_title()`
* `get_plugin_page_hook()`
* `get_plugin_page_hookname()`
* `user_can_access_admin_page()`
Add missing descriptions and `@since` tags.
Props subrataemfluence, kennithnichol, stevenlinx, SergeyBiryukov.
Fixes #44253 , #49067 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47006 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-23 14:34:10 +00:00
Sergey Biryukov
56e338c132
Upgrade/Install: When creating the .htaccess
file in insert_with_markers()
, make sure it has 0644
as a minimum set of permissions.
...
Props rcutmore, dd32, i3anaan.
Fixes #40572 .
git-svn-id: https://develop.svn.wordpress.org/trunk@47005 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-22 02:43:30 +00:00
Sergey Biryukov
d592888f36
Users: When creating the first user on installation, populate the Website profile field with the site URL.
...
Skip setting the field if the user already exists, which is the case when the user tables are being shared among multiple sites.
Props EFAREM, eclare, darrenlambert, zachflauaus, viralsampat.
Fixes #35778 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46989 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-18 02:24:05 +00:00
Sergey Biryukov
ed3e924683
Upgrade/Install: Remove unused global in upgrade_430_fix_comments()
.
...
Props adnan.limdi.
Fixes #41970 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46972 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-17 16:43:22 +00:00
Sergey Biryukov
2a8f0cb9e0
Coding Standards: Use strict comparison in wp-admin/includes/network.php
.
...
Props ataurr.
Fixes #48994 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46963 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-16 12:35:26 +00:00
Sergey Biryukov
3575a07f4b
Docs: Improve documentation for wp_dashboard_browser_nag()
and dashboard_browser_nag_class()
.
...
Props grapplerulrich.
Fixes #48932 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46880 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-11 10:57:44 +00:00
Sergey Biryukov
c1ab0cc974
Menus: Avoid a PHP warning in add_submenu_page()
when the same value is passed for both $parent_slug
and $menu_slug
parameters.
...
Props welcher, ispreview, ayeshrajans, NextScripts, adamsilverstein, garrett-eclipse, 123host.
Fixes #48599 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46868 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-09 21:01:13 +00:00
Sergey Biryukov
9c82519c13
Accessibility: Menus: Properly disable form controls on the Menus screen that cannot be used until at least one menu is created.
...
This ensures that the actual UI controls state matches the visually conveyed state.
Props afercia, audrasjb, dinhtungdu, sathyapulse, simonjanin, welcher, SergeyBiryukov.
Fixes #48409 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46842 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-09 13:47:12 +00:00
John Blackbourn
e12f866db2
Docs: Further docblock corrections and improvements.
...
See #48303
git-svn-id: https://develop.svn.wordpress.org/trunk@46826 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-07 13:21:07 +00:00
John Blackbourn
726d3a1d9c
Docs: Increase the specificity of various docblock parameter types and return types.
...
See #48303
git-svn-id: https://develop.svn.wordpress.org/trunk@46823 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-06 22:41:26 +00:00
John Blackbourn
bcfccc7344
Docs: Correct various docblocks documentation.
...
See #48303
git-svn-id: https://develop.svn.wordpress.org/trunk@46821 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-06 22:21:07 +00:00
Andrew Ozz
8917973d52
Upload: Exclude PNG images from scaling after uploading. Fixes a case where resizing a very large PNG may create a scaled image that has smaller dimensions but larger file size than the original.
...
Fixes #48736 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46809 602fd350-edb4-49c9-b593-d223f7449a82
2019-12-01 18:24:30 +00:00
Sergey Biryukov
b5ed00dc82
REST API: Use strict in_array()
checks for the list of usernames blacklisted via illegal_user_logins
filter.
...
See #48839 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46804 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-29 22:02:30 +00:00
Sergey Biryukov
4b60e6a0db
Site Health: Add a test for PHP default timezone.
...
The test reports a failure if the default timezone was changed with `date_default_timezone_set()` to anything other than `UTC`.
WordPress historically uses `UTC` as the default timezone for calculating date and time offsets, overriding it is not recommended and can cause widespread and obscure issues.
Props Rarst, Clorith, TimothyBlynJacobs.
Fixes #48692 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46797 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-28 15:46:45 +00:00
Dominik Schilling
c2413a4711
Upgrade/Install: Provide a default label for "Continue" button in language selection form.
...
Prevents an empty continue button if a translation isn't yet available.
Props sathyapulse.
Fixes #48776 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46784 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-26 15:17:30 +00:00
SergeyBiryukov
dc486308e6
Accessibility: Administration: Underline links on Dashboard that are located within a line of text and thus need to be underlined:
...
* "change your theme completely"
* Active theme in the "At a Glance" box
* "View all drafts" in the Quick Draft box
Split "Manage widgets or menus" into separate items for consistency with other links.
For better accessibility, links that are a part of other text should be underlined and not rely on color alone to be distinguished.
Per accessibility coding standards:
> When links can be identified as such by the context, for example because they’re part of a menu, or a set of links clearly identified as user interface controls, they don’t necessarily need to be underlined. In all the other cases, especially for links surrounded by other text (in a line or block of text), links need to be always underlined.
https://make.wordpress.org/core/handbook/best-practices/coding-standards/accessibility-coding-standards/#links-underline-or-no-underline
https://make.wordpress.org/accessibility/handbook/design/use-of-color/#not-by-color-alone
Props afercia, audrasjb, karmatosed.
Fixes #48406 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46770 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-24 19:55:01 +00:00
Sergey Biryukov
fec3976927
Docs: Add missing @since
tags for functions in wp-admin/includes/update.php
.
...
Props sathyapulse, zodiac1978.
Fixes #48777 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46763 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-23 18:49:59 +00:00
Sergey Biryukov
065a181fc0
I18N: Correct translator comment for By %s
string in Plugins list table.
...
Follow-up to [44541].
See #45898 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46755 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-21 00:06:32 +00:00
Andrea Fercia
5e574eb45f
Accessibility: Add an aria-current
attribute to the Media Library switch links.
...
The `aria-current` attribute is a simple, effective, way to help assistive technology users orientate themselves within a set of items.
Props mayanksonawat, afercia.
Fixes #48271 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46746 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-18 16:49:42 +00:00
Sergey Biryukov
e68601875e
Docs: Update broken source code link in WP_Filesystem_SSH2
class.
...
Props mryoga, finchps.
Fixes #48467 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46742 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-17 16:14:37 +00:00
Sergey Biryukov
7bb2a562a6
Docs: Correct spelling of "subclass" and "overridden" in various docblocks and error messages.
...
Props garrett-eclipse.
Fixes #48676 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46739 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-17 07:41:49 +00:00
SergeyBiryukov
24de36bc5a
Docs: Fix typo in wp_credits_section_title()
description.
...
Switch descriptions for `wp_credits_section_title()` and `wp_credits_section_list()` to third-person singular verbs, per the documentation standards.
Props hareesh-pillai.
Fixes #48674 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46738 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-16 21:02:02 +00:00
Sergey Biryukov
6cf77dbbb6
Docs: Remove incorrect @return
tags.
...
Props diddledan.
Fixes #48613 , #48614 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46732 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-14 09:55:21 +00:00
Sergey Biryukov
895ec7224b
Help/About: Update the 5.3 About page.
...
* Remove extra padding on the Credits tab.
Previously [46556], [46572], [46616], [46705].
Props ryelle.
See #47708 .
git-svn-id: https://develop.svn.wordpress.org/trunk@46709 602fd350-edb4-49c9-b593-d223f7449a82
2019-11-11 20:43:48 +00:00