Crear un shortcode con Antonella Framework

Esta vez vamos a hacer un shortcode con Antonella Framework sobre un proyecto ya empezado.

Para ello ya debes haber descargado Antonella Framework de su repositorio e instalarlo.  Toda la información sobre los pasos iniciales puedes verlo aquí  https://antonellaframework.com/documentacion/

Creando un Shortcode nivel fácil

Para crear un shorcode es muy fácil debemos crear una función o crear un controlador y crear una función dentro de la clase del controlador creado

Para crear un Controlador podemos ir a la consola y ejecutar

php antonella make TuControlladorController

llamemos a la funcion «MiShortcode» pero puedes llamarlo como desees

public function Mishortcode()
{
return 'hola mundo';
}

Ahora vamos a Config.php en  el apartado shortcodes y ponemos

/**
* add custom shortcodes
* @input array
* @example [['example',__NAMESPSCE__.'ExampleController::example_shortcode']]
*/
public $shortcodes=[
['mi-shortcode', __NAMESPACE__.'TuControlladorController::Mishortcode']
];

Y ya está. cuando pongamos en cualquier parte del contenido del post  «[mi-shortcode]» se reemplazará por la frase «hola mundo»

Creando un Shortcode Nivel Avanzado

Para ello podemos seguir la documentación que hay en el CODEX de WordPress referente a los shortcodes sólo que las funciones que crearemos lo pondremos en nuestra clase controladora.

public function Mishortcode( $atts, $content = null ) {
$a = shortcode_atts( array(
'attr_1' => 'attribute 1 default',
'attr_2' => 'attribute 2 default',
// ...etc
), $atts );
}

Asi puedes colocar el shortcode en el post asi: [mi-shortcode attr_1=»algun valor» attr_2=»5″]

Recogerá los atributos y puedes jugar con ellos para hacer lo que desees.

Otro ejemplo:

public function Mishortcode( $atts, $content = null ) {
return '<span class="caption">' . $content . '</span>';
}

Asi puedes poner en el post [mi-shortcode]Este es un texto de ejemplo[/mi-shortcode]

Como verás es sencillo poder hacer shortcodes con WordPress y más sencillo con la ayuda de Antonella Framework.

Si te gusta compártelo