User Tools

Site Tools


Sidebar

jtrackgallery.net
J!TrackGallery J!2.5 demo J!TrackGallery forum J!TrackGallery GitHub







manual:level:icons

Level icons

Difficulty is represented on a linear scale ranging from 1 to 5 by default. This can be represented by icons in front end.
The difficulty level can be represented in two ways: * multiple_symbols: each level is associated to a different symbols * single_symbol: one single symbol is repeated x time to represent x level (example level =4)

Futhermore, level icons can be associated to particular category so that the same difficulty is represented by different icons for trek and bike tracks for example. The category difficulty level can be represented in two ways:

  • category_single_symbol: one single symbol is repeated x time to represent x level
  • category_multiple_symbols: each level is associated to a different symbols

Icons folder

You can customize icons by simply copying icons to the icons folder which is /images/jtrackgallery/difficulty_level.
At install, the default icons are copied to this folder.

Icons naming convention

Icons naming use the difficulty level level and category id catid

symbolfilenameexamples
category_multiple_symbols (*) catid_level.png12_1.png
category_single_symbol (+) catid_l1.png catid_l2.png catid_l3.png15_l1.png 15_l2.png 15_l3.png
multiple_symbols (*) level.png1.png 4.png …
single_symbol (+) l1.png l2.png l3.pngl1.png l2.png l3.png
  • (*) Multiple_symbols sets must be defined for each possible value of the difficulty level.
  • (+) Single symbol sets must comprise 3 icons (l1 l2 l3) whose color differs. the maximun level (5 for example) will be represented by approximately one third of icons l1.png (2) one third with l2.png (1) and one third with l3.png (2).

Icons rendering rules

J!TrackGallery will render difficulty level following the rules

  • if present use — category_multiple_symbols
  • otherwise use — category_single_symbol
  • otherwise use — multiple_symbols
  • otherwise use — single_symbol
  • otherwise — display text

For the set given on this page:

  • category with id 15 will be rendered with: 15_l1.png 15_l2.png 15_3.png
  • all other categories will use: 1.png 2.png 3.png 4.png 5.png
  • if one track in category different from 15 has a level of 6 it will be rendered using l1.png l2.png l3.png because 6.png don't exists
  • l1.png l2.png l3.png are not used (if track level range from 1 to 5)
manual/level/icons.txt · Last modified: 2015/10/12 14:18 by cseguinot