Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Derived sites are sites that use ‘library themes’ or ‘public themes’. These themes were not custom made for a particular site or client, but have multiple sites that use that theme. It is important to remember that the source theme can push updates to all derived site themes. These updates override the existing theme files, content types and content fields. If you use a ‘library theme’ for your site, you can choose to unlink it from parent theme updates. However, if you want to use the parent theme’s updates, while still being able to change your derived site’s theme, there are a few things you can do:

...

layouts/theme.plate

Code Block
languagehtml
<head>
  {% include "layouts/_asset_files" %}
</head>

layouts/_asset_files.plate

...

child_theme/layouts/_asset_files.plate overrides the ‘regular’ layouts/_asset_files.plate. Your custom my-css.css can safely be placed among the ‘regular’ theme files, in the theme root.

 

Library theme builders info

...

Note

Keep in mind to keep the files in child_theme small and overridable. If you put an important theme file like theme.plate in child_theme, it means this theme file does not receive any updates, which can break your site in the future.

Keep the following best practices in mind:

  • Use as many included includes as possible. The smaller the theme files, the less a user has to override, if he wants to.

  • Make sure to send a notification about an update before actually pushing the update. You can send a notification to theme users from the theme dashboard.