Overview of Drupal Recipes

Drupal 10.3 introduced the concept of Recipes as Experimental APIs, aiming to enhance the way developers create and manage Drupal sites. This new feature allows for easy sharing and composition of site configurations, replacing traditional installation profiles and streamlining the setup process.

Overview of Drupal Recipes

• What are Recipes?: Recipes are a new way to package and share configurations, modules, and themes, making it easier to set up Drupal sites with predefined settings and features.
• Standard Recipe: Drupal 10.3 includes a Standard recipe that serves as a foundational template for building sites, simplifying the initial setup for developers.

Key Benefits of Using Recipes

• Modularity: Recipes can be composed from other recipes, allowing for a modular approach to site building. This promotes reusability and reduces redundancy in configurations.
• Ease of Use: By providing a structured way to manage site configurations, Recipes make it easier for developers to onboard new projects and maintain existing ones.

Understanding Drupal Recipes

• Definition: Recipes are a method for packaging site configurations, modules, and themes, allowing developers to share and reuse setups across different projects.
• Purpose: They aim to replace traditional installation profiles, providing a more flexible and efficient way to configure Drupal sites.

Core Features of Recipes

• Standard Recipe: The introduction of a Standard recipe serves as a foundational template, streamlining the initial setup for developers and ensuring consistency across projects.
• Dependency Management: Recipes can depend on other recipes, enabling a composable architecture that allows for complex configurations to be built from simpler components.

Advantages of Using Recipes

• Modularity: Recipes promote a modular approach, allowing developers to create reusable components that can be easily integrated into various projects.
• Simplified Configuration Management: By structuring configurations in a clear manner, Recipes reduce the complexity of managing site settings, making it easier for developers to
• onboard new projects.

Applying Recipes in Drupal

• Execution: Developers can apply recipes using Drush commands, making the process straightforward. For example, to apply an image media type recipe, one would run:

  • ddev drush recipe core/recipes/image_media_type

• Validation: Recipes include validation checks to ensure that existing configurations match the recipe definitions, preventing conflicts and ensuring a smooth application process.

Use Cases for Recipes

• Media Management: Recipes can be used to create media types, such as images and videos, allowing for a more organized media library.
• Custom Workflows: Developers can create custom workflows tailored to specific project needs, enhancing collaboration and content management.

More information about recipe can be found here.

An example Drupal recipe.yml

name: 'Example recipe'
description: "An example Drupal recipe description"
type: 'Content type'

recipes:
  - another_recipe

install:
  - node
  - text
config:
  import:
    node:
      - node.type.article
    text: *
  actions:
    user.role.editor:
      createIfNotExists:
        label: 'Editor'
      grantPermissions:
        - 'delete any article content'
        - 'edit any article content'
content:
# A Drupal recipe can have a content directory. All content in this directory
# will be created after the configuration is installed.