Knowledge base

Why do all of your themes come as a distribution?

To ensure that my themes are LibreJS-compatible, they all come as a distribution—even though it’s only a theme, really. The installer simply creates a node with all JavaScript licenses and links to it in the footer menu. For LibreJS being able to recognise the link, the link attributes module is installed to add the necessary rel="jslicense" attribute. You also find a text format Full HTML (without any options enabled) and a Basic page content type, since they are necessary to create the node. That’s it, no blows and whistles. You can build the website the way you want.

Installing a theme/distribution from drupalthemes

  • Download your distribution from drupalthemes.
  • Extract the distribution archive
  • Upload all files inside the dist/ folder to your web server’s directory where you want to install Drupal
  • Open your browser and navigate to your new Drupal site
  • Follow the installer script

Update a distribution

If there is a distribution update, you can download the new update from drupalthemes. Unfortunately, there won’t be an update notice in your Drupal installation. There are only notifications for distributions, themes and modules downloaded from the official Drupal website. If an update is available, proceed as following:

  • Make a backup of all your distribution modifications (i.e. modifications of custom.css)
  • Upload all files of the newly downloaded distribution version and overwrite the old files
  • Reapply your modifications
  • Clear the page cache

Depending on your site configuration, you’ll receive a notice when updates for Drupal or modules are available. You should update these on a regular base. If you updated Drupal or modules independently of our distribution, please only upload the files inside the profiles/custom/[distribution] directory.

Can I aggregate and compress CSS files?

If you enable CSS aggregation and compression, LibreJS-will not recognise the licenses anymore and block the scripts. However, the themes itselves will continue to work.

I installed a new module and now LibreJS complains about non-free JavaScript

All JavaScript licenses listed on licenses page cover the Drupal core and everything added by the distribution. If you install additional modules, you have to add those licenses yourself.

Every module has a MODULE.libraries.yml file for its libraries (while MODULE would be the machine-readable name of the module, i.e. link_attributes). There you should find the licenses of the JavaScript files used by the module. If there is no license, it might be the same license as Drupal itself, which is the GPLv2 or newer. The naming convention for LibreJS to recognize the licenses can be found in the LibreJS documentation.

Using only a theme without LibreJS support

If you only want to use the theme without the installer that adds the JavaScript licenses page, you can easily do so. The theme of every distribution is in profiles/custom/[distribution]/themes/[distribution]_theme/ folder. Upload the whole folder into the themes/ folder in your Drupal installation and activate it.