README

What is Blueberry Dristrib D8

The Blueberry Distrib D8 provides a pre-installed website for Drupal 8 with the basic modules and an administration theme configured.

Requirements

Composer

Installation

First declare a PROJECT_CODE variable which will be used as project folder and database name :

sh/bash/zsh: export PROJECT_CODE="blueberry"
fish: set PROJECT_CODE "blueberry"

Then, get the code source of the profile Blueberry, you can run the command below :

composer create-project margauxdupuy/blueberry-project --stability=dev $PROJECT_CODE

Then you can choose which module packages you want to activate by adding them in Drupal installation form (not ready in command line).

Finally, completes the installation of the profile, assuming you can access a database on localhost with root:root :

cd $PROJECT_CODE
drush site-install blueberry site-default-country=CH date-default-timezone="Europe/Zurich" --db-url=mysql://root:root@localhost/$PROJECT_CODE --account-mail="admin@example.com" --account-name=admin --account-pass=admin --site-mail="admin@example.com" --site-name="$PROJECT_CODE"
drush cex -y

Theme installation

Update

To update Drupal Core and its dependencies, run :

composer update drupal/core webflo/drupal-core-require-dev "symfony/*" --with-dependencies

To update Blueberry profile, run :

composer update druids/blueberry --with-dependencies

Enable developer mode / disable cache

Source : https://www.liip.ch/en/blog/lets-debug-drupal-8

Uncomment these lines in settings.php :

if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) {
  include $app_root . '/' . $site_path . '/settings.local.php';
}

Create the file settings.local.php in web/sites/default (you can duplicate example.settings.local.php).

Uncomment/update some values in settings.local.php` :

uncomment this line to enable the “null cache service”:

$settings['container_yamls'][] = DRUPAL_ROOT . '/sites/development.services.yml';

uncomment these lines to disable CSS/JS aggregation:

$config['system.performance']['css']['preprocess'] = FALSE;
$config['system.performance']['js']['preprocess'] = FALSE;

uncomment these lines to disable the render cache and the dynamic page cache:

$settings['cache']['bins']['render'] = 'cache.backend.null';
$settings['cache']['bins']['dynamic_page_cache'] = 'cache.backend.null';

you can allow test modules and themes to be installed if needed with:

$settings['extension_discovery_scan_tests'] = TRUE;

Disable Twig caching in development.services.yml and add the following settings :

parameters:
    twig.config:
        debug: true
        auto_reload: true
        cache: false

margauxdupuy / blueberry-project

Maintainers

Details