Guia prático e passo a passo para autores, investigadores, docentes e editores de conteúdo científico no WordPress.
1. O que é o Zotero WP Cite?
O Zotero WP Cite liga o seu gestor bibliográfico Zotero diretamente ao editor de texto do WordPress. Com ele pode:
- Pesquisar em tempo real pelas suas referências académicas sem sair do artigo;
- Inserir citações no texto com apenas 2 cliques;
- Gerar automaticamente a lista de referências bibliográficas no final do artigo segundo as normas académicas oficiais (APA 7.ª edição, Norma Portuguesa 405, Harvard, Chicago, ABNT, etc.);
- Permitir aos seus leitores consultar caixas de pré-visualização (tooltips), saltar diretamente para a bibliografia, copiar citações e links DOI com 1 clique, e descarregar ficheiros BibTeX / RIS.
2. Passo 1: Obter as Credenciais no Zotero
Para que o WordPress possa aceder à sua biblioteca de referências, precisa de obter duas informações gratuitas no site do Zotero: o seu User ID e uma Chave de API (API Key).
- Aceda a zotero.org e inicie sessão com a sua conta.
- No canto superior direito, clique em Settings (Definições) e depois no separador Feeds/API (ou aceda diretamente a
https://www.zotero.org/settings/keys). - No topo da página verá o seu identificador numérico:
Your userID for use in API calls is XXXXXXX. Guarde este número. - Logo abaixo, clique em Create new private key (Criar nova chave privada):
- Key Description: Escreva um nome para identificar a chave (ex.:
WordPress BlogouMeu Site). - Permissions: Deixe as permissões padrão ativas (Allow library access / Permissão de leitura).
- Key Description: Escreva um nome para identificar a chave (ex.:
- Clique em Save Key.
- Importante: O Zotero mostrará uma sequência de letras e números (a sua Chave de API). Copie-a de imediato, pois por motivos de segurança ela só é apresentada uma vez.
3. Passo 2: Configurar o Plugin no WordPress
Configuração Geral do Site (Administradores)
- No painel de administração do WordPress, vá a Definições > Zotero WP Cite.
- No separador Definições da Conta:
- Chave de API do Zotero: Cole a sua chave privada.
- ID do Utilizador Zotero: Introduza o seu número de User ID.
- No separador Estilo de Citação, selecione a norma pretendida:
- Normas Oficiais Nacionais: Norma Portuguesa 405 (NP 405), Revista Portuguesa de Arqueologia, FPCEUP (Universidade do Porto), ABNT (Brasil).
- Normas Internacionais com Idioma Adaptado: APA 7.ª ed. (Português pt-PT), Harvard (Português), Chicago Autor-Data (Português).
- Normas Internacionais em Inglês: APA 7th (EN), Chicago (EN), Harvard (EN), MLA (EN).
- Estilo Personalizado: Permite introduzir o identificador de qualquer estilo do repositório oficial do Zotero (ex.:
nature,ieee, etc.).
- Clique no botão Testar Ligação. Se os dados estiverem corretos, verá uma confirmação verde com sucesso.
- Clique em Guardar Alterações.
Configuração Pessoal por Autor (Docentes e Investigadores)
Se o site tiver vários autores e cada um quiser usar a sua própria biblioteca pessoal de referências do Zotero:
- Vá a Utilizadores > Perfil.
- Desça até à secção Zotero WP Cite — Credenciais Pessoais.
- Introduza o seu User ID e a sua API Key pessoal e clique em Atualizar Perfil.
- A partir desse momento, todos os artigos escritos por si utilizarão automaticamente a sua biblioteca pessoal.
4. Passo 3: Como Inserir Citações no Editor Gutenberg
O plugin integra a Barra Rápida oficial do Zotero (Quick Format Bar) diretamente nos blocos de texto:
- Ao escrever um parágrafo no Gutenberg, coloque o cursor no sítio exato onde quer inserir a citação.
- Na barra de ferramentas flutuante do parágrafo, clique no ícone de livro Zotero (ou use o atalho de teclado
Ctrl+Alt+Z/Cmd+Alt+Z). - Abrir-se-á a barra de pesquisa rápida:
- Escreva pelo menos 2 letras (do apelido do autor, palavra do título ou ano).
- O plugin pesquisa instantaneamente na sua biblioteca do Zotero e apresenta a lista de resultados com o tipo de documento (Livro, Artigo, Tese, etc.).
- Clique no documento pretendido para o adicionar à barra como uma etiqueta (pill).
- Se pretender citar mais do que uma obra no mesmo parênteses (citação múltipla), continue a escrever e adicione as restantes obras.
- Pressione Enter no teclado ou clique em Inserir Citação.
5. Passo 4: Formatar Citações (Narrativa, Páginas, Fontes Secundárias)
Ao clicar numa etiqueta (pill) da obra na barra rápida, abre-se uma janela de opções refinadas:
1. Adicionar Número de Página ou Localizador
- Escolha o tipo de localizador no menu: Página (padrão), Capítulo, Secção, Parágrafo, Figura, Equação, Tabela, Volume, etc. (27 localizadores disponíveis).
- Escreva o valor (ex.:
12para p. 12, ou15-20para pp. 15–20, ou3para cap. 3).
2. Escolher o Modo de Apresentação
- Entre Parênteses (Padrão): Formata a citação completa entre parênteses, ex.:
(Samara & Tavares, 2008, p. 45). - Narrativa (APA 7th): Integra os autores no fluxo da frase em português, ex.:
Samara e Tavares (2008, p. 45). - Apenas Ano: Oculta o autor e mantém apenas a data, útil quando o nome do autor já foi mencionado na frase, ex.:
(2008, p. 45).
3. Citar Fontes Secundárias («Citado por»)
Se estiver a citar um autor clássico através de um estudo mais recente:
- No campo Autor Original, introduza o autor original (ex.:
Liljedahl). - No campo Ano Original, introduza o ano da obra original (ex.:
2016). - O plugin formata automaticamente a regra formal:
- Narrativa:
Liljedahl (2016) citado por Vale e Barbosa (2020, p. 5) - Parênteses:
(Liljedahl, 2016, citado por Vale & Barbosa, 2020, p. 5)
- Narrativa:
6. Passo 5: Inserir a Lista de Bibliografia Final
- No final do seu artigo, clique no botão + (Adicionar Bloco).
- Procure por Bibliografia Zotero e insira o bloco.
- No editor, o bloco mostrará uma pré-visualização em tempo real de todas as obras citadas no texto, formatadas rigorosamente segundo a norma configurada.
- Nota de conveniência: Se se esquecer de inserir o bloco, o plugin adiciona automaticamente a lista de referências no fim do artigo assim que detetar citações no texto.
7. Passo 6: Funcionalidades Interativas para os Leitores
Quando os leitores visitam o seu artigo publicado, têm acesso a um conjunto de ferramentas:
- Caixas de Pré-visualização (Tooltips): Ao passar o cursor ou focar pelo teclado numa citação no texto, abre-se uma janela com os dados bibliográficos completos da fonte.
- Navegação Suave e Destaque: Ao clicar na citação, o navegador desliza suavemente até à referência exata na bibliografia e destaca-a com um efeito de marcador fluorescente amarelo.
- Botão de Retorno (
↩): Na lista de referências, cada item tem uma seta de retorno que devolve o leitor à frase exata do texto onde estava a ler. - Botão «Copiar Referência»: Permite ao leitor copiar a referência formatada para a sua área de transferência com 1 clique.
- Botão «Copiar DOI»: Copia o link direto e permanente da publicação científica.
- Exportação BibTeX e RIS: Botões de descarga rápida para importar todas as fontes do artigo para o Zotero, Mendeley, EndNote ou LaTeX.
8. Perguntas Frequentes e Resolução de Problemas
1. Adicionei um livro novo ao Zotero, mas ele não aparece na pesquisa do WordPress. O que fazer?
O plugin pesquisa em tempo real na API do Zotero. Certifique-se de que sincronizou a aplicação Zotero no seu computador (clicando no botão verde de sincronização no canto superior direito do Zotero Desktop) para que os dados subam para a nuvem da sua conta.
2. Como funciona a ordenação em citações múltiplas?
Segundo a norma APA 7.ª edição, quando seleciona várias obras para o mesmo parênteses, o plugin ordena-as automaticamente por ordem alfabética do apelido do primeiro autor (ex.: (Antunes, 2019; Barbosa, 2022; Silva, 2024)).
3. O site ficou mais lento por usar o Zotero?
Não. O plugin foi desenhado para máxima velocidade:
- Todas as referências são guardadas numa cache interna ultrarrápida durante 30 dias.
- Ao publicar ou atualizar um artigo, o plugin pré-carrega a bibliografia em segundo plano (Warmup), para que o leitor receba a página de imediato sem esperar pela API do Zotero.
- Em páginas ou artigos que não contenham citações académicas, o plugin não carrega nenhum ficheiro CSS ou JavaScript adicional (0 bytes de impacto).
4. Como limpar a cache de referências?
Se alterou detalhes de uma obra no Zotero e quer forçar a atualização imediata no WordPress:
- Vá a Definições > Zotero WP Cite.
- No cartão Gestão de Cache, clique em Limpar Cache.