WordPress introdujo la API de código corto hace seis años con el lanzamiento de WordPress 2.5. Los códigos cortos ahora son utilizados por un gran número de complementos de WordPress para permitir a los usuarios agregar contenido a sus publicaciones y páginas.
La API de código corto le permite crear sus propios códigos cortos agregando funciones a las funciones de su tema.plantilla php (se encuentra en www.yourwebsite.com/wp-content/themes/yourtheme/).
Además de crear tus propios códigos cortos, WordPress también incluye cinco códigos cortos predeterminados con el núcleo de WordPress:
- audio – Permite incrustar archivos de audio.
- leyenda: Le permite ajustar los subtítulos al contenido. Se usa comúnmente con imágenes.
- incrustar: le permite incrustar una amplia gama de contenido, como video, audio y tweets.
- galería-Le permite insertar galerías de imágenes.
- video: Le permite incrustar archivos de video.
Aunque los códigos cortos predeterminados de WordPress se usan comúnmente, muy pocos usuarios de WordPress aprovechan la API de código corto y diseñan códigos cortos únicos para su sitio web. En este tutorial, me gustaría mostrarle lo sencillo que es mejorar su sitio web con códigos cortos personalizados.
Antes de comenzar, asegúrese de hacer una copia de seguridad de las funciones.php y cualquier otro archivo que edite antes de realizar cambios con su sitio web en vivo.
Crear un código corto-Un ejemplo básico
Para darte una buena comprensión de cómo funciona la API de código corto de WordPress, comencemos con una función de código corto básica.
Recuerde que los códigos cortos deben crearse para el contenido y la funcionalidad que usa con frecuencia. El objetivo de usar códigos cortos es ahorrar tiempo a alguien. Si solo vas a usar algo una vez, no tiene mucho sentido crear un código corto para ello.
escribo alrededor de una docena de artículos por semana. Una cosa que hago con frecuencia es animar a aquellos que disfrutaron de mis artículos a suscribirse a mi blog (o al blog para el que estoy escribiendo). Actualmente escribo esto cada vez, sin embargo, podría ahorrarme mucho tiempo creando un código corto para el texto.
Para hacer esto, podría agregar una función como esta a las funciones de mi tema.plantilla php:
Aquellos de ustedes que no tienen experiencia en codificación pueden encontrar el código anterior un poco desalentador, sin embargo, es fácil de entender una vez que desglosan el código línea por línea.
Lo primero que hacemos es añadir un comentario encima de nuestra función. Esto nos ayudará a ver rápidamente para qué sirve nuestra función cuando veamos el código en una fecha posterior.
// Function to add subscribe text to posts and pages
Luego definimos nuestra función. Me gusta usar nombres que se explican por sí mismos, por lo que he llamado a mi función «subscribe_link_shortcode».
function subscribe_link_shortcode() {
a continuación, definimos nuestro mensaje. La instrucción return mostrará nuestro mensaje cuando se llame. También almacena los mensajes (a diferencia de echo, que lo imprimirá pero no lo almacenará).
La función se cierra.
}
Luego definimos el código corto en sí usando la función add_shortcode. La primera variable especificada define el código corto que se utilizará y la segunda variable llama a nuestra función (es decir, la que definimos anteriormente).
add_shortcode('subscribe', 'subscribe_link_shortcode');
Después de guardar las funciones.plantilla php, ahora podemos llamar a nuestro mensaje cuando queramos usando el código corto subscribe.
El uso del código de suscripción en una publicación o página producirá el siguiente mensaje:
Si te ha gustado este artículo, te animo a que te suscribas al blog de Elegant Themes a través de RSS.
Utilicé un mensaje simple en mi ejemplo, sin embargo, podría modificarlo para mostrar muchas otras cosas. Por ejemplo, podría crear un código corto para mostrar anuncios de adsense o un formulario de suscripción para su boletín informativo; y luego insertarlos en cualquier lugar que desee en sus artículos.
Crear un código corto Con atributos
Los atributos pueden ampliar la funcionalidad de los códigos cortos al permitirle pasar datos a través de sus códigos cortos.
En el siguiente ejemplo, le mostraré cómo se pueden usar los atributos para expandir la función que creamos anteriormente. Como puede ver, gran parte del código sigue siendo el mismo.
at atts es el nombre de nuestra matriz de atributos. Luego usamos la función extract para importar variables de nuestro array (a través de la función WordPress shortcode_atts).
Se definen dos atributos: subtipo y subtipo. Representan el tipo de suscripción y la URL de suscripción. Estos atributos son entonces llamados en nuestro mensaje.
Nuestro tipo de suscripción predeterminado es RSS y nuestra URL de suscripción predeterminada es http://feeds.feedburner.com/ElegantThemes. Esta información se mostrará cuando no se hayan definido atributos.
Por lo tanto, cuando agregue lo siguiente a una publicación:
Obtendremos la siguiente salida:
Asegúrese de suscribirse a futuras actualizaciones de Temas elegantes por RSS.
Si definimos los atributos, el resultado es diferente. El siguiente código:
Produciría:
Asegúrese de suscribirse a futuras actualizaciones de Temas elegantes por RSS.Asegúrate de suscribirte a futuras actualizaciones de Temas Elegantes de Twitter.Asegúrate de suscribirte a futuras actualizaciones de Temas Elegantes de Facebook.Asegúrese de suscribirse a futuras actualizaciones de Temas Elegantes de Google.
Aunque este fue un ejemplo básico de cómo funcionan los atributos, es fácil ver cómo los desarrolladores de complementos pueden usar la API de código corto para hacer que las funciones complicadas sean más fáciles de usar para los usuarios.
Descripción general
Si sigue los pasos indicados en este tutorial, ahora debería tener una comprensión básica de cómo puede crear sus propios códigos cortos personalizados para su sitio web. Los códigos cortos son una excelente manera de simplificar las tareas complicadas, por lo que te animo a tener en cuenta la API de código corto de WordPress en el futuro.
No te preocupes si este tutorial fue un poco difícil para ti. Todos los diseños de temas elegantes vienen con códigos cortos que facilitan la publicación de contenido hermoso. Los códigos cortos se pueden usar para crear presentaciones de diapositivas, columnas y tablas. Incluso te permite proteger tu contenido con contraseña.
Espero que hayas disfrutado de este tutorial sobre cómo crear un código corto único para tu sitio web de WordPress. Si es así, te animo a suscribirte a Temas Elegantes, ya que tenemos un gran contenido en proceso 🙂
También, una vez más, te recuerdo que hagas una copia de seguridad de cualquier archivo antes de editarlo.