css/README.stylesheets

   1 Some notes about stylesheets:
   2
   3 * NOT every directory in css/ is considered a style to be chosen. The available
   4   stylesheets are hardcoded in at least 3 places:
   5   - SL/Auth.pm:read_user
   6   - SL/Controller/Admin.pm:init_stylesheets
   7   - bin/mozilla/am.pl:config
   8   yes it sucks. change it, if you like.
   9
  10 * If a stylesheet is requests from controller code, it is searched in this order:
  11   - css/<stylesheet_of_current_user>/<path>
  12   - css/<path>
  13   - <path>
  14
  15   so common libraries can be put higher here, to be included by any stylesheet
  16
  17 * 'kivitendo' is used as the fallback style if no style was found or the style
  18   chosen was invalid.
  19
  20 * Pay attention to the position of relative image urls. Most should not be
  21   included in css anyway but should use the generated icon maps. For the rest,
  22   a couple of ../ may be needed to get the right path.
  23
  24 * If you edit another styles, these are things that are known to get broken.
  25   Be sure to test them thoroughly:
  26   - tabs
  27   - calendars
  28   - all menus
  29   - autocompletion (parts/customers)
  30   - charts of accounts
  31   - multiselect
  32   - ckeeditor
  33   - jquery-ui widgets (i hate those things)