Skip to content

Media and troubleshooting

This chapter covers common issues for competition administrators.

Images and files

JoomLeague uses Joomla Media Manager.

Typical folders:

text
images/com_joomleague
images/com_joomleague/clubs
images/com_joomleague/teams
images/com_joomleague/persons
images/com_joomleague/playgrounds
images/com_joomleague/database

File recommendations

Use:

  • reasonable image dimensions;
  • filenames without spaces;
  • filenames without special characters;
  • JPG, PNG or SVG depending on usage.

Cannot select an image

If Joomla says no filesystem providers were found, enable:

text
System → Plugins → Filesystem: Local

Cannot upload an image

Check:

  • permissions of the images folder;
  • PHP upload size;
  • allowed file types in Joomla;
  • file size;
  • filename characters.

Record does not save

Possible causes:

  • required field is missing;
  • invalid date format;
  • selected relation does not exist;
  • insufficient permissions;
  • record is checked out by another user.

Record is not visible in the list

Check:

  • search filter;
  • publishing filter;
  • list limit;
  • ordering;
  • whether you are in the correct component section.

Raw language constants after import

Older JoomLeague data may contain values such as:

text
COM_JOOMLEAGUE_...
JL_...

Do not delete these values from the database. They should be translated through language files. If a raw constant appears, a translation is missing.

Reporting a problem

Always include:

  • exact URL;
  • what you clicked;
  • what record you saved;
  • exact error message;
  • whether it happened in administration or frontend;
  • screenshot if possible.

Documentation is statically generated with VitePress.