vhad/wordpress-develop
1
0
Fork 0
mirror of https://github.com/gosticks/wordpress-develop.git synced 2026-04-07 22:24:36 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Docs: Corrections and improvements to docblocks for global styles, global settings, theme.json parsing, and shortcodes.

Browse Source 
See #57840


git-svn-id: https://develop.svn.wordpress.org/trunk@55711 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
John Blackbourn
2023-05-03 18:46:44 +00:00
parent 8a074052c5
commit 90fb45dfdd
4 changed files with 49 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
src/wp-includes/shortcodes.php
View File

@@ -308,8 +308,18 @@ function get_shortcode_regex( $tagnames = null ) {
*
* @global array $shortcode_tags
*
* @param array $m Regular expression match array.
* @return string|false Shortcode output on success, false on failure.
* @param array $m {
* Regular expression match array.
*
* @type string $0 Entire matched shortcode text.
* @type string $1 Optional second opening bracket for escaping shortcodes.
* @type string $2 Shortcode name.
* @type string $3 Shortcode arguments list.
* @type string $4 Optional self closing slash.
* @type string $5 Content of a shortcode when it wraps some content.
* @type string $6 Optional second closing brocket for escaping shortcodes.
* }
* @return string Shortcode output.
*/
function do_shortcode_tag( $m ) {
global $shortcode_tags;
@@ -342,7 +352,7 @@ function do_shortcode_tag( $m ) {
*
* @param false|string $output Short-circuit return value. Either false or the value to replace the shortcode with.
* @param string $tag Shortcode name.
* @param array|string $attr Shortcode attributes array or empty string.
* @param array|string $attr Shortcode attributes array or the original arguments string if it cannot be parsed.
* @param array $m Regular expression match array.
*/
$return = apply_filters( 'pre_do_shortcode_tag', false, $tag, $attr, $m );
@@ -361,7 +371,7 @@ function do_shortcode_tag( $m ) {
*
* @param string $output Shortcode output.
* @param string $tag Shortcode name.
* @param array|string $attr Shortcode attributes array or empty string.
* @param array|string $attr Shortcode attributes array or the original arguments string if it cannot be parsed.
* @param array $m Regular expression match array.
*/
return apply_filters( 'do_shortcode_tag', $output, $tag, $attr, $m );
@@ -521,11 +531,10 @@ function get_shortcode_atts_regex() {
*
* @since 2.5.0
*
* @param string $text
* @return array|string List of attribute values.
* Returns empty array if '""' === trim( $text ).
* Returns empty string if '' === trim( $text ).
* All other matches are checked for not empty().
* @param string $text Shortcode arguments list.
* @return array|string Array of attribute values keyed by attribute name.
* Returns empty array if there are no attributes.
* Returns the original arguments string if it cannot be parsed.
*/
function shortcode_parse_atts( $text ) {
$atts = array();