`s, leaving orphan ``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 `
` tags, etc.
The [Codex says](https://codex.wordpress.org/Shortcode_API#Output):
> 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 as `
` or `
`.
But 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 `` tag with some classes. _(Yeah, you might want to use [custom TinyMCE styles](https://codex.wordpress.org/TinyMCE_Custom_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.
## 安裝方式
See the standard installation instructions at [WordPress.org](https://codex.wordpress.org/Managing_Plugins#Installing_Plugins)
or [WPBeginner](http://www.wpbeginner.com/beginners-guide/step-by-step-guide-to-install-a-wordpress-plugin-for-beginners/).
I expect developers will copy the code directly into their functions.php files,
possibly customizing the string to specify the priority shortcodes.
## 常見問題集
### Does this affect all shortcodes?
No. See “Usage” above.
### Should I use this everywhere instead of the normal shortcodes?
No. Only use it on shortcodes that are being messed up.
### How does it work?
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](https://core.trac.wordpress.org/browser/tags/4.0/src/wp-includes/shortcodes.php#L0)
### Why not just change the order wpautop and do_shortcode run in?
That can mess up other shortcodes. Plus, I’ve tried it, and it doesn’t have the
result I wanted at all.
## 使用者評論
### [Pure Garbage](https://wordpress.org/support/topic/pure-garbage-7/)
[Chris](https://profiles.wordpress.org/nutlog13/) 2022 年 12 月 13 日
This plugin has a fatal flaw for me so I’m giving it a 1/5, from me. Karma sucks!
[ 閱讀全部 0 則使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/)
## 參與者及開發者
以下人員參與了開源軟體〈Priority Shortcodes〉的開發相關工作。
參與者
* [ swinggraphics ](https://profiles.wordpress.org/swinggraphics/)
[將〈Priority Shortcodes〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/priority-shortcodes)
### 對開發相關資訊感興趣？
任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/priority-shortcodes/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/priority-shortcodes/)，或透過
[RSS](https://plugins.trac.wordpress.org/log/priority-shortcodes/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/priority-shortcodes/)。
## 變更記錄
#### 2.0.2
* Tested with WP 5.6
* Updated README with note about Gutenberg
#### 2.0.1
* Bumped “Tested up to” version
#### 2.0
* Changed to more simple `[!` syntax
* Added compatibility with text widgets
#### 1.0
* Initial release
## 中繼資料
* 版本 **2.0.2**
* 最後更新 **2 年前**
* 啟用安裝數 **10+**
* WordPress 版本需求 ** 2.5.0 或更新版本 **
* 已測試相容的 WordPress 版本 **6.5.8**
* 語言
* [English (US)](https://wordpress.org/plugins/priority-shortcodes/)
* 標籤:
* [classic editor](https://tw.wordpress.org/plugins/tags/classic-editor/)[shortcodes](https://tw.wordpress.org/plugins/tags/shortcodes/)
[tinyMCE](https://tw.wordpress.org/plugins/tags/tinymce/)
* [進階檢視](https://tw.wordpress.org/plugins/priority-shortcodes/advanced/)
## 評分
1 星，滿分為 5 星
* [ 0 個 5 星使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/?filter=5)
* [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/?filter=4)
* [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/?filter=3)
* [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/?filter=2)
* [ 1 個 1 星使用者評論 ](https://wordpress.org/support/plugin/priority-shortcodes/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/priority-shortcodes/reviews/#new-post)
[查看全部使用者評論](https://wordpress.org/support/plugin/priority-shortcodes/reviews/)
## 參與者
* [ swinggraphics ](https://profiles.wordpress.org/swinggraphics/)
## 技術支援
使用者可在技術支援論壇提出意見反應或使用問題。
[檢視技術支援論壇](https://wordpress.org/support/plugin/priority-shortcodes/)