Línguas: Português – Italiano – 日本語 Português do Brasil – Русский – (Adicione seu idioma)

O recurso Galeria permite que você adicione uma ou mais galerias de imagens aos seus posts e páginas usando um simples Shortcode. Desde o WordPress 2.5 até o 3.5, o atalho da galeria era comumente usado em sua forma mais básica:

Seguindo a versão 3.5, os atalhos da galeria incluem os IDs das imagens por padrão. Assim:

É importante notar que este estilo de atalho de galeria não é novo para 3.5, anteriormente podíamos usar o atributo include. Contudo é muito mais fácil de gerar e gerir com o novo Media Workflow introduzido em 3.5.

DVDs de especificação no seu atalho permite que você inclua imagens na sua galeria que não são necessariamente “anexadas” ao seu post – ou seja, não carregadas de dentro do seu post ou página. Essa flexibilidade lhe permite criar e incorporar qualquer número de galerias contendo qualquer número de imagens!

Note: Se você escolher usar apenas a versão “barebones” do atalho em seu post ou página, apenas as imagens que estão “anexadas” a esse post ou página serão exibidas.

Utilização

Existem várias opções que podem ser especificadas usando esta sintaxe:

Você também pode imprimir uma galeria diretamente em um template assim:

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

Isso também funciona:

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

Options

As seguintes opções básicas são suportadas:

ordenar por especificar como ordenar as miniaturas de exibição. O padrão é “menu_order”. Opções:

• menu_order – você pode reordenar as imagens na aba Gallery do pop-up Add Media
• title – ordenar pelo título da imagem na Media Library
• post_date – ordenar por data/hora
• rand – ordenar aleatoriamente
• ID

ordenar por especificar a ordem usada para exibir as miniaturas. ASC ou DESC. Por exemplo, para ordenar por ID, DESC:

colunas especifique o número de colunas. A galeria incluirá uma tag de quebra no final de cada linha, e calculará a largura da coluna conforme apropriado. O valor padrão é 3. Se as colunas forem definidas como 0, nenhuma quebra de linha será incluída. Por exemplo, para exibir uma galeria de 4 colunas:

id especifique o ID do post. A galeria exibirá imagens que estão anexadas àquele post. O comportamento padrão, se nenhum ID for especificado, é exibir as imagens anexadas ao post atual. Por exemplo, para exibir imagens anexadas ao post 123:

size specify the image size to use for the thumbnail display. Os valores válidos incluem “thumbnail”, “medium”, “large”, “full” e qualquer outro tamanho de imagem adicional que foi registrado com add_image_size(). O valor padrão é “thumbnail”. O tamanho das imagens para “thumbnail”, “medium” e “large” pode ser configurado no painel de administração do WordPress em Settings > Media. Por exemplo, para exibir uma galeria de imagens de tamanho médio:

Algumas opções avançadas estão disponíveis:

itemtag o nome da tag XHTML usada para anexar cada item na galeria. O padrão é “dl”. iconetag o nome da tag XHTML usada para anexar cada ícone em miniatura na galeria. O padrão é “dt”. captiontag o nome da tag XHTML usada para anexar cada legenda. O padrão é “dd”. Por exemplo, para alterar a marcação da galeria para usar as tags div, span e p:

link Especifique onde você quer que a imagem seja ligada. O valor padrão liga ao permalink do anexo. Opções:

• file – Link diretamente ao arquivo de imagem
• none – No link

incluir IDs de anexos separados por vírgula para mostrar apenas as imagens destes anexos.

excluir IDs de anexos separados por vírgulas exclui as imagens destes anexos. Observe que incluir e excluir não pode ser usado em conjunto.

Developers – Coisas a considerar

O comportamento padrão esperado para uma galeria que não tem IDs explícitos declarados é adicionar todas as imagens que têm o post como post parent atribuído. Em outras palavras, adicione todas as imagens que foram carregadas usando o botão “Add media”/link nesta tela de edição de postagem. Tenha em mente que isto também significa que cada anexo adicionado àquele post mais tarde será interpretado para fazer parte da galeria. Não importa se ele foi exibido como anexo simples ou não.

Este deve ser o padrão de erro se nenhum argumento foi fornecido: …lorem ipsum…

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

E pare de usar extract() em shortcode_atts() (ou em qualquer outro lugar). IDEs não são capazes de retroceder que.