Guía rápida

1. Cree una carpeta en su ordenador.
2. Copie las fotografías a la carpeta y redimensiónelas para su visualización en la web. Atención: el nombre de las carpetas y de los archivos puede contener sólo letras, cifras y los caracteres "-", "_" y ".". Debe omitir espacios y caracteres acentuados.
3. Copie el contenido de la carpeta mediante un cliente FTP al directorio "galleries" de su instalación remota de Piwigo.
4. Acceda a su instalación de Piwigo y vaya a Administración » Imágenes » Miniaturas para crear las miniaturas.
5. Vaya a Administración y haga clic en el botón de sincronización.

¡Enhorabuena! Ha creado el primer álbum de la galería.

Organización de directorios y archivos

- Las carpetas que contienen los álbumes se encuentran en el directorio "galleries". A continuación se muestra a modo de ejemplo la arborescencia de una galería de pequeñas dimensiones (pero que proporciona ya una gran funcionalidad):

      .
      |-- admin
      |-- doc
      |-- galleries
      |   |-- album-1
      |   |   |-- album-1.1
      |   |   |   |-- categoría-1.1.1
      |   |   |   |   |-- album-1.1.1.1
      |   |   |   |   |   |-- pwg_high
      |   |   |   |   |   |   +-- mariage.jpg
      |   |   |   |   |   |-- thumbnail
      |   |   |   |   |   |   +-- TN-mariage.jpg
      |   |   |   |   |   +-- mariage.jpg
      |   |   |   |   +-- album-1.1.1.2
      |   |   |   +-- album-1.1.2
      |   |   |-- album-1.2
      |   |   |   |-- pookie.jpg
      |   |   |   +-- thumbnail
      |   |   |       +-- TN-pookie.jpg
      |   |   +-- album-1.3
      |   +-- categoría-2
      |       |-- porcinet.gif
      |       |-- pwg_representative
      |       |   +-- video.jpg
      |       |-- thumbnail
      |       |   +-- TN-porcinet.jpg
      |       +-- video.avi
      |-- include
      |-- install
      |-- language
      |-- template
      +-- tool

- El contenido de un álbum se encuentra en una carpeta ubicada en el directorio "galleries". Cada álbum puede contener, a su vez, tantas sub-carpetas como se desee. En el ejemplo anterior, album-1.1.1.1 está en un nivel de profundidad 4.
- Cada elemento indica un archivo. Un archivo constituye un elemento en Piwigo si su extensión figura en la lista definida por el parámetro de configuración `file_ext` (Ver archivo include/config.inc.php). Un archivo es identificado como de tipo imagen si su extensión figura en la lista definida por el parámetro de configuración `picture_ext`.
- Los elementos de tipo imagen deben tener una miniatura asociada (ver la sección siguiente a propósito de las miniaturas).
- Los elementos de tipo imagen pueden tener asociada una imagen de mayor tamaño, tal como puede observar respecto del archivo mariage.jpg en el ejemplo de arborescencia anterior. El nombre de archivo no requiere prefijo alguno.
- Por defecto, los archivos que no son de tipo imagen (vídeos, sonidos, archivos de texto, cualquier otro tipo de archivo que desee incluir) se representan mediante el icono correspondiente a la extensión del nombre de archivo. Se les puede asociar opcionalmente una miniatura y una imagen de portada (ver el archivo video.avi en el ejemplo).
- Atención: El nombre de un directorio o de un archivo puede contener sólo letras, cifras y los caracteres "-", "_" y ".". Debe omitir espacios y caracteres acentuados.
- Consejo: una carpeta puede contener elementos y sub-carpetas a la vez. Sin embargo, se aconseja discriminar el tipo de contenido según se trate de una carpeta, elementos o sub-carpetas.
- Una vez archivos, miniaturas e imágenes de portada se encuentran correctamente distribuidos en carpetas, ir a Administración » Álbumes » Sincronizar.

Miniaturas

- Como se ha mencionado anteriormente, cada elemento de tipo imagen debe estar asociado a una miniatura.
- Las miniaturas se almacenan en la sub-carpeta "thumbnail", en cada una de las carpetas que contienen un álbum. Una miniatura es un archivo de tipo imagen (con la misma extensión del nombre del archivo), cuyo nombre se asigna según el valor del parámetro de configuración `prefix_thumbnail` ver include/config.inc.php).
- Las miniaturas no necesitan tener la misma extensión que la imagen asociada (una imagen con extensión ".jpg" puede tener una miniatura ".gif", por ejemplo).
- Se aconseja utilizar un programa externo para la creación de las miniaturas; también puede utilizar el programa integrado de creación de miniaturas, pero la calidad dista de ser óptima y ocupa recursos del servidor (lo que podría constituir un problema en caso de hosting compartido).
- Si escoge generar las miniaturas en el servidor mediante el programa integrado, recuerde que debe dar permisos de escritura a las carpetas contenedoras.