Como o portal integra
<script src="https://eleicoes.exemplo.com.br/eleicoes.js" data-uf="SP" defer></script>
Uma linha, colada onde o widget deve aparecer. Não precisa de
<div>: a tag cria o espaço dela sozinha. Nem de
data-api: o endereço vem de onde o próprio arquivo foi
servido. data-uf define a região padrão — o portal já sabe a
cidade dele, então não é preciso geolocalizar por IP.
Para montar a linha vendo o resultado: /instalar no servidor.
No WordPress, o plugin de um arquivo aceita [eleicoes uf="SP"].
Chegar direto no candidato
Quem vem do Google buscando o nome de um candidato deve cair na ficha dele, não no menu. O widget lê a URL:
portal.com.br/eleicoes?candidato=fernando-haddad-250002549705 portal.com.br/eleicoes#candidato=fernando-haddad-250002549705 <div data-eleicoes data-candidato="fernando-haddad-250002549705"></div>
O que identifica é o SQ_CANDIDATO no fim; o nome está ali
para o link ser legível. Abrir um perfil dentro do widget publica o
link na barra de endereço, e o botão voltar do navegador fecha o
perfil. Isto não indexa o portal — para busca orgânica o HTML
precisa vir do servidor; resolve a chegada de quem já clicou.
A casa do parceiro
O widget não tem marca própria. Logo, textos e cor saem de atributos — é o que está aplicado no exemplo acima:
<div data-eleicoes
data-logo="/img/diario-do-rio.png"
data-logo-fundo="escuro"
data-titulo="Eleições 2026"
data-subtitulo="Cobertura do Diário do Rio"
data-cor="#ce2027"
data-cor-topo="#12111a"
data-creditos="Diário do Rio"
data-creditos-url="https://diariodorio.com"></div>
O fundo continua sendo o da página — data-cor muda só a cor
de destaque, e o contraste do texto sobre ela é recalculado. Quem
preferir mandar em tudo ainda pode escrever as custom properties
direto:
[data-eleicoes] {
--eleicoes-primary: #10233f;
--eleicoes-radius: 4px;
}