Creando tu primer archivo PHP para WordPress
Spanish (Español) translation by Ana Paulina Figueroa (you can also view the original English article)
En este tutorial y screencast, te mostraré cómo crear un archivo PHP dentro de un tema de WordPress. También te enseñaré cómo agregar un poco de código PHP al archivo.

Este video ha sido tomado de mi curso "Aprende PHP para WordPress". Puedes ver el curso completo de forma gratuita aquí en Envato Tuts+.
Los archivos del tema de WordPress
Comenzaré localizando el tema de WordPress junto con todos los archivos de plantilla que lo componen. Después crearé un nuevo archivo de plantilla de página. El propósito de esto es proporcionar una manera alternativa para mostrar algunas de las páginas de un sitio.



El tipo de archivo que se está creando o lo que hace no son aspectos extremadamente importantes. Lo importante es cómo crear un archivo PHP y agregarle código relevante.
Crea un archivo nuevo
Comienza creando un archivo nuevo.



La manera de hacerlo puede ser diferente dependiendo del editor de código que estés usando. Yo estoy usando Coda para Mac.
Una vez que se haya creado el archivo, debes asignarle un nombre. Por ejemplo, demo-page.php.
Coda le asigna una pequeña bandera para denotar el hecho de que se trata de un archivo PHP.
Pero eso por sí solo no significa que funcionará como un archivo PHP, necesita algo de código. Esto significa que necesita una etiqueta PHP de apertura: <?php
. No es necesario agregar una etiqueta PHP de cierre, ya que WordPress no lo requiere.
Agrega código al archivo
Ahora podemos agregar un poco de código al archivo.



Este es un archivo de plantilla de página. Esto significa que requiere texto comentado en la parte superior para indicarle a WordPress qué es y cómo se llama.
Lo primero que debes incluir es una etiqueta de plantilla dentro de WordPress para obtener el contenido del archivo header.php. Eso se hace escribiendo get_header
.
Cada vez que uses una función en PHP, siempre debes incluir las llaves (paréntesis) después del nombre de la función. Esto se termina con un punto y coma.
Las llaves indican que es una función y también son el lugar en el que se incluirán los parámetros necesarios.
En este ejemplo no se requiere ningún parámetro.
Agrega un bucle



A continuación agrega un bucle. Nuevamente vamos a usar una etiqueta de plantilla.
if (have_posts() ) : while( have_posts() ) : the_post();
La etiqueta de plantilla have_posts
nos permite saber si hay entradas para procesar en el bucle. Nuestro bucle dice que, si hay entradas para comenzar, se debe ejecutar la función the_post()
mientras todavía haya entradas.
Para mostrar el contenido en la página se requieren más etiquetas de plantilla y un poco de HTML. Te enseñaré cómo hacer eso en otro tutorial.
Terminamos nuestro bucle usando endwhile
y endif
.
Otra forma de escribir este bucle es agregando sangrías a las instrucciones if
y while
en sus propias líneas con llaves {
. A menudo este estilo es más fácil de leer, especialmente si tienes que escribir más código dentro del bucle.
1 |
if( have_posts() ) { |
2 |
while( have_posts() ) { |
3 |
the_post(); |
4 |
}
|
5 |
}
|
Hay muchas otras cosas que podrías agregar a este bucle. Si hay entradas, quizá quieras desplegar un encabezado, por ejemplo, o una barra de búsqueda. También puedes usar una instrucción else
para trabajar con el caso en el que no existen entradas.
Agregando comentarios



En PHP, los comentarios de varias líneas tienen la barra diagonal y luego los asteriscos. Puedes usar solo un asterisco o tantos como desees.
Es útil hacer esto en donde haya un nuevo bloque de código.
Asegúrate de que las barras diagonales se encuentren al principio y al final: /*
y */
. Por ejemplo, en el archivo de funciones, cada función tiene una sección grande de texto comentado y, con la cantidad de asteriscos que se usaron, es muy visible.
También podemos agregar comentarios PHP de una sola línea comenzando el comentario con //
.



Así que he agregado una instrucción else
al bucle para trabajar con el caso en el que no existen entradas. Luego he usado //
para agregar un comentario como marcador de posición. Aquí estoy usando el comentario solo como un recordatorio, para mí y para cualquiera que lea el código, de lo que se supone que debe pasar en la instrucción else
.
Experimentación



Para experimentar con un par más de etiquetas de plantilla, agrega get_sidebar
y get_footer
al final del archivo.
Dentro de un archivo de plantilla de tema, esos comentarios recuperan los archivos sidebar.php y footer.php. Una razón para hacer esto, en vez de simplemente agregar el código de una barra lateral directamente en tu plantilla, es garantizar que esas piezas de código solamente deban escribirse una vez en el tema. De esa manera, si cambias tu barra lateral, por ejemplo, ¡no tienes que regresar y actualizar cada uno de los archivos en tu tema!
Con eso tienes un archivo PHP básico dentro del tema. Los elementos principales que se requieren son las etiquetas PHP de apertura, y luego las etiquetas de plantilla PHP y las funciones. Pueden haber instrucciones condicionales también. Como puedes ver, el código tiene sangrías para facilitar su lectura.
Si estás siguiendo el curso, en la siguiente lección te enseñaré cómo agregar un poco de HTML a tu archivo de PHP.
Los mejores temas y complementos de WordPress en Envato Market
Explora miles de los mejores temas de WordPress alguna vez creados en ThemeForest y los complementos de WordPress más destacados en CodeCanyon. Compra estos temas y complementos de alta calidad de WordPress y mejora la experiencia en tu sitio web para ti y tus visitantes.



Estos son algunos de los temas y complementos de WordPress mejor vendidos y más prometedores disponibles para 2020.
- Inspiración15+ de los mejores temas de portafolios para creativos de WordPressBrenda Barron
- WordPressLos 17 mejores complementos de WordPress para sliders y carruseles de 2020Daniel Strongin
- WordPressLos 20 mejores complementos y widgets de calendarios de WordPressDaniel Strongin
- Temas de WordPressLos 23+ mejores temas responsivos de WordPress (para sitios en 2020)Brenda Barron
- WordPress24 de las mejores extensiones y complementos de WPBakery Page Builder (compositor visual) de 2020Daniel Strongin
- Temas de WordPressLos 20+ mejores temas de WordPress para asesoramiento y consultoría (2020)Brenda Barron