Hierarquia de dados

O SportsPress organiza os dados esportivos em uma estrutura em camadas. Entender essa hierarquia facilita a configuração correta do plugin e evita erros comuns de configuração.

Os cinco níveis

Competição (Liga / Copa / Torneio)
  └── Temporada (2024–25, Temporada 1 etc.)
        └── Time  ──────────────────┐
              └── Jogador           │
              └── Equipe técnica    │
              └── Partida  ←────────┘
                    └── Resultados / Desempenho

1. Competição

Uma Competição (também chamada de Liga em alguns contextos) é o agrupamento de nível mais alto. Representa o torneio, a copa ou a liga em que um conjunto de times está jogando. Um site pode ter várias competições rodando ao mesmo tempo — um site de clube pode administrar simultaneamente uma liga nacional, uma copa e uma liga de reservas.

As competições são administradas em SportsPress > Competições.

2. Temporada

Uma Temporada divide uma competição no tempo — geralmente por ano ou por período. Todo dado do SportsPress está vinculado a uma ou mais temporadas, para que os dados históricos fiquem separados da campanha atual.

Convenções comuns para nomear temporadas: 2024–25, Outono 2025, Temporada 3.

As temporadas são administradas em SportsPress > Temporadas.

3. Time

Os Times são os clubes, franquias ou competidores que participam de uma competição. Cada time é atribuído a uma ou mais competições e temporadas.

Um time contém:

Seu nome, escudo e cores
Um elenco de jogadores
Um estádio de mando
A associação com uma tabela de classificação

4. Jogador e equipe técnica

Os Jogadores são os atletas no elenco de um time. A Equipe técnica são os técnicos, diretores e demais funcionários. Ambos são atribuídos a um time e, opcionalmente, a uma competição e temporada.

Os dados dos jogadores (estatísticas, métricas) são sempre calculados no escopo de uma competição e temporada específicas, de modo que o mesmo jogador pode ter estatísticas diferentes em campanhas diferentes.

5. Partida

Uma Partida é um único confronto. Toda partida está vinculada a:

Uma competição e uma temporada
Dois ou mais times (mandante e visitante, ou vários participantes)
Opcionalmente, um estádio e um calendário

Quando você publica os resultados de uma partida, o SportsPress recalcula automaticamente todas as tabelas de classificação, estatísticas de jogadores e totais de carreira afetados.

Por que essa ordem importa

Você precisa criar os itens de nível mais alto antes que os de nível mais baixo possam referenciá-los:

Crie pelo menos uma Competição e uma Temporada primeiro.
Crie Times e atribua-os à competição e à temporada.
Adicione Jogadores e atribua-os a um time.
Crie Partidas e atribua-as a uma competição, uma temporada e aos times participantes.

Pular etapas — por exemplo, adicionar jogadores antes de criar um time — significa que você não consegue fazer as atribuições corretas, e os dados não aparecerão em modelos nem em tabelas de classificação.

Dados compartilhados vs. dados específicos da temporada

Tipo de dado	Específico da temporada?
Competição	Não — persiste através das temporadas
Temporada	Sim — cada temporada é independente
Time	Não — a mesma entidade de time pode atravessar várias temporadas
Jogador	Não — a mesma entidade de jogador pode atravessar várias temporadas
Partida	Sim — cada partida pertence a uma temporada específica
Tabela de classificação	Sim — normalmente uma tabela por competição por temporada
Lista de jogadores / Elenco	Pode abranger várias temporadas ou ser restrita a uma

Jogadores e times são reutilizados entre temporadas. As estatísticas e classificações são calculadas por temporada com base nas partidas das quais participaram naquela temporada.

Várias competições em um mesmo site

O SportsPress permite operar várias competições simultaneamente. Uma configuração comum para um site de clube:

Time principal masculino — Brasileirão 2024–25
Time principal masculino — Copa do Brasil 2024–25
Time feminino — Brasileirão Feminino 2024–25
Sub-18 — Campeonato Sub-18 2024–25

Cada par competição/temporada produz sua própria tabela de classificação e pode ter sua própria lista de jogadores, calendário e conjunto de partidas. Os shortcodes e widgets aceitam os parâmetros league e season para exibir os dados de uma competição específica.