Wordpress: Using the shortcodes
Friday, July 3, 2009 Since version 2.5 of Wordpress (better than 2.5.1) are available so-called shortcodes, a procedure that allows the creation of callback, or better than the hook, when our place in the text it finds a string formatted with brackets like [id_shortcode] . Before the release 2.5 of the WordPress shortcodes were implemented manually (Napolux), now you can exploit them more easily and for many different uses.
Syntax
To use shortcodes is sufficient to create a hook function, with parameters and set the standard shortcodes through add_shortcode()
- / **
- * This is the prototype of the hook function
- * /
- $attrs , $content = null ) { mio_shortcode_hook function ($ attrs, $ content = null) (
- / / Code here
- ; return "Output in the post";
- )
- / **
- * Add_shortcode () takes two parameters:
- *
- * @ Param string $ tag shortcode tags to be searched in post content.
- * @ Param callable $ func Hook to run when shortcode is found.
- * /
- , "mio_shortcodes_hook" ) ; add_shortcode (mio_shortcode "," mio_shortcodes_hook ");
This code can be placed in the file functions.php When writing your post by including mio_shortcode brackets will be executed as code dell'hook (the function) mio_shortcode_hook()
The hook function, and our shortcode can be used in various ways as needed:
- <! - Only shortcode ->
- [mio_shortcode]
- <! - With attributes ->
- [mio_shortcode color = '# 000000']
- <! - With content included ->
- [mio_shortcode color = '# 000000'] I am content [/ mio_shortcode]
Note: the above code I had to insert a space between the shortcode closing the opening of the bracket and the slash. This area will be eliminated in your code. All this because of a conflict with the plugin that I use to see the code, as anc'esso uses a syntax similar to the shortcode
Management attributes
The attributes included in a shortcode are easy to handle and you can set the default value. Here, for example how to create a shortcode that operates a title specially formatted:
- $attrs , $content = null ) { mio_shortcode_hook function ($ attrs, $ content = null) (
- 'attributo 1 default' , 'attr_1' => 'attribute 1 default',
- 'attributo 2 default' , 'attr_2' => 'attribute 2 default',
- / / ... Etc
- $attrs ) ) ; ), $ Attrs));
- / / ...
- )
Similarly to how we saw Wordpress: wp_parse_args (), the management of attributes is very simple and allows you to set default values in the absence of the attributes themselves. The code above "melts" the array $attrs with that dynamic through the function shortcode_atts() (cousin of wp_parse_args() making available in the scope of the function (see extract() attributes as variables. Attributes must be all lowercase!
Content Management
The way the content is the most versatile in specific cases, here is an illustrative example:
- $attrs , $content = null ) { make_title_shortcode function ($ attrs, $ content = null) (
- . $content . '"><span>' . $content . '</span></h1>' ; return '<h1 title="'. $content.'"> <span>'. $ content. '</ span> </ h1>';
- )
- , 'make_title_shortcode' ) ; add_shortcode ( 'my-title', 'make_title_shortcode');
Using the shortcode in our post:
- [my-title] This is a title [/ my-title]
We will have as output:
We can improve our model by introducing even more customizable attributes to make our shortcode:
- $attrs , $content = null ) { make_title_shortcode function ($ attrs, $ content = null) (
- 'my-title' , 'class' => 'my-title',
- $attrs ) ) ; ), $ Attrs));
- . $class . '" title="' . $content . '"><span>' . $content . '</span></h1>' ; return '<h1 class="'. $class.'" title="'. $content.'"> <span>'. $ content. '</ span> </ h1>';
- )
- [my-title class = "color-red"] This is a title [/ my-title]
As already mentioned you will find extensive information on documentazine official WordPress. Here are some useful shortcode.
Show AdSense in posts
Enter the code below into your file functions.php Change the Google AdSense code with your own.
- show_adsense function () (
- return '<script type="text/javascript"> <! --
- google_ad_client = "pub-9877654123213210";
- google_ad_slot = "9876543210";
- google_ad_width = 468;
- google_ad_height = 60;
- //-->
- </ script>
- <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </ script>
- ';
- )
- , 'adsense' ) ; add_shortcode ( 'myadsense', 'adsense');
In the place just enter:
- [myadsense]
Add notes to a post visible only by the administrator
This shortcode allows you to add notes to a post visible only to an administrator.
- $attrs , $content = null ) { admin_note function ($ attrs, $ content = null) (
- current_user_can ( 'publish_posts' ) ) if (current_user_can ( 'publish_posts'))
- . $content . '</div>' ; return '<div class="admin-note">'. $ content. '</ div>';
- ; return'';
- )
- , 'admin_note' ) ; add_shortcode ( 'admin-notes', 'admin_note');
- [note] This note is visible only to administrators of the blog [/ note]
Publish in future other shortcode useful ...
Related Post
Loading ... 
As they say here in America ... Awesome! I did not know this thing of short codes in wordpress, I've always done "by hand" with the old method. Thank you.
@ camu: dear ... glishortcodes actually are a very powerful and useful in many occasions. Apropos ... I know that this year will not be able to come and get you a greeting, but kept carefully your very useful suggestions and I will try to follow them for at least the next year ...
Absolutely! You want, you are welcome
[...] Further consult original article: Undolog.com »Wordpress: Using the shortcodes Related articles: Pligg - WordPress: Using the [...]
Excellent
or so I wrote a small plugin bbcode 