2. Core Concepts - Sports Leagues Docs

Understanding the core data model is essential for effective use of Sports Leagues. This section explains how the plugin organizes sports data and how different entities relate to each other.

📊 Data Hierarchy

Sports Leagues uses a hierarchical structure to organize your data:

1. Seasons — Time periods (e.g., “2024/2025”)
2. Leagues — Competition categories (e.g., “Premier League”, “Division 1”)
3. Tournaments — Specific competitions combining season + league + teams
4. Teams — Organizations that compete
5. Players — Individuals on team rosters
6. Games — Individual matches between teams
7. Standings — Calculated league tables

🔗 How It All Connects

Here’s how these entities work together:

• A Tournament belongs to one Season and one League
• Teams are assigned to Tournaments (the same team can play in multiple tournaments)
• Players are assigned to Teams via Rosters (which are season-specific)
• Games belong to a Tournament and involve two Teams
• Standings are calculated automatically from Game results within a Tournament

Season: 2024-25
├── League: Premier Division
│   └── Tournament: Premier Division 2024-25
│       ├── Teams (8 teams)
│       ├── Games (56 games)
│       └── Standing (auto-calculated)
└── League: Youth League
    └── Tournament: Youth League 2024-25
        ├── Teams (6 teams)
        ├── Games (30 games)
        └── Standing (auto-calculated)

📚 In This Section

Explore each concept in detail:

Article	What You’ll Learn
Seasons & Leagues	Create time periods and competition categories
Tournaments	Configure round-robin, knockout, and multistage competitions
Teams	Set up teams with rosters, staff, and branding
Venues	Manage stadiums and arenas
Players & Staff	Manage player profiles and team personnel
Games	Record fixtures, results, events, and lineups
Standings	Understand automatic table calculations
Data Filtering	Filter data by season, tournament, team, and date