|
Descripción
wp-minigallery es un plugin para Wordpress 2.0.x o superior que monta una galería de fotos según una estructura de directorios dada. Digamos que tenemos un directorio (posiblemente con subdirectorios) lleno de fotos. Con este plugin generaremos una vista Thumbnail con la que navegaremos por el árbol y al clicar sobre una foto se generará una vista de foto individual, con posibilidad de seguir navegando hacia la siguiente y anterior foto, y hasta reproducir el directorio actual en una presentación (SlideShow).
Además se agrega una pestaña más dentro de las Opciones de la Administración de Wordpress con la que configuramos varios parámetros de las vistas como los tamaños de los thumbnails y el tiempo de espera del modo presentación, y hasta se muestra un pequeño explorador de archivos mediante el que se pueden crear/eliminar directorios y subir/eliminar fotos.
Funcionamiento en artículos
wp-minigallery se presenta en cualquier artículo o página de Wordpress mediante el uso de unas etiquetas propias que determinarán el funcionamiento inicial de la vista. Hay tres tipos: vista normal, vista de foto y presentación slideshow. Se declaran de la siguiente forma:
- Vista normal: Presentará la vista de thumbnails y permitirá explorar el árbol de directorios dado. Es el funcionamiento básico que lo permite todo. Se pueden clicar las imágenes Thumbnails y arrancar las presentaciones. Se activa escribiendo la ruta hacia la galería encerrada con los siguientes tags en el cuerpo del artículo: {minigallery}/path/to/gallery/{/minigallery}
- Vista de foto: Presentará una foto específica. En este modo se esconde el cuadro de navegación. Se activa escribiendo la ruta hacia la foto encerrada con los siguientes tags en el cuerpo del artículo: {minigallery_photo}/path/to/photo.jpg{/minigallery_photo}
- Presentación SlideShow: Presentará la foto especificada pero pasado un tiempo determinado (por defecto 8 segundos) cambiará a la siguiente foto del mismo directorio. Cuando llegue a la última empezará de nuevo por la primera. En este modo se esconde el cuadro de navegación. Se activa escribiendo el nombre de la primera foto de la presentación (no tiene porqué ser la primera del directorio) del directorio deseado encerrada con los siguientes tags en el cuerpo del artículo: {minigallery_slideshow}/path/to/photo.jpg{/minigallery_slideshow}
- Presentación MiniSlideShow: Idéntico a la Presentación SlideShow pero usando el tamaño de visualización secundario. Se activa escribiendo el nombre de la primera foto de la presentación (no tiene porqué ser la primera del directorio) del directorio deseado encerrada con los siguientes tags en el cuerpo del artículo: {minigallery_minislideshow}/path/to/photo.jpg{/minigallery_minislideshow}
Funcionamiento en Plantillas
Es posible declarar cualquier modo anterior insertando un código PHP en cualquier plantilla, incluso en el sidebar o Barra Lateral. Las siguientes instrucciones llaman a cada modo (recordad que deben ir entre tags PHP!):
- Vista normal: showGallery(’minigallery’,'/path/to/album/’);
- Vista de foto: showGallery(’photo’,'/path/to/photo.jpg’);
- Presentación SlideShow: showGallery(’slideshow’,'/path/to/photo.jpg’);
- Presentación MiniSlideShow: showGallery(’minislideshow’,'/path/to/photo.jpg’);
Requisitos técnicos
wp-minigallery está probado sobre Wordpress 2.0.4 y debería funcionar sobre ése y cualquier Wordpress superior. Al activarlo se agrega a la lista de filtros sobre el texto en la función “the_content” de Wordpress. A nivel interno, wp-minigallery tiene los siguientes requisitos:
- PHP 4 (probado sobre la versión 4.4.4)
- No requiere librerías GD.
- Permisos de escritura en /wp-content/plugins (para guardar la configuración)
- Permisos de escritura en el árbol de directorios de las fotos (en la administración, para crear/eliminar directorios y subir fotos)
- Permisos de escritura en las fotos (en la administración, para eliminar fotos. Las fotos subidas tendrán permiso de escritura por defecto. El resto depende del propietario del archivo)
Instalación
- Descargar el archivo wp-minigallery.phps
- Renombrar a wp-minigallery.php
- Subirlo a tu directorio de plugins de tu Wordpress, normalmente en /wp-content/plugins
- Crear un directorio para las fotos.
- Dar permisos de escritura para el usuario público sobre los directorios definidos anteriormente
- Activarlo desde la pestaña de Plugins de la Administración de Wordpress
- Verificar las opciones en la pestaña Opciones > MiniGallery
Algunas pistas para el buen funcionamiento
- En las opciones de la Administración, el parámetro “Top Images Root Level Dir” se debe revisar bién. Por defecto apuntará a la raíz del sitio (S_SERVER[’DOCUMENT_ROOT’]), pero éso normalmente no es correcto. Debemos introducir la ruta absoluta al directorio de las fotos, empezando por la raíz del servidor.
- Para generar una galería de fotos lo ideal es crear una Página (no una entrada) y colocar ahí un tag {minigallery}
Limitaciones
Las funciones de AJAX apuntan directamente a unos divs de la página. Ésto provoca que sólo pueda haber un objeto en toda la página. Puedes tener una galerias, foto o SlideShows en varios artículos, pero (por ejemplo) en la página inicial de Wordpress, al mostrarse varios artículos, si hay más de una galería visible pueden fallar (viéndose correctamente cuando se visualiza el artículo individualmente).
Por el mismo motivo, no funcionan varios elementos diferentes (por ejemplo un álbum y una presentación) en el mismo artículo si se visualizan en la misma pantalla.
Éste es el primer TODO que hay en la lista
Solucionado!
Bugs conocidos
Si el path contiene espacios en blanco, el refresco automático del explorador de archivos en la Administración que hace el uploader falla dando error de Javascript.
Si el path indicado entre los tags en el contenido del artículo contiene espacios en blanco, la galería no funciona.
- El tratado de los archivos con acentos no funciona. Se recomienda no crear directorios ni subir archivos que contengan acentos.
En Internet Explorer la maquetación CSS falla. En Firefox funciona perfectamente.
ScreenShots

Histórico y Características
- Vesión 1.0 (04/09/2007) [Descargar aquí: wp-minigallery v1.0]
- Versión inicial
- Vista Thumbnails
- Vista Foto Individual
- Modo SlideShow
- Enlaces de navegación en Vista Foto Thumbnail
- Enlace para ver la foto a tamaño completo en nueva ventana
- Maquetación sólo con DIVs y CSS
- Parámetros muy configurables
- Explorador en la administración que permite crear/eliminar directorios y subir/eliminar fotos
- Versión 1.01 (06/09/2007) [Descargar aquí: wp-minigallery v1.01]
- Solución de pequeños bugs relacionados con espacios en blanco
- Versión 1.02 (19/09/2007) [Descargar aquí: wp-minigallery v1.02]
- Solucionado problema de id’s de DIVs: Ya se pueden incrustar varias instancias de la galería en la misma página mostrada.
- Ya se pueden incrustar varias instancias de igual o diferente modo en el mismo artículo.
- Versión 1.03 (25/09/2007) [Descargar aquí: wp-minigallery v1.03]
- Se añade precarga de la siguiente foto en el Modo SlideShow.
- Versión 1.04 (03/10/2007) [Descargar aquí: wp-minigallery v1.04]
- Añadido modo de presentación secundario
- Añadida función para generar un modo de la Galería desde cualquier plantilla.
- Versión 1.05 (28/10/2007) [Descargar aquí: wp-minigallery v1.05]
- Solucionado bug de estilos en Internet Explorer
- Nuevo parámetro en la administración para controlar la calidad de las imágenes generadas.
- Solucionado bug en el modo SlideShow… El programa confundía el tamaño con el SlideShow secundario.
Tags: Fotos, General, PHP, Plugin, Programación, WordPress, wp minigallery |
Escribe un Comentario