Idiomas: English – Italiano – 日本語 Português do Brasil – Русский – (Añade tu idioma)

La función de Galería te permite añadir una o más galerías de imágenes a tus entradas y páginas utilizando un simple Shortcode. Desde WordPress 2.5 y hasta la 3.5, el shortcode de la galería era comúnmente utilizado en su forma más básica:

Desde la versión 3.5, los shortcodes de galerías incluyen los IDs de las imágenes por defecto. Así:

Es importante señalar que este estilo de shortcode de galería no es nuevo en 3.5, antes podíamos utilizar el atributo include. Sin embargo es mucho más fácil de generar y gestionar con el nuevo Media Workflow introducido en 3.5.

Especificar IDs en tu shortcode te permite incluir imágenes en tu galería que no están necesariamente «adjuntas» a tu post – es decir, no subidas desde dentro de tu post o página. Esta flexibilidad le permite crear e incrustar cualquier número de galerías que contengan cualquier número de imágenes!

Nota: Si decide utilizar sólo la versión «barebones» del shortcode en su post o página, sólo se mostrarán las imágenes que están «adjuntas» a ese post o página.

Uso

Hay varias opciones que se pueden especificar utilizando esta sintaxis:

También puede imprimir una galería directamente en una plantilla así:

 <?php echo do_shortcode(''); ?>

Esto también funciona:

 <?php $gallery_shortcode = ''; print apply_filters( 'the_content', $gallery_shortcode ); ?>

Opciones

Se admiten las siguientes opciones básicas:

orderby especificar cómo ordenar las miniaturas de visualización. El valor por defecto es «menu_order». Opciones:

• menu_order – puede reordenar las imágenes en la pestaña Galería de la ventana emergente Añadir medios
• title – ordenar por el título de la imagen en la Biblioteca de medios
• post_date – ordenar por fecha/hora
• rand – ordenar aleatoriamente
• ID

order especificar el orden de clasificación utilizado para mostrar las miniaturas. ASC o DESC. Por ejemplo, para ordenar por ID, DESC:

columnas especifica el número de columnas. La galería incluirá una etiqueta de ruptura al final de cada fila, y calculará el ancho de las columnas según corresponda. El valor por defecto es 3. Si las columnas se ajustan a 0, no se incluirán saltos de fila. Por ejemplo, para mostrar una galería de 4 columnas:

id especifica el ID de la entrada. La galería mostrará las imágenes adjuntas a esa entrada. El comportamiento por defecto, si no se especifica ningún ID, es mostrar las imágenes adjuntas a la entrada actual. Por ejemplo, para mostrar las imágenes adjuntas al post 123:

size especifica el tamaño de la imagen que se utilizará para mostrar las miniaturas. Los valores válidos incluyen «thumbnail», «medium», «large», «full» y cualquier otro tamaño de imagen adicional que se haya registrado con add_image_size(). El valor por defecto es «thumbnail». El tamaño de las imágenes para «thumbnail», «medium» y «large» se puede configurar en el panel de administración de WordPress en Ajustes > Medios. Por ejemplo, para mostrar una galería de imágenes de tamaño medio:

Hay algunas opciones avanzadas:

itemtag el nombre de la etiqueta XHTML utilizada para encerrar cada elemento de la galería. El valor predeterminado es «dl». icontag el nombre de la etiqueta XHTML utilizada para encerrar cada icono de miniatura en la galería. El valor predeterminado es «dt». captiontag el nombre de la etiqueta XHTML utilizada para encerrar cada pie de foto. El valor por defecto es «dd». Por ejemplo, para cambiar el marcado de la galería para utilizar etiquetas div, span y p:

enlace Especifique dónde quiere que se enlace la imagen. El valor por defecto enlaza con el permalink del archivo adjunto. Opciones:

• archivo – Enlaza directamente con el archivo de imagen
• ninguno – Sin enlace

incluir IDs de adjuntos separados por comas para mostrar sólo las imágenes de estos adjuntos.

excluir IDs de archivos adjuntos separados por comas excluye las imágenes de estos archivos adjuntos. Tenga en cuenta que include y exclude no pueden usarse juntos.

Desarrolladores – Cosas a tener en cuenta

El comportamiento esperado por defecto para una galería que no tiene IDs explícitos declarados es añadir todas las imágenes que tienen el post como padre del post asignado. En otras palabras, agrega todas las imágenes que fueron subidas usando el botón/enlace «Add media» en esta pantalla de edición del post. Tenga en cuenta que esto también significa que todos los archivos adjuntos añadidos a ese puesto más tarde será interpretado como parte de la galería. No importa si se muestra como archivo adjunto simple o no.

Esta debería ser la respuesta por defecto si no se proporciona ningún argumento: …lorem ipsum…

$attachments = get_children( array('post_parent' => $attr,'post_status' => 'inherit','post_type' => 'attachment','post_mime_type' => 'image','order' => $attr,'orderby' => $attr,) );

Y deje de usar extract() en shortcode_atts() (o en cualquier otro lugar). Los IDEs no son capaces de rastrear eso.