Gotchas

REVIEWED 230531

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

• May 29, 2023 - 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

• April 5, 2023 - Don't switch the upstream for a site from the deprecated drupal-project upstream to the new drupal-composer-managed upstream until the site has been upgraded to PHP 8. The new upstream has a commit that mandates Drupal 8: https://github.com/pantheon-systems/drupal-composer-managed/commit/40b46b2f69c306c0b1e0edf8972357f3de49e577 Support may recommend this course of action, but be careful

• May 29, 2023 - 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