Ir para o conteúdo

Os shortcodes nas páginas Avada

Uma parte do que as páginas do site mostram (o calendário, os blocos «Próximos eventos», os contactos do centro…) não está escrita na própria página: é lá inserida por um shortcode. Esta página explica o que é e como se usa.

O que é um shortcode?

Um shortcode é uma palavra-chave entre parênteses retos, colocada no conteúdo de uma página. No site, o visitante nunca vê a palavra-chave: vê o que o plugin põe no seu lugar.

Na página O que o visitante vê
[calendar] o calendário dos eventos
[upcoming id="2222"] um bloco «Próximos eventos», que lista as próximas sessões
[info name="phone"] o número de telefone do centro, clicável
[icon name="tabler:phone"] um ícone de telefone, no meio do texto
[year] o ano corrente, por exemplo no rodapé
[youtube] o logótipo e o nome do YouTube, a vermelho

A vantagem: a informação só é introduzida num único sítio. O número de telefone altera-se em Definições > Geral, e todas as páginas que o mostram através de [info name="phone"] acompanham a mudança sozinhas.

As definições de um shortcode

Alguns shortcodes pedem uma precisão, escrita depois do nome na forma nome="valor": [info name="phone"] mostra o telefone, [info name="address"] a morada.

Copia estas definições exatamente: aspas retas ("), sem espaços à volta do sinal =. O mais seguro é copiar o shortcode no sítio onde o ecrã o propõe. Por exemplo, cada bloco «Próximos eventos» mostra o seu próprio shortcode, pronto a copiar, no campo Shortcode a copiar: basta um clique no campo para o copiar. Para os ícones, é o menu Definições > Ícones.

Onde colocá-los no Avada

No construtor do Avada, um shortcode cola-se num bloco de texto (Text Block), no sítio onde o seu conteúdo deve aparecer. Guarda a página e depois abre-a no site para verificar o resultado: no construtor, muitas vezes só se vê a palavra-chave.

O shortcode aparece por extenso no site?

O nome está provavelmente mal escrito (uma maiúscula, um hífen em vez de um traço de sublinhado): o WordPress não o reconhece e deixa-o tal como está. Copia-o de novo a partir do ecrã que o propõe, ou a partir desta página.

Nomes ingleses e nomes franceses antigos

Os shortcodes do plugin passaram a ter nomes ingleses: [upcoming] chamava-se antes [a_venir], [weekly_timetable] chamava-se [AgendaHebdo]. Os nomes antigos continuam a funcionar, e vão continuar a funcionar: as páginas existentes não têm de ser modificadas.

Para uma nova página, usa o nome inglês, seja qual for a língua do site.

Nome a usar Nome antigo O que mostra
[upcoming id="…"] [a_venir id="…"] um bloco «Próximos eventos» (ver Blocos «Próximos eventos»)
[weekly_timetable] [AgendaHebdo] o horário semanal (ver Horário semanal)
[teachers] [enseignants] a lista dos professores
[teachers_portraits] [enseignants_portraits] os retratos dos professores
[home_image] [ImageAccueil] a imagem de início
[global_element name="…"] [element_global nom="…"] um elemento global (ver Elementos globais)
[info name="…"] [info nom="…"] uma informação geral do centro
[icon name="…"] [icone nom="…"] um ícone (ver Os ícones)
[year] [annee] o ano corrente
[page_name] [NomPage] o título da página
[youtube] (nenhum) o logótipo e o nome do YouTube (ver O logótipo do YouTube)

[calendar] e [youtube] não têm nome antigo.

As informações gerais do centro

O shortcode [info] mostra uma informação introduzida em Definições > Geral. A definição name diz qual:

Shortcode Mostra
[info name="name"] o nome do centro
[info name="address"] a morada
[info name="zip"] o código postal
[info name="city"] a localidade
[info name="access"] o acesso (transportes…)
[info name="maps_link"] a ligação do Google Maps
[info name="phone"] o telefone, clicável num telemóvel
[info name="email"] o endereço de e-mail

Se a informação não estiver preenchida em Definições > Geral, o shortcode não mostra nada.

Os ícones

O shortcode [icon name="…"] insere um ícone no texto de uma página: uma estrela, um telefone, um envelope… O ícone fica com o tamanho e a cor do texto à sua volta.

Não precisas de conhecer os nomes dos ícones: o menu Definições > Ícones apresenta-os todos e fornece o shortcode pronto a colar.

  1. Abre Definições > Ícones.
  2. Na lista das bibliotecas, escolhe de preferência Font Awesome — Solid. Escreve depois uma palavra no campo Procurar um ícone… (em inglês, por exemplo phone ou calendar).
  3. Clica no ícone que te agradar: aparece uma pré-visualização, com o respetivo shortcode no campo Shortcode (clique para copiar).
  4. Clica nesse campo: o shortcode fica copiado.
  5. Cola-o no bloco de texto do Avada, no sítio onde o ícone deve aparecer, depois guarda a página e verifica-a no site.

Os ícones vêm de várias bibliotecas: Font Awesome (Solid, Regular, Brands), Tabler Icons, Lucide, Phosphor, Material Symbols e Bootstrap Icons. O shortcode copiado indica a que escolheste, antes dos dois pontos: [icon name="tabler:star"].

Prefere o Font Awesome — Solid

É a biblioteca a usar em primeiro lugar: é a dos shortcodes antigos, e é a única em que a pesquisa entende palavras-chave. Escrevendo tea, obténs por exemplo uma chávena fumegante (mug-hot), mesmo que a palavra não esteja no nome do ícone.

Se não encontrares mesmo o teu ícone, podes procurar nas outras bibliotecas, mas aí a pesquisa é menos flexível: só incide sobre o nome do ícone (em inglês). Experimenta várias palavras próximas (mug, cup, coffee…).

Os shortcodes de ícone antigos continuam a funcionar

Um shortcode sem biblioteca, como [icon name="star"], continua a mostrar o ícone Font Awesome correspondente: as páginas existentes não têm de ser modificadas. Para uma nova página, copia o shortcode proposto por Definições > Ícones.

A mesma escolha de ícones é proposta noutros sítios, sem passar por um shortcode para colar:

  • na ficha de uma atividade, o campo Ícone da atividade (ver As atividades);
  • no texto de uma imagem de início, o botão Inserir um ícone, que coloca o shortcode no sítio do cursor.

O logótipo do YouTube

O shortcode [youtube] não tem nenhuma definição: mostra o logótipo do YouTube seguido da palavra «YouTube», tudo a vermelho. Serve para designar o YouTube num texto, por exemplo para dizer que uma sessão é transmitida online, sem ter de escrever o nome em texto simples. Cola-o no bloco de texto do Avada, no sítio pretendido. Ver um exemplo: o logótipo no título de um evento.

Os shortcodes dos modelos

Outros shortcodes servem para construir a estrutura do site: cabeçalho ([template_header]), rodapé ([template_footer]), partes das páginas dos eventos ([event_teacher], [event_schedule], [event_registration]…). São colocados pelo webmaster nos modelos de paginação, de uma vez por todas. Normalmente não tens de lhes mexer.

Quando um shortcode não mostra nada

Um shortcode bem escrito pode não mostrar nada:

  • a informação que mostra não está preenchida (uma morada vazia, um bloco «Próximos eventos» sem próximas sessões);
  • o módulo que o fornece não está ativo no teu site (ver Os módulos). O shortcode é então substituído por nada, em vez de aparecer por extenso.

Um bloco «Próximos eventos» com um número errado mostra uma mensagem de erro em vez da lista: copia de novo o seu shortcode a partir do campo Shortcode a copiar do bloco.

Para saber mais