Changeset 38713 for trunk/src/wp-includes/shortcodes.php

Timestamp:

10/04/2016 12:38:45 AM (9 years ago)

Author:

pento

Message:

Shortcodes: Add a do_shortcode_tag filter.

The addition of the pre_do_shortcode_tag in [38506] allows plugins to short-circuit the shortcode execution process, which is particularly helpful for caching expensive shortcodes.

The do_shortcode_tag is the corresponding part of that system - when a shortcode hasn't been executed previously, there needs to be a clean method of populating the cache.

Props flixos90.
Fixes #32790.

File:

• trunk/src/wp-includes/shortcodes.php (modified) (1 diff)

trunk/src/wp-includes/shortcodes.php

@@ -340 +340 @@
     }
 
-    if ( isset( $m[5] ) ) {
-        // enclosing tag - extra parameter
-        return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, $m[5], $tag ) . $m[6];
-    } else {
-        // self-closing tag
-        return $m[1] . call_user_func( $shortcode_tags[$tag], $attr, null,  $tag ) . $m[6];
-    }
+    $content = isset( $m[5] ) ? $m[5] : null;
+
+    $output = $m[1] . call_user_func( $shortcode_tags[ $tag ], $attr, $content, $tag ) . $m[6];
+
+    /**
+     * Filters the output created by a shortcode callback.
+     *
+     * @since 4.7.0
+     *
+     * @param string $output Shortcode output.
+     * @param string $tag    Shortcode name.
+     * @param array  $attr   Shortcode attributes array,
+     * @param array  $m      Regular expression match array.
+     */
+    return apply_filters( 'do_shortcode_tag', $output, $tag, $attr, $m );
 }