Codex

pt-br:Shortcode Gallery

O recurso de Galeria permite a opção de adicionar uma galeria de imagens de um postagem ou página do seu blog, basta inserir o shortcode [gallery] diretamente no texto de sua postagem ou página.

Uso

Pode ser usado em sua forma mais simples como esta:

 [gallery]

Existem várias opções que podem ser especificados usando a sintaxe:

[gallery option1="value1" option2="value2"]

Você também pode mostrar uma galeria diretamente em um modelo assim:

 <?php echo do_shortcode('[gallery option1="value1"]'); ?>

Isso funciona também:

 <?php
    $gallery_shortcode = '[gallery id="' . intval( $post->post_parent ) . '"]';
    print apply_filters( 'the_content', $gallery_shortcode );
 ?>

Nota: O código deve ser inserido [gallery], não deve ser traduzido!

Opções

As opções seguintes são suportados:

columns
especifica o número de colunas. A galeria irá incluir uma tag de quebra no final de cada linha e calcular a largura da coluna conforme o caso. O valor padrão é 3. Se colunas é definido como 0, nenhuma quebra de linha será incluída. Por exemplo, para exibir uma galeria com 4 colunas:
[gallery columns="4"]
id
especifica o ID da postagem. A galeria irá mostrar imagens que estão ligadas a essa postagem. O comportamento padrão se nenhum ID é especificado, é para mostrar as imagens anexadas a postagem atual. Por exemplo, para exibir as imagens anexadas a postagem 123:
[gallery id="123"]
size
especificar o tamanho da imagem a ser usada para a exibição de miniaturas. Os valores válidos são thumbnail (miniatura) , medium (médio), large (grande) e full (total). O padrão é thumbnail. O tamanho das imagens para "miniatura", "médio" e "grandes " podem ser configurados no painel de administração do WordPress em Configurações > Mídia. Por exemplo, para exibir uma galeria de imagens de média dimensão:
[gallery size="medium"]

Opções avançadas

orderby 
especifica a ordem para mostrar as miniaturas. O padrão é "menu_order ASC, ID ASC". "RAND" (aleatório) também é suportado.
itemtag 
nome da tag XHTML usada para envolver cada item da galeria. O padrão é "dl".
icontag 
o nome da tag XHTML usada para envolver cada ícone de miniatura na galeria. O padrão é "dt".
captiontag
o nome da tag XHTML usada para envolver cada legenda. O padrão é "dd". Por exemplo, para alterar a marcação usada na galeria para usar tags span div, p etc
link
você pode configurar o link apontar para o "arquivo" para cada imagem um link para o arquivo de imagem. O padrão é um link permanente para o anexo.
include
IDs de anexo separados por vírgula, [gallery include="23,39,45"] irá mostrar apenas as imagens destes anexos.
exclude
IDs de anexo separados por vírgula, [gallery exclude="21,32,43"] exclui as imagens desses anexos. Por favor note que include e exclude não podem ser usados juntos.
[gallery itemtag="div" icontag="span" captiontag="p" link="file"]
WordPress Brasil
Artigos sobre o WordPress em Português-Brasil.
Todas as comunidades lusófonas também são bem-vindas! Adicione {{Codex-pt}} em seus artigos.