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

Troubleshooting

A list or selector is empty

JoomLeague selectors intentionally show only compatible records. Check that the record is published, belongs to the current project/sport type and is allowed by the active profile contract. Project entries must exist before stage assignment; stages before rounds; rounds before programme items.

If Positions, Events or Statistics are empty on a new site, create a sport type from a profile with the corresponding initialization switch enabled, or create catalog records manually for that sport type.

Frontend says data is not published

Publication is checked across the relationship chain. A published programme item is still unavailable when its project, competition, season, sport type, stage or round is unpublished or inaccessible to the visitor's view level. Test the complete chain, not only the final row.

Total standings work but home or away do not

Current builds calculate all profile-defined scopes automatically on read. Confirm the installed package is current and that the profile contract defines the requested scopes. Clear Joomla/component cache after updating an older development build. Do not create a manual snapshot solely to make a public scope appear.

A result fails the profile contract

The project retains the profile version assigned when it was created. Result participants, score type, score segments and values must satisfy that exact contract. This commonly indicates an invalid external conversion or data written by an earlier development schema. Use the current migration service and inspect its validation report; do not import legacy SQL directly.

SQL import does not start

Confirm the file is below both PHP upload_max_filesize and post_max_size, the PHP upload temporary directory is configured and writable, and the file contains only supported JoomLeague CREATE/INDEX/INSERT statements. A server or reverse-proxy body limit can reject the request before Joomla receives it. Diagnostics reports the PHP-side limits and writable paths.

SQL export appears in the browser

Current Database Tools sends a downloadable SQL attachment. If SQL is rendered as page text, update to the current package and clear administrator/browser cache. Also verify that a template override or debugging plugin is not writing output before response headers.

Guided Tour cannot find a field

Return to the JoomLeague dashboard, close modal windows and restart the tour. Confirm the administrator template is not overridden and the form belongs to the current JoomLeague release. See Guided Tours for the full recovery sequence.

Smart Search returns no JoomLeague items

Enable the Finder JoomLeague plugin, publish the source records, then run the Smart Search indexer. A plugin enabled after the initial index requires a new index. Verify the visitor can access the records' view levels.

Calendar download is empty

Confirm the project is published and contains published programme items. For entry/club scopes, verify the entry_id or club_id belongs to that project. An event without a scheduled start cannot become a useful calendar event.

What to include in a support report

Provide the JoomLeague and Joomla versions, database driver/version, PHP version, exact URL/view, steps to reproduce and the relevant Diagnostics output. Remove passwords, tokens, private person data and raw production SQL. For conversion problems, include the migration report and source-family detection, not the confidential SQL dump in a public forum post.