Documentação atualizada em 3 de julho de 2023. Última versão do plugin: 1.16.1.
O plugin “ScoutSportsBR” é uma criação do Swim It Up! a pedido da própria Scout Sports, iniciado em 2017. É o primeiro e único trabalho desenvolvido fora do ambiente de natação.
O plugin faz consultas por webservice (API via varíaveis GET), restrita por IP, e basicamente trabalha com shortcode altamente configurável por variáveis, podendo embutir múltiplos shortcodes nas páginas especiais de eventos, gerando códigos interativos que trabalham por ajax, dentro dos limites do div gerado pelo shortcode, garantindo assim utilização inteligente de recursos e requisições na própria página onde o plugin é implantado.
O plugin tem seu próprio código CSS, mas é possível editá-lo para garantir máxima compatibilidade e adaptabilidade ao site do cliente.
A partir da versão 1.9.0 do plugin, é exigido que a requisição do plugin seja feita por um servidor com chave de segurança pré-autorizado a utilizar o webservice da Scout Sports.
O shortcode funciona com o seguinte inserido em um post ou página:
[scoutsportsbr %acao% %id-campeonato% (variaveis) ... ]
%acao% e %id-campeonato% são itens obrigatórios no shortcode. Se eles não existirem, é retornado um erro número 101 da requisição (instrução inválida). Se a ação e/ou o campeonato não existirem, também é retornado um erro 101.
O parâmetro id-campeonato pode receber múltiplos valores, sempre separados por vírgula, por exemplo:
[scoutsportsbr artilharia id-campeonato=3,4,5]
AÇÕES
[scoutsportsbr ranking="jogador/equipe" ocorrencia="GOL/CA/CV/ASSIS/GS/GSPLACAR/ATAQUE/DEFESA" id-campeonato=y (variaveis) ... ]
Exibe ranking de ocorrência para equipe ou jogador. Somente pode contabilizar uma ocorrência por shortcode.
Ocorrências:
- GOL: gol simples contabilizado nas ocorrências
- CA: cartão amarelo contabilizado nas ocorrências
- CV: cartão vermelho contabilizado nas ocorrências
- ASSIS: assistência contabilizada nas ocorrências
- GS: gol sofrido contabilizado nas ocorrências
- GSPLACAR: gol sofrido contabilizado no placar final do jogo
- ATAQUE: Aproveitamento de gols por partida (total de gols a favor contabilizado no placar dividido pelo número de partidas)
- DEFESA: Rendimento de gols por partida (total de gols sofridos contabilizado no placar dividido pelo número de partidas)
[scoutsportsbr artilharia id-campeonato=y (variaveis) ... ]
Exibe artilharia de determinado campeonato.
[scoutsportsbr tabeladejogos id-campeonato=y (variaveis) ... ]
Exibe a tabela de jogos de determinado campeonato. Se nenhuma varíavel adicional é exibida, é retornado os 10 próximos jogos a partir da data atual. Se não houver jogos, a mensagem “Nenhum jogo encontrado” é retornada.
[scoutsportsbr tabeladejogos2 id-campeonato=y (variaveis) ... ]
Exibe a tabela de jogos de determinado campeonato. Neste formato não-responsivo, a tabela é composta por diversas linhas de 1-e-3 colunas. A primeira linha de duas indica os dados do jogo como data, local, horário, e a segunda linha exibe as logos/nomes das equipes e o placar final, se existir. Se nenhuma varíavel adicional é exibida, é retornado os 10 próximos jogos a partir da data atual. Se não houver jogos, a mensagem “Nenhum jogo encontrado” é retornada.
[scoutsportsbr classificacao id-campeonato=y (variaveis) ... ]
Exibe a classificação de determinado campeonato.
[scoutsportsbr estatisticas id-campeonato=y (variaveis) ... ]
Exibe as estatísticas resumidas de determinado campeonato.
[scoutsportsbr estatisticasjogadores id-campeonato=y (variaveis) ... ]
Exibe as estatísticas resumidas para cada jogador, em formato de classificação, de determinado campeonato.
VARIÁVEIS
jogo=y[,x,z...]
Filtra por ID do jogo. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
lista-de-campeonatos
Esta variável é especial e apresentará uma lista de todos os campeonatos ativos disponíveis em formato exclusivo JSON. Esta variável é utilizada na administração do site.
sede=y[,x,z...]
Filtra por ID da sede/local do jogo. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
grupo=y[,x,z...]
Filtra por ID do grupo do jogo. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
fase=y[,x,z...]
Filtra por ID da fase do jogo. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
equipe=y[,x,z...]
Filtra por ID da equipe. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
categoria=y[,x,z...]
Filtra por ID de categoria de equipe, item disponível para seleção dentro de cada jogo. Os números podem ser múltiplos, mas devem ser separados exclusivamente por vírgulas.
reduzido=1/0
Algumas tabelas exibidas podem ser apresentadas na forma “reduzida”, ou seja, com títulos de cabeçalho abreviados, nomes de equipes por siglas, ocultar certas colunas adicionais etc.
sem-titulo=1/0
Mostrar ou ocultar o título padrão da tabela, quando existir na tabela
limite=y
Impõe um limite para exibição, se a lista gerar mais que 1 item. Se não for fornecido, listará até 10 itens. Para tabelas com classificação, o limite leva em consideração o ranking, não o número de linhas. Por exemplo, se o limite é 5 e existem 3 equipes/atletas empatados em 5o. lugar, eles são exibidos.
exibir-categorias=1/0
Exibe ou esconde a categoria da equipe no jogo, se houver.
css=1/0
Inclui ou não o arquivo CSS padrão do plugin. Se a página conter múltiplos shortcodes, a opção irá afetar todos os outros shortcodes.
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO tabeladejogos OU tabeladejogos2
periodo=YYYY-MM-DD[,YYYY-MM-DD]
Filtra por período de data. Se apenas uma data é citada, a lista é gerada considerando dados a partir da data citada. Se a segunda data, separada por vírgula, é citada, a lista é gerada considerando dados da primeira data citada até a segunda data citada. Se a data for inválida, o filtro não funcionará. Um erro número 703 será exibido se houver mais de 2 datas solicitadas; erro número 702 para uma ou as duas datas inválidas e; erro número 701 para única data fornecida como inválida.
exibir-sigla=1/0
Exibe ou oculta a sigla da equipe. Por padrão a sigla é exibida.
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO classificacao
sem-ranking=1/0
Exibe ou oculta a coluna contendo a classificação numérica (1º, 2º, 3º etc). Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (sem-ranking=0).
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO estatisticas OU estatisticasjogadores
exibir-estatistica-total-jogos=0/1
Exibe ou oculta a coluna de total de jogos. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-jogos=0).
exibir-estatistica-total-gols=0/1
Exibe ou oculta a coluna de total de gols. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-gols=0).
exibir-estatistica-media-gols=0/1
Exibe ou oculta a coluna de média de gols do campeonato. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-media-gols=0).
exibir-estatistica-total-assistencias=0/1
Exibe ou oculta a coluna de total de assistências realizadas por cada equipe/jogador. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-assistencias=0).
exibir-estatistica-total-ca=0/1
Exibe ou oculta a coluna de total de cartões amarelos. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-ca=0).
exibir-estatistica-total-wo=0/1
Exibe ou oculta a coluna de total de jogos finalizados por W.O.. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-wo=0).
exibir-estatistica-total-derrotas=0/1
Exibe ou oculta a coluna de total de jogos com placar com derrota de um dos times. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-derrotas=0).
exibir-estatistica-total-vitorias=0/1
Exibe ou oculta a coluna de total de jogos com placar com vitória de um dos times. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-vitorias=0).
exibir-estatistica-total-empates=0/1
Exibe ou oculta a coluna de total de jogos finalizados com placar de empate. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-empates=0).
exibir-estatistica-total-cv=0/1
Exibe ou oculta a coluna de total de cartões vermelhos. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-cv=0).
exibir-estatistica-foto-jogador=0/1
Exibe ou oculta a coluna com a foto do jogador. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-foto-jogador=0).
exibir-estatistica-nome-jogador=0/1
Exibe ou oculta a coluna com o nome do jogador. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-nome-jogador=0).
exibir-estatistica-nome-equipe=0/1
Exibe ou oculta a coluna com o nome da equipe. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-nome-equipe=0).
exibir-estatistica-logo-equipe=0/1
Exibe ou oculta a coluna com a logo da equipe. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-logo-equipe=0).
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO artilharia
exibir-artilharia-ranking=0/1
Exibe ou oculta a coluna de classificação por rank da artilharia. Por padrão a coluna NÃO é exibida.
exibir-artilharia-atleta=0/1
Exibe ou oculta a coluna do jogador, que inclui a foto e o nome. Por padrão a coluna NÃO é exibida.
exibir-artilharia-foto-atleta=0/1
Exibe ou oculta a foto do jogador. Por padrão a coluna NÃO é exibida. É necessário que a variável exibir-artilharia-atleta esteja como 1 se quiser exibir a foto do jogador.
exibir-artilharia-equipe=0/1
Exibe ou oculta a coluna da equipe, que inclui a logo e o nome. Por padrão a coluna NÃO é exibida.
exibir-artilharia-foto-equipe=0/1
Exibe ou oculta a logo da equipe. Por padrão a coluna NÃO é exibida. É necessário que a variável exibir-artilharia-equipe esteja como 1 se quiser exibir a logo da equipe.
exibir-artilharia-gols=0/1
Exibe ou oculta a coluna de gols. Por padrão a coluna NÃO é exibida.
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO ranking=”jogador”
modelo=lista
Exibe tabela em modelo de lista similar à artilharia.
exibir-equipe=1/0
Exibe ou oculta a sigla e logo da equipe. Por padrão a sigla e logo é exibida.
VARIÁVEIS QUE SÓ FUNCIONAM COM A AÇÃO ranking
exibir-ranking=0/1
Exibe ou oculta a coluna de ranking, que é a primeira coluna da tabela. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-ranking=0).
exibir-ranking-nome-equipe=0/1
Exibe ou oculta a coluna do nome e logo da equipe. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-ranking-nome-equipe=0). Ao ativar essa exibição, você ainda pode escolher para exibir ou não a logo da equipe. Se a logo estiver para ser exibida, é preciso também exibir o nome da equipe.
exibir-ranking-logo-equipe=0/1
Exibe ou oculta a logo da equipe. Por padrão a logo é exibida e tem que estar com a variável exibir-ranking-nome-equipe marcada como 1. A variável é mais utilizada para não exibir a logo (exibir-ranking-logo-equipe=0).
exibir-ranking-total=0/1
Exibe ou oculta a coluna de total, que é a última coluna da tabela, onde apresenta o número absoluto. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-ranking-total=0).
exibir-ranking-numero-jogos=0/1
Exibe ou oculta as duas colunas que mostram o número de jogos e a média de entre a ocorrência e o número de jogos. Esta estatística está ligada somente à ocorrência GS (gols sofridos). Por padrão as colunas são exibida, então a variável é mais utilizada para não exibir as colunas (exibir-ranking-numero-jogos=0).
exibir-ranking-logo-equipe=0/1
Exibe ou oculta a logomarca. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-estatistica-total-ca=0).
exibir-ranking-foto-jogador=0/1
Exibe ou oculta a coluna com a foto do jogador. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-ranking-foto-jogador=0).
exibir-ranking-nome-jogador=0/1
Exibe ou oculta a coluna com o nome do jogador. Por padrão a coluna é exibida, então a variável é mais utilizada para não exibir a coluna (exibir-ranking-nome-jogador=0).
EXEMPLOS
Abaixo as diversas configurações e seus shortcodes:
[scoutsportsbr ranking="jogador" id-campeonato="4" limite="5" ocorrencia="GS"]
[scoutsportsbr artilharia id-campeonato="4" limite="2"]
[scoutsportsbr tabeladejogos id-campeonato="4" limite="5" reduzido="1" periodo="2020-01-15" sede="2"]
[scoutsportsbr estatisticasjogadores id-campeonato="4" limite="5" reduzido="0" grupo="2"]