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

Timestamp:

09/02/2016 12:09:42 AM (10 years ago)

Author:

pento

Message:

Shortcodes: Add the pre_do_shortcode_tag filter.

This filter allows the shortcode generation process to be short-circuited, so expensive short codes can be cached and returned immediately.

Props ideag.
Fixes #37906.

File:

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

trunk/src/wp-includes/shortcodes.php

@@ -322 +322 @@
         }
 
+        /**
+         * Filters whether to call a shortcode callback.
+         *
+         * Passing a truthy value to the filter will effectively short-circuit the
+         * shortcode generation process, returning that value instead.
+         *
+         * @since 4.7.0
+         *
+         * @param bool|string $return      Short-circuit return value. Either false or the value to replace the shortcode with.
+         * @param string      $tag         Shortcode name.
+         * @param array       $attr        Shortcode attributes array,
+         * @param array       $m           Regular expression match array.
+         */
+        $return = apply_filters( 'pre_do_shortcode_tag', false, $tag, $attr, $m );
+        if ( false !== $return ) {
+                return $return;
+        }
+
         if ( isset( $m[5] ) ) {
                 // enclosing tag - extra parameter