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

[code lang=»bash»]php antonella make TuControlladorController [/code]

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

[code lang=»php»]

public function Mishortcode()
{
return ‘hola mundo’;
}

[/code]

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

[code lang=»php»]

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

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.

[code lang=»php»] public function Mishortcode( $atts, $content = null ) {
$a = shortcode_atts( array(
‘attr_1’ => ‘attribute 1 default’,
‘attr_2’ => ‘attribute 2 default’,
// …etc
), $atts );
}
[/code]

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:

[code lang=»php»] public function Mishortcode( $atts, $content = null ) {
return ‘<span class=»caption»>’ . $content . ‘</span>’;
}
[/code]

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