I would like to create shortcodes
, but some tutorials write about to use add_action
:
add_action( 'init', 'register_shortcodes');
But I read another tutorial where the author didn’t use it, only put this to functions.php
:
add_shortcode( 'recent-posts', 'recent_posts_function' );
Which is the best method, and why to use add_action
?
If you take a look at the Codex page about
add_shortcode()
you won’t see anything about the need of anadd_action()
before you can useadd_shortcode()
.So, you can just put your
add_shortcode()
directly into yourfunctions.php
. This is what I do too.See this article – WordPress Shortcodes: A Complete Guide about the use of shortcodes and best practices.
Sometimes it is required to use ‘init’ action. For example, right now I edit theme heavily based on widgets and customize panel. I tried to add custom shortcode without actions and got errors upon saving content in Customize panel. Action ensures the right order of executing functions. It says “hey shortcodes! First I will load most important functions, then you!”
Without repeating too much that has been covered in the answers above; this is just a best practices approach. I often use this in plugin development where I need to have separate classes like in the wppb.me plugin starter template.
It makes sense to register all your admin hooks in the loader. In the case of the shortcode, you can add the add_action shortcode hook in the hooks loader method :
The main benefit I have with this approach is for easy code maintenance since the code is modular. You can add several other hooks in the same method which makes it easy to track and change things, especially for a large plugin.
It, therefore, means in the class where you want to use
add_shortcode
you do not have to run the action hook in the constructor method, you can now use it in a custom method like :