Cuando estemos realizando un plugin de WordPress va a ser frecuente que necesitemos indicar un valor especial e en nuestra entrada o página para que sea sustituido por el lo que nosotros programemos en el Plugin. Es lo que se conoce como shortcode.
Nuestro plugin deberá incorporar la instrucción:
add_shortcode('MyShortCode', 'ab_category_posts_show');
Esto lo que hace es que cuando WordPress encuentre en una entrada el siguiente valor [MyShortCode] ejecute la función ab_category_posts_show().
Esta función puede tener la siguiente estructura:
- function ab_category_posts_show($atts, $content=null){
- $title = $atts['title'];
- $cats_selected = array();
- $cats_selected = explode(",", $atts['cat']);
- foreach ( $cats_selected as $catid ) {
- $content .= '...';
- }
- ....
- return $content;
- }
Este ejemplo también sirve para comentar como pasar parámetros a la función que vamos a utilizar mediante el valor $atts. Es un array con todos los parámetros que se han especificado dentro del Shortcode. Un parámetro dentro de array a su vez puede ser un único valor (title) o contener una lista de valores que necesitamos pasar a un array de parámetros (cat). En este último caso utilizaremos la función explode() para poner en un array por el que podamos iterar la lista de parámetros.
Ejemplos de llamadas:
- [MyShortCode title="My title"]
- [MyShortCode title="My title" cat=5]
- [MyShortCode title="My title" cat=5,235,4]
