Seu primeiro widget
Escolha um widget, copie o código de incorporação e personalize-o.
- Abra o catálogo de widgets e escolha a visualização desejada. Use o configurador para selecionar uma equipe, liga, competição ou jogo.
- Entre na conta e selecione um plano de desenvolvedor quando necessário. Copie o código de incorporação finalizado, incluindo o token, a classe do iframe e o script de dimensionamento.
- Cole o código de incorporação em um bloco HTML do seu site. Para uma WebView nativa, use a URL do widget e configure o aplicativo host para permitir vídeo e tela cheia.
- Ajuste apenas as preferências compatíveis com esse widget. Teste em dispositivos móveis e com o mesmo token de conta que será usado em produção.
<iframe id="football-widget"
title="Football scores"
src="https://www.scorebat.com/embed/livescore/?token=YOUR_EMBED_TOKEN"
style="display:block;width:100%;height:760px;border:0"
allow="autoplay; fullscreen"
allowfullscreen>
</iframe>Como funcionam as preferências
Quatro tipos diferentes de configuração, cada um com seu próprio escopo.
| Configuração | Onde deve ficar | Escopo |
|---|---|---|
| Seleção de conteúdo | Caminho da URL de incorporação | Seleciona um widget e a equipe, competição, liga ou jogo correspondente. |
| Preferências do widget | Parâmetro de consulta pref | Um objeto JSON para esta instância do widget. As chaves devem estar exatamente em minúsculas; os valores mantêm seus tipos JSON. |
| Tamanho e aparência do quadro | Atributos do iframe, CSS e script de dimensionamento | Largura, altura, raio da borda, sombra e dimensionamento responsivo devem ser configurados na página hospedeira. |
| Preferências da conta | Configurações de desenvolvedor salvas | As cores e as configurações elegíveis de navegação personalizada são compartilhadas por toda a conta e estão sujeitas ao plano ativo. |
O parâmetro da URL é pref, no singular. Ele contém JSON codificado para URL, não Base64. Use os valores booleanos true e false, não strings como "true". Chaves desconhecidas não são um mecanismo de personalização compatível.
const url = new URL("https://www.scorebat.com/embed/standings/team/chelsea/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
language: "en",
tableview: "nearby",
tableneighbors: 2,
nomaxwidth: true
}));
// URLSearchParams performs the URL encoding once.
const iframe = document.querySelector("#football-widget");
iframe.src = url.toString();Ao editar uma URL existente, interprete o JSON de pref, altere as chaves necessárias e serialize-o novamente. Não concatene JSON sem escape nem codifique pela segunda vez um valor já codificado.
Uma preferência pode ser processada corretamente, mas não ter efeito se o widget selecionado não a utilizar. Cada seção de widget abaixo lista as preferências compatíveis e as exceções importantes.
Encontre o conteúdo certo
Use seleções reais do configurador e mantenha o tipo de entidade.
As rotas de equipes e torneios usam os identificadores gerados pelo configurador. Slugs como chelsea ou england-premier-league são exemplos legíveis; não crie identificadores convertendo o nome de exibição para letras minúsculas. As rotas de partidas exigem um identificador de partida fornecido pelo seletor de partidas ou um matchviewUrl já retornado.
Uma competição identifica uma competição ou fase específica. Uma liga agrupa competições relacionadas. O seletor unificado escolhe o tipo adequado; liga e competição não são intercambiáveis.
O configurador da Copa do Mundo é uma predefinição baseada nos mesmos widgets de liga, barra de placares, painel de vídeos e partidas. Use a seleção do configurador atual, em vez de um alias antigo do torneio.
Dimensionamento responsivo
Use o script auxiliar correspondente ao widget.
<iframe title="Football widget"
class="_scorebatEmbeddedPlayer_"
src="https://www.scorebat.com/embed/team/chelsea/?token=YOUR_EMBED_TOKEN"
allow="autoplay; fullscreen" allowfullscreen
style="display:block;width:100%;height:760px;border:0"></iframe>
<script src="https://www.scorebat.com/embed/embed.js?v=arrv"
id="scorebat-jssdk"></script><iframe title="Football videos"
class="_scorebatEmbeddedPanel_"
src="https://www.scorebat.com/embed/videopanel/?token=YOUR_EMBED_TOKEN"
allow="autoplay; fullscreen" allowfullscreen
style="display:block;width:100%;height:800px;border:0"></iframe>
<script>
window.SCOREBAT_OPTIONS = {
panelClassName: "_scorebatEmbeddedPanel_",
panelSizing: "responsive"
};
</script>
<script src="https://www.scorebat.com/embed/panelx.js?v=f4fksn"
id="scorebat-paneljs"></script>Carregue cada script auxiliar uma única vez por página, depois dos elementos iframe que ele deve gerenciar. Mantenha a classe de iframe correspondente. Em um aplicativo renderizado no cliente, monte os elementos iframe antes de inserir o script auxiliar; não presuma que uma string de script inserida no HTML será executada.
As barras de placares usam uma altura fixa. Para painéis de tamanho fixo ou outras incorporações com altura fixa, omita o dimensionamento automático e defina as dimensões do iframe no CSS. O nomaxwidth interno não redimensiona o iframe.
Cores, acesso e configurações da conta
Mantenha as preferências da instância separadas das configurações salvas.
O configurador salva a cor de fundo na configuração ui.color da conta e a cor da barra de placares em ui.barColor. Ele também pode adicionar um estilo background-color ao iframe. Inserir color ou barColor dentro de pref não define o tema interno do widget.
As cores salvas são aplicadas a toda a conta e exigem o direito de personalização correspondente. Alterá-las pode afetar outras incorporações que usam a mesma conta. A prévia do configurador pode exibir um estilo de demonstração; valide o código exportado com seu token real.
Ocultar um cabeçalho de conteúdo com noheader exige acesso sem anúncios ativo. A remoção da marca é um direito separado. As preferências não podem liberar recursos pagos, remover restrições do plano nem forçar a exibição de conteúdo de IA indisponível.
Contas elegíveis podem configurar URLs de navegação para jogos, equipes, ligas e competições nas configurações da conta. Essas são preferências de links salvas, não chaves pref arbitrárias. Mantenha a navegação padrão do configurador, a menos que você tenha configurado e testado uma integração personalizada.
Os carregamentos de widgets e players sem anúncios compartilham a franquia do desenvolvedor com as chamadas faturáveis da API de Vídeo. Uma chamada faturável da API consome cinco créditos, e um carregamento de widget ou player sem anúncios consome um. Consulte o plano ativo e o uso na sua conta; exceder a franquia pode reativar as restrições do plano gratuito.
Configuração de domínio personalizado
Mantenha os visitantes no seu site quando abrirem partidas, competições, ligas e times. Disponível nos planos Advanced e Enterprise.
Este recurso conecta os links dos widgets às páginas hospedadas por você. Ele não transfere os serviços do ScoreBat para o seu domínio nem exige uma alteração de DNS. Seu servidor deve renderizar o widget apropriado em cada URL compatível.
- Crie uma página de hospedagem com o carregador abaixo. Substitua YOUR_EMBED_TOKEN pelo seu token de incorporação disponível no construtor.
- Configure reescritas internas para que cada caminho compatível exiba essa página, mantendo no navegador a URL original e a string de consulta.
- Teste URLs reais de partidas, competições, ligas e times antes de ativar os links para toda a conta.
- Em Conta, abra as configurações de desenvolvedor e insira as URLs base. Revise as alterações, confirme que testou as páginas e salve. Os links entram em vigor imediatamente após serem salvos com sucesso; não é necessária aprovação manual.
<script>
window.SCOREBAT_OPTIONS = {
embedToken: "YOUR_EMBED_TOKEN",
baseDir: "/"
};
</script>
<script src="https://www.scorebat.com/embed/embedx.js?v=vh2"></script>| Tipo de página | URL no seu site | Configuração da conta |
|---|---|---|
| Partida | https://example.com/matchview/MATCH_ID/ | matchviewUrl: https://example.com/matchview/ |
| Competição | https://example.com/competition/COMPETITION_ID_OR_SLUG/ | competitionUrl: https://example.com/competition/ |
| Liga | https://example.com/league/LEAGUE_ID/ | leagueUrl: https://example.com/league/ |
| Time | https://example.com/team/TEAM_ID_OR_SLUG/ | teamUrl: https://example.com/team/ |
O carregador compartilhado espera os nomes de caminho matchview, competition, league e team. Um caminho como /match/123/ exige uma lógica de roteamento própria que o associe à incorporação matchview; apenas renomear a URL não é suficiente.
RewriteEngine On
RewriteRule ^(?:matchview|competition|league|team)/[^/]+/?$ popup.html [L]
# Place popup.html at the website root.
# Keep these rules before a general application catch-all.location ~ ^/(matchview|competition|league|team)/[^/]+/?$ {
rewrite ^ /popup.html last;
}
# Serve /popup.html as an existing static file in this server.
# Adapt this example to your application routing before reloading Nginx.Para um subdiretório como /football/, use baseDir: "/football/", direcione /football/matchview/... e os outros três caminhos para a página compartilhada e salve as URLs base com o mesmo prefixo /football/. Preserve os parâmetros de consulta, incluindo sbprf, que contém as preferências de navegação.
O carregador pode atualizar o título da página de hospedagem. Defina noTitle: true em SCOREBAT_OPTIONS se o seu site gerencia o próprio título. Use identificadores reais do construtor; os placeholders não são conteúdos válidos.
Configuração do WordPress
Disponibilize a mesma página do WordPress em cada rota de widget.
- Crie uma página do WordPress para hospedar seu widget e adicione o script da página de hospedagem compartilhada da seção anterior. Use seu próprio token de incorporação.
- Encontre o ID da página na URL do editor e substitua 123 no exemplo abaixo. Coloque o código em um pequeno plugin do site ou no seu tema filho, não em um tema pai que possa ser sobrescrito por atualizações.
- Salve Configurações → Links permanentes uma vez após adicionar ou alterar as regras de reescrita. Não atualize as regras de reescrita a cada solicitação.
- Abra URLs reais dos quatro tipos de conteúdo e confirme que os widgets corretos são carregados antes de salvar suas URLs base em Conta.
<?php
// Put this in a small plugin or child theme functions.php.
// Omit the opening PHP tag if the file already has one.
function scorebat_custom_widget_routes() {
$page_id = 123; // Replace with your widget host page ID.
add_rewrite_rule(
'^(matchview|competition|league|team)/[^/]+/?$',
'index.php?page_id=' . $page_id,
'top'
);
}
add_action('init', 'scorebat_custom_widget_routes');Algumas funções de usuário, editores e plataformas de hospedagem do WordPress removem tags de script dos blocos de HTML personalizado. Se o carregador desaparecer, peça ao seu desenvolvedor para adicioná-lo por meio de um plugin confiável do site ou de um modelo de página, somente na página que hospeda o widget. Verifique seus plugins de cache, redirecionamento e segurança se os links diretos não funcionarem.
Para o WordPress instalado em um subdiretório, defina baseDir como o caminho da instalação com uma barra no final. Os padrões de reescrita são relativos a essa instalação; as URLs base da conta devem incluir o mesmo prefixo.
Teste e ative seus links
Uma URL salva não comprova que seu site está pronto. Primeiro teste e depois confirme a alteração para toda a conta.
- Acesse uma URL real de cada tipo de conteúdo configurado. Confirme que o widget correto aparece, atualize a página e abra-a em uma nova aba do navegador.
- Verifique o layout em dispositivos móveis, a altura do widget e a navegação entre os tipos de conteúdo. Mantenha visível a URL original do link direto; não redirecione todas as solicitações para popup.html ou para o slug da página do WordPress.
- Verifique se o HTTPS funciona e se o servidor preserva a string de consulta. Confira os erros do navegador caso uma política de segurança de conteúdo bloqueie scripts ou iframes do ScoreBat.
- Salve em Conta após confirmar a configuração. Acesse um link por um widget que use o mesmo token da conta para verificar os destinos ativados.
- Para restaurar os destinos do ScoreBat, limpe as URLs base relevantes ou escolha Usar links do ScoreBat. Depois, revise e salve novamente.
Estas cores são compartilhadas por todos os widgets qualificados que usam o token da sua conta, incluindo os que você já publicou.
A edição de domínio personalizado exige uma assinatura Advanced ou Enterprise ativa. Outros desenvolvedores podem ver os controles e fazer upgrade. Os links já configurados são preservados. Entre em contato com o ScoreBat se precisar de ajuda com uma configuração que não se encaixe nesses exemplos.
Escolha seu widget
Cada referência lista as próprias preferências compatíveis, padrões e exceções.
Use o filtro de família abaixo para encontrar o widget que você está incorporando. Nomes de parâmetros compartilhados podem ter efeitos específicos em cada widget; uma preferência só é compatível quando estiver listada. As rotas avançadas são indicadas quando não há uma predefinição específica no configurador.
Placares, jogos e resultados de várias competições.
PlacaresBarra de placares ↗Uma barra horizontal de placares para todos os jogos, uma equipe ou um torneio.
TorneiosLiga completa ↗Uma visualização completa da liga, reunindo competições relacionadas, jogos e tabelas.
TorneiosCompetição completa ↗Jogos, resultados e classificação disponível para uma competição.
TorneiosJogos e resultados ↗Uma visualização dedicada a jogos e resultados, com uma aba Hoje quando aplicável.
TorneiosClassificação de competições e ligas ↗Tabelas específicas da liga; uma liga pode exibir tabelas de várias fases.
EquipesEquipe completa ↗Uma página completa da equipe, com jogos e informações disponíveis.
EquipesClassificação da equipe ↗Uma tabela centralizada em uma equipe, com a opção de exibir a tabela completa.
EquipesCard de partidas da equipe ↗Cards das próximas partidas e/ou das últimas partidas concluídas de uma equipe.
JogosJogo completo ↗A visualização completa da partida, com as informações disponíveis para o jogo.
JogosPlacar do jogo ↗Um cartão de placar do jogo com eventos opcionais.
JogosEscalação ↗Titulares, apresentação em campo/lista e reservas, quando disponíveis.
JogosEstatísticas do jogo ↗Estatísticas disponíveis do jogo em uma visualização dedicada.
JogosConfronto direto ↗Confrontos anteriores e conteúdo comparativo do jogo selecionado.
JogosVídeo e IA do jogo ↗Conteúdo em vídeo e contexto de IA disponível para uma partida selecionada.
JogosClassificação do jogo ↗Classificação disponível com destaque para as duas equipes do jogo.
JogosIA do jogo ↗Uma visualização dedicada à previsão por IA, quando disponível.
VídeoPainel de vídeos ↗Um player de vídeo com uma seleção navegável de jogos.
VídeoFeed de vídeos ↗Um feed vertical de vídeos de jogos, com expansão e reprodução automática opcionais.
Placar ao vivo
Placares, jogos e resultados de várias competições.
resizer/embed/livescore/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
limitwidth | boolean | integertrue | false | integer ≥ 400 | false | Somente para o placar ao vivo: true limita o conteúdo a 1200px. Um número inteiro de pelo menos 400 define um limite personalizado em pixels. Isso é diferente de nomaxwidth. |
const url = new URL("https://www.scorebat.com/embed/livescore/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"limitwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Barra de placares
Uma barra horizontal de placares para todos os jogos, uma equipe ou um torneio.
fixed/embed/livescore-bar/
/embed/livescore-bar/team/{team}/
/embed/livescore-bar/competition/{competition}/
/embed/livescore-bar/league/{league}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
const url = new URL("https://www.scorebat.com/embed/livescore-bar/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Liga completa
Uma visualização completa da liga, reunindo competições relacionadas, jogos e tabelas.
resizer/embed/league/{league}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/league/{league}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Competição completa
Jogos, resultados e classificação disponível para uma competição.
resizer/embed/competition/{competition}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Jogos e resultados
Uma visualização dedicada a jogos e resultados, com uma aba Hoje quando aplicável.
resizer/embed/fixtures/competition/{competition}/
/embed/fixtures/league/{league}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
fixturesview | stringfixtures | results | fixtures | Aba inicial de jogos/resultados. Se a competição tiver jogos hoje, o widget abrirá inicialmente em Hoje. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"fixturesview": "fixtures",
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/fixtures/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"fixturesview": "results",
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Classificação de competições e ligas
Tabelas específicas da liga; uma liga pode exibir tabelas de várias fases.
resizer/embed/standings/competition/{competition}/
/embed/standings/league/{league}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
tabledetailed | booleantrue | false | false | Abre a classificação específica na visualização detalhada. As colunas disponíveis dependem da tabela de origem. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/standings/competition/{competition}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"tabledetailed": true,
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Equipe completa
Uma página completa da equipe, com jogos e informações disponíveis.
resizer/embed/team/{team}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Classificação da equipe
Uma tabela centralizada em uma equipe, com a opção de exibir a tabela completa.
resizer/embed/standings/team/{team}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
tableview | stringnearby | full | nearby | Somente classificação da equipe: exiba as linhas próximas à equipe selecionada ou a tabela inteira. |
tableneighbors | integer1–5 | 3 | Número de linhas vizinhas na classificação da equipe no modo nearby. O configurador oferece 1, 2, 3 ou 5; o processador limita os valores ao intervalo de 1 a 5. Não tem efeito no modo full. |
tabledetailed | booleantrue | false | false | Abre a classificação específica na visualização detalhada. As colunas disponíveis dependem da tabela de origem. |
tablecompetition | stringCompetition slug or numeric ID as a string | Automático | Seleciona uma competição de classificação para uma equipe. A competição deve estar disponível para essa equipe; um seletor sem correspondência gera uma tabela indisponível em vez de usar uma alternativa. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"tableview": "nearby",
"tableneighbors": 3,
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/standings/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"tableview": "nearby",
"tableneighbors": 2,
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Card de partidas da equipe
Cards das próximas partidas e/ou das últimas partidas concluídas de uma equipe.
resizer/embed/team-match/team/{team}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
matchmode | stringnext | latest | both | both | Seleciona os cartões do próximo jogo de uma equipe (primeiro um jogo ao vivo; caso contrário, o próximo), do jogo concluído mais recente ou de ambos. Jogos ausentes não são criados artificialmente. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"matchmode": "both",
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/team-match/team/{team}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"matchmode": "next",
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Jogo completo
A visualização completa da partida, com as informações disponíveis para o jogo.
resizer/embed/matchview/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/matchview/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Placar do jogo
Um cartão de placar do jogo com eventos opcionais.
resizer/embed/matchscore/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
noevents | booleantrue | false | false | Oculta a linha do tempo de eventos no widget de placar do jogo. Outros tipos de widget de jogo não usam essa preferência. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
layout | stringmini | Padrão | A escalação aceita field ou list; omita para usar a visualização combinada. O placar do jogo aceita mini para exibir o placar compacto. Essa preferência de URL não está relacionada ao modo de dimensionamento do iframe no configurador. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/matchscore/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"noevents": true,
"layout": "mini",
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Escalação
Titulares, apresentação em campo/lista e reservas, quando disponíveis.
resizer/embed/line-up/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
layout | stringfield | list | Padrão | A escalação aceita field ou list; omita para usar a visualização combinada. O placar do jogo aceita mini para exibir o placar compacto. Essa preferência de URL não está relacionada ao modo de dimensionamento do iframe no configurador. |
subs | stringhide | collapse | Expandido | Somente para escalações: oculte as listas de reservas ou deixe-as inicialmente recolhidas. Omita para manter a exibição normal dos reservas. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/line-up/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"layout": "field",
"subs": "collapse",
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Estatísticas do jogo
Estatísticas disponíveis do jogo em uma visualização dedicada.
resizer/embed/matchstats/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/matchstats/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Confronto direto
Confrontos anteriores e conteúdo comparativo do jogo selecionado.
resizer/embed/match-h2h/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"nomaxwidth": true
}const url = new URL("https://www.scorebat.com/embed/match-h2h/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Vídeo e IA do jogo
Conteúdo em vídeo e contexto de IA disponível para uma partida selecionada.
resizer/embed/g/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
autoplay | booleantrue | false | false | Solicita a reprodução automática do vídeo. A reprodução começa sem som. As políticas do navegador e a disponibilidade da fonte ainda podem impedir o autoplay. |
const url = new URL("https://www.scorebat.com/embed/g/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"autoplay": false
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Classificação do jogo
Classificação disponível com destaque para as duas equipes do jogo.
resizer/embed/matchstandings/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
dontcollapse | booleantrue | false | false | Mantém um feed de vídeos expandido. Na classificação do jogo, exibe a tabela completa em vez de uma pequena área ao redor das duas equipes. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nopadding | booleantrue | false | false | Remove o espaçamento interno do conteúdo compatível. Não remove o espaçamento da página pai ao redor do iframe nem todas as regras de espaçamento interno. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
const url = new URL("https://www.scorebat.com/embed/matchstandings/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"dontcollapse": true,
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.IA do jogo
Uma visualização dedicada à previsão por IA, quando disponível.
resizer/embed/matchai/{match}/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
noheader | booleantrue | false | false | Oculta o cabeçalho do conteúdo quando compatível. Exige acesso sem anúncios ativo e é ignorado sem esse direito. Por si só, não remove a marca ScoreBat. |
nomaxwidth | booleantrue | false | false | Remove a largura máxima interna do widget. O iframe ainda precisa ter uma largura adequada na página. |
const url = new URL("https://www.scorebat.com/embed/matchai/{match}/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"nomaxwidth": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Painel de vídeos
Um player de vídeo com uma seleção navegável de jogos.
responsivePanel/embed/videopanel/
/embed/videopanel/team/{team}/
/embed/videopanel/competition/{competition}/
/embed/videopanel/league/{league}/
/embed/videopanel/live-stream/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
autoplay | booleantrue | false | false | Solicita a reprodução automática do vídeo. A reprodução começa sem som. As políticas do navegador e a disponibilidade da fonte ainda podem impedir o autoplay. |
filternotlive | booleantrue | false | false | Filtra jogos encerrados no feed de vídeos de transmissão ao vivo. Aplica-se ao escopo de transmissão ao vivo, não a um filtro geral de placares ao vivo. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"autoplay": true
}const url = new URL("https://www.scorebat.com/embed/videopanel/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"autoplay": false
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Feed de vídeos
Um feed vertical de vídeos de jogos, com expansão e reprodução automática opcionais.
resizer/embed/videofeed/
/embed/videofeed/team/{team}/
/embed/videofeed/competition/{competition}/
/embed/videofeed/league/{league}/
/embed/videofeed/live-stream/Preferências compatíveis
Os padrões descrevem URLs sem parâmetros adicionais. Use apenas as preferências listadas para este widget.
| Preferência | Tipo / valores | Quando omitido | Efeito |
|---|---|---|---|
language | stringen, ar, cs, da, de, el, es, fi, fr, he, id, it, ms, nl, no, pl, pt-br, ro, ru, sv, th, tr, vi, zh-cn | Automático | Seleciona o idioma do widget. Use um código compatível; isso não traduz os nomes dos campos da API. |
autoplay | booleantrue | false | false | Solicita a reprodução automática do vídeo. A reprodução começa sem som. As políticas do navegador e a disponibilidade da fonte ainda podem impedir o autoplay. |
dontcollapse | booleantrue | false | false | Mantém um feed de vídeos expandido. Na classificação do jogo, exibe a tabela completa em vez de uma pequena área ao redor das duas equipes. |
filternotlive | booleantrue | false | false | Filtra jogos encerrados no feed de vídeos de transmissão ao vivo. Aplica-se ao escopo de transmissão ao vivo, não a um filtro geral de placares ao vivo. |
Padrões do configurador
O configurador define explicitamente essas preferências. Os outros padrões são herdados da variante selecionada.
{
"autoplay": true,
"dontcollapse": true
}const url = new URL("https://www.scorebat.com/embed/videofeed/");
url.searchParams.set("token", "YOUR_EMBED_TOKEN");
url.searchParams.set("pref", JSON.stringify({
"autoplay": false,
"dontcollapse": true
}));
// Replace route placeholders with your builder selection.
// Use this URL as the iframe src with the sizing setup above.Plugin para WordPress
Adicione e gerencie widgets de futebol diretamente no painel do WordPress.
Use o plugin ScoreBat para adicionar placares ao vivo, jogos, classificações, widgets de times e partidas, além de melhores momentos em vídeos oficiais, ao seu site WordPress.
Baixe o plugin ScoreBat no WordPress.org
- No painel do WordPress, acesse Plugins → Adicionar plugin, pesquise por ScoreBat e instale e ative o plugin.
- Abra o ScoreBat no painel e selecione Conectar ao ScoreBat. Entre na sua conta ou crie uma conta gratuita e autorize a conexão com o seu site.
- Abra o catálogo de widgets, escolha e personalize um widget e selecione Usar no WordPress para salvá-lo no seu site.
- Adicione um bloco Widget de futebol do ScoreBat e selecione o widget salvo ou cole o shortcode dele em um bloco Shortcode. Você também pode criar, pelo painel do ScoreBat, uma página de rascunho com o widget já adicionado.
- Visualize a página no computador e no celular e publique quando estiver tudo pronto.
Quando uma configuração não funciona
Verifique a rota, o tipo do valor, os direitos de acesso e o ambiente de incorporação.
- Confirme se a rota corresponde à seção do widget que você está consultando. Equipe completa, classificação da equipe e cartão de jogo da equipe usam renderizadores diferentes.
- Verifique a chave exata em minúsculas e o tipo JSON. Use pref={...} codificado uma única vez; não forneça rótulos da interface nem nomes internos em camelCase.
- Compare com a lista de preferências compatíveis. Um controle do configurador pode aparecer em várias variantes, mesmo quando um renderizador específico não o utiliza.
- Verifique o plano e o token ativos. A remoção do cabeçalho, as cores, a marca e os recursos de IA podem depender dos direitos de acesso.
- Teste a URL realmente exportada, não uma prévia de demonstração. Verifique se a página hospedeira permite o iframe e o script de dimensionamento necessário.
- Se o conteúdo estiver ausente, verifique outro jogo ou competição que tenha dados disponíveis. Uma preferência não pode gerar tabelas, vídeos ou escalações ausentes.
Em caso de problemas de layout, verifique primeiro a largura e a altura do contêiner pai. Se o conteúdo estiver cortado, confira o script auxiliar e a classe do iframe ou aumente a altura fixa. Atualize o widget após alterar sua URL ou as configurações salvas.
Crie com um assistente de IA
Um guia que pode ser copiado e um manifesto de widget legível por máquina.
Use o guia em Markdown para consultar as instruções de integração e o manifesto JSON para verificar rotas, nomes de preferências compatíveis, valores permitidos, padrões e observações de aplicabilidade. Ambos contêm placeholders em vez de tokens da conta.
- Escolha a variante exata do widget e um identificador real no configurador. Nunca invente uma rota ou preferência.
- Use a lista de preferências compatíveis com esse widget. Preserve as chaves em letras minúsculas e os tipos de valores JSON.
- Crie URLs com URL e URLSearchParams e preserve o token de incorporação. Mantenha as configurações de tamanho fora de pref.
- Respeite os direitos da conta e a disponibilidade do conteúdo. Nunca prometa que alterar uma preferência removerá a marca ou fará conteúdo indisponível aparecer.
- Inclua um título descritivo no iframe, dimensões adequadas, permissões de vídeo quando necessário e o script auxiliar correto.

