Scott Taylor
5743898e1e
@param cleanup:
...
* `get_metadata()` will return literally anything, needs to be `mixed`
* `wp()` and `WP_Query::__construct()` no longer just take a query string
* Clarify a few others
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31212 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-16 19:02:26 +00:00
Drew Jaynes (DrewAPicture)
9b0cf1bd5b
Ensure we're using the correct @ignore phpDocumentor tag to mark elements that should be skipped when parsing.
...
Up to this point, various core elements' DocBlocks incorrectly included an `@internal` tag as a means for skipping the parsing process. When paired with a description (inline or otherwise), `@internal` is a valid tag meant to provide internal-only context, but not necessarily to skip parsing the entire element.
See #30987 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31170 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-13 00:50:32 +00:00
Scott Taylor
c3bd2252f5
Use PHP_SAPI constant instead of php_sapi_name() in iis7_supports_permalinks(), wp_fix_server_vars(), and wp_redirect().
...
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31120 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-10 04:58:49 +00:00
Scott Taylor
6fd11624d1
The keyword elseif should be used instead of else if so that all control keywords look like single words.
...
This was a mess, is now standardized across the codebase, except for a few 3rd-party libs.
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31090 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-08 07:04:40 +00:00
Scott Taylor
8108c0babe
PHP keywords and constants "true", "false", "null" should be in lower case - there was one lingering capitalized false in _http_build_query().
...
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31086 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-08 06:13:05 +00:00
Gary Pendergast
eb4d356e29
size_format() incorrectly included a trailing space for B values: less than 1024 bytes.
...
Also add a unit test to check for this, so we don't do it again.
Fixes #30908 .
Props tillkruess.
git-svn-id: https://develop.svn.wordpress.org/trunk@31052 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-05 13:12:06 +00:00
Scott Taylor
49d19a367a
ImageMagick expects TIFF files to have .tiff as an extension, so the key in wp_get_mime_types() should be 'tiff|tif' not 'tif|tiff' so the proper extension is returned in WP_Image_Editor->get_extension() subclass invocations.
...
Fixes #30211 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31044 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-04 03:08:48 +00:00
Scott Taylor
0632a3de68
Improve various @param docs.
...
See #30224 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30674 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-30 23:23:37 +00:00
Drew Jaynes (DrewAPicture)
e587324180
Docs Formatting: Backtick-escape inline code for all remaining dynamic hook docs in wp-includes/*.
...
Affects DocBlocks for the following hooks:
* `auth_post_meta_{$meta_key}`
* `term_links-$taxonomy`
* `customize_render_control_ . $this->id`
* `customize_render_panel_{$this->id}`
* `customize_render_section_{$this->id}`
* `customize_preview_{$this->id}`
* `customize_save_ . $this->id_data[ 'base' ]`
* `customize_update_ . $this->type`
* `customize_value_ . $this->id_data[ 'base' ]`
* `customize_sanitize_js_{$this->id}`
* `comment_form_field_{$name}`
* `comment_{$old_status}_to_{$new_status}`
* `comment_{$new_status}_{$comment->comment_type}`
* `extra_{$context}_headers`
* `get_template_part_{$slug}`
* `get_the_generator_{$type}`
* `get_{$adjacent}_post_join`
* `get_{$adjacent}_post_where`
* `get_{$adjacent}_post_sort`
* `{$adjacent}_post_rel_link`
* `{$adjacent}_post_link`
* `{$adjacent}_image_link`
* `blog_option_{$option}`
* `$permastructname . _rewrite_rules`
* `{$type}_template`
* `theme_mod_{$name}`
* `pre_set_theme_mod_$name`
* `current_theme_supports-{$feature}`
* `get_user_option_{$option}`
* `edit_user_{$field}`
* `pre_user_{$field}`
* `user_{$field}`
See #30552 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30656 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-30 12:09:56 +00:00
Scott Taylor
a411918199
Adjust the RegEx in wp_check_filetype() to be aware that query strings are thing that exist sometimes in URLs.
...
Adds unit tests.
Props voldemortensen.
Fixes #30377 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30640 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-30 06:32:16 +00:00
Drew Jaynes (DrewAPicture)
f7e01d5331
Improve line-wrapping and formatting in the DocBlock for wp_send_json_error().
...
See #30469 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30614 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-28 11:38:59 +00:00
Drew Jaynes (DrewAPicture)
7bf6ff37e2
4.1 Docs Audit: Ensure optional arguments in wp_json_encode() are properly documented as such.
...
See #30469 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30613 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-28 11:35:39 +00:00
Gary Pendergast
0cb93dd166
When json_encode() returns a JSON string containing 'null' in PHP 5.4 or earlier, wp_json_encode() will now sanity check the data, as older versions of PHP failed to encode non UTF-8 characters correctly, instead returning 'null'.
...
Fixes #30471 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30561 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-25 05:00:36 +00:00
Drew Jaynes (DrewAPicture)
d93bfdce56
Ensure inline code is markdown-escaped as such, HTML tags are removed from summaries, and that code snippets in descriptions are properly indented.
...
Affects DocBlocks for the following core elements:
* Markdown-indent a code snippet in the description for `_deprecated_argument()`
* Markdown-indent a code snippet in the description for `wp_localize_script()`
* Backtick-escape HTML tags in two parameter descriptions for `wp_register()`
* Various DocBlock formatting in the description for `get_bloginfo()`
* Remove HTML tag from the summary for `_wp_render_title_tag()`
* Backtick-escape a HTML tag in the description for `get_archives_link()`
* Markdown-indent a code snippet in the description for `wp_admin_css_color()`
* Markdown-indent a code snippet in the description for the `welcome_panel` hook
Props rarst.
See #30473 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30541 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-24 05:38:44 +00:00
Drew Jaynes (DrewAPicture)
4f331ec1df
Improve return description for get_file_data() documentation.
...
Also convert an incorrect use of `@see` to `@link`.
Props 5um17 for the initial patch.
Fixes #30466 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30532 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-23 17:56:14 +00:00
John Blackbourn
3afb2efae4
Update the inline docs for wp_die() to reflect parameter changes made in r30355
...
See #10551
git-svn-id: https://develop.svn.wordpress.org/trunk@30507 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-21 17:07:42 +00:00
John Blackbourn
8ea65c3c0d
Add support for WP_Error objects passed to wp_send_json_error(). The error object gets output as an array of error codes and messages, rather than as an empty object.
...
Fixes #28978
Props paulschreiber
git-svn-id: https://develop.svn.wordpress.org/trunk@30506 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-21 16:55:28 +00:00
Drew Jaynes (DrewAPicture)
aa2c1e6e73
Ensure the mixed type of string|int is reflected on the $title parameter in wp_die().
...
The ability to pass an error code as short-hand to the `$title` and `$args` parameters was added in r30355. Changes also include cleaned-up formatting and line-wraps for other documentation in the DocBlock.
See [30355]. Fixes #10551 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30379 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-18 16:46:36 +00:00
John Blackbourn
4e1e4745ff
Switch to a 403 response code in places where it is more appropriate than a 500 due to permissions errors.
...
Fixes #10551
Props nacin
git-svn-id: https://develop.svn.wordpress.org/trunk@30356 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-16 06:15:29 +00:00
John Blackbourn
b68026bbfb
Allow the response code to be passed as a shorthand to the $title or $args parameter of wp_die(), for brevity.
...
See #10551 and #11286
Props nacin
git-svn-id: https://develop.svn.wordpress.org/trunk@30355 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-16 06:10:58 +00:00
Boone Gorges
2b6df5f8ce
Ignore case when checking string 'false' in wp_validate_boolean().
...
Props TobiasBg, kitchin.
Fixes #30238 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30207 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-03 15:54:42 +00:00
Scott Taylor
2443090c23
Correct the @param type for the $query arg for remove_query_arg().
...
See #30224 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30191 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-03 05:28:47 +00:00
Scott Taylor
5f09d235f0
In _wp_json_convert_string(), when $use_mb is false, perhaps pass a variable that actually exists to wp_check_invalid_utf8().
...
Introduced in [30055].
See #30224 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30162 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-01 21:59:58 +00:00
Drew Jaynes (DrewAPicture)
7cd15026bd
Correct references of @uses $wpdb in core documentation to use @global.
...
See #30191 , [30105].
Fixes #30217 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30122 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-31 17:55:39 +00:00
Drew Jaynes (DrewAPicture)
3cc10d77a0
Remove redundant and erroneous @uses tag from most core inline documentation.
...
Per our inline documentation standards, no further use of the `@uses` tag is recommended as used and used-by relationships can be derived through other means. This removes most uses of the tag in core documentation, with remaining tags to be converted to `@global` or `@see` as they apply.
Fixes #30191 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30105 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-30 01:04:55 +00:00
Mark Jaquith
42456d35fd
Docs and code standards cleanup for [30055] (wp_json_encode() & friends)
...
fixes #28786
props TobiasBg
git-svn-id: https://develop.svn.wordpress.org/trunk@30078 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-28 21:28:34 +00:00
Scott Taylor
1e8635fcea
Adjust caching for get_term_by() calls:
...
* Remove md5 hashes for term name cache keys
* Remove the namespace for the keys for `names` and `slugs` and add them to the group names
* Remove `wp_get_last_changed()`, which @nacin hated
Props tollmanz.
Fixes #21760 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30073 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-28 21:04:52 +00:00
Gary Pendergast
d871bf86ca
Fix a PHPDoc typo for wp_json_encode().
...
Props JustinSainton.
See #28786 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30058 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-28 18:53:10 +00:00
Gary Pendergast
0e68ecc0b6
Add wp_json_encode(), a wrapper for json_encode() that ensures everything is converted to UTF-8.
...
Change all core calls from `json_encode()` to `wp_json_encode()`.
Fixes #28786 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30055 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-28 18:34:16 +00:00
Scott Taylor
0d58d32462
Cache get_term_by() calls:
...
* Add a helper function, `wp_get_last_changed()`, to retrieve a last-modified timestamp by cache group
* When caching a term, also make cache entries for slug and name via `slug:{$term_id}` and `name:{$term_id}` keys in the `$taxonomy:$last_changed` bucket that reference the term_id
* In `clean_term_cache()` and `update_term_cache()`, respect `$_wp_suspend_cache_invalidation`
* Original term cache entries maintain BC
Adds unit tests.
Props wonderboymusic, tollmanz, boonebgorges.
Fixes #21760 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29915 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-16 04:44:13 +00:00
Scott Taylor
07a38ff81a
Allow PSDs (Photoshop documents) to be uploaded.
...
Props michalzuber, ccprice.
Fixes #28805 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29833 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-03 19:51:56 +00:00
Mark Jaquith
7063377539
Use HTTPS URLs for core.trac.wordpress.org
...
see #27115
git-svn-id: https://develop.svn.wordpress.org/trunk@29788 602fd350-edb4-49c9-b593-d223f7449a82
2014-09-29 13:27:55 +00:00
Scott Taylor
f00f28cce0
wp_extract_urls() needs to also grab URLs with query strings and hashes.
...
Updates unit test.
Props hauvong, dlh.
Fixes #29314 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29756 602fd350-edb4-49c9-b593-d223f7449a82
2014-09-23 02:49:22 +00:00
Scott Taylor
91517ce620
Clarify that get_the_date(), get_the_time(), get_post_time() and get_post_modified_time() should return false when get_post() is null.
...
Adds unit tests.
Props GaryJ, SergeyBiryukov, tollmanz.
Fixes #28310 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29344 602fd350-edb4-49c9-b593-d223f7449a82
2014-08-01 18:39:22 +00:00
Sergey Biryukov
6be5fc19b3
Make sure phpinfo() is not disabled before calling it in apache_mod_loaded().
...
props rohan013, harmr.
fixes #26772 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29330 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-30 17:27:54 +00:00
Dominik Schilling (ocean90)
080f52ceb9
Revert [28894] as it's currently unused in core.
...
see #28487 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29309 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-27 17:15:22 +00:00
Drew Jaynes (DrewAPicture)
551f829c55
Inline documentation cleanup for 4.0 audit.
...
Various improvements:
* Adds `@see` reference for `wp_list_comments()` in 'wp_list_comments_args' filter docs, added in [28285]
* Various phpDoc tweaks for the 'run_wptexturize' filter docs, added in [28715]
* Sentence and wrapping changes for `is_https_url()`, added in [28894]
* Documents the `$args` parameter for `wp_dropdown_languages()`, added in [29007]
* Adds a period to the parameter description for `_update_posts_count_on_delete()`, added in [28835]
* Documents a global in `is_customize_preview()`, added in [28999]
* phpDoc tweaks, adds an access modifier for `wpdb::esc_like()`, added in [28711]
See #28885 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29163 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-14 01:01:22 +00:00
Drew Jaynes (DrewAPicture)
0be40edabc
Fix inconsistent language in two function descriptions in wp-includes/functions.php.
...
Also adds correct coding standards to a code sample in `_deprecated_argument()`.
Props TobiasBg.
Fixes #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29013 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-07 07:07:17 +00:00
Drew Jaynes (DrewAPicture)
2a07fc794e
General inline documentation improvements in wp-includes/functions.php.
...
Final run. Fixes #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29011 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-07 06:18:05 +00:00
Sergey Biryukov
fd4ad167b2
Some fixes for get_weekstartend() docs.
...
see #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28937 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-01 14:58:37 +00:00
Drew Jaynes (DrewAPicture)
ecb39eaccb
General inline documentation improvements in wp-includes/functions.php.
...
Second run. See #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28936 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-01 01:43:48 +00:00
Sergey Biryukov
4114ff052f
Remove free-spacing modifier and extra spaces from wp_extract_urls() pattern.
...
fixes #28222 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28933 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-30 23:08:48 +00:00
Drew Jaynes (DrewAPicture)
99faddd819
General inline documentation improvements in wp-includes/functions.php.
...
First run. See #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28918 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-30 03:55:03 +00:00
Drew Jaynes (DrewAPicture)
0c8b5722d2
Improve inline documentation for date_i18n(), _http_build_query(), wp_checkdate(), and wp_auth_check().
...
Props morganestes.
See #26185 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28917 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-30 03:46:22 +00:00
Andrew Nacin
02094174f9
Add index key support for wp_list_pluck(), à la array_column().
...
props trepmal.
fixes #28666 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28900 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-29 21:25:21 +00:00
John Blackbourn
3c77cf1140
Introduce is_https_url() for testing whether the scheme for a given URL is https. See #28487 .
...
git-svn-id: https://develop.svn.wordpress.org/trunk@28894 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-29 11:31:25 +00:00
Scott Taylor
56e66c79b4
wp_extract_urls() should not match dates.
...
Updates unit tests.
Props hinnerk, sergej.mueller.
Fixes #28222 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28882 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-28 04:15:30 +00:00
Scott Taylor
782bd3ee67
Do not touch absint(). Reverts [28855].
...
git-svn-id: https://develop.svn.wordpress.org/trunk@28858 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-26 18:44:45 +00:00
Scott Taylor
8ec1723e03
Revert [28856] at nacin's behest. See #23383 .
...
git-svn-id: https://develop.svn.wordpress.org/trunk@28857 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-26 18:33:50 +00:00
Scott Taylor
ce6de601e3
absint() should always return PHP_INT_MAX if the resulting value exceeds it.
...
See [28855].
Fixes #23383 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28856 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-26 18:23:51 +00:00