Bienvenido al Supervisor de estado del PC de Toshiba. Esta aplicación supervisa activamente las funciones del sistema de la computadora, tales como el consumo de energía,  el enfriamiento del sistema y el funcionamiento del sensor de 3D, notificando a los usuarios información importante sobre las condiciones del sistema. Esta aplicación reconoce los números de serie del sistema y de los componentes individuales y rastrea actividades específicas relacionadas con la computadora y su uso.

La información sobre el sistema, los componentes y el uso que se rastrea y recopila, a saber:

1. información básica sobre la computadora (por ejemplo, nombre del producto, número de modelo, número de pieza, número de serie, versión del BIOS, versión del FW),
2. información sobre los componentes básicos (por ejemplo, dispositivo de video, dispositivo de sonido, dispositivo de red, unidad de disco duro, unidad de estado sólido, unidad de discos ópticos),
   
3. información sobre el sistema operativo (SO) (por ejemplo, versión del SO, fecha de instalación del SO, versión de Direct X, versión de Internet Explorer, listas actualizadas de los programas y controladores instalados),
4. tiempos de funcionamiento/contadores de los componentes (por ejemplo, interruptor de alimentación, adaptador de CA, batería, pantalla LCD, ventilador, volumen del sonido, LAN inalámbrica, estación de acoplamiento, USB, tarjeta ExpressCard),
5. fecha de primer encendido del sistema y uso del sistema y de los componentes (por ejemplo, teclado [conteo del uso de la tecla FN],
6. configuraciones de energía, batería [temperatura, capacidad de carga y descarga],
7. CPU, memoria, retroiluminación [tiempo de encendido], temperatura del módulo térmico).

Uso de la información

se almacena en la unidad de disco duro de su computadora. Los datos almacenados usan una porción muy pequeña de la capacidad total del disco duro, aproximadamente 10MB o menos por año de actividad del sistema.La información recopilada se usa para

1. supervisar el funcionamiento del sistema,
2. notificar al usuario de las condiciones del sistema
3. y, cuando sea necesario, ayudar a diagnosticar problemas si la computadora llegara a requerir servicio.
4. Toshiba también puede usar esta información para sus análisis de control de calidad internos.
5. Sujetos a las restricciones de uso especificadas arriba, los datos almacenados podrían ponerse a la disposición de entidades ubicadas fuera de su país o región de residencia, y dichos países podrían tener o no las mismas leyes sobre la protección de datos o niveles de protección de datos que los de su país o región geográfica.

La transmisión de los datos recopilados se lleva a cabo cuando se instala la Estación de servicio de TOSHIBA en la computadora y se habilitan el botón “Conexión de la información del estado del PC” y la función Conexión de la información del estado del PC. Para obtener información adicional, por favor consulte el “Aviso y aceptación de la transmisión de los datos del Supervisor de estado del PC” de la Estación de servicio de TOSHIBA que aparece cuando se hace clic en el botón “Conexión de la información del estado del PC”.

Ni el Supervisor de estado del PC ni su uso  extienden o modifican en ninguna forma las obligaciones de Toshiba de acuerdo con la garantía limitada estándar. Por lo tanto se aplican los términos y limitaciones de la garantía limitada estándar de Toshiba.

Le recomendamos que active el Supervisor de estado del PC ahora, pero si lo desea, puede hacerlo más tarde o no usarlo. Una vez habilitada, usted puede deshabilitar esta función en cualquier momento desinstalando el software en el Panel de Control usando la función Agregar/Quitar programas. Una vez deshabilitado el Supervisor de estado del PC todos los datos recopilados y almacenados por la aplicación se borran automáticamente.

Al habilitar el Supervisor de estado del PC usted acuerda a los presentes términos y condiciones, y al uso y compartimiento de la información recopilada. Por favor imprima una copia de este Aviso y aceptación para sus archivos y consulte la Guía de información del usuario, el Manual del usuario o la Guía del usuario para obtener información más detallada.

Flipo

Las etiquetas condicionales se utilizan en los archivos de plantilla para cambiar qué contenido se muestra y cómo dependiendo de las condiciones que tenga la página. Por ejemplo, es posible que queramos mostrar un pequeño texto encima de los posts, pero sólol en la página principal del blog. Con la etiqueta condicional is_home() es fácil conseguirlo.

Nota: este tema está muy relacionado con la  jerarquía de plantillas.

Las condiciones para…

Todas las etiquetas condicionales comprueban que se dan ciertas condiciones, y devuelven TRUE o FALSE. Ahora veremos en qué condiciones es posible que varias etiquetas devuelvan TRUE is listed below. También explicamos qué etiquetas pueden aceptar parámetros.

La página principal

is_home()

Cuando se está mostrando la página principal del blog. (WordPress 2.1 maneja esta función de forma distinta que versiones anteriores de wp . ver static Front Page.) <

Nota: Si seleccionas una página estática como tu página de inicio (ver el punto siguiente), esta etiqueta se aplicará a tu página de posts.

La página de inicio

is_front_page()

Cuando se muestra la página principal, ya sea los posts o una página (Page). Devuelve TRUE cuando se muestra la página principal del blog y

1. ‘Opciones->Lectura->Página inicial’ está configurado pra “Tus últimas entradas”,
2. o cuando when ‘Opciones->Lectura->Página inicial’ está como  ” página estática ” y el valor de la  “página de inicio” es la que se está mostrando en ese momento  Nota: esta etiqueta se añadió en la Versión 2.5.

Los paneles de administración

is_admin()

Cuando se muestra el tablero o los paneles de administración.

Una página de post individual

is_single()

Cuando se muestra una página con un post individual.

is_single(’17′)

Cuando se muestra el post 17  de forma individual.

is_single(‘Irish Stew’)

Cuando se está mostrando el post con el título “Irish Stew” en un post individual.

is_single(‘beef-stew’)

Cuando un post con la etiqueta (Post Slug) “beef-stew” se muestra como un post individual.

is_single(array(17,’beef-stew’,'Irish Stew’))

Devuelve true cuando el post individual que se muestra tiene el id 17 o el post_name is “beef-stew”, o  post_title es “Irish Stew”. Nota: la posibilidad del array se añadió en la versión Version 2.5.

Comrpbando sub-Páginas

Todavía no hay ninguna función  is_subpage() pero podemos comprobarlo con una poco de código

<?php
// Get $post if you're inside a function
global $post;

if (is_page() && $post->post_parent ) {
	// This is a subpage
} else {
	// This is not a subpage
}
?>

Si necesitas comprobar si estás en una página concreta o en una subpágina de esta (por ejemplo para mostrar una banner distinto dependiendo de en qué página esté el usuario, averigua el ID de la página-madre y luego utiliza un código cómo este:

<?php

if 	(is_page(about) || $post->post_parent=="2") {
	$bannerimg="home.jpg";
} elseif (is_page(learning) || $post->post_parent=="56") {
	$bannerimg="teaching.jpg";
} elseif (is_page(admissions) || $post->post_parent=="15") {
	$bannerimg="admissions.jpg";
} else {
	$bannerimg="home.jpg" ; // Fall-through
}	

?>

Es una plantilla de página (page)

Desde la  Versión 2.5 esta función te permite averiguar si estás o no en una plantilla de página o si estás usando una plantilla de página específica.

is_page_template()

¿ Se está utilizando una plantilla de página ?

is_page_template(‘about.php’)

¿Se está usando la plantilla de página (Page Template)  ‘about’? Ten en cuenta, que al contrario que en otras etiquetas condicionales, si quieres especificar una plantilla de página específica, tienes que usar el nombre del archivo como about.php o mi_plantilla_de_pagina.php.

Una página de categoría

is_category()

Cuando se está mostrando una página de categoría.

is_category(’9′)

Cuando se esté mostrando una página con los posts de la categoría  9.

is_category(‘Stinky Cheeses’)

Cuando se esté mostrando una página con los posts de la categoría  “Stinky Cheeses”

is_category(‘blue-cheese’)

Cuando se esté mostrando una página con los posts de la categoría  (Category Slug) “blue-cheese”

is_category(array(9,’blue-cheese’,'Stinky Cheeses’))

Devuelve true cuando se esté mostrando una página con los posts de la categoría  con _ID 9, o slug “blue-cheese”, o name “Stinky Cheeses”. Nota: El array es posible desde la Versión 2.5.

in_category(’5′)

Devuelve true si el post en cuestión pertenece a la categoría 5. Más información

Nota: Atención a la ortografía, entre “is” y “in” hay una gran diferencia.

ver también is_archive() y Category Templates.

Una página de etiquetas

is_tag()

Cuando se muestra el archivo de los posts con una determinada etiqueta.

is_tag(‘mild’)

Cuando se muestra el archivo de los posts con la etiqueta ‘mild’.

is_tag(array(‘sharp’,'mild’,'extreme’))

Devuelve true cuando se muestra el archivo de las etiquetas  “sharp”, “mild”, o “extreme”. Nota: los arrays se añadieron en la  Versión 2.5.

has_tag()

Si el post que se está mostrando tiene una etiqueta. Tiene que usarse dentro del bucle. Nota: has_tag se añadió en la versión Version 2.6.

has_tag(‘mild’)

Si el post que se está mostrando tiene la etiqueta ‘mild’.

has_tag(array(‘sharp’,'mild’,'extreme’))

Si el post que se está mostrando tiene cualquiera de las etiquetas del array.

Ver también is_archive() y Tag Templates.

Una página de autor

is_author()

Cuando se muestra cualquier página de un autor.

is_author(’4′)

Cuando se muestra un archivo de las páginas del autor con el ID 4.

is_author(‘Vivian’)

Cuando se muestra un archivo de las páginas del autor con el alias “Vivian” .

is_author(‘john-jones’)

Cuando se muestra un archivo de las páginas del autor con el nombre “john-jones” .

is_author(array(4,’john-jones’,'Vivian’))

Cuando se muestra un archivo de las páginas bien con el id de usuario ID 4, ocon  user_nicename “john-jones”, o alias“Vivian”. Nota: desde la  Versión 2.5.

Ver también is_archive() y Author Templates.

Páginas de archivo cronológico

is_date()

Al mostrar un archivo cronológico basado en cualquier tipo de fecha (mensual, anual, diario o por hora)

is_year()

Al mostrar un archivo cronológico anual.

is_month()

Al mostrar un archivo cronológico mensual.

is_day()

Al mostrar un archivo cronológico diario.

is_time()

Al mostrar un archivo cronológico horario.

ver también  is_archive().

Una página de archivo

is_archive()

Cuando se muestra cualquier tipo de archivo: Categoría, etiqueta, autor o fecha son tipos de páginas de archivo.

Una página de búsqueda

is_search()

Cuando se muestra una página con resultados de búsqueda.

Página no encontrada 404

is_404()

Cuando se muestra una página tras un error  “HTTP 404: Not Found”.

Una página “paginada”

is_paged()

Cuando se trata de una página que está ‘paginada’, se refiere a vistas de archivo o a la página principal que se ve en varias no se refiere a una entrada o a una página (Page)  cuyo contenido se haya dividido en varias páginas utilizando QuickTag <!--nextpage--> .

Un archivo adjunto

is_attachment()

Cuando se muestra un documento adjunto a una entrada o página Page . Un archivo adjunto es una imagen u otro archivo que se ha subido con la utilidad para subir archivos del editor de wordpress. Los archivos adjuntos pueden mostrarse en su propia ‘página’ plantilla. Para más información, consultar Using Image and File Attachments.

Sindicación

is_feed()

Cuando el sitio solicitado es una the  Syndication. Esta etiqueta no suelen utilizarla los usuarios, la utiliza internamente wordpress y los desarrolladores de plugins.

Trackbacks

is_trackback()

Cuando el sitio solicitado el el gancho de WordPress a su trackback.  Esta etiqueta la utilizan wordpress internamente así como los desarrolladores de plugins.

Ejemplos que funcionan

Aquí hay algunos ejemplos que funcionan para demostrar el funcionamiento de estas etiquetas condicionales.

En un post individual

Este ejemplo muestra cómo utilizar la función is_single() para mostrar algo concreto sólo cuando se trata de una página de post individualdisplay

if (is_single())
{
     echo 'This is just one of many fabulous entries in the ' . single_cat_title() . ' category!';
}

Diferencias basadas en la fecha

Vamos a distinguir por colores los posts de años distintos en el caso de que alguien navegue por fechas:

<?php
// this starts The Loop
if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<h2 id="post-<?php the_ID(); ?>">
<a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>">
<?php the_title(); ?></a></h2>
<small><?php the_time('F jS, Y') ?> <!-- by <?php the_author() ?> --></small>

<?php
// are we showing a date-based archive?
if (is_date())
{
     if (date('Y') != get_the_date('Y'))
     {
          // this post was written in a previous year
          // so let's style the content using the "oldentry" class
          echo '<div class="oldentry">';
     } else {
          echo '<div class="entry">';
     }
} else {
     echo '<div class="entry">';
}
the_content('Read the rest of this entry »');
?>
</div>

Contenido variable del menú lateral

Este ejemplo mostrará contenido diferente en el menú lateral dependiendo de qué página esté viendo el usuario.

<!-- begin sidebar -->
<div id="sidebar">
<?php
// let's generate info appropriate to the page being displayed
if (is_home()) {
        // we're on the home page, so let's show a list of all top-level categories
        echo "<ul>";
        wp_list_cats('optionall=0&sort_column=name&list=1&children=0');
        echo "</ul>";
} elseif (is_category()) {
        // we're looking at a single category view, so let's show _all_ the categories
         echo "<ul>";
        wp_list_cats('optionall=1&sort_column=name&list=1&children=1&hierarchical=1');
        echo "</ul>";
} elseif (is_single()) {
        // we're looking at a single page, so let's not show anything in the sidebar
} elseif (is_page()) {
        // we're looking at a static page.  Which one?
        if (is_page('About')) {
             // our about page.
             echo "<p>This is my about page!</p>";
        } elseif (is_page('Colophon')) {
             echo "<p>This is my colophon page, running on WordPress " . bloginfo('version') . "</p>";
        } else {
              // catch-all for other pages
              echo "<p>Vote for Pedro!</p>";
        }
} else {
        // catch-all for everything else (archives, searches, 404s, etc)
        echo "<p>Pedro offers you his protection.</p>";
} // That's all, folks!
?>
<form id="searchform" method="get" action="<?php echo $_SERVER['PHP_SELF']; ?>">
<div>
<input type="text" name="s" id="s" size="15" />
<input type="submit" value="<?php _e('Search'); ?>" />
</div>
</form>

</div>
<!-- end sidebar -->

Una página 404 útil

Una página de Error: página no encontrada (404) puede resultar intimidatoria y poco útil. Utilizando wordpress podemos construir una página 404 que resulte útil a los usuarios y a también a uno mismo, si hacemos que nos mande un email cada vez que un usuario pulse en un enlace que nos lleve a una página no existente.

<p>You
<?php
#some variables for the script to use
#if you have some reason to change these, do.  but wordpress can handle it
$adminemail = get_bloginfo('admin_email'); #the administrator email address, according to wordpress
$website = get_bloginfo('url'); #gets your blog's url from wordpress
$websitename = get_bloginfo('name'); #sets the blog's name, according to wordpress

  if (!isset($_SERVER['HTTP_REFERER'])) {
    #politely blames the user for all the problems they caused
        echo "tried going to "; #starts assembling an output paragraph
	$casemessage = "All is not lost!";
  } elseif (isset($_SERVER['HTTP_REFERER'])) {
    #this will help the user find what they want, and email me of a bad link
	echo "clicked a link to"; #now the message says You clicked a link to...
        #setup a message to be sent to me
	$failuremess = "A user tried to go to $website"
        .$_SERVER['REQUEST_URI']." and received a 404 (page not found) error. ";
	$failuremess .= "It wasn't their fault, so try fixing it.
        They came from ".$_SERVER['HTTP_REFERER'];
	mail($adminemail, "Bad Link To ".$_SERVER['REQUEST_URI'],
        $failuremess, "From: $websitename <noreply@$website>"); #email you about problem
	$casemessage = "An administrator has been emailed
        about this problem, too.";#set a friendly message
  }
  echo " ".$website.$_SERVER['REQUEST_URI']; ?>
and it doesn't exist. <?php echo $casemessage; ?>  You can click back
and try again or search for what you're looking for:
  <?php include(TEMPLATEPATH . "/searchform.php"); ?>
</p>

Nota: Esto es una traducción del artículo conditional Tags en el codex de WordPress que he hecho para ver si consigo enterarme de algo.

Introducción

Las plantillas de WordPress se acomplan como piezas de un puzle para generar las páginas de un sitio hecho con WordPress. Algunas plantillass (los archivos  encabezamiento y del pie de página por ejemplo) se utilizan en todas las página, en cambio otros archivos de plantilla sólo se utilizan en determinadas condiciones.

De qué trata este artículo

Este artículo busca responder a la siguiente pregunta:

¿Que archivo(s) de plantilla utilizará WordPress para mostrar cada tipo de página?

A quien puede resultarle útil esta información

Desde la introducción de los  Temas en la versión 1.5 de WordPress , las plantillas son cada vez más configurables. A la hora de desarrollar temas para WordPress, resulta esencial tener claro  cómo selecciona WordPress los archivos de plantilla para mostrar las distintas páginas del blog. Si necesitas personalizar un Tema de WordPress ya existente, este artículo te ayudará a decidir que archivo necesitas editar.

Las etiquetas condicionales

WordPress nos ofrece más de una manera de adecuar las plantillas a lo que queremos. Los desarrolladores de temas para plantillas pueden utilizar también etiquetas condicionales para controlar qué plantillas se utilizarán para generar determinadas páginas. Algunos Temas de wordpress puede que no utilicen todos los archivos de plantilla que describimos en este artículo. Otros Temas utilizarán etiquetas condicionales para cargar otras plantillas. Consultar: Conditional Tags y “Query Based” in Theme Development para más información.

La jerarquía de los archivos de plantilla

La idea general

WordPress utiliza la Query String — Información presente en los enlaces del sitio — Para decir qué plantilla o conjunto de ellas tiene que utilizar para mostrar la página.

Primero, WordPress contrasta la Query con los tipos de query posibles — es decir, decide qué tipo de página se está solicitando (una página de búsqueda, una página de categoría , la página principal, etc.).

Las plantillas se seleccionan (y consecuentemente se generan las páginas) en el orden sugerido por la jerarquía de plantillas de  WordPres, dependiendo de qué archivos de plantilla estén disponibles en el Tema específico que se esté utilizando en ese momento.

WordPress busca archivos de plantilla con nombres específicos en el directorio del tema que se esté usando y utiliza el primer archivo cuyo nombre concuerde con el adecuado para la query que se haya producido.

Con la excepción del achivo index.php que es necesario, los desarrolladores de Temas para WordPress pueden elegir si quieren o no desarrollar un archivo de plantilla concreto. Si WordPress no puede encontrar el archivo con nombre concordante, va a mirar al siguiente archivo en la jerarquía, si no encuentra nada, recurre al  index.php (el archivo de plantilla de la página principal del Tema) .

Examples

If your blog is at http://domain.com/wp/ and a visitor clicks on a link to a category page like http://domain.com/wp/category/your-cat/, WordPress looks for a template file in the current Theme’s directory that matches the category’s ID. If the category’s ID is 4, WordPress looks for a template file named category-4.php. If it is missing, WordPress next looks for a generic category template file, category.php. If this file does not exist either, WordPress looks for a generic archive template, archive.php. If it is missing as well, WordPress falls back on the main Theme template file, index.php.

If a visitor goes to your home page at http://domain.com/wp/, WordPress looks for a template file called home.php and uses it to generate the requested page. If home.php is missing, WordPress looks for a file called index.php in the active theme’s directory, and uses that template to generate the page.

Ejemplos

Si tu blog está en  http://tudominio.com/wp/ y un visitante pulsa un enlace a una tategoría,  http://tudominio.com/wp/cateogría/tu-cat/, WordPress , en el directorio del Tema que ezssté usando, busca un archivo que concuerde con el ide de la categoría. Si el ID de la categoría es 4 buscará un archivo con el nombre category-4.php. Si no lo hay, buscará una plantilla genérica de categoría, category.php. Si tampoco existe, buscará una plantilla de archivo genérica, archive.php. Y si tampoco está recurrirá a la plantilla básica del Tema index.php.

Si un v isitante va a un página en http://tu dominio.com/wp/, WordPress buscará un archivo llamado home.php y lo utilizará para generar la página. Si home.php no está, buscará  index.php en el directorio del tema activo y lo utilizará.

Visión general

El siguiente diagrama nos muestra qué plantillas se requieren para generar las páginas, basándonos en la jerarquía de plantillas WordPress.

Jerarquía de plantillas. Pulsar para ver en grande

La jerarquía de plantillas en detalle

Los puntos siguientes describen en qué orden busca WordPress los archivos para cada tipo de query.

Vista de la página principal

1. home.php
2. index.php

Vista de una entrada individual

1. single.php
2. index.php

Vista de una “Página” (WordPress Pages):

1. pagetemplate.php – Donde pagetemplate.php es la plantilla de página  Page Template asignada a una página de wp Page.
2. page.php
3. index.php

Vista de categoría (Category Templates):

1. category-id.php – Si la ID de la categoría fuera 6 , WordPress buscaría category-6.php
2. category.php
3. archive.php
4. index.php

Vista de etique4tas Tag Templates:

1. tag-slug.php – si la etiqueta fuera sometag, WordPress buscaríar tag-sometag.php
2. tag.php
3. archive.php
4. index.php

Vista por autores (Author Templates):

1. author.php
2. archive.php
3. index.php

Vista de por fecha (Date Templates):

1. date.php
2. archive.php
3. index.php

Vista de los resultados de búsqueda (Creating a Search Page):

1. search.php
2. index.php

Página no encontrada 404 (Not Found) (Creating an Error 404 Page):

1. 404.php
2. index.php

Vista de archivos adjuntos (Attachment Templates):

1. image.php, video.php, audio.php, application.php o cualquier otra “primera partedel tipo MIME (MIME type).
2. attachment.php
3. single.php
4. index.php

Lecturas relacionadas

Theme Development | The Loop | Conditional Tags | Template Tags | Using Permalinks

Nota : Este artículo es una traducción de The template hierarchy del codex de WordPress que he hecho para obligarme a mi misma a leérmelo entero y asegurarme de que he entendido algo

Introdución

“El Bucle” es un término que se refiere al proceso principal de WordPress. Usamos el bucle en las plantillas de wordpress ( template files) para mostrar las entradas a los usuarios. Podríamos hacer plantillas ein El Bucle, pero sólo podríamos mostrar los datos de 1 post.

Lo primero que hace WordPress es comprobar que están todos los archivos que necesita. Luego, recopila de la base de datos las opciones establecidas por el administrador del blog. Esto incluye cosas cómo el número de entradas que hay que mostrar en cada página, si los comentarios están abiertos, etc. Una vez establecidas estas opciones, WordPress comprueba qué es lo que el usuario ha pedido y lo utiliza para coger esa información de la base de datos.

Si es usuario no ha pedido una entrada, categoría, página o fecha específicas, WordPress utiliza la información por defecto que ha recogido antes para determinar qué posts va a enseñar al usuario. Por ejemplo, si el administrador del blog ha establecido mostrar 5 posts por página en  Administración > Opciones > Lectura, WordPress cogerá los 5 posts más recientes de la base de datos. Si el usuario ha pedido un post, categoría, página o fecha específicos,  WordPress usará esa información para recoger esas entradas de la base de datos.

Una vez hecho todo esto,  WordPress conecta con la base de datos, extrae la información necesaria y guarda los resultados en una variable. El Bucle accede a esta variable y utiliza los valores para mostrarlos en las plantillas.

Por defecto, si el visitante no ha seleccionado un post, categoría, página o fecha específicos, WordPress usa index.php para mostrar cualquier cosa. En la primera parte de este artículo sobre el bucle, nos vamos a centrar únicamente en index.php, y la vista por defecto del blog. Después, una vez que entendamos como funcionan las cosas, investigaremos cómo funciona el bucle en otros archivos.

El index más simple del mundo

El código siguiente es un index perfectamente funiconal que mostrará los contenidos (y sólo los contenidos) de cada post, de acuerdo con las condiciones utilizadas para preparar El Bucle. El único propósito de mostrar esto es demostrar lo poquísimo que es necesario para que el Bucle  funcione. La mayor parte del index.php es CSS, HTML y declaraciones en PHP que hace que el bucle tenga una bonita apariencia

<?php
get_header();
if (have_posts()) :
   while (have_posts()) :
      the_post();
      the_content();
   endwhile;
endif;
get_sidebar();
get_footer();
?>

Ahora vamos a echar un vistazo a las cosas que logran que El Bucle tenga una bonita apariencia.

El Bucle por defecto

Vamos a ver paso a paso el uso por defecto del Bucle, el que viene con las plantillas default y classic in the en la instlación standar de  v1.5.

Principio del Bucle

Al principio de la plantilla index.php encontramos el código que da comienzo al Bucle.

<?php if (have_posts()) : ?><br />
<?php while (have_posts()) : the_post(); ?>

1. Primero comprueba si se recogió alguna entrada con la función have_posts() .
2. Si hay alguna entrada, se da comienzo a un bucle while de PHP, que se continuará ejecutando mientras la condición establecida entre paréntesis siga siendo verdadera (ver estructuras de control en el manual de PHP) En tanto que la función have_posts() siga devolviendo un valor  true value, El Bucle seguirá ejecutándose.
3. La función have_posts() simplemente comprueba el siguiente item en la colección de entradas: si hay otro item, devuelve true, si no lo hay, devuelve false.

Generando el Post

La función the_post() coge el contenido del item actual dentro de la colección de posts y lo hace disponible para su utilización dentro  del Bucle. Sin  the_post(), muchas de las etiquetas de plantilla (Template Tags) usadas en un Tema, no funcionarían.

Una vez que los datos del post están disponibles, la plantilla puede empezar a mostrárselos a los visitantes.

Título, Fecha y Autor

Las siguientes etiquetas de plantilla  (template tags) muestran el título del post en cuestión, así como la fecha y el autor del mismo.

<h2 id="post-<?php the_ID(); ?>">
<a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title(); ?>">
<?php the_title(); ?></a></h2>
<small><?php the_time('F jS, Y') ?> <!-- by <?php the_author() ?> --></small>

El Contenido del post

La etiqueta de plantilla the_content() muestra el contenido del post. Esto tag displays the content of the post. Esto es el plato principal de cada pasada por El Bucle:

<div class="entry">
<?php the_content('Read the rest of this entry &raquo;'); ?>
</div>

Si incluyes el botón  Quicktag llamado more, que se muestra cómo  <!--more-->, en el cuerpo del post, sólo se mostrará la porción del post que esté antes de esa línea. Así que si sólo quieres mostrar en la página principal una o dos frases de cada post, lo único que hay que hacer es insertar <!--more--> después de la primera frase de cada post.

Cuando estamos viendo un post en particular, se ignora el delimitador <!--more--> . Así que poniendo este delimitador <!--more--> forzamos a los usuairos a pulsar sobre cada post para verlo entero.

Detalles adicionales

En el archivo index. php, debajo del contenido de cada post hay un sitio para mostrar más información sobre el post, como la categoría, la fecha e información sobre los comentarios, se conoce como post meta data section, si eres un usuario registrado con suficientes privilegios (el autor del post) también puedes ver un enlace para “editar el artículo” gracias a la función de la etiqueta edit_post_link() .

<p class="postmetadata">
Posted in <?php the_category(', ') ?>
<strong>|</strong>
<?php edit_post_link('Edit','','<strong>|</strong>'); ?>
<?php comments_popup_link('No Comments »', '1 Comment »', '% Comments »'); ?></p>

Si los comentarios están activados, o el post tiene comentarios, la etiqueta de plantilla comments_popup_link() mostrará a los usuarios un enlace a los comentarios. Si estás utilizando la ventana ‘popup’ de los comentarios, este enlace abrirá una ventana para los comentarios (comments popup window), en caso contrario saltará a los comentarios del post en la misma ventana .

Si el visitante está viendo un índice de posts (más de un post en El Bucle) la etiqueta  comments_popup_link() llevará al usuario al la página individual del post.

Autodescubrimiento de Trackback

La función de la etiqueta trackback_rdf es mostrar un código legíble para máquinas para autodescubrir trackbacks .

<!--
<?php trackback_rdf(); ?>
-->

Nota: La etiqueta trackback_rdf() se supone que debe usarse con las etiquetas de comentario (<!––>) alrededor (no es que esté desactivada).

Finalizando El Bucle

El bucle se finaliza bucle con:

<?php endwhile; ?>

Si se introducen etiquetas de plantilla relativas al post después de este punto, no funcionarán tal y como se espera de ellas (y si lo hacen, usaran el último post del Bucle). Esto significa que si necesitas usar una etiqueta de plantilla que tenga que ser usada dentro del bucle.

La sección inmediatamente después del bucle, muestra los controles para navegar, para moverse adelante y atrás por cada página.

<div class="navigation">
<div class="alignleft"><?php posts_nav_link('','','&laquo; Previous Entries') ?></div>
<div class="alignright"><?php posts_nav_link('','Next Entries &raquo;','') ?></div>
</div>

Si el blog está configurado para mostrar 10 entradas por cada página, y las condiciones que ha utilizado el Bucle, recogen 25 posts, habrá 3 páginas en las que navegar: dos páginas con 10 entradas cada una y una página con 5. Los enlaces de navegación permitirán al visitante moverse adelante y atrás por la colección de posts.

Los controles de navegación se incluyes fuera del Bucle pero dentro de la condición if, de forma que sólo se muestran si hay algún post.  Las funciones de navegación también comprueban si hay o no algo a lo que puedan enlazar, basándose en el bucle actual y sólo se muestran los enlaces si efectivamente hay algo que enlazar.

<?php else : ?>
 <h2 class="center">Not Found</h2>
 <p class="center">
<?php _e("Sorry, but you are looking for something that isn't here."); ?></p>

La cláusula  else : determina qué hay que hacer si  have_posts() (que vismos al principio) esfalse. Es decurm lo que pongas después de else sólo se ejecutará/mostrará si el Bucle no contenía post alguno. No se muestra ningún post cuando, por ejemplo, el visitante solicita un día en concreto en el que no se publicó ninguna entrada; o cuando se realiza una búsqueda que no obtiene ningún resultado.

  <?php endif; ?>

Esto termina termina la condición de ” Si hay post para hacer esto, si no hay posts, haz esto otro” Una vez que se termina la condición, el index.php por defecto incluye la barra lateral y finalmente el pie de página.

Así que nuestro bucle completito en elindex.php, tal y cómo aparece en la plantilla “default” sería:

<?php if (have_posts()) : ?>
    <?php while (have_posts()) : the_post(); ?>
    <?php endwhile; ?>
<?php else : ?>
<?php endif; ?>

El Bucle en otros archivos de plantilla

WordPress puede usar diferentes archivos de plantilla para mostar el blog de formas diferentes. En la plantilla por defecto (default) hay archivos de plantilla para la vísta del índice, la vísta de categoría, la vista de archivo, así cómo un archivo de plantilla para ver post individuales. Cada uno de estos archivos usa El Bucle, pero cada uno de ellos con un formato ligeramente distinto, así como una utilización distinta de las etiquetas de plantilla (template tags).

Para cualquier vista que no tenga un archivo de plantilla específico, , WordPress will utilizará index.php por defecto.  Si un visitantes solicita ver un post individual, , WordPress primero buscará un archivo llamado single.php. Si existe ese archivo, lo usará para presentar el post al usuario, pero si no existe, WordPress usará  index.php para mostrar el post al visitante. Esto es lo que se llama la Jearquía de las plantillas (Template Hierarchy).

Si estás haciendo tu propio Tema, suele ser útil echarle un vistazo a los archivos de plantilla del tema “default” para tener una referencia. También ayuda utilizar el archivo index.php de tu Tema como punto de partida para los demás archivos de plantilla. Hacerlo, te dará un archivo conocido y que funciona a partir del cual puedes empezar a hacer cambios a medida que vas creando más archivos de plantilla.

Formato del archivo cronológico

Un archivo cronológico es una colección de posts pasados. En el uso por defecto, los posts que se muestran en la página principal son posts recientes ordenados cronológicamente . Cuando un visitante pulsa en alguno de los enlaces del archivo cronológico, o si manualmente solicitan una fecha específica (http://www.example.com/blog/index.php?m=200504 o http://www.example.com/blog/2005/04 para seleccionar todos los posts de Abril de 2005), WordPress mostrará la vista de archivo cronológico. Por defecto, este archivo utilizará la plantilla index.php, y por lo tanto su apariencia será la misma que la de la página principal, sólo que mostrando los posts de abril de 2005.

Cuando WordPress prepara una vista cronológica para el visitante, buscará un archivo llamado archive.php en el directorio del Tema. Si queremos diferenciar nuestra vista cronológica de la página principal, lo único que tenemos que hacer es  copiar index.php guardarlo como  archive.php, y editarlo cómo queramos!

Por ejemplo, si en nuestra vista cronológica queremos mostrar sólo los títulos y no el contenido de los posts podríamos usar algo como esto:

<?php get_header(); ?>
 <div id="content" class="narrowcolumn">

  <?php if (have_posts()) : ?>
   <?php while (have_posts()) : the_post(); ?>
     <div class="post">
     <h2 id="post-<?php the_ID(); ?>">
<a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to
<?php the_title(); ?>"><?php the_title(); ?></a></h2>
     <small><?php the_time('F jS, Y') ?> <!-- by <?php the_author() ?> --></small>
      </div>
    <?php endwhile; ?>
<div class="navigation">
<div class="alignleft">
<?php posts_nav_link('','','&laquo; Previous Entries') ?>
</div>
<div class="alignright">
<?php posts_nav_link('','Next Entries &raquo;','') ?>
</div>
  </div>
<?php else : ?>
  <h2 class="center">Not Found</h2>
 <p class="center"><?php _e("Sorry, but you are looking for something that isn't here."); ?></p>
  <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

El formato del archivo de categorías

Al igual que en el caso de la vista cronológica,  WordPress buscará un archivo de plantilla específico para la  vista por categorías. Si un visitante pulsa sobre un enlace de categoría en el blog, verá una página con una vita por categorías. WordPress prepara El Bucle con posts provenientes sólo de esta categoría, limitándo el número de posts que muestra al que se haya establecido en las opciones del blog.

Para que nuestra vista por categorías sea diferente de la página anterior, hay que copiar index.php y  renombrarlo como category.php. Para una vista de categoría lo normal es que no sea necesario listar las categorías a las que el post está asignado, por lo que, en el ejemplo, vamos a quitar esa sección y a poner el nombre de la categoría al principio de la página

<?php get_header(); ?>
 <div id="content" class="narrowcolumn">
 <p>
 <strong>
  <?php single_cat_title('Currently browsing '); ?>
  </strong><br />
 <?php echo category_description(); ?>
 </p>
 <?php if (have_posts()) : ?>
   <?php while (have_posts()) : the_post(); ?>
     <div class="post">
      <h2 id="post-<?php the_ID(); ?>">
<a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to
<?php the_title(); ?>">
<?php the_title(); ?></a></h2>
   <small>
     <?php the_time('F jS, Y') ?>
        <!-- by <?php the_author() ?> -->
   </small>
 </div>
<?php endwhile; ?>
 <div class="navigation">
   <div class="alignleft">
    <?php posts_nav_link('','','&laquo; Previous Entries') ?>
   </div>
   <div class="alignright">
    <?php posts_nav_link('','Next Entries &raquo;','') ?>
   </div>
 </div>
<?php else : ?>
  <h2 class="center">Not Found</h2>
<p class="center"><?php _e("Sorry, but you are looking for something that isn't here."); ?></p>
 <?php endif; ?>
</div>
<?php get_sidebar(); ?>
<?php get_footer(); ?>

Un formato diferente para cada categoría

Tal y cómo se explica en la  Jerarquía de plantillas, es posible crear archivos de plantilla específicos para cada categoría. Sólo hay que nombrar el archivo como category-X.php, siendo X el ID de la cateogría. Hay que evaluar cuidadosamente la necesidad de crear toda una plantilla nueva para una categoría específica.

Vamos a ver 2 categrías: “Plantas” y “flores”, cuyos ID de categoría son 3 y 4 respectivamente. Al lado de cada título de un post quieres tener una imagen bien de una planta, bien de una flor, dependiendo de la categoría en la que estemos. Podríamos:

• Utilizar dos archivos separados, category-3.php y category-4.php, cada uno con una etiqueta de imagen distinta para cada dítulo.
• Utilizar una condición dentro de nuestra plantilla de archivo category.php que comprobase si la categoría que se está visiualizando es “Plantas” o “flores” y mostrar la imagen que corresponda.

<?php if (is_category('3') ):
 // Estamos en la categoría plantas, muestra una planta ?>
 <img src='/images/plant.png' alt='a plant' />
<?php } elseif (is_category('4') ):
 // Estamos en la categoría Flores, muestra una Flor ?>
 <img src='/images/flower.png' alt='a pretty flower' />
<?php endif; // end the if, no images for other other categories ?>

Si quisieras mostrar otra categoría , “Coches”, que quisieras mostrar de una forma completamente distinta, si que te vendría bien un archivo específico category-X.php .

Un CSS diferente para categorías diferentes

Muchos usuarios quieren crear un CSS específico para una categoría concreta. Es fácil de hacer. Es importante recordar que las hojas de estilo se definen y carcan en el encabezamiento de un documento HTML (<head>). WordPress lo hace en header.php. En elheader.php, Busca esta línea:

<link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>" type="text/css" media="screen" />

Y cámbialo por algo como esto:

<?php if ( is_category('5') ) { // Carga un específico CSS para la categoría "coches" ?>
  <link rel="stylesheet" href="<?php bloginfo('template_url'); ?>/category-5.css" type="text/css" media="screen" />;
<?php } else { ?>
   <link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>" type="text/css" media="screen" />
<?php } ?>

Nota: La plantilla coches, utiliza el archivo  category-5.css para pasar por encima del ‘layout’ por defecto. En este ejemplo el archivo css se ha llamado cómo la plantilla de la categoría a la que se va a aplicar. Así sabemos que category-5.css va con  category-5.php.

Un formato diferente para la plantilla indivisual

Cuando estamos viendo una entrada individual (o permalink), WordPress utilizará, si existe el archivo  single.php.

Esta parte, que viene del archivo single.php de la plantilla ‘default’ de WordPress, nos da la información del post (post meta data information) que estamos viendo:

<p class="postmetadata alt">
<small>
This entry was posted on <?php the_time('l, F jS, Y') ?> at <?php the_time() ?>
and is filed under <?php the_category(', ') ?>.
You can follow any responses to this entry through
the <?php comments_rss_link('RSS 2.0'); ?> feed.
<?php
if (('open' == $post->comment_status) && ('open' == $post->ping_status)) {
// Both Comments and Pings are open
?>
  You can <a href="#respond">leave a response</a>, or
  <a href="<?php trackback_url(display); ?>">trackback</a>
from your own site.
<?php
} elseif (!('open' == $post->comment_status) && ('open' == $post->ping_status)) {
// Only Pings are Open
?>
  Responses are currently closed, but you can
  <a href="<?php trackback_url(display); ?> ">trackback</a>
from your own site.
<?php
} elseif (('open' == $post->comment_status) && !('open' == $post->ping_status)) {
// Comments are open, Pings are not
?>
  You can skip to the end and leave a response. Pinging is currently not allowed.
<?php
} elseif (!('open' == $post->comment_status) && !('open' == $post->ping_status)) {
// Neither Comments, nor Pings are open
?>
  Both comments and pings are currently closed.
<?php
}
edit_post_link('Edit this entry.','',''); ?>
</small>
</p>

Este tipo de información (estén abiertos o no los comentarios) no tiene sentido en las vistas de la página principal, el archivo cronológico o las páginas de categoría y por eso se incluye sólo en el archivo de plantilla para posts indidividuales single.php.

Otros trucos que se pueden hacer con El Bucle

Ahora que ya tenemos una buena introducción a los usos básicos del Bucle, vamos a ver otros efectos y trucos que se pueden conseguir.

Página principal estática

Mostrar  algo específico sólo para la página princpal del blog que sólo se vea en la home y en ninguna otra parte del blog es fácil de hacer, se llama página principal estática. La página principal no es estática, simplemente utiliza el bucle para parecerlo.

Para conseguirlo, utilizamos la etiqueta de plantilla condicional is_home().

En nuestro  index.php, utilizamos una condición if () para mostrar contenido adicional:

<?php get_header(); ?>
<?php if (is_home()) {
 // we're on the home page, so let's show a picture of our new kitten!
 echo "<img src='/images/new_kitty.jpg' alt='Our new cat, Rufus!' />";
 // and now back to our regularly scheduled home page
} ?> 

La función is_home() sólo dará un valor true si el visitante no está pidiendo una entrada, categoría, página o fecha específicos por lo que muestra sólo la página principal.

Para más información ver Creación de una página de inicio estática.

Sólo extractos

La manera más fácil de mostrar sólo estractos, en lugar del contenido entero de los posts, es sustuir todos los the_content() por the_excerpt(). Si no hemos creado los extractos explícitamente pra nuestros posts, esta función mostrará automáticamente las primeras 120 palabras del post.

<div class="entry">
<?php the_excerpt(); ?>
</div>

Mostrar extractos o todo el contenido dependiendo del número de posts

En algunas circunstancias, por ejemplo en páginas con vistas de archivo cronológico, podemos querrer mostrar el post completo si sólo hay uno y extractos si hay más de uno. Se puede personalizar el bucle para lograrlo.

<?php if (have_posts()) : ?>

  <?php if (($wp_query->post_count) > 1) : ?>
     <?php while (have_posts()) : the_post(); ?>
       <!-- Aquí poner encabezamiento del post en caso de extractos-->
          <?php the_excerpt() ?>
       <!-- Poner el pie del post en caso de extractos -->
     <?php endwhile; ?>

  <?php else : ?>

     <?php while (have_posts()) : the_post(); ?>
       <!-- Do your post header stuff here for single post-->
          <?php the_content() ?>
       <!-- Do your post footer stuff here for single post-->
     <?php endwhile; ?>

  <?php endif; ?>

<?php else : ?>
     <!-- Stuff to do if there are no posts-->

<?php endif; ?>

Encabezados/menús laterales y pies de página diferenciados

WordPress tiene las etiquetas para incluir ( Include Tags)  the get_header(), get_sidebar(), and get_footer() y usarlos en nuestros  archivos de plantilla. Estas funciones facilitan la definición de encabezados/menus laterales/pies de página estándar que son fáciles de editar. Cualquier cambio hecho en estos archivos será inmediatamente visible a los usuarios.

Pero a veces no quieres un menú lateral, en ese caso simplemente quitaríamos la llamada get_sidebar() de nuestra plantilla. Por eujemplo, la plantilla  the single.php del tema por defecto de WordPress no incluye un menú lateral.

Para crear un menú lateral personalizado tenemos 2 opciones:

1. Incluir los contenidos del sidebar directamente en la plantilla en la que estemos trabajando. Si queremos que la categoría 3 tenga un menú distinto, podemos editar category-3.php y añadirle el  HTML y PHP que sea necesario para incluir nuestro menú diferenciado.
2. Utilizar una función include de  PHP, pra incluir otro archivo.  La función  get_sidebar() de WordPress  sólo carga sidebar.php. Si creamos un archivo y lo llamamos sideleft.php (por ejemplo), lo incluiríamos así:

<?php include(TEMPLATEPATH . '/sideleft.php'); ?>

Utilizando la Jerarquía de plantillas de wordpress, si quieres utilizar los mismos elementos en diferentes plantillas, suele ser mejor poner esos elementos en diferentes archivos y luego utilizar la función include() de PHP. En cambio si el elemento que estamos añadiendo es específico para un sólo archivo, lo mejor es añadírselo directamente a ese archivo.

Resumen

Hemos visto solo MUY superficialmente cómo se utiliza el bucle de wordpress. Los siguientes recursos nos ayudarán a personalizar nuestro propio WordPress Loop.

• Template Files (Archivos de plantilla)
• Template Tags (Etiquetas de Plantilla)
• Template Hierarchy (jerarquía de plantillas)
• Conditional Tags (Etiquetas condicionales)

Otros recursos

• The Ultimate Guide to the WordPress Loop
• WordPress Triple Loop Tutorial
• Multiple Loops with Multiple Columns
• Super Loop: Exclude Categories and Limit Number of Posts
• Easily Adaptable WordPress Loop Templates: Basic Loops, Mullet Loops, and More
• Horizontally Sequenced Display Order for WordPress Posts in Two Columns

====

Las plantillas son los ladrillos con los que se construye un sitio web hecho con wordpress. Encajan como las piezas de un puzle para ir formando las páginas que forman el sitio. Algunas plantillas (el encabezado y el pie, por ejemplo) se usan en todas las páginas mientras que otras sólo se utilizan en condiciones específicas. Una página  tradicional consta normalmente de dos archivos:

• El documento XHTML que contiene la estructura y el contenido de la página.
• Una hoja de estilo CSS que se ocupa de la presentación (apariencia) de la página.

En WordPress, ambos documentos están presentes, pero los generan varias plantillas que trabajan detrás de la escena. genera “detrás del escenario”. Los archivos de plantilla y la hoja de  estilo se guardan juntos cómo un  Tema de WordPress. Para aprender más sobre desarrollo de temas de wordpress, hay que consultar la documentación de  Desarrollo de plantillas.

La estructura de una página de wordpress

Una página de wp sencilla se construye con 3 bloques: Encabezado (header), contenido (content) y footer (pie). Cada uno de estos bloques lo genera un archivo de plantilla distinto del tema de wordpress que estemos utilizando.

• El encabezado (header) contiene toda la información que tiene que estar en la parte superior de la del página (dentro de las etiquetas <head>, de un documento HTML) como son las etiquetas <doctype>, <meta> y los enlaces a las hojas de estilo. También incluye la etiqueta de apertura del “cuerpo del documento”<body> y la parte visible del encabezamiento (que normalmente incluye el nombre del sitio, quizá los menús de navegación, un logo, la descripción del sitio, etc…).

• El contenido (content) contiene los posts y las páginas del blog, la “chicha” de la página.

• El pie (footer) contiene la información que normalmente va abajo del todo del documento, como enlaces a otras páginas, o las categorías del sitio en un menú de navegación, información sobre copyright, forma de contacto y otros detalles.

Archivos de plantilla básicos

Para generar esta estructura en un  Tema de WordPress, se empieza con un archivo de plantilla llamado  index.php en el directorio de nuestro Tema. Este archivo tiene dos funciones principales:

• Incluir o “llamar” a otros archivos de plantilla
• Incluir el Bucle de wordpress (WordPress Loop) para requerir la información que está en la base de datos (posts, páginas, categorías, etc…).

Para nuestra simple estructura, sólo necesitamos otros 2 archivos de plantilla: La de encabezamiento (header) y la de pie de página (footer). Estos dos archivos de plantilla tienen que llamarse obligatoriamente header.php y footer.php. Las etiquetas de plantilla (Template Tags) que los incluyen, tienen este aspecto:

<?php get_header(); ?>

<?php get_footer(); ?>

Para poder mostrar los posts y las páginas del blog (y personalizar su apariencia), el archivo index.php tiene que ejecutar el bucle de wordpress (WordPress Loop) entre las llamadas al encabezamiento y al pie de página.

La forma en que el sitio presenta el encabezamiento, cuerpo y pie del documento depende de la plantilla o tema que se esté utilizando en el sitio.

Estructuras más complejas

Muchos temas de WordPress incluyen uno o varios “barras laterales” (sidebars) que contienen las características de navegación y más información sobre el sito. Esta barra lateral se genera con el archivo llamado sidebar.php. Se incluye en el archivo index.php con la  etiqueta de plantilla:

<?php get_sidebar(); ?>

¿Dónde está el truco?

Cómo se puede observar no se ha incluido ninguna etiqueta para “traer” el contenido de la página. Eso es porque el contenido lo genera el bucle de wordpress ( WordPress Loop), dentro de index.php.

Además, la hoja de estilo del tema controla la apariencia y ubicación del encabezamiento, pie, barra lateral y contenido en la pantalla del usuario. Para más información sobre cómo modificar la apariencia de los temas de wordpress y páginas web consultar Blog Design and Layout….

Archivos de plantilla dentro de otros

Hemos visto cómo incluye WordPress los archivos de plantilla estandar  (header, footer, y sidebar) dentro de index.php. También se pueden incluir otros archivos de plantilla dentro de nuestros archivos de plantilla (valga la redundancia).

Por ejemplo,  sidebar.php puede contener un archivo de plantilla que genere un formulario de búsqueda — searchform.php. Cómo este no es uno de los archivos de plantillas estandar de WordPress, el código para incluirlo es un poco distinto:

<?php include (TEMPLATEPATH . '/searchform.php'); ?>

En lugar de usar una etiqueta de plantilla de wordpress para incluir el archivo, utilizaremos un include de php (PHP command include), que necesita saber dónde está el archivo a incluir (TEMPLATEPATH es una variable especial de WordPress que apunta al directorio de los archivos de plantilla del tema).

La mayoría de los temas de WordPress incluyen varios archivos de plantilla dentro de otras plantillas para generar las páginas del sitio. Una estructura típica del archivo principal (index.php) de un sitio WordPress sería:

• header.php (encabezamiento)
  • theloop.php (contenido)
  • wp-comments.php (comentarios)
• sidebar.php (barra lateral)
  • searchform.php (formulario de búsqueda)
• footer.php (pie de página)

Sin embargo, esta estructura se puede cambiar. Por ejemplo, podemos poner el formulario de búsqueda en el encabezamiento o puede que nuestro diseño no necesite un pie de página, por lo que podríamos no incluirlo en nuestro archivo.

Archivos de plantilla especiales

WordPress tiene dos formas principales de mostrar las páginas de un sitio  WordPress. La vista individual se utiliza para mostrar páginas con una sola entrada (post).  La vista multi-post lista varias entradas (o resúmenes de entradas) y se aplica a los archivos de categoría, cronológicos, por autor.. y normalmente a la vista de la página principal. Se puede usar el archivo index.php para generar todos estos tipos de páginas o apoyarse en la jerarquía de plantillas (template hierarchy) de WordPress para elegir los diferentes archivos de plantilla dependiendo de la situación.

La Jerarquía de plantillas de WordPress da respuesta a la siguiente pregunta:

¿Qué archivo de plantilla va a utilizar WordPress al mostrar una determinada página?

WordPress reconoce automáticamente los archivos de plantilla con nombres estandar y los usa para ciertas páginas.  Por ejemplo, cuando un usuario pulsa sobre el título de una entrada, WordPress sabe automáticamente que quieren ver sólo ese artículo en su propia página. Lat Jerarquía de las plantillas utilizará el archivo  single.php en lugar de index.php para generar la página — si el tema tiene un archivo single.php. De igual manera, si el usuario pulsa sobre un enlace de una categoría en particular, WordPress usará  the category.php si existe; si no, buscará archive.php, y si tampoco existe , WordPress utilizará la plantilla.php. Se puede incluso hacer plantillas especiales para determinadas categorías (ver Category Templates para más información).

Consejos sobre los archivos de plantilla

Unos consejos útiles a la hora de crear archivos de plantilla para wordpress:

1. Seguir la pista a la apertura y cierre de etiquetas

Los archivos de plantilla utilizan etiquetas XHTML y referencias CSS references. Tanto los elementos HTML cómo las referencias CSS pueden  ‘cruzar archivos’ empezando en uno y terminando en otro. Por ejemplo, Los etiquetas <html> y <body> normalmente empiezan en header.php y terminan en  footer.php. La mayoría de los temas de WordPress utilizan  div, que también pueden acaparar varios archivos. Por ejemplo el div principal del contenido de la página puede empezar en header.php y terminar en index.php o en single.php. Seguir la pista de las dónde empiezan y terminas las etiquetas html puede llegar a complicarse bastante si estás desarrollado, diseñando o modificando un tema. Una buena idea es utilizar comentarios en las plantillas para dejar constancia de dónde se abren y se cierran los tags para no despistarnos, y así distinguir qué DIV es cual al final de las diferentes secciones.

1. Prueba los archivos de plantilla utilizando diferentes vistas posibles: If you have made changes to the comments, sidebar, search form, or any other template file, make sure you test them using different web page views (single post, different types of archives, and pages).
2. Comenta cuando te apartes de la norma: Si estás diseñando Temas para liberarlos públicamente, ten en cuenta que las personas que se lo bajen probablemente querrán modificar alguna cosa para adaptarlo a sus necesidades. Resulta muy útil si añades notas y comentarios cuando te apartas de la lógica normal de los Temas Clásico de WordPress. También es buena idea añadir comentarios a la hoja de estilo si vas a poner estilos en otros archivos (por ejemplo en header.php).
3. Cierra la puerta detrás de ti: Si empiezas una etiqueta html o div en un archivo de plantilla, asegúrate de que incluyes la etiqueta de cierre en otro/s. En el foro de  WordPress Forum hay muchísimas preguntas sobre “Qué le ha pasado a mi plantilla” cuando alguien trata de quitar el pie de página sin cerrar las etiquetas que empezaron el en archivo de encabezamiento. Haz un seguimietno de tus etiquetas y asegúrate de que las has cerrado.  Una forma de asegurarse de haber cerrado las etiquetas correctamente es someter la página a un  HTML validator).
4. Estilos CSS Styles en la plantilla: Se puede usar cualquier etiqueta de HTML o estilo de CSS en las plantillas, sin embargo, se recomenda utilizar la estructura estandar de la estructura de WordPress (ver Site Architecture 1.5). Esto hará que nuestras plantillas sean más comprensibles para los demás

Recursos de plantillas de archivo

Para ver una lista completa de recursos relacionados con archivos de plantilla, consultar Templates. También es conveniente echarle un vistazo a otros artículos en  Category:Templates y Category:Template Tags.

Más información

Así que me voy a importar aquí el manual de html y el de php que necesito un repaso. Sí están algo obsoletos pero para aprender y volver a entender de qué me están hablando supongo que me valdrá.

Así que de aquí a nada veréis aparecer por aquí los artículos como churros. Además así aparto la cabeza un rato de los roles de wordpress que me voy a volver loca.

El Blog A da nivel de suscriptor a todo nuevo usuario

El Blog B da nivel de autor a todo nuevo usuario

• admin tiene el mismo estatus en ambos blogs, es el ‘heredado’
• El usuario Alfa se ha registrado en el Blog A
• El usuario Beta se ha registrado en el Blog B

Usuarios registrados en el Blog A intentan loguearse en el blog B

El Usuario Alfa se ha registrado, logueado y cambiado su contraseña en el blog A sin problemas.

El Usuario Alfa   no puede loguearse en el blog B. Resultado: Página en blanco con el siguiente mensaje de error: “No tienes autorización para acceder a esta página”

Problema: El Usuario Alfa no tiene asignado ningún rol en el Blog B y por lo tanto no puede “ver” el back-end de wp.

Usuarios registrados en el Blog B intentan loguearse en el blog A

El Usuario Beta  se ha registrado, logueado y cambiado su contraseña en el blog B  sin problemas.

El Usuario Beta  no puede loguearse en el blog A. Resultado: Página en blanco con el siguiente mensaje de error: “No tienes autorización para acceder a esta página”

Problema: El Usuario Beta no tiene asignado ningún rol en el Blog A y por lo tanto no puede “ver” el back-end de wp.

Cambiando el rol por defecto de ambos blogs para que sea el mismo en ambos, el resultado es el mismo. El usuario, aunque consta como usuario en el blog en el que no se registró, no tiene asignado ningún rol y por tanto no puede acceder al panel de control.

mmm no sé por qué me da que esto va a pasar por modificar el registro.  Y luego queda el tema de mantener las sesiones entre uno y otro, lo que parece que tampoco está muy claro.

¿Por qué me meteré yo en estos líos?

Muy bien, en wordpress support he visto que que que hacer un cambio en wp_includes/wp-capabilities.php

Aunque tiene dos problemas:

• Mucho me temo que con esto los usuarios de los distintos blogs tendrán todos el mismo rol, que no es lo que queremos.
• Supone tocar el código fuente de wordpress, lo que luego nos puede dar por saco con los plugins especialmente con los de roles que vamos a necesitar.

Hecho el cambio en el blog B ha pasado he registrado al Usuario Omega a través del Blog B

Lo que ha ocurrido es que el el usuario Omega tiene categoría de Autor en el Blog B pero no tiene ningún rol asignado en el blog A: es decir estamos exactamente igual que antes. Seguiremos investigando

Según Ayuda WordPress, está chupado. Los pasos 1 y 2 ya están hechos: tengo dos wordpress 2.6.3 reciénd instalados instalados en el mismo servidor y compartiendo la misma base de datos.

El paso que me falla es el tercero: añadir al wp-config.php las dos líneas que personalizan las tablas de usuarios y de metadatos de los usuarios:

define(‘CUSTOM_USER_TABLE’, ‘wp_users’);
define(‘CUSTOM_USER_META_TABLE’, ‘wp_usermeta’);

¿Cual es el problema? Que en ninguna de mis pruebas he añadido la segunda línea:

define(‘CUSTOM_USER_META_TABLE’, ‘wp_usermeta’)

Así que voy a hacer otra prueba:

Para empezar he cambiado las contraseñas para que me sea más fácil loguearme y desloguearme, ya las volveré a cambiar después. Los admins de ambos blogs por tanto comparten el nombre de usuarios ‘admin’ pero tienen cada uno su contraseña.

Las tablas del primer blog tienen el sufijo wp_ y las del segundo CL_

Añadidas las dos líneas en cuestión. En el blog principal no tengo problemas, en el dependiente si utilizo la contraseña del blog A me dice que no tengo autorización para acceder a esta páginas. Me temo que me toca preguntar.

Solucionado. El problema era que no basta con modificar wp-config.php sobre un blog B ya instalado. Sino que es necesario hacer una nueva instalación del blog B con las líneas de las tablas personalizadas ya modificadas. Así que si quieres Unir dos blogs ya funcionando, habría que instalar un nuevo blog, importar las entradas, comentarios y enlaces del que quieres unir. Y lo que no sé es si luego vas y cambias de carpeta el  Blog B la cosa seguirá funcionado, es posible que se vaya todo al carajo pero no pienso probarlo.