Are you enjoying the extensions? Did you like the support? Help others decide.

Leave a review
Information
Print

User stylesheets

Information
Latest News Enhanced

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).

Related tutorials and topics