Cómo agregar una interfaz de usuario de código corto en WordPress con Shortcake

Si está desarrollando un sitio de WordPress para un cliente, es probable que tenga códigos cortos para que los usen sus clientes. El problema es que muchos principiantes no saben cómo agregar códigos cortos y si están involucrados parámetros complejos, entonces es aún más difícil. Shortcake proporciona una solución al agregar una interfaz de usuario para códigos cortos. En este artículo, le mostraremos cómo agregar una interfaz de usuario de código corto en WordPress con Shortcake.

¿Qué es Shortcake?

WordPress ofrece una forma más fácil de agregar código ejecutable dentro de publicaciones y páginas usando códigos cortos. Muchos temas y plugins de WordPress permiten a los usuarios agregar funciones adicionales mediante códigos cortos. Sin embargo, estos códigos cortos a veces pueden complicarse cuando un usuario tiene que ingresar parámetros para la personalización.

Por ejemplo, en un tema típico de WordPress, si hay un código corto para insertar un botón, el usuario probablemente tendrá que agregar al menos de dos a cinco parámetros. Me gusta esto:

[themebutton url=”http://example.com” title=”Download Now” color=”purple” target=”newwindow”]

Shortcake es un plugin de WordPress y una función futura propuesta de WordPress. Su objetivo es resolver este problema proporcionando una interfaz de usuario para ingresar estos valores. Esto hará que los códigos cortos sean mucho más fáciles de usar.

Para comenzar

Este tutorial está dirigido a usuarios que son nuevos en el desarrollo de WordPress. Incluso los usuarios de nivel principiante que quieran editar sus temas de WordPress encontrarán útil este tutorial.

Dicho esto, comencemos.

Lo primero que debe hacer es instalar y activar el archivo. Shortcake (interfaz de usuario de código abreviado) conectar.

Ahora necesitará un código corto que acepte algunos parámetros de entrada del usuario. Si necesita una pequeña actualización, aquí le mostramos cómo agregar un código corto en WordPress.

Por el bien de este tutorial, utilizaremos un código abreviado simple que permite a los usuarios insertar un botón en sus publicaciones o páginas de WordPress. Aquí está el código de muestra para nuestro código corto y puede usarlo agregándolo al archivo de funciones de su tema o en un plugin específico del sitio.

add_shortcode( 'cta-button', 'cta_button_shortcode' );

function cta_button_shortcode( $atts ) {
       extract( shortcode_atts(
               array(
                       'title' => 'Title',
                       'url' => ''
               ),
               $atts
       ));
       return '<span class="cta-button"><a href="' . $url . '">' . $title . '</a></span>';
}

También necesitará agregar algo de CSS para diseñar su botón. Puede utilizar este CSS en la hoja de estilo de su tema.


.cta-button {
padding: 10px;
font-size: 18px;
border: 1px solid #FFF;
border-radius: 7px;
color: #FFF;
background-color: #50A7EC;
}

Así es como un usuario usará el shortcode en sus publicaciones y páginas:

[cta-button title="Download Now" url="http://example.com"]

Ahora que tenemos un código corto que acepta parámetros, creemos una interfaz de usuario para él.

Registro de interfaz de usuario de código corto con Shortcake

La API de Shortcake te permite registrar la interfaz de usuario de tu shortcode. Deberá describir qué atributos acepta su código abreviado, los tipos de campos de entrada y qué tipos de publicaciones mostrarán la interfaz de usuario del código abreviado.

A continuación se muestra un fragmento de código de muestra que usaremos para registrar la interfaz de usuario de nuestro código corto. Hemos intentado explicar cada paso con comentarios en línea. Puede pegarlo en el archivo de funciones de su tema o en un plugin específico del sitio.

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
'cta-button',

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface. This part is required. */
'label' => 'Add Button',

/** Icon or an image attachment for shortcode. Optional. src or dashicons-$icon.  */
'listItemImage' => 'dashicons-lightbulb',

/** Shortcode Attributes */
'attrs'          => array(

/**
* Each attribute that accepts user input will have its own array defined like this
* Our shortcode accepts two parameters or attributes, title and URL
* Lets first define the UI for title field. 
*/

array(

/** This label will appear in user interface */
'label'        => 'Title',

/** This is the actual attr used in the code used for shortcode */
'attr'         => 'title',

/** Define input type. Supported types are text, checkbox, textarea, radio, select, email, url, number, and date. */
'type'         => 'text',

/** Add a helpful description for users
'description'  => 'Please enter the button text',
),

/** Now we will define UI for the URL field */

array(
'label'        => 'URL',
'attr'         => 'url',
'type'         => 'text',
'description'  => 'Full URL',
),
),
),

/** You can select which post types will show shortcode UI */
'post_type'     => array( 'post', 'page' ), 
)
);

Eso es todo, ahora puede ver la interfaz de usuario de código corto en acción editando una publicación. Simplemente haga clic en el botón Agregar medios encima de un editor de publicaciones. Aparecerá el cargador de medios donde verá un nuevo elemento “Insertar elemento de elemento” en la columna de la izquierda. Al hacer clic en él, aparecerá un botón para ingresar el código.

Insertando su shortcode en una publicación o página

Al hacer clic en la miniatura que contiene el icono de la bombilla y la etiqueta circular, aparecerá la interfaz de usuario del código corto.

Interfaz de usuario para un código corto simple

Agregar códigos cortos con múltiples entradas

En el primer ejemplo, usamos un shortcode muy simple. Ahora hagámoslo un poco más complicado y mucho más útil. Agreguemos un código corto que permita a los usuarios elegir un color para el botón.

Primero agregaremos el shortcode. Es casi el mismo código abreviado, excepto que ahora excluye la entrada del usuario para el color.


add_shortcode( 'mybutton', 'my_button_shortcode' );

function my_button_shortcode( $atts ) {
       extract( shortcode_atts(
               array(
                       'color' => 'blue',
                       'title' => 'Title',
                       'url' => ''
               ),
               $atts
       ));
       return '<span class="mybutton ' . $color . '-button"><a href="' . $url . '">' . $title . '</a></span>';
}

Dado que nuestro código abreviado mostrará botones en diferentes colores, también necesitaremos actualizar nuestro CSS. Puede utilizar este CSS en la hoja de estilo de su tema.

.mybutton {
    padding: 10px;
    font-size: 18px;
    border: 1px solid #FFF;
    border-radius: 7px;
    color: #FFF;
}

.blue-button  {
    background-color: #50A7EC;
}
.orange-button { 
background-color:#FF7B00;
} 

.green-button { 
background-color:#29B577;
}

Así es como se verán los botones:

Botones de llamada a la acción creados con códigos cortos

Ahora que nuestro shortcode está listo, el siguiente paso es registrar la interfaz de usuario del shortcode. Usaremos esencialmente el mismo código, excepto que esta vez tenemos otro parámetro para el color y ofrecemos a los usuarios la opción de botones azules, naranjas o verdes.

shortcode_ui_register_for_shortcode(

/** Your shortcode handle */
'mybutton',

/** Your Shortcode label and icon */
array(

/** Label for your shortcode user interface. This part is required. */
'label' => 'Add a colorful button',

/** Icon or an image attachment for shortcode. Optional. src or dashicons-$icon.  */
'listItemImage' => 'dashicons-flag',

/** Shortcode Attributes */
'attrs'          => array(

/**
* Each attribute that accepts user input will have its own array defined like this
* Our shortcode accepts two parameters or attributes, title and URL
* Lets first define the UI for title field. 
*/

array(

/** This label will appear in user interface */
'label'        => 'Title',

/** This is the actual attr used in the code used for shortcode */
'attr'         => 'title',

/** Define input type. Supported types are text, checkbox, textarea, radio, select, email, url, number, and date. */
'type'         => 'text',

/** Add a helpful description for users */
'description'  => 'Please enter the button text',
),

/** Now we will define UI for the URL field */

array(
'label'        => 'URL',
'attr'         => 'url',
'type'         => 'text',
'description'  => 'Full URL',
),

/** Finally we will define the UI for Color Selection */ 
array(
'label'		=> 'Color',
'attr'      => 'color',

/** We will use select field instead of text */
'type'		=> 'select',
    'options' => array(
        'blue'		=> 'Blue',
        'orange'	=> 'Orange',
        'green'		=> 'Green',
    ),
),

),

/** You can select which post types will show shortcode UI */
'post_type'     => array( 'post', 'page' ), 
)
);

Eso es todo, ahora puede editar una publicación o página y hacer clic en el botón Agregar medios. Notará su código corto recién agregado en “Insertar elementos de publicación”.

Seleccione el elemento de publicación o el código corto para insertar

Al hacer clic en su código corto recién creado, aparecerá la interfaz de usuario del código corto, donde simplemente puede ingresar valores.

Interfaz de usuario de código corto con un campo de selección

Puede descargar el código utilizado en este tutorial como plugin.

wpb-shortcake-tutorial

Hemos incluido CSS, por lo que puede usarlo para estudiar o usarlo para agregar sus botones de llamada a la acción en WordPress utilizando una interfaz de usuario más simple. Siéntete libre de editar la fuente y jugar con ella.

Esperamos que este artículo le haya ayudado a aprender cómo agregar una interfaz de usuario de código corto en WordPress con Shortcake. También puede consultar estos 7 consejos esenciales para usar códigos cortos en WordPress.

¿Te ha resultado útil??

0 / 0

Deja una respuesta 0

Tu dirección de correo electrónico no será publicado. Required fields are marked *