Mastering the shortcode api

Mastering the Shortcode API Peter Baylies Semper Fi Web DesignMonday, November 7, 11

What’s a shortcode • It’s a tag that can dynamically insert content into your wordpress site. It should look sort of like this: [gallery]Monday, November 7, 11

How do I make them? • with the add_shortcode() function • arguments: your shortcode’s name and your PHP function that it calls: add_shortcode(‘tag’,‘my_function_name’);Monday, November 7, 11

Wait, my PHP function? • Yes, it can be passed up to three arguments: my_function_name($atts,$content,$code); • arguments passed to your shortcode • content contained within your shortcode • the name of the shortcode itselfMonday, November 7, 11

Attributes • Shortcode attributes look like this: [gallery id=”123” columns=”4”] • They get processed with shortcode_atts() extract ( shortcode_atts ( array ( ‘id’ => null, ‘columns’=>3 ), $atts ) ); • This sets defaults and validates arguments.Monday, November 7, 11

Content • Shortcodes can enclose content too. [caption]This is a caption.[/caption] The text in between the shortcode tags gets passed to $content for processing.Monday, November 7, 11

Code • The name of the shortcode called. • This gives you the ability to write one function to handle multiple shortcodes. • This helps avoid duplication of code.Monday, November 7, 11

Removing a shortcode: • remove_shortcode() • Lets you unregister an existing shortcode • This lets you replace other shortcodes with your own custom code.Monday, November 7, 11

Running a shortcode: •do_shortcode() • This handles shortcode processing. • Run it on $content to nest shortcodes: [loop] [title] [content] [/loop]Monday, November 7, 11

That’s It! • Now go forth and write shortcodes! • Any Questions?Monday, November 7, 11

Mastering the shortcode api

by Peter Baylies

Accessibility

Categories

Upload Details

Usage Rights

1 Embed 1

Statistics

Mastering the shortcode api Presentation Transcript