Disable automatic formatting inside WordPress shortcodes

Question

I've seen the tutorials on creating a (raw) shortcode that leaves the code inside it untouched,

http://www.wprecipes.com/disable-wordpress-automatic-formatting-on-posts-using-a-shortcode

but unfortunately this only applies to one shortcode at a time... and because the else statement bypasses the normal filters and calls the functions directions. My other modifications to autop and texturize functions get ignored.

Is there a way to 1. match multiple shortcodes and 2. preserve my other add/remove filters to the_content?

The link is (effectively) broken. It redirects to a generic page, home for https://wphacks.com/. — Peter Mortensen
– Peter Mortensen, Commented Dec 8, 2019 at 20:51

Peter Mortensen · Accepted Answer · 2019-12-08 20:52:54Z

47

After implementing @helgatheviking's solution on multiple websites, I'm convinced that only these lines are required:

// Move wpautop filter to AFTER shortcode is processed
remove_filter('the_content', 'wpautop');
add_filter('the_content', 'wpautop', 99);
add_filter('the_content', 'shortcode_unautop', 100);

Put them in your functions.php file and you're set.

edited Dec 8, 2019 at 20:52

Peter Mortensen

31.4k22 gold badges110 silver badges134 bronze badges

answered Feb 4, 2013 at 11:08

Matthew Blackford

3,0611 gold badge25 silver badges29 bronze badges

Sign up to request clarification or add additional context in comments.

8 Comments

helgatheviking Over a year ago

Thanks for verifying that. I've accepted this answer so that people will stop using my full code.

Larry K Over a year ago

Where is shortcode_unautop defined? Is it a part of Wordpress?

Nate Beaty Over a year ago

Seriously, why is this not the default? I was getting all sorts of weird mangled output from a shortcode that was run through wpautop twice— dropped this in and it's perfect.

InanisAtheos Over a year ago

@NateBeaty Just yet another weird quirk of WordPress I suppose. wpautop() is one of those functions that seem quite dated just in general, but these behaviours make it more than a little annoying.

Genaut Over a year ago

Anybody remember in what part of functions.php?

|

Peter Mortensen · Accepted Answer · 2019-12-08 20:54:29Z

9

I solved this as best as possible by combining a slightly modified parse_shortcode_content function from Donal MacArthur (his originally manually calls wpautop... which I've removed. With the re-ordering of default filters to run wpautop much later... after the shortcode has already been processed instead of before.

// Clean up WordPress shortcode sormatting - important for nested shortcodes
// Adjusted from http://donalmacarthur.com/articles/cleaning-up-wordpress-shortcode-formatting/
function parse_shortcode_content( $content ) {

   /* Parse nested shortcodes and add formatting. */
    $content = trim( do_shortcode( shortcode_unautop( $content ) ) );

    /* Remove '' from the start of the string. */
    if ( substr( $content, 0, 4 ) == '' )
        $content = substr( $content, 4 );

    /* Remove '' from the end of the string. */
    if ( substr( $content, -3, 3 ) == '' )
        $content = substr( $content, 0, -3 );

    /* Remove any instances of ''. */
    $content = str_replace( array( '<p></p>' ), '', $content );
    $content = str_replace( array( '<p>  </p>' ), '', $content );

    return $content;
}

and moving the filters

// Move wpautop filter to AFTER shortcode is processed
remove_filter( 'the_content', 'wpautop' );
add_filter( 'the_content', 'wpautop', 99);
add_filter( 'the_content', 'shortcode_unautop', 100 );

EDIT:

The parse_shortcode_content() function is no longer required (if it ever was). Simply adjust the filter order.

edited Dec 8, 2019 at 20:54

Peter Mortensen

31.4k22 gold badges110 silver badges134 bronze badges

answered Jul 26, 2011 at 17:04

helgatheviking

26.4k12 gold badges100 silver badges156 bronze badges

5 Comments

helgatheviking Over a year ago

with the filters re-ordered, i'm not even sure that i need to continue using the parse_shortcode_content( $content ) in lieu of simply do_shortcode($content) in my nested shortcodes

nanobar Over a year ago

thanks but where are you calling parse_shortcode_content? if i put that code in functions.php nothing happens. Thanks

helgatheviking Over a year ago

honestly, after a year, i can't really remember. i believe it was inside the shortcode function... in lieu of do_shortcode(). but try re-ordering the filters, that seemed to work for @dan

Lèse majesté Over a year ago

This code doesn't look right. How can a 4-character long or 3-character long string ever be '' (an empty string)?

helgatheviking Over a year ago

i have no idea. it might not be right or even needed, anymore.

Peter Mortensen · Accepted Answer · 2019-12-08 20:55:20Z

5

In my case - this solution has broken one of the side shortcodes (revslider).

So I've found another solution here: http://wordpress-hackers.1065353.n5.nabble.com/shortcode-unautop-tp42085p42086.html

Which is to use another filter like this:

// Via http://www.wpexplorer.com/clean-up-wordpress-shortcode-formatting/
if ( !function_exists('wpex_fix_shortcodes') ) {
    function wpex_fix_shortcodes($content){
        $array = array (
            '<p>[' => '[',
            ']</p>' => ']',
            ']<br />' => ']'
        );
        $content = strtr($content, $array);
        return $content;
    }
    add_filter('the_content', 'wpex_fix_shortcodes');
}

It works fine for me :)

edited Dec 8, 2019 at 20:55

Peter Mortensen

31.4k22 gold badges110 silver badges134 bronze badges

answered Nov 5, 2015 at 13:57

chestozo

1,3311 gold badge14 silver badges30 bronze badges

Comments

Peter Mortensen · Accepted Answer · 2019-12-08 20:56:16Z

1

Please see my answer here:

Remove wpautop from shortcode content / remove whitespace in buffering

It allows you to turn off wpautop for as many specific shortcodes as you want using this:

include "shortcode-wpautop-control.php";
chiedolabs_shortcode_wpautop_control(array('shortcodeone', 'shortcodetwo'));

edited Dec 8, 2019 at 20:56

Peter Mortensen

31.4k22 gold badges110 silver badges134 bronze badges

answered Dec 14, 2015 at 17:22

Chiedo

7,5843 gold badges28 silver badges23 bronze badges

Collectives™ on Stack Overflow

Disable automatic formatting inside WordPress shortcodes

4 Answers 4

8 Comments

5 Comments

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

4 Answers 4

8 Comments

5 Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related