Roman Fink

Como adicionar uma lightbox ao bloco Galeria do WordPress (sem plugin)

O WordPress abre as fotos de uma galeria em ecrã inteiro sem plugin. A lightbox vem integrada e, desde o WordPress 7.0, tem setas para passar de uma foto para a seguinte. Antes do 7.0, era preciso um plugin para isso.

Resposta curta: selecione o bloco Galeria, clique em Ligação na barra de ferramentas do bloco e escolha Ampliar ao clicar. Depois guarde a página. Verifiquei todos os passos no WordPress 7.1.4 com um tema de blocos.

Ativar a lightbox numa galeria

  1. Clique uma vez na galeria, para que fique selecionado o bloco Galeria inteiro e não uma só imagem. O caminho dos blocos no fundo do editor mostra Galeria.
  2. Na barra de ferramentas do bloco, clique em Ligação (o ícone da corrente).
  3. Escolha Ampliar ao clicar.
  4. Guarde a página.

O WordPress ativa a lightbox em todas as imagens dessa galeria de uma só vez. Cada galeria tem a sua própria definição, por isso pode deixar as outras como estão.

O que os visitantes veem

  • A foto abre em grande, por cima da página. O fundo fica com a cor de fundo do tema: branco num estilo claro, escuro num estilo escuro. Para ter um fundo preto atrás das suas fotos, escolha um estilo escuro em Estilos (veja aqui como alterar as cores de um tema de blocos).
  • As setas dos lados levam à foto anterior e à seguinte da mesma galeria. As teclas de seta do teclado também funcionam, e Esc fecha a lightbox.
  • Num telemóvel, as setas passam para a parte de baixo do ecrã.
  • Os leitores de ecrã anunciam «Imagem ampliada 2 de 6» e depois o texto alternativo, por isso todas as fotos precisam de texto alternativo.

As setas precisam do WordPress 7.0 ou mais recente. Na versão 6.x, a lightbox abre uma foto de cada vez. A sua versão aparece em Painel → Actualizações.

Trocar as setas por texto

Selecione outra vez a galeria e abra o separador Opções na barra lateral (o ícone da roda dentada). Em baixo, Tipo de botão de navegação tem três opções: Ícone (a predefinida), Texto ou Ambos. Com Texto, os botões mostram palavras em vez de setas.

Uma só imagem

O bloco Imagem tem a mesma opção. Selecione a imagem, clique em Ligação e escolha Ampliar ao clicar. Uma imagem isolada abre sem setas.

Todas as imagens do site

Uma única definição ativa-a para todas as imagens:

  1. Vá a Apresentação → Editor → Estilos.
  2. Abra Blocos e depois Imagem.
  3. Em baixo, em Opções, ative Ampliar ao clicar. Guarde.

Testei o que isto faz ao conteúdo que já existe. Uma galeria definida como Nenhum também abre na lightbox quando a definição do site está ativa. Uma imagem com ligação para o seu ficheiro mantém a ligação. Esta definição fica em Estilos, por isso precisa de um tema de blocos.

Para programadores de temas: theme.json

Um tema pode definir o valor por omissão no theme.json. enabled ativa a lightbox em todas as imagens. allowEditing com o valor false esconde a opção no editor. O exemplo abaixo ativa a lightbox e mantém a opção.

{
  "version": 3,
  "settings": {
    "blocks": {
      "core/image": {
        "lightbox": {
          "enabled": true,
          "allowEditing": true
        }
      }
    }
  }
}

Com allowEditing desligado, «Ampliar ao clicar» desaparece do menu, mas as galerias que já estavam guardadas com essa opção mantêm a lightbox.

«Ampliar ao clicar» não aparece

  • A imagem já tem uma ligação. Ligar ao ficheiro de imagem, a uma página de anexo ou a qualquer URL substitui a lightbox. Abra o mesmo menu Ligação e escolha antes Ampliar ao clicar.
  • O tema desativou-a. Se allowEditing estiver como false no theme.json do tema, a opção não aparece no menu. Fale com o autor do tema ou mude-a para true no theme.json de um tema filho.
  • Não é o bloco Galeria nativo. As galerias dos construtores de páginas e dos plugins de galeria têm as suas próprias opções. Procure o nome do bloco Galeria no caminho dos blocos, no fundo do editor.
  • Faltam as setas, não a lightbox. Atualize o WordPress para a versão 7.0 ou mais recente.

O que a lightbox integrada não faz

  • Sem legendas. A legenda fica por baixo da miniatura, na página. Na lightbox, só os leitores de ecrã recebem o texto alternativo.
  • Abre o ficheiro em tamanho completo, não uma miniatura. O WordPress reduz para 2560 píxeis as imagens carregadas que forem maiores, por isso é esse o máximo que um visitante recebe. Exporto as fotos de portfólio com 2560 píxeis no lado maior e cerca de 500 KB, para que cada uma abra depressa.
  • Só imagens. Não abre vídeos.
  • Sem opção própria para o fundo. A lightbox usa sempre a cor de fundo do seu estilo.

Se precisar de legendas dentro da lightbox, continua a ser necessário um plugin de galeria com lightbox própria.

Os temas das capturas de ecrã

As capturas de ecrã são do meu Makani Pro. Usa os blocos Galeria e Imagem nativos, tal como o meu tema de portfólio Kanoa e o gratuito Anastasi, para fotos a preto e branco, por isso tudo isto funciona neles. Para mais, veja a minha lista de temas de blocos escuros para um portfólio.

Se preferir não tratar do site por conta própria, posso construí-lo por si.

Roman Fink