shortcode_unautop

Don't auto-p wrap shortcodes that stand alone.

Description

(string) shortcode_unautop( (string) $pee ); 

Ensures that shortcodes are not wrapped in

...

..

Returns (string)

The filtered content.

Parameters (1)

0. $pee (string)
The content.

Usage

  1. if ( !function_exists( 'shortcode_unautop' ) ) { 
  2.     require_once ABSPATH . WPINC . '/formatting.php'; 
  3. } 
  4.   
  5. // The content. 
  6. $pee = ''; 
  7.   
  8. // NOTICE! Understand what this does before running. 
  9. $result = shortcode_unautop($pee); 
  10.     

Defined (1)

The function is defined in the following location(s).

/wp-includes/formatting.php  
  1. function shortcode_unautop( $pee ) { 
  2.     global $shortcode_tags; 
  3.  
  4.     if ( empty( $shortcode_tags ) || !is_array( $shortcode_tags ) ) { 
  5.         return $pee; 
  6.     } 
  7.  
  8.     $tagregexp = join( '|', array_map( 'preg_quote', array_keys( $shortcode_tags ) ) ); 
  9.     $spaces = wp_spaces_regexp(); 
  10.  
  11.     $pattern = 
  12.           '/' 
  13.         . '<p>'                              // Opening paragraph 
  14.         . '(?:' . $spaces . ')*+'            // Optional leading whitespace 
  15.         . '('                                // 1: The shortcode 
  16.         .     '\\['                          // Opening bracket 
  17.         .     "($tagregexp)"                 // 2: Shortcode name 
  18.         .     '(?![\\w-])'                   // Not followed by word character or hyphen 
  19.                                              // Unroll the loop: Inside the opening shortcode tag 
  20.         .     '[^\\]\\/]*'                   // Not a closing bracket or forward slash 
  21.         .     '(?:' 
  22.         .         '\\/(?!\\])'               // A forward slash not followed by a closing bracket 
  23.         .         '[^\\]\\/]*'               // Not a closing bracket or forward slash 
  24.         .     ')*?' 
  25.         .     '(?:' 
  26.         .         '\\/\\]'                   // Self closing tag and closing bracket 
  27.         .     '|' 
  28.         .         '\\]'                      // Closing bracket 
  29.         .         '(?:'                      // Unroll the loop: Optionally, anything between the opening and closing shortcode tags 
  30.         .             '[^\\[]*+'             // Not an opening bracket 
  31.         .             '(?:' 
  32.         .                 '\\[(?!\\/\\2\\])' // An opening bracket not followed by the closing shortcode tag 
  33.         .                 '[^\\[]*+'         // Not an opening bracket 
  34.         .             ')*+' 
  35.         .             '\\[\\/\\2\\]'         // Closing shortcode tag 
  36.         .         ')?' 
  37.         .     ')' 
  38.         . ')' 
  39.         . '(?:' . $spaces . ')*+'            // optional trailing whitespace 
  40.         . '<\\/p>'                           // closing paragraph 
  41.         . '/'; 
  42.  
  43.     return preg_replace( $pattern, '$1', $pee ); 
  44. }