Gotchas

REVIEWED 230529

The goal of this page is to let us document our previous mistakes to avoid making them again. Hopefully, it will let you learn from someone else's mistakes instead of making them yourself.

Drupal

Layout

1. Paragraphs are not translatable. If you use the paragraphs module to allow layout flexibility on a multilingual site, there are important things to consider. If there ever needs to be variations between the layouts of each language, you are likely to wish you’d done your layouts differently. Paragraphs will expect the same paragraphs to be added in the same order to your content in all languages. The workaround was to add display checkboxes to each paragraph type so that we could omit the items not to be displayed in the current language. This still meant that the paragraphs for all language layouts has to be present in all languages which made editing and manipulating them very error-prone.

Pantheon

Secrets

1. Pantheon’s secret.json created by the Terminus Secrets Plugin is copied between environments just like any other file when you sync files.  This negates the ability to use it for environment variables, because when you sync files you bring the environment variables over.  There is a new solution for this in early access: Pantheon Secrets Manager.  If you need the secrets to allow you to set environment variables for use with the key module, use Pantheon Secrets in concert with the Early Access Secrets Manager.

Review History