Nota: el código a continuación ha sido probado bajo WordPress 2.7. Debería funcionar también en WordPress 2.5 o superior, aunque no me hago responsable de los resultados.

Paso 1: Configurar el tamaño de las miniaturas

Antes que nada, tendremos que pensar cuáles serán los tamaños que necesitaremos para nuestras miniaturas. WordPress genera 3 tamaños distintos de miniaturas, además de conservar el tamaño original. Para el que no sepa dónde se cambian, está en Opciones » Objetos (vaya nombre tan poco intuitivo). Yo puse los mismos valores que venían especificados en mi theme Arthemia 2.

Paso 2: Insertando el código final en el theme

Lo bueno que tiene dejar de utilizar timthumb.php es que ya no se llamará más a este script cada vez que queramos cargar una miniatura. Vale que tiene un sistema de cachés y es bastante efectivo, pero el approach de los chicos de WordPress es mucho más eficiente: subes una imagen y se almacenan las miniaturas en 3 tamaños diferentes, para siempre. Esto hace las cosas mucho más sencillas y no hay que procesar un PHP entre medias, libera recursos de CPU, RAM y se reduce el tiempo de carga. Todos ganan (menos Tim :-D). El código final es este (los comentarios están en inglés por si alguien llega hasta aquí y no entiende español):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

<?php
    $image = null; // Clear the value from the previous post
    // Get all attachments from the post ID with type image
    $attachments =& get_children(array('post_parent'=>get_the_ID(),'post_type'=>'attachment','post_mime_type'=>'image'));
 
    // If attachments are found...
    if ($attachments == TRUE) {
        // ... go through all of them
        foreach($attachments as $att) {
            // Get the image source for every image attachment found
            // Post_ID, Size ('thumbnail', 'medium', 'large', 'full' or an Array), Icon (true/false)
            $image = wp_get_attachment_image_src($att->ID,'thumbnail',false);
            break; // Comment this line to get all images inside the post
        }
    }
 
    echo '<!-- Attachment_ID='.$att_id.'-->'; // Comment this line if everything works OK (used for debugging)
 
    if (isset($image)) {
?>
    <a href="<?php the_permalink() ?>" rel="bookmark" title="Enlace permanente a <?php the_title(); ?>">
    <img src="<?php echo $image[0] ?>" alt="<?php the_title(); ?>" class="left" width="<?php echo $image[1]; ?>" height="<?php echo $image[2]; ?>" /></a>
    <?php } ?>

Paso 3: Vamos por partes (para amateurs)

1
2
3
4

<?php
    $image = null; // Clear the value from the previous post
    // Get all attachments from the post ID with type image
    $attachments =& get_children(array('post_parent'=>get_the_ID(),'post_type'=>'attachment','post_mime_type'=>'image'));

Lo primero que hacemos es abrir una etiqueta php allí donde queramos mostrar la miniatura, siempre dentro de El Bucle (The Loop). Con $image = null; vaciamos esta variable por si contiene valores de la iteración (post) anterior. Si no lo hacemos, la minuatura podría repetirse en una entrada que vaya después y a la que no le hayamos adjuntado ninguna imagen. Por último, utilizamos la función get_children() que hemos visto antes pasándole como parámetros el número del post actual, y los filtro para que sólo nos devuelva los adjuntos y dentro de éstos, las imágenes. El resultado de esta operación se almacena en la variable $attachments.

6
7
8
9
10
11
12
13
14
15

    // If attachments are found...
    if ($attachments == TRUE) {
        // ... go through all of them
        foreach($attachments as $att) {
            // Get the image source for every image attachment found
            // Post_ID, Size ('thumbnail', 'medium', 'large', 'full' or an Array), Icon (true/false)
            $image = wp_get_attachment_image_src($att->ID,'thumbnail',false);
            break; // Comment this line to get all images inside the post
        }
    }

Comprobamos si al hacer la petición a get_children() hemos recibido algún resultado, y en caso afirmativo, recorremos cada uno de los adjuntos con la sentencia foreach, y pedimos con wp_get_attachment_image_src() que nos almacene en $image los datos que necesitamos (URL, ancho y alto) para la miniatura de tamaño thumbnail (por ejemplo). Para ello, le hemos especificado tambien el identificador de adjunto que usa internamente WordPress con $att->ID y que no queremos incluir un icono en la imagen con el tercer parámetro false. Como en mi caso yo sólo quiero la primera imagen que tenga incluída en mis entradas -podría tener varias-, he colocado un break; (salto) para que se detenga al obtener la miniatura de la primera imagen.

17
18
19
20

    echo '<!-- Attachment_ID='.$att_id.'-->'; // Comment this line if everything works OK (used for debugging)
 
    if (isset($image)) {
?>

La línea 17 simplemente imprime un comentario con el identificador interno de la imagen que ha obtenido de nuestro post. Para poder ver el resultado tendremos que mostrar el código fuente en el navegador. Si todo funciona correctamente, podemos comentar esta línea insertando dos barras // delante del echo. En la línea 19 indicamos que sólo queremos que se ejecute el código que viene a continuación si se ha obtenido una miniatura. Quedaría bastante mal insertar una imagen con una URL rota que no lleva a ninguna parte.

21
22
23

<a href="<?php the_permalink(); ?>" rel="bookmark" title="Enlace permanente a <?php the_title(); ?>">
    <img src="<?php echo $image[0] ?>" alt="<?php the_title(); ?>" class="left" width="<?php echo $image[1]; ?>" height="<?php echo $image[2]; ?>" /></a>
    <?php } ?>

Y por último creamos el código HTML de el enlace al post, con la imagen en su interior. Usamos la función the_permalink() para obtener la URL de la entrada y the_title() para el título. Para finalizar imprimimos la URL de la minuatura con echo $image[0];, el ancho con $image[1] y la altura con $image[2], tal como vimos antes en la documentación del Codex. Y que no se nos olvide cerrar la condición al final con su llave } correspondiente.

Paso 4: Regenerar las miniaturas con los nuevos tamaños

Si habéis cambiado los tamaños de las miniaturas en el paso 1, hay que tener en cuenta que todas las imágenes subidas hasta la fecha fueron escaladas al tamaño que estaba especificado entonces. La solución manual sería eliminar todas las imágenes una por una y volverlas a subir para que WordPress coja los nuevos tamaños. Suerte que está el plugin Regenerate Thumbnails para solucionarnos la papeleta automáticamente por nosotros. Una vez instalado y activado, sólo hay que ir a Herramientas » Regen. Thumbnails y pulsar sobre el botón Regenerate all Thumbnails para establecer todas las miniaturas a los nuevos tamaños. ¿A que no ha sido para tanto? ;-)

Páginas: 1 2