JoomLeague Docs
JoomLeague 6.2 development documentationNot compatible with the JoomLeague 6.1.x component. Use a clean test installation.

Getting Started

What is JoomLeague?

JoomLeague is a competition and league management component for Joomla. It handles competitions, seasons, clubs, teams, people, matches, results and scheduling — driven by a sport-independent data model, so it isn't limited to football.

This documentation covers JoomLeague 6.2, a ground-up rewrite currently in active development. See Downloads for test packages and Converting legacy data if you need to bring data from an older JoomLeague installation into a clean 6.2 test site.

Compatibility warning: JoomLeague 6.2 is not an update for JoomLeague 6.1.x and is not compatible with its files or database schema. Install it as a clean component on a supported Joomla site. Legacy data transfer is a separate external conversion, not an in-place upgrade.

Requirements

  • Joomla CMS 6.1.x or 6.2.x
  • PHP 8.3 or later
  • MariaDB/MySQL or PostgreSQL

Installing

  1. Prepare a clean Joomla 6.1 or 6.2 test installation without JoomLeague 6.1.x.
  2. Download the full package (pkg_joomleague-*.zip) from downloads.joomleague.eu.
  3. In your Joomla administrator, go to System → Install → Extensions and upload the zip file.
  4. The package installs the component, five supporting plugins and eleven site modules as one Joomla package.

Joomla's own Update screen will also pick up new 6.2 builds automatically once installed, using the update channel published on downloads.joomleague.eu.

What's in the package

  • com_joomleague — administration, public views and the shared domain services used by the extensions below.
  • 11 site modules — standings, programme, next event, project navigation, participant, club, personnel, venue programme, competitions, statistic ranking and event ranking. See Site Modules.
  • 5 plugins — Administrator quick icon, CLI commands, Joomla Scheduler tasks, Smart Search indexing and article content tags. See Joomla Integrations.

The installer also registers two JoomLeague administrator guided tours: a read-only orientation and an interactive 20-step competition-foundation workflow. See Guided Tours for every step, prerequisite and recovery procedure.

After installing

Once installed, open Components → JoomLeague → Dashboard or use the JoomLeague quick icon. A normal first setup is:

  1. Create a sport type from one of the bundled sport profiles.
  2. Create a competition and season.
  3. Create a project and add its entries.
  4. Configure stages, rounds and the programme.
  5. Run the project preflight check before publishing frontend menu items.

See Core Concepts for the data model and Complete Project Workflow for the full operating order. For a complete example, start with the Football League tutorial or choose another sport from the Tutorials section. When the programme is ready, continue with Results and Event Report.

Presentation is configured independently from sport rules. See Template Settings and Inheritance before creating project-level or page-specific display overrides.

Core Concepts →