Drupal 8 Configuration Management

Stefan Borchert, Anja Schirwinski

• Editorial: Packt Publishing
• Año: 2015
• ISBN:
  9781783985203
• Categoría: Informatique
• Categoría: Programmation Open Source

Drupal 8 Configuration Management

---

Table of Contents

Drupal 8 Configuration Management

Credits

About the Authors

About the Reviewer

www.PacktPub.com

Support files, eBooks, discount offers, and more

Why subscribe?

Free access for Packt account holders

Preface

So what is configuration in Drupal terms?

How it works in Drupal 8

What this book covers

What you need for this book

Who this book is for

Conventions

Reader feedback

Customer support

Downloading the example code

Errata

Piracy

Questions

1. Understanding Configuration Management

An introduction to Configuration Management

Configuration

Content

Session

State

Why manage configuration?

Tracking configuration changes

Some version control best practices

Using a project management tool

Meaningful commit messages

Meaningful branches

A look back at Drupal 7

Manual Configuration Management

The hook_install()/hook_update_N() function

The Features module

What is the Features module?

Creating a Feature

The settings to export with Features

The settings to not export with Features

The Configuration Management module

Storing configuration variables in settings.php

How Drupal 8 takes care of Configuration Management

How to start using Configuration Management

Using version control to keep track of configuration changes

Types of configuration

Configuration storage and deploying between environments

Summary

2. Configuration Management for Administrators

Why do we want to manage our configuration?

Making a clone of your site

The Configuration Management interface

The interface options

Using full import/export

Single import/export

Summary

3. Drupal 8's Take on Configuration Management

The config directory

A simple configuration example

Config and schema files – what are they and what are they used for?

Config files

Schema files

Learning the difference between active and staging directories

Changing the active configuration storage

Changing the storage location of the active and staging directories

Simple configuration versus configuration entities

Simple configuration

Configuration entities

Summary

4. The Configuration Management API

A simple configuration API

Working with configuration data

Retrieving the configuration object

Getting configuration values

Setting configuration values

Removing configuration values

Best practices

Getting notified about configuration changes

Overriding the configuration

Global overrides

Language overrides

Module overrides

Avoiding overrides

Creating configuration entity types

Adding the basics

Taking control of your data

Summary

5. The Anatomy of Schema Files

What are schema files in Drupal?

The structure of a schema file

Properties

Data types

Reusing data types

Making data translatable

Dynamic type references

The element-key references

The sub-key references

The parent-key references

Coding standards

PHP API

Summary

6. Adding Configuration Management to Your Module

Default configuration

An example

Defining and using your own configuration

Setting your configuration file

Custom configuration entity types

Using the configuration

Creating a configuration form

Configuration forms in Drupal 7

Creating configuration forms in Drupal 8

Adding a form controller

Route and menu items

The result

Summary

7. Upgrading Your Drupal 7 Variables to the Drupal 8 Configuration

Upgrading your variables

Simple configuration

Complex configuration objects

Upgrading to the new state system

Providing an upgrade path for your variables

Migrating your data

Source plugins

Process plugins

Destination plugins

Running the migration

Summary

8. Managing Configuration for Multilingual Websites

Multilingual sites in Drupal 7

The Locale module

Content translation

Translating other types of content

Translation settings/configuration

Translating entities

Translating in Drupal 8

Configuration translation

Translating the configuration

Storing translations

Exporting and importing configuration translations

Summary

9. Useful Tools and Getting Help

Community documentation

The administration guide documentation

Contributed modules

The configuration inspector for Drupal 8

Configuration development

Drush

Exporting and importing your configuration using Drush commands

Forums

The issue queue

IRC chat

Summary

Questions

Index

Drupal 8 Configuration Management

Copyright © 2015 Packt Publishing

All rights reserved. No part of this book may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, without the prior written permission of the publisher, except in the case of brief quotations embedded in critical articles or reviews.

Every effort has been made in the preparation of this book to ensure the accuracy of the information presented. However, the information contained in this book is sold without warranty, either express or implied. Neither the authors, nor Packt Publishing, and its dealers and distributors will be held liable for any damages caused or alleged to be caused directly or indirectly by this book.

Packt Publishing has endeavored to provide trademark information about all of the companies and products mentioned in this book by the appropriate use of capitals. However, Packt Publishing cannot guarantee the accuracy of this information.

First published: March 2015

Production reference: 1130315

Published by Packt Publishing Ltd.

Livery Place

35 Livery Street

Birmingham B3 2PB, UK.

ISBN 978-1-78398-520-3

www.packtpub.com

Credits

Authors

Stefan Borchert

Anja Schirwinski

Reviewers

Greg Dunlap

Johannes Haseitl

Thomas Keitel

Jose A. Reyero

Dev Saran

Commissioning Editor

Julian Ursell

Acquisition Editor

Kevin Colaco

Content Development Editor

Shubhangi Dhamgaye

Technical Editor

Indrajit A. Das

Copy Editors

Alfida Paiva

Adithi Shetty

Project Coordinator

Harshal Ved

Proofreaders

Stephen Copestake

Maria Gould

Indexer

Priya Sane

Production Coordinator

Alwin Roy

Cover Work

Alwin Roy

About the Authors

Stefan Borchert has been working with Drupal for more than 9 years. In the community, he is better known by his nickname stBorchert. He contributes to Drupal by writing contributed modules, helping with Drupal Core, and providing help to new contributors as a project application review administrator. He is a founding partner and senior Drupal developer at undpaul, a Drupal Digital Agency based in Germany.

Anja Schirwinski got to know Drupal more than 8 years ago as a themer/site builder and went on to build several very different web applications with it for the company she worked for. She has been a parti...