Las funciones principales y más útiles de WordPress

Actualizado: 17 de noviembre del 2022
Por: Norfi Carrodeguas

Selección de funciones elementales y básicas que debemos conocer para modificar y personalizar nuestro blog, con ejemplos prácticos de su uso y sintaxis.

Las funciones principales y más útiles de WordPress

Comparto en este artículo con los aficionados, una selección de funciones de utilidad, para los que se animan a modificar su blog de WordPress.
Con ellas podemos escribir y agregar contenido en widgets, post personalizados, en plugins y directamente en el código PHP de las plantillas.
Existe una gran cantidad de funciones disponibles, las que se pueden consultar en Function Reference de WordPress, pero en esta entrada comparto solo las más esenciales y que nos pueden resultar de mucha utilidad en la práctica.
Es como un pequeño manual práctico para tener a mano y auxiliarnos al comenzar a modificar nuestro blog.

Funciones elementales y prácticas para modificar WordPress

Información de la página o el sitio

bloginfo(); – Escribe el nombre del blog o del sitio web.
bloginfo(‘url’); – Dirección URL del blog o sitio web. También se puede escribir con: echo home_url();
the_title(); – Escribe el título de la página actual.
the_permalink(); – Escribe la dirección URL de la página.
bloginfo(‘description’); – Muestra la descripción de la página.
the_content(); – Escribe todo el contenido.
the_excerpt(); – Escribe el “Excerpt” o resumen. De forma predeterminada posee 55 palabras, pero se puede modificar.
next_posts_link(); – Crea un enlace a la publicación anterior. Al usar WordPress un orden inverso, se refiere a la más antigua.
previous_posts_link(); – Crea un enlace a la publicación siguiente, si existe.
the_ID(); – Escribe el número de identidad que corresponde a la página actual.
wp_list_pages(); – Crea una lista de todas las páginas del sitio con sus enlaces, en formato de lista.

Funciones para fecha y hora

echo date(‘H:i’); – Muestra la hora GTM.
echo date_i18n(‘H:i’); – Muestra la hora local.
echo date_i18n(‘F jS, Y, H:i:s’); – Muestra la fecha y hora local.
echo current_time( ‘mysql’ ); – Escribe la fecha y hora actual local.
echo current_time( ‘mysql’, 1 ); – Escribe la fecha y hora actual GMT.
the_time(‘d-m-y’); – Escribe la fecha de publicación del post. En este caso se especifica: día, mes y año.
the_date( ‘c’ ); – Escribe la fecha con la hora de creación de este artículo.
echo get_the_modified_date( ‘c’ ); – Escribe la fecha y hora de la última modificación realizada a este artículo.
get_calendar(); – Inserta un calendario en la página del mes en curso, con enlaces que conducen a las publicaciones creadas cada día.
El estilo del calendario se puede modificar con CSS, usando las clases que este inserta.

Funciones para mostrar imágenes

the_post_thumbnail(); – Inserta la imagen destacada de la página.
the_post_thumbnail( ‘thumbnail’ ); – Inserta la imagen destacada, en un tamaño de 150 x 150 pixeles.
the_post_thumbnail( ‘large’ ); – Inserta la imagen destacada, en un tamaño de 1024 x 768 pixeles.
Otros tamaños se pueden especificar usando los valores ‘médium’ (ancho máximo de 300 px), ‘medium_large’ (máximo ancho de 768 px) y ‘full’ (2000 x 1200 px).

Funciones para el autor

the_author(); – Escribe el nombre del autor del artículo.
the_author_link(); – Crea enlace con el nombre del autor del artículo, que conduce a la página de autor.

Funciones para archivos

the_category(); – Muestra las Categorías asignadas a la publicación, con sus enlaces, en formato de lista.
the_category(‘, ‘); – Muestra las Categorías asignadas a la publicación, con sus enlaces, separadas por comas.
wp_list_categories(); – Muestra todas las categorías del blog con sus enlaces.
the_tags(); – Muestra todas las etiquetas o tags separadas por comas, asignadas en la página y con sus enlaces a las paginas correspondientes.

Otras funciones

timer_stop(1); – Escribe el tiempo de carga de la página en segundos.
echo get_num_queries(); – Escribe el número de consultas realizadas por la página a la base de datos.
echo wp_trim_words( get_the_content(), 20, ‘…’ ); – Recorta y escribe las primeras 20 palabras del contenido de la página.

Como probar los códigos y funciones en WordPress

WordPress está creado con PHP.
Por motivos de seguridad este código PHP no se puede agregar directamente en las entradas usando el editor.
Para probar cualquiera de las funciones, la opción ideal es crear una plantilla personalizada para post (Custom Post Type Templates).
Es algo sencillo.

Crear una plantilla de prueba en WordPress

Para crear una plantilla, solo para experimentar y probar código y funciones, haz lo siguiente:

1- Crea una copia del archivo “single.php” y cámbiale el nombre a “single-pruebas.php”.
2- Edítala y dentro de los créditos comentados en su parte superior, agrega lo siguiente:
* Template Name: Pruebas
3- Crea una nueva entrada en el Panel de administración y el menú desplegable bajo Plantillas, en la sección Atributos de entrada, selecciona “Pruebas”.
4- En la sección Publicar, en Visibilidad, márcala como “Privada”. De esa forma la entrada de prueba no la podrá ver nadie más.
5- Dale un título cualquiera y publica la entrada.

Es todo ahora puede cargar en el navegador la nueva entrada publicada, que lógicamente, no tendrá contenido.
Para probar los códigos abre en el editor la nueva plantilla “single-pruebas.php” y agrégalos antes de la etiqueta del cierre del Loop (antes de la instrucción “endwhile”).
Para tener mejor visibilidad y menos código, se pueden eliminar ciertos elementos como la barra lateral (get_sidebar()) y la barra inferior de navegación (the_post_navigation()).

Reglas para escribir en PHP

Antes de probar las funciones se debe tener en cuenta lo siguiente:
– Todas las instrucciones en PHP deben terminar con punto y coma(;).
– Algunas funciones necesitan ir antecedidas de la instrucción echo.
– Para crear un salto de línea se debe emplear:
– Para interrumpir momentáneamente el código PHP y poder agregar texto o HTML, se debe emplear las siguientes instrucciones:

?>
TEXTO o HTML
<?php

– En algunos casos para evitar errores en caso de que no existan los recursos que especificamos, se debe emplear una condicional
Por ejemplo la siguiente condicional devuelve un mensaje de texto si la página actual no posee una imagen destacada, si la posee la escribe.

if ( has_post_thumbnail() ) {
    the_post_thumbnail();
}else{
echo 'El post no posee imagen';}

Como insertar las funciones de WordPress en las publicaciones

Las funciones anteriores en la práctica se pueden agregar a las publicaciones, sin afectar el código fuente, de diversas formas.

– Usando shortcodes.
– En Widgets que lo permiten como el de texto.
– Creando un plugin personal y haciendo referencia al lugar donde se deben insertar ya sea en todas las publicaciones o solo en alguna de ellas especificando su ID.

Ejemplo, agregar fecha de creación y de modificación

Para mostrar la fecha de creación y de la última modificación de las entradas, se puede agregar las siguientes instrucciones en la plantilla “single.php”, en el lugar exacto que se deseen mostrar:

Fecha de creacion: <?php the_time('d-m-y'); ?><br/>
Fecha de actualizacion: <?php echo get_the_modified_date('d-m-y'); ?><br/><br/>

En este caso el resultado se muestra en el formato: día, mes y año
Para mostrar todos los datos de la fecha, incluyendo hora, minutos y segundos sustituye: ‘d-m-y’ por ‘c’.

¡Ojo!
Al copiar el código en esta página y pegarlo en el código fuente, es necesario comprobar que usamos comillas rectas (‘) y no las tipográficas (’).
El portapapeles de Windows las transforma, jugándonos una mala pasada.

Otras páginas relacionadas

✓ Como modificar y personalizar mi tema de WordPress
✓ Como usar y configurar WordPress sin plugins
✓ Convertir los enlaces externos en NoFollow en WordPress

Comparte

Facebook

Twitter