The module creates minified stylesheets ‘on-the-fly’ (troubleshoot here if you have file permission issues). Each stylesheet will be different depending on the parameters that have been selected and on the overrides added for each instance.
A stylesheet named common_styles-min.css
is also used by all module instances (for the styles that are common to all module instances). It reduces the CSS footprint when using multiple instances on a single page.
You may want to add your own styles that are common to all module instances (for CSS additions specific to a module instance, use the CSS Overrides parameter).
In that case, all properties will start with .lnee
. In order to avoid loading those styles through the template (therefore loading the styles on every page, even when no module instance is present on that page), a simple mechanism has been put in place:
Under Joomla 3
- add the file
common_user_styles.css
to the module’s/styles
folder, - add the file
common_user_styles-min.css
to the module’s/styles
folder to load a minified version of your tweaks. It has precedence over the non-minified version.
Under Joomla 4
In the /media
folder:
- add the file
common_user_styles.css
to the module’s/css
folder, - add the file
common_user_styles-min.css
(common_user_styles.min.css
in v6.8+) to the module’s/css
folder to load a minified version of your tweaks. It has precedence over the non-minified version.
The module will look for those files and load the right version alongside all the other module's stylesheets (if the minified version is not found, it will load the non-minified one).
Power users: it is possible to disable the module styles altogether and replace them with your own:
Under Joomla 3
- add the file
substitute_styles.css
to the module’s/styles
folder, - add the file
substitute_styles-min.css
to the module’s/styles
folder to load a minified version of your CSS properties. It has precedence over the non-minified version.
Under Joomla 4
In the /media
folder:
- add the file
substitute_styles.css
to the module’s/css
folder, - add the file
substitute_styles-min.css
(substitute_styles.min.css
in v6.8+) to the module’s/css
folder to load a minified version of your CSS properties. It has precedence over the non-minified version.
Having any of those files present will disable the ‘on-the-fly’ stylesheet creation and prevent loading of the common files. If the minified version is not found, it will load the non-minified one.
- The previous files (
common_user_styles.css
,substitute_styles.css
and their minified versions) won't be removed on module update. - Minifying the code has to be done manually (you can use a tool such as the one found at cssminifier.com).