Creando tu primer archivo PHP para WordPress

Spanish (Español) translation by Ana Paulina Figueroa Vazquez (you can also view the original English article)

En este tutorial y screencast, te mostraré cómo crear un archivo PHP dentro de un tema de WordPress. También te enseñaré cómo agregar un poco de código PHP al archivo.

Este video ha sido tomado de mi curso "Aprende PHP para WordPress". Puedes ver el curso completo de forma gratuita aquí en Envato Tuts+.

WordPress

Aprende PHP para WordPress

Rachel McCollin

Los archivos del tema de WordPress

Comenzaré localizando el tema de WordPress junto con todos los archivos de plantilla que lo componen. Después crearé un nuevo archivo de plantilla de página. El propósito de esto es proporcionar una manera alternativa para mostrar algunas de las páginas de un sitio.

The WordPress theme files as shown in Coda — Los archivos del tema de WordPress como se muestran en Coda

El tipo de archivo que se está creando o lo que hace no son aspectos extremadamente importantes. Lo importante es cómo crear un archivo PHP y agregarle código relevante.

Crea un archivo nuevo

Comienza creando un archivo nuevo.

Creating a new file in Coda — Creando un archivo nuevo en Coda

La manera de hacerlo puede ser diferente dependiendo del editor de código que esté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 pequeña bandera para denotar el hecho de que se trata de un archivo PHP.

Pero eso por sí solo no significa que funcionará como un archivo PHP, necesita algo de có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 código al archivo

Ahora podemos agregar un poco de código al archivo.

Adding code to the file — Agregando código al archivo

Este es un archivo de plantilla de página. Esto significa que requiere texto comentado en la parte superior para indicarle a WordPress qué es y có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 función en PHP, siempre debes incluir las llaves (paréntesis) después del nombre de la función. Esto se termina con un punto y coma.

Las llaves indican que es una función y también son el lugar en el que se incluirán los parámetros necesarios.

En este ejemplo no se requiere ningún parámetro.

Agrega un bucle

Adding a loop in the code — Agregando un bucle en el código

A continuació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 función the_post() mientras todavía haya entradas.

Para mostrar el contenido en la página se requieren más etiquetas de plantilla y un poco de HTML. Te enseñaré cómo hacer eso en otro tutorial.

Terminamos nuestro bucle usando endwhile y endif.

Otra forma de escribir este bucle es agregando sangrías a las instrucciones if y while en sus propias líneas con llaves {. A menudo este estilo es más fácil de leer, especialmente si tienes que escribir más código dentro del bucle.

if( have_posts() ) {
    while( have_posts() ) {
        the_post();
    }
}

Hay muchas otras cosas que podrías agregar a este bucle. Si hay entradas, quizá quieras desplegar un encabezado, por ejemplo, o una barra de búsqueda. También puedes usar una instrucción else para trabajar con el caso en el que no existen entradas.

Agregando comentarios

Adding comments in the code — Agregando comentarios en el código

En PHP, los comentarios de varias líneas tienen la barra diagonal y luego los asteriscos. Puedes usar solo un asterisco o tantos como desees.

Es útil hacer esto en donde haya un nuevo bloque de código.

Asegúrate de que las barras diagonales se encuentren al principio y al final: /* y */. Por ejemplo, en el archivo de funciones, cada función tiene una sección grande de texto comentado y, con la cantidad de asteriscos que se usaron, es muy visible.

También podemos agregar comentarios PHP de una sola línea comenzando el comentario con //.

Así que he agregado una instrucció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 posición. Aquí estoy usando el comentario solo como un recordatorio, para mí y para cualquiera que lea el código, de lo que se supone que debe pasar en la instrucción else.

Experimentación

Experimenting with the code — Experimentando con el código

Para experimentar con un par má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 razón para hacer esto, en vez de simplemente agregar el código de una barra lateral directamente en tu plantilla, es garantizar que esas piezas de có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 bá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 también. Como puedes ver, el código tiene sangrías para facilitar su lectura.

Si estás siguiendo el curso, en la siguiente lección te enseñaré cómo agregar un poco de HTML a tu archivo de PHP.