Cómo crear un código corto en WordPress

¿Alguna vez ha necesitado ejecutar o mostrar el resultado de su código PHP personalizado en las publicaciones o páginas de su sitio web de WordPress? Dado que, de manera predeterminada, WordPress no le permite ejecutar PHP en publicaciones o páginas por precauciones de seguridad, es posible que haya considerado usar un complemento para permitir el uso de código PHP en sus publicaciones o páginas. En realidad, puede ejecutar el código sin instalar ningún complemento adicional, simplemente creando un código abreviado puede agregar el código en un archivo PHP separado o puede colocar el código en su tema functions.php y luego usar el código abreviado que ha creado para ¡muestre el resultado en las publicaciones o páginas de su sitio web!

¿Qué es el código corto?

Introducido con el lanzamiento de la API de código abreviado de WordPress 2.5, el código abreviado le permite agregar características con un esfuerzo mínimo que normalmente requeriría mucho código complicado en una sola línea entre corchetes, como [thisone] . Muchos complementos de WordPress solían ofrecer códigos cortos para simplificar drásticamente el proceso de mostrar el resultado de una función compleja. Por ejemplo, un complemento de comercio electrónico popular como WooCommerce también tiene varios códigos abreviados prefabricados que pueden ser muy útiles para cualquier propietario de una tienda que use esta plataforma.

Sin embargo, desde que el editor de bloques (Gutenberg) reemplazó al editor clásico, muchos complementos han comenzado a ofrecer bloques, ya que es más fácil y tiene un diseño visual agradable. Pero, si tiene conocimientos de codificación o tiene algún código para agregar funciones adicionales a su sitio, ¡usar códigos abreviados sigue siendo una de las mejores opciones que puede probar! Y puede leer nuestro artículo anterior sobre agregar un tiempo de lectura estimado a las publicaciones de su blog usando un código abreviado en Gutenberg, Elementor y Divi.

En este tutorial, le mostraremos cómo crear un código abreviado en WordPress

Cómo crear un código corto

Antes de crear un shortcode, sugerimos hacer una copia de seguridad de su sitio y usar un tema secundario para evitar romper el tema principal o perder sus cambios cuando actualice su tema, ya que agregaremos el código al archivo functions.php del tema. Para abrir el archivo, vaya a Apariencia → Editor de archivos de temas desde su panel de administración de WordPress. En la página que aparece, haga clic en Funciones de tema ( functions.php ) de la lista de archivos de tema para abrir el editor de archivos.

Alternativamente, puede crear un archivo PHP separado en la carpeta de su tema (ubicado en wp-content → themes → “Su tema” en la mayoría de los casos) con myshortcodes.php como nombre.

Una vez que haya creado el archivo, puede agregar tantos códigos y códigos abreviados como desee entre el delimitador de PHP ( <?php ?> ) en ese archivo. Luego, solo necesita agregar una línea de código en la parte inferior de su archivo functions.php de tema para decirle al sistema que incluya cualquier cambio que realice en su archivo de código abreviado. Y el código es el siguiente:

 include('miscodigoscortos.php');

Paso 1: preparar el código

Una vez que esté listo, prepare el código que desea convertir en un código abreviado. El código debe tener una función y regresar sin efectos secundarios ya que un shortcode es esencialmente un filtro. Para este tutorial, usamos un código PHP para obtener el recuento de palabras y calcular el tiempo de lectura estimado dividiendo el recuento de palabras por 260, que es el número promedio de palabras que un adulto lee en silencio por minuto. Luego devuelva el tiempo estimado y el recuento de palabras en una frase como sigue:

• “1 minuto de lectura (recuento de palabras 121)”

Coloque el siguiente código en la parte inferior de su tema functions.php

 function lectura_tiempo() {
$contenido = get_post_field( 'post_content', $post->ID );
$recuento_de_palabras = str_recuento_de_palabras( strip_tags( $contenido ) );
$tiempodelectura = ceil($word_count / 260);
$wcounttext = " (recuento de palabras ". $recuento_de_palabras .")";
si ($tiempo de lectura == 1) {
$temporizador = "minuto de lectura";
} más {
$temporizador = "minutos leídos";
}
$tiempototaldelectura = $tiempodelectura . $temporizador. $wcounttexto;
devuelve $tiempototaldelectura;
}

Paso 2: crea un código abreviado básico

El siguiente paso es crear un shortcode básico para el código que ha preparado. Para crear un shortcode, es posible que deba seguir la siguiente guía para evitar un error:

• Use la add_shortcode( string $tag, callable $callback ) para agregar un código abreviado, mientras que $tag es el nombre de su código abreviado para buscarlo en el contenido de la publicación y $callback es para llamar al código que ha preparado
• Los nombres de los códigos abreviados deben estar en minúsculas (se aceptan números y guiones bajos)
• Evite usar un guión (-)
• Agregue un prefijo para que el nombre de su código abreviado sea único para evitar la colisión con otro código abreviado de complemento.

Una vez que esté listo, cree un código abreviado para su código usando la función add_shortcode y agregue el nombre de su código abreviado y una devolución de llamada para su código al parámetro de la función como en el siguiente ejemplo:

 add_shortcode('wpbread', 'reading_time');

El shortcode anterior es para el código de tiempo de lectura estimado del paso 1. Usamos 'wpbread' para el nombre del shortcode y la devolución de llamada 'reading_time' que es el nombre de nuestra función de código después. Continúe agregando el código anterior justo debajo del código que preparó en el paso 1 en el archivo functions.php o en su archivo PHP personalizado y luego guarde los cambios que le hizo.

Paso 3: usar el código abreviado

Una vez que el código abreviado esté listo, en nuestro caso, el código abreviado es [wpbread], ahora intentemos llamarlo en una de sus publicaciones agregando el código abreviado justo encima del contenido o en cualquier lugar que elija para mostrarlo dentro de su editor de contenido.

Ahora, echemos un vistazo al resultado inicial, ya sea mediante una vista previa o publicando la publicación.

Como puede ver en la captura de pantalla anterior, justo encima de nuestro contenido hay un tiempo de lectura estimado que dice " 11 minutos de lectura (recuento de palabras 2775) " para el artículo que escribimos.

La línea de fondo

De forma predeterminada, WordPress no le permite ejecutar PHP en publicaciones o páginas por razones de seguridad. Sin embargo, con solo crear un código abreviado, puede agregar el código en un archivo PHP separado o colocar el código en el archivo functions.php de su tema y luego usar el código abreviado que ha creado para mostrar el resultado en las publicaciones o páginas de su sitio web sin instalarlo. cualquier complemento adicional. Un código abreviado le permite agregar funciones con un esfuerzo mínimo que normalmente requeriría mucho código complicado en una sola línea.

Desde que el editor de bloques (Gutenberg) reemplazó al editor clásico como una forma de publicar contenido en WordPress, muchos complementos han comenzado a ofrecer bloques, ya que es más fácil y tiene un diseño visual agradable. Sin embargo, si tiene conocimientos de codificación o tiene algún código para agregar funciones adicionales a su sitio, ¡usar códigos abreviados sigue siendo una de las mejores opciones que puede probar!