Skip to main content

Drupal

Welcome to drupal.docs.cern.ch, your one-stop Drupal resource at CERN.

Support

We strive to make these docs your go-to place for anything Drupal. We are continuously expanding the website with guides and tutorials for most use-cases.

There are various ways to get in touch, depending on your needs:

  • Mattermost channel Drupal Infra is a place for informal, technical exchange with the community and with the service managers.
  • Drupal Community Forum is a place for informal, technical exchange with advanced users from the community.
  • For any questions or concerns regarding the service or your website, please open a ticket.

Roadmap

The Drupal service follows as close as possible the Drupal release cycle and support at most two versions at the same time. Once a Drupal release becomes end-of-life (EOL), it will no longer be supported at CERN as well. Accordingly, users must ensure their website is running the supported Drupal version to receive centralised support.

All updates and upgrades are communicated to the users via the Notifications service and/or via a Service Status Board announcement.

The only supported version currently is Drupal 10. Drupal 10 is expected to be supported at CERN until mid of 2026.

Drupal 9 is EOL since November 2023.

Service level

Drupal is a service centrally provided by the IT department in close collaboration with the Web Team (IR-ECO).

Website development

No expertise or support is provided regarding website development. Support is limited to the infrastructure maintenance or website malfunction. It is thus strongly recommended to not exceed what is offered centrally in the CERN Drupal Distribution as this introcue additional complexity and maintenance which would be the responsibility of the website owner(s). For guidance regarding Drupal development or theming, please consider reaching other community experts via the means listed under #Support.

User responsibility

A Drupal website is by default publicly accessible. Accordingly, as with any IT offering, it must adhere to CERN's rules, regulations and guidelines on subjects such as design, accessibility, and security. Additionally, in order to ensure CERN's Digital Identity, any website must adhere to the CERN Web Presence Guidelines.

In this way, all users must adhere to all guidelines indicated thought out the documentation or risk having their website blocked without prior notice. Additionally, make sure you follow all the guidelines under Data Privacy. This is particularly important if additional, custom modules are installed which collect or otherwise aggregate user data.

CERN Drupal Distribution and customisation

CERN provides and maintains a curated collection of Drupal modules called the CERN Drupal Distribution. For the full list of modules, please refer to Introduction to Modules. Any module or functionality which exceeds what is centrally provided is the sole responsibility of the website owner and its administrators.

The official recommendaiton is to avoid installing any additional module(s) or theme(s)! Conforming exclusively to the central distribution is the only way to ensure smooth operations, and to benefit from centrally provided upgrades and migrations. If you inherit a customised website, the general recommendation is to attempt simplifying it, stripping away any customisation and ensuring conformance with what is centrally offered. If you find yourself in this situation, please do not hesitate reaching out for assistance.

Customisation disclaimer

Please note that installing and using custom modules requires:

  • (a) continuous maintenance;
  • (b) continuous attention to updates, security patches, and new feature releases;
  • (c) ensuring compatibility with the supported Drupal version; and
  • (d) manual work for the webmaster who will have to carefully check that everything works as expected on their side everytime any central upgrade is available.

This work will solely be the responsibility of the website owner(s) as any custom module not in the CERN Drupal Distribution will not benefit from the centrally managed updates.

Any website is a living and breathing piece of software. As such, once a given Drupal version reaches end-of-life, it will no longer receive further security updates. Running an outdated version of Drupal necessarily puts the website, and consequently CERN's reputation, at risk. Accordingly, upgrades will, at some point, be forced through; even if doing so breaks compatibility with customised modules.

If you require a set-and-forget solution, please do not exceed what is offered in the CERN Drupal Distribution. By using this service with custom modules, you agree to take active part in the upgrades process, allowing us to follow the upstream release cycles in due time.

In the event that the modules provided via the CERN Drupal Distribution are not sufficient for your needs, we recommend you either:

  • post on the CERN Drupal Community Forums/Mattermost to see whether others have already achieved what you are looking for;
  • submit a request to the Drupal Team to evaluate whether the feature(s) you require can be accommodated by adding a new module to the CERN Drupal Distribution, benefiting all CERN websites.

Data privacy

Please refer to the information in the CERN's Data Privacy Office website and make sure that you read and agree with the Drupal Service Data Privacy Police before using the service.

Additionally, please ensure you follow all the guidelines under Cookie Policy.

How can I help?

This documentation is open and accessible by everyone with a CERN account. If you spot an error, a typo, or would like to propose changes, please click Edit this page at the bottom of any page. Clicking this link takes you to the below screen directly on our Gitlab page (https://gitlab.cern.ch/drupal/paas/drupal-documentation/). On here, you can submit your proposed changes. We will then review your submissions and update the documentation accordingly.

We intend for this documentation to be living and breathing.