开发者 | swinggraphics |
---|---|
更新时间 | 2024年4月16日 06:19 |
PHP版本: | 2.5.0 及以上 |
WordPress版本: | 6.5.2 |
版权: | GPLv2 or later |
版权网址: | 版权信息 |
<p>
s around <div>
s, leaving orphan </p>
s, and all sorts of craziness? This plugin allows you to specify shortcodes to be processed before those other actions, generating the clean code you expected.
Priority Shortcodes works by adding an action to the_content
and widget_text
hooks with a higher priority than wpautop
and do_shortcode
. The result is that those other actions run your shortcode's final output, rather than trying to guess if it should be wrapped in <p>
tags, etc.
The Codex says:
wpautop recognizes shortcode syntax and will attempt not to wrap p or br tags around shortcodes that stand alone on a line by themselves. Shortcodes intended for use in this manner should ensure that the output is wrapped in an appropriate block tag such asBut sometimes shortcodes stand on their own on a line, wanting desperately to be wrapped in a paragraph tag, and sometimes they don't. Like a shortcode that generates a<p>
or<div>
.
<span>
tag with some classes. (Yeah, you might want to use custom TinyMCE styles instead for a simple span.)
Usage
Where you want to process a shortcode with priority, use "[!" at the start. For example: [my-shortcode]
becomes [!my-shortcode]
and [my-shortcode]Some content.[/my-shortcode]
becomes [!my-shortcode]Some content.[/my-shortcode]
.
Gutenberg
Users of the new WordPress editor, "Gutenberg", will probably not use Priority Shortcodes within the new editor, but the plugin continues to work in the Classic Editor.
No.
No. Only use it on shortcodes that are being messed up.
The plugin adds an action hook to the_content
with priority 9, before wpautop
and do_shortcode
, which run with normal priority 10. The function that runs in our action hook is basically a copy/mashup of do_shortcode()
and do_shortcode_tag()
with a custom regular expression. That regex pulled using get_shortcode_regex()
, so any updates to that expression in core will be respected by this plugin. See shortcodes.php
That can mess up other shortcodes. Plus, I've tried it, and it doesn't have the result I wanted at all.
[!
syntax