Docs: Add a reminder to the DocBlock description for add_query_arg() mentioning that the output is not escaped by default.

Props brentvr for the initial patch. (first props!)
See #33912. See #32246.


git-svn-id: https://develop.svn.wordpress.org/trunk@34264 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Drew Jaynes 2015-09-17 09:38:56 +00:00
parent f9ff998d01
commit 8c65cfc7f4

View File

@ -680,6 +680,10 @@ function _http_build_query( $data, $prefix = null, $sep = null, $key = '', $urle
* value. Additional values provided are expected to be encoded appropriately * value. Additional values provided are expected to be encoded appropriately
* with urlencode() or rawurlencode(). * with urlencode() or rawurlencode().
* *
* Important: The return value of add_query_arg() is not escaped by default.
* Output should be late-escaped with esc_url() or similar to help prevent
* vulnerability to cross-site scripting (XSS) attacks.
*
* @since 1.5.0 * @since 1.5.0
* *
* @param string|array $param1 Either newkey or an associative_array. * @param string|array $param1 Either newkey or an associative_array.