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.
Only one position appears after migration
Clear list filters and verify the selected sport type first. Then distinguish a fresh import from an existing partially populated target. RC2 adds catalogue identity/ownership checks and corrects the PostgreSQL rollback case; it does not automatically recreate every record missing after an earlier attempt.
Inspect the conversion/import report and profile binding on a backed-up test copy. Do not delete positions, change sport IDs or repeat the full import blindly. See Migration and Updating.
The form asks for two stages when generating fixtures
You are probably in a stage-transition rule, not the generator. For a league, open the project's stage, then Rounds -> Generate schedule. A transition between stages is not required to generate a normal round-robin programme.
A quick score cannot be saved
Check both values, project result-edit permission, checkout and whether the profile/existing result supports quick numeric editing. Use the detailed editor for structured scores. A stale-write error means another version exists: reload and compare it instead of forcing an old score over the newer one.
Extra-time or shootout scores look wrong
Review the preserved source data and RC2 repair behaviour. Extra-time totals must not be counted twice, and shootout scores are separate. Unknown period values must not be guessed just to make an aggregate look plausible.
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.
Translation keys or missing flags
For raw language keys or English fallback text, check the separate translation package and CMS language. For flags, check Klucon Countries, the connector and the actual saved country code. See Languages and Country flags. These are independent integrations, not reasons to recreate a player or rewrite their competition history.
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.
