Themes

La estructura de WordPress

Internamente WordPress se compone de los siguientes ficheros y carpetas:

• wp-config.php: fichero de configuración. Aquí está almacenado el usuario y el nombre de la base de datos, así como otros datos de seguridad. Es importante que este fichero no tenga lectura más que por el owner del mismo. Este fichero no se machaca con las actualizaciones de WP.
• wp-admin y wp-includes: carpetas que guardan los ficheros php que hacen que funcione el blog. Ambas carpetas se machacan con las actualizaciones
• wp-content: esta carpeta guarda los datos y configuraciones propias del blog. No se toca nada en la actualizaciones de WP. La estructura interna es la siguiente:
  • uploads: todas las imágenes, vídeos y archivos que se suban a la librería de wordpress. Normalmente se organiza por años y luego por meses. Ejemplo: uploads/2009/12.
  • plugins: todos los plugins que tenemos disponibles para el blog (aunque no estén activos).
  • languages: aquí van los ficheros .mo de los idiomas en los que queremos tener WP (tanto la parte visible como la de administración). Para indicar luego que el blog esté en un idioma u otro, habrá que añadir una línea en wp-config.php como la que sigue: define ('WPLANG', 'es_ES'); donde es_ES es el nombre del fichero .mo (tienen que coincidir en nombre).
  • themes: todas las plantillas que tenemos disponibles para "vestir" al blog. Nosotros nos centraremos en esta carpeta.

La estructura básica de un theme

La estructura básica de un theme es la siguiente:

• header.php: aquí se define la cabecera de la página.
• footer.php: aquí se define el pie de página.
• sidebar.php: aquí se definen las diferentes barras laterales.
• index.php: este es el fichero que carga de inicio del site. Desde aquí se invoca la carga de cabecera (get_header();), barras laterales (get_sidebar();) y footer (get_footer();).
• single.php: este es el fichero que se interpreta cuando se carga un post concreto.
• archive.php: igual que single.php pero para las páginas de categorías y etiquetas.
• functions.php: aquí se recogerán funciones propias del theme. Por ejemplo, si queremos registrar varias barras laterales para que aparezcan en la sección de widgets, indicar a WP dónde están los ficheros de idiomas, quitar filtros, ...
• style.css: fichero con los estilos.
• 404.php: si creamos este fichero, cada vez que algo no se encuentre en el blog, se cargará esta página.

Desde el apartado de administración se podrá configurar la apariencia de una forma muy visual mediante widgets (en el apartado Apariencia --> Widgets). Aquí aparecen las barras laterales definidas y múltiples funcionalidades que se pueden colocar: comentarios recientes, posts recientes, buscador, una caja donde introducir nuestro propio código html, ...

También desde el apartado de administración (Ajustes --> Lectura) podemos configurar que la portada que se carga de nuestra web sea una página y no el formato blog de entradas, dándole más carácter de página web.

Sidebars

Para que aparezcan en la sección de widgets las diferentes sidebars que queramos "alimentar" desde el apartado de administración, hay que registrarlas en el fichero functions.php de la siguiente forma:

if ( function_exists('register_sidebars') )
{
    register_sidebar(array(
        'name' => 'Barra Lateral Derecha',
        'before_widget' => 'código html que queremos que se cargue al inicio de la barra',
        'after_widget' => 'código html que queremos que se cargue al final de la barra',
        'before_title' => 'código html que queremos que se cargue al inicio del título de la barra',
        'after_title' => 'código html que queremos que se cargue al final del título de la barra',
    ));
    register_sidebar(array(
        'name' => 'Barra Lateral Izquierda',
        'before_widget' => 'código html que queremos que se cargue al inicio de la barra',
        'after_widget' => 'código html que queremos que se cargue al final de la barra',
        'before_title' => 'código html que queremos que se cargue al inicio del título de la barra',
        'after_title' => 'código html que queremos que se cargue al final del título de la barra',
    ));
}

Cabeceras y Footers personalizados

<?php if is_category('Cine') {
	get_footer('Cine');
} else {
	get_footer();
} ?>

De esta forma tan sencilla podemos cargar ficheros php personalizados para mostrar diferentes footers o cabeceras según estemos en una categoría u otra. En el ejemplo, si estamos en la categoría de Cine se cargará cine-footer.php. Si no, se cargará footer.php.

Sería exactamente lo mismo para las cabeceras (cine-header.php vs. header.php):

<?php if is_category('Cine') {
	get_header('Cine');
} else {
	get_header();
} ?>

Funciones

• the_permalink(): nos dará la url del post que estemos tratando dentro del loop. No tiene parámetros.
• get_permalink(): tendremos que mostrarlo nosotros por pantalla con un echo, pero nos permite que, si tenemos el ID del post y se lo pasamos por parámetro, lo usemos fuera del loop: get_permalink($post->ID)
• the_title($before, $after, $echo): muestra el título del post y también es necesario usarlo dentro del loop. Los parámetros $after y $before nos permite introducir cadenas de texto que irán delante y detrás respectivamente. Por ejemplo, si queremos que el título vaya con las etiquetas html <h3>, podemos hacer la siguiente llamada: the_title('<h3>', '</h3>'). El parámetro $echo nos sirve para indicar si queremos que muestre el título por pantalla (si lo ponemos a true) o no para hacer algún tratamiento con ese título (si lo ponemos a false).
• get_the_title(ID): igual que get_permalink pero para el título del post.
• the_content(): muestra el cuerpo del post.Se usa dentro del loop. Tiene también su versión get_the_content().
• the_excerpt(): muestra lo que hayamos introducido en el campo Extracto. Se usa dentro del loop. Tiene su versión get_the_excerpt().

<?php if(!empty($post->post_excerpt)) {
	// Si tiene extracto, lo muestra
	the_excerpt();
} else {
	// Si no, muestra el contenido del post
	the_content();
} ?>

• the_time(): muestra la fecha por cada post. Le podemos pasar por parámetro el formato de esa fecha:
  • l = Nombre completo del día de la semana.
  • F = Nombre completo para el mes.
  • j = Día numérico.
  • m = Mes con dos dígitos.
  • Y = Año con cuatro dígitos.
  • y = Año con dos dígitos.
  • Para escapar letras, usaremos la barra \. Por ejemplo, para poner la palabra "de" le pasaremos "\d\e"

<?php the_time('l, j \d\e F, Y'); //Nos muestra Martes, 14 de Septiembre, 2010 ?>

• the_date(): igual que the_time pero muestra la fecha soló en el primer post de un grupo que haya sido publicado el mismo día.

Templates

Podemos crear plantillas con comportamientos propios a los que luego asignar a cada página. Desde el editor de páginas estáticas hay una opción para aplicar plantillas. Para que un fichero php sea interpretado por WP como una template, hay que incluir al inicio del mismo el siguiente código:

/* 
Template Name: Nombre-plantilla 
*/

Enlaces de interés

• Nuestra nueva biblia: Codex Wordpress.
• El gran repositorio de WordPress de plantillas, para que seleccionemos una como base para la modificación.