WordPress y PHP

La estructura de los archivos y carpetas WordPress

Es importante saber cómo se organizan los archivos en WordPress. La estructura es siempre la misma, tanto para un sitio web pequeño o para uno de mayor tamaño: el núcleo o corazón de WordPress no cambia.

1. Los archivos y carpetas en la raíz del sitio web

Todos los sitios de WordPress tienen la misma estructura. En la raíz, encontrará las carpetas wp-admin, wp-content, wp-includes y los archivos de WordPress.

Archivos y carpetas en la raíz del sitio web WordPress

No debe modificar o eliminar ningún archivo o carpeta nativo de WordPress. En el caso de aquellos que forman parte del core, es posible que el sitio web deje de funcionar. Además, la actualización de WordPress sobrescribe todos los cambios.

La carpeta wp-admin contiene todos los archivos relacionados con la administración del sitio web. No debe modificar archivos de esta carpeta.

La carpeta wp-content contiene todos los archivos por temas, extensiones y medios, idiomas, etc. En esta carpeta es donde se realizan las principales modificaciones y personalizaciones del sitio web.

La carpeta wp-includes contiene todos los archivos principales de WordPress (clases, funciones, scripts, etc.). No debe editar archivos de esta carpeta.

El archivo wp-config.php es un archivo generado durante la instalación de WordPress, a partir del archivo wp-config-sample.php. La información...

La base de datos WordPress

WordPress instala doce tablas en la base de datos. Para ver esto, conéctese a su base de datos mediante phpMyAdmin. Aquí es donde se almacena toda la información sobre su sitio (contenido de artículos, páginas, categorías, etiquetas, configuración de WordPress, complementos, temas, información sobre los usuarios, etc.).

En este libro, los ejemplos se ilustran con el prefijo msw_ (por defecto, WordPress usa el prefijo wp_). Normalmente, el prefijo se elige durante la instalación, por lo que podría ser diferente si lo cambia por razones de seguridad. Recuerde cambiar el prefijo cuando utilice los ejemplos.

Tablas en la base de datos durante la instalación de WordPress, en phpMyAdmin

Hay otras tablas que aparecen según los temas, extensiones y el uso del modo multisitio.

Aquí están las tablas nativas de WordPress, con el prefijo base wp:

La estructura y los archivos principales de un tema

Al instalar WordPress, hay tres temas presentes en el directorio wp-content/themes: Twenty Twenty-One, Twenty Twenty-Two, Twenty Twenty-Three, que son temas predeterminados desarrollados por WordPress.

Todos los temas tienen una estructura común que consta de archivos y carpetas principales, que están presentes en la mayoría de los temas. Se denominan archivos de plantilla o plantillas de página.

Archivos que componen los tres temas predeterminados de WordPress: Twenty Twenty-One, Twenty Twenty-Two, Twenty Twenty-Three

/* 
Theme Name: Twenty Twenty-One 
Theme URI: https://wordpress.org/themes/twentytwentyone/ 
Author: the WordPress team 
Author URI: https://wordpress.org/ 
Description: Twenty Twenty-One is a blank canvas for your ideas 
and it makes the block editor your best brush. With new block 
patterns, which allow you to create a beautiful layout in a matter  
of seconds, this theme’s soft colors and eye-catching — yet 
timeless — design will let your work shine. Take it for a spin! 
See how Twenty Twenty-One elevates your...

Las funciones de inclusión

En los temas clásicos, WordPress utiliza sus propias funciones PHP de inclusión:

Ejemplos

<?php get_searchform(); ?> 

La función get_searchform() llama al archivo searchform.php y muestra el formulario de búsqueda.

<?php get_template_part( 'template-parts/page/content', 'page' ); ?> 

La función get_template_part() del archivo page.php llama al archivo template-parts/page/content-page.php.

Según los temas y uso de los formatos, en algunos temas, como por ejemplo Twenty Seventeen, en el archivo single.php puede ver la siguiente función:

<?php get_template_part( 'template-parts/post/content', 
get_post_format() );?> 

La función get-template_part() llama al archivo content-nombredelformato.php si los formatos se utilizan durante la edición de los artículos en el bloque Formato.

La función get_post_format() permite recuperar el nombre del formato.

Si Audio está seleccionado en el bloque...

Los marcadores condicionales

Los marcadores condicionales, como en cualquier lenguaje de programación, le permiten realizar acciones en casos especiales.

Las condiciones en WordPress son las mismas que en PHP: if, elseif, else, endif.

Están redactadas de dos formas, siendo la segunda la más frecuente en WordPress:

if(mi_condicion){ 
}elseif(mi_condicion){ 
}else{ 
} 

o:

if(mi_condicion): 
elseif(mi_condicion): 
else: 
endif; 

Hay funciones condicionales específicas de WordPress que devuelven true o false. Están directamente relacionadas con el tipo de archivo PHP (plantilla de página), que se mostrará en el navegador.

Por ejemplo, is_home() comprueba que está en la página de inicio del blog (lista de todas las publicaciones), que coincide con el archivo de visualización index.php o archive.php.

A continuación se muestran algunas funciones:

El bucle y sus funciones

El bucle de WordPress es un bucle while() propio de PHP.

Permite recuperar el contenido de las páginas y artículos, gracias a las funciones WordPress have_posts() y the_post().

Está presente en casi todos los archivos del tema y su particularidad es mostrar el contenido según el archivo PHP (plantilla de página) donde se encuentra, teniendo en cuenta las diferentes condiciones y funciones que integra.

<?php 
while(have_posts()): the_post(); 
    // mis funciones para mostrar contenido 
end while; 
?> 

Dentro del bucle, inserte las funciones de visualización primarias específicas de WordPress para mostrar contenido o use las funciones principales de recuperación de variables, para crear sus propias funciones. Dentro de un bucle, no es raro ver también una función de inclusión que llama a otro archivo.

En los temas basados en bloques, el bloque Bucle de consulta es un bloque avanzado que permite mostrar una lista de publicaciones a partir de parámetros específicos. Esto funciona como un bucle PHP, pero no es necesario escribir código.

<?php the_ID(); ?> 

<?php the_title($before,$after,$echo); ?> 

Las funciones para los textos en los archivos PHP

Es posible insertar texto sin formato en archivos PHP (pero no es muy recomendable). Desafortunadamente no se tienen en cuenta los caracteres especiales y acentuados. Tiene que usar códigos ASCII o convertirlos a UTF-8, gracias a una función clásica de PHP o usar funciones de WordPress.

La ventaja de utilizar las funciones de WordPress es que han sido especialmente diseñadas para gestionar el multidioma, gracias a un archivo de traducción.

Hay dos funciones de WordPress recurrentes en la mayoría de los temas: __() y _e().

<?php _e( $text, $domain ); ?> 
<?php __( $text, $domain ); ?> 

<?php _e('Nothing Found', 'twentytwenty'); ?> 

Este código muestra el texto "Nothing Found" en la pantalla, pero el texto aparece en español: "Nada encontrado".

WordPress busca el archivo twentytwenty.po ubicado en la carpeta wp-content/language/themes/twenty-es_ES.po, para temas nativos de WordPress; en este ejemplo, el tema en cuestión es Twenty Twenty.

Para temas personalizados, el archivo de idioma se puede ubicar en la carpeta citada anteriormente, pero...

Las rutas en las URL

Varias funciones específicas de WordPress le permiten mostrar las rutas de las diferentes carpetas.

Aquí están las diferentes funciones:

También encuentra las funciones:

La función bloginfo()

La función bloginfo() permite recuperar diversa información sobre el blog. La función get_bloginfo() devuelve una variable, mientras que bloginfo() muestra el resultado.

La función solicita un argumento obligatorio: $param, para devolver un resultado:

<?php bloginfo($param); ?> 

o:

<?php 
$bloginfo=get_bloginfo($param); 
echo $bloginfo 
?> 

Aquí está el detalle de los diferentes argumentos de la función:

La función wp_nav_menu()

WordPress gestiona los menús de forma muy sencilla y le permite crearlos a voluntad a través del panel de administración en Apariencia - Menús. Consulte el capítulo Introducción a WordPress, sección Apariencia.

La función wp_nav_menu() le permite mostrar cualquier menú creado en la administración Apariencia - Menús, en archivos de WordPress. Por tanto, el menú principal del blog utiliza esta función. Normalmente se encuentra en el archivo header.php, pero puede variar según el tema.

En la mayoría de los casos, si no se crea un menú personal como menú principal, WordPress muestra automáticamente las páginas en orden alfabético.

  <?php wp_nav_menu($defaults);?> 

La función puede recibir uno o más argumentos opcionales, clasificados dentro de una tabla.

Aquí está el detalle de la función predeterminada:

<?php 
 
$defaults = array( 
 'menu' => '', 
 'menu_class' => 'menu', 
 'menu_id' => '', 
 'container' => 'div', 
 'container_class' => '', 
 'container_id' => '', 
 'fallback_cb' => 'wp_page_menu', 
 'before' => '', 
 'after' => '', 
 'link_before' => '', 
 'link_after' => '', 
 'echo' => true, 
 'depth' => 0, 
 'walker' => '', 
 'theme_location' => '' 
 'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>', 
 'item_spacing' =>'preserve', 
); 
wp_nav_menu( $defaults ); 
 
?> 

Observe que un menú se compone de la estructura siguiente HTML:

<nav> 
 
<ul> 
   <li><a href='http://mienlace.com'>nombre de mi enlace</a></li> 
   <li><a href='http://mienlace2.com'>nombre de mi enlace2</a></li> 
</ul> ...

Hooks (filtros y acciones)

Los hooks le permiten personalizar su sitio de WordPress. Hay dos tipos de hooks en WordPress: acciones y filtros.

Los hooks son esenciales al crear funciones en un tema a través del archivo functions.php (a veces archivo de una carpeta adicional) o al crear extensiones.

Fueron creados para no modificar los archivos fuente o extensiones de WordPress, que serían sobrescritos durante una actualización. Los hooks enganchan funciones personalizadas al núcleo de WordPress.

Referencia al códex para obtener más información sobre los hooks: https://developer.wordpress.org/reference/hooks/

<?php add_action($hook, $function_name, $priority, 
$accepted_args); ?> 

<?php 
   mi_funcion_change_hook(){ 
     // mi acción 
   } 
   add_action('hook_accion_existente','mi_funcion_change_hook'); 
?> 

<?php do_action( $hook, $arg ); ?> 
 
<?php do_action( $hook, $arg1, $arg2, ... ); ?>...

Globales

Las globales se usan en todas partes en WordPress, es como en PHP. Casi todos los datos en WordPress pueden ser recuperados por globales. Es mejor no modificar las globales directamente, sino utilizar funciones específicas de WordPress.

Para recuperar las globales, declárelas, como en PHP, de la siguiente manera:

<?php global $mi_variable; ?> 

<?php global $ post; ?> 

Las clases de WordPress

WordPress está integrado en la programación orientada a objetos (POO), por lo que utiliza muchas clases.

Estas clases generalmente pertenecen a las API de WordPress. Las API son un conjunto de clases, métodos y funciones que facilitan la codificación.

Ejemplo: API de widgets, API de shortcodes, API en la base de datos, etc.

Las clases le permiten estructurar WordPress. Muchas funciones instancian directamente una clase, y permiten que ciertos métodos se utilicen a través de otras funciones. Además, algunas globales le permiten instanciar directamente una clase.

Por lo tanto, es normal recuperar información de varias formas, ya sea mediante funciones de WordPress, globales o usando objetos directamente.

Los objetos se utilizan como en PHP, por instancia de clase:

<?php $Nombre_del_objeto = new Nombre_de_la_clase; ?> 

Detallemos algunas:

Clase WP_Query y consultas del contenido

La clase WP_Query permite realizar consultas a la base de datos en la tabla wp_posts, y recuperar cualquier contenido relacionado con los artículos y páginas creados en la administración, pestañas Páginas y Entradas, gracias al método the_post().

<?php $ the_query = new WP_Query($ args); ?> 

WP_Query con el método the_post(), devuelve una tabla con el contenido de los artículos y páginas, lo que permite hacer un bucle y recuperar este contenido usando funciones de visualización(ej.: the_title() para el título).

<?php 
$the_query = new WP_Query($args); 
 
if($the_query->have_posts()){ 
   while($the_query->have_posts()){ 
     $the_query->the_post(); 
       //funciones ej.: the_title(); 
   } 
} 
?> 

Muchas de las funciones vistas anteriormente usan la clase WP_Query. El bucle principal de WordPress utiliza el método the_post(), así como funciones que solicitan información sobre el contenido de un artículo o página, pero también marcadores condicionales. El conjunto representa una parte de la API WP_Query.

El bucle con la clase WP_Query y el método the_post(), funciona exactamente como el bucle de WordPress; por tanto, el bucle acepta las mismas funciones de visualización. Este bucle se puede utilizar como bucle secundario del bucle principal.

Es importante tener en cuenta que demasiadas consultas a la base de datos pueden ralentizar el sitio web, según la complejidad de las consultas y la cantidad de artículos o páginas del sitio web.

La clase wpdb y las consultas en formato SQL

Los métodos de la clase wpdb no se utilizan directamente, sino a través de la global $wpdb y permiten la comunicación con la base de datos, mediante consultas SQL.

<?php global $wpdb; ?> 

$wpdb no se limita a las tablas predefinidas por WordPress, sino que se comunica con cualquier tabla en la base de datos. Esto es útil para crear sus propias tablas.

<?php 
$prefijo = $wpdb-> prefix; 
// echo $prefijo devuelve el nombre de su prefijo 
?> 

<?php 
   $string= "Soy una variable de texto"; 
 
$wpdb->query($wpdb->prepare( 
 " 
 INSERT INTO $wpdb->mitabla 
( id, content ) 
 VALUES(%d,%s ) 
 ", 
 10, 
 $string 
   )); ...

La clase WP_rewrite y la reescritura de la URL

Los métodos de la clase WP_rewrite no se utilizan directamente, sino a través de la global $wp_rewrite. Esto permite agregar reglas de escritura, gracias a métodos y funciones específicos.

<?php global $ wp_rewrite; ?> 

Se verá obligado a utilizar este objeto si está utilizando enlaces permanentes (distintos de los predeterminados) para la reescritura de URL (URL rewriting), y desea pasar variables en sus URL, o si está utilizando una estructura de artículos o una taxonomía personalizada, o incluso un bucle personalizado que requiere paginación.

Si está acostumbrado a usar el archivo .htaccess para pasar sus reglas de reescritura de URL, aquí será mejor usar los diferentes métodos que ofrece el objeto WP_rewrite.

WordPress utiliza este sistema para evitar conflictos con diferentes complementos o temas, y la reescritura sistemática del archivo .htaccess. Para evitar conflictos, las reglas de escritura se guardan en la base de datos, en la tabla de opciones.

Localmente, recuerde activar el módulo rewrite_module de Apache.

Los shortcodes

El shortcode es un código simplificado entre corchetes, propio de WordPress, de la forma:

[mishortcode] 

Permite mostrar el resultado de una función realizada en PHP. Se utiliza en páginas, artículos, etc.

A veces se inserta automáticamente en sus páginas o en sus artículos. Este es el caso cuando crea una galería, por ejemplo. El shortcode se inserta en su editor WYSIWYG y en la página ve su galería de fotos.

Ejemplo

[gallery] 

El shortcode muestra la galería de fotos.

El shortcode también puede aceptar argumentos o recuperar contenido.

Ejemplo

[ gallery columns='2' size='large'] 

La galería está entonces en dos columnas de gran tamaño.

[tag] mi contenido [/tag] 

Es posible recuperar el contenido entre dos shortcodes.

Algunas extensiones requieren el uso de estos argumentos para funcionar, esto generalmente se indica en la documentación de la extensión respectiva.

El shortcode es muy útil para aquellos que son nuevos en la programación. Proporcionar códigos cortos al crear extensiones, puede simplificar muchas tareas.

Aquí está la lista de códigos cortos predeterminados de WordPress: