thinkshout/drupal-project

ThinkShout's project template for Drupal 8 projects with composer

Saturday, June 23, 2018
by tauno
Repository
2 Watchers
4 Stars
40 Installations

PHP
0 Dependents
0 Suggesters
543 Forks
6 Open issues
22 Versions
8 % Grown

The README.md

You should no longer be using this repo to create a new project. Start from https://library.thinkshoutlabs.com/articles/new-drupal-site-setup instead., _(*1)

:::::::::::::::::::::: Customize code below ::::::::::::::::::::::

Development set-up

This is a Drupal 9 site built using the robo taskrunner. Clone this repo directly into ~/Sites using git clone and you will be ready to begin., _(*2)

This site uses PHP 7.4: make sure your local environment is running PHP 7.4 (you can run php --version to verify)., _(*3)

First you need to install composer., _(*4)

brew install composer, _(*5)

Next add ./vendor/bin to your PATH, at the beginning of your PATH variable, if it is not already there., _(*6)

Check with: echo $PATH, _(*7)

Update with: export PATH=./vendor/bin:$PATH, _(*8)

You can also make this change permanent by editing your ~/.zshrc file: export PATH="./vendor/bin:..., _(*9)

Initial build (existing repo) -- do this once

From within your ~/Sites directory run:, _(*10)

git clone git@github.com:thinkshout/new-project-name.git
cd new-project-name
composer install

Building

Running the robo configure command will read the .env.dist, cli arguments and your local environment (DEFAULT_PRESSFLOW_SETTINGS) to generate a .env file. This file will be used to set the database and other standard configuration options. If no database name is provided, the project name and the git branch name will be used. If no database name is provided, the project name and the git branch name will be used. Note the argument to pass to robo configure can include: --db-pass; --db-user; --db-name; --db-host., _(*11)

robo configure
# Use an alternate DB password
robo configure --db-pass=<YOUR LOCAL DATABASE PASSWORD>
# Use an alternate DB name
robo configure --db-name=<YOUR DATABASE NAME>
# Use an alternate release/production/live branch name
robo configure --prod-branch=<YOUR BRANCH NAME>

The structure of DEFAULT_PRESSFLOW_SETTINGS if you want to set it locally is:, _(*12)

DEFAULT_PRESSFLOW_SETTINGS_={"databases":{"default":{"default":{"driver":"mysql","prefix":"","database":"","username":"root","password":"root","host":"localhost","port":3306}}},"conf":{"pressflow_smart_start":true,"pantheon_binding":null,"pantheon_site_uuid":null,"pantheon_environment":"local","pantheon_tier":"local","pantheon_index_host":"localhost","pantheon_index_port":8983,"redis_client_host":"localhost","redis_client_port":6379,"redis_client_password":"","file_public_path":"sites\/default\/files","file_private_path":"sites\/default\/files\/private","file_directory_path":"site\/default\/files","file_temporary_path":"\/tmp","file_directory_temp":"\/tmp","css_gzip_compression":false,"js_gzip_compression":false,"page_compression":false},"hash_salt":"","config_directory_name":"sites\/default\/config","drupal_hash_salt":""}

Configure Drush

Drush options can be configured in the .env file. For example, to set a default uri for commands like drush uli, add this:, _(*13)

DRUSH_OPTIONS_URI="https://web.new-project-name.localhost"

Drush configuration docs, _(*14)

Installing -- do this regularly (after changing branches especially)

Running the robo install command will run composer install to add all required dependencies and then install the site and import the exported configuration., _(*15)

robo install

Committing code -- do this regularly

Each time you start a new task, you should create a branch from production with the github ticket number and a short description of the ticket's goal in the branch:, _(*16)

git checkout production
git pull
git checkout -b issue-123-short-description

As a best practice, you should now re-install, _(*17)

robo install

Now work on your changes. Make sure configuration changes are saved in the codebase. If you make a config change and it doesn't seem to affect your codebase (i.e. it doesn't make any changes to the config folder), run a drush cex., _(*18)

Once you're happy with your changes, create a pull request from your branch to the develop branch in github and tag the tech lead or PM in the PR. Also move your ticket into the "Tech Review" column on Zenhub. Someone will then review the PR for potential improvements or fixes, and merge, and move the ticket into the "Ready to deploy" column in Zenhub. This ticket is now ready to go out with the next release., _(*19)

Testing -- do as needed

Test are run automatically on CircleCI, but can be run locally as well with:, _(*20)

robo test

We're also running the Drupal Code Sniffer on our custom module and theme directories. If you submit a PR with some coding standard errors, your build will fail on circle. You can get your local site machine to run this same code sniffer by running these commands:, _(*21)

composer code-sniff

If you have errors, you can run this command to fix most of those errors automagically:, _(*22)

composer code-sniff-fix

This site also runs Visual Regression tests both during the PR phase on backstopjs and nightly on the develop multidev. More info about the backstopjs, including how to run locally, can be found in the .ci/test/visual-regression README., _(*23)

If you need to apply patches (depending on the project being modified, a pull request is often a better solution), you can do so with the composer-patches plugin., _(*24)

To add a patch to drupal module "foobar" insert the patches section in the extra section of composer.json:, _(*25)

"extra": {
    "patches": {
        "drupal/foobar": {
            "Patch description": "URL to patch"
        }
    }
}

Updating Drupal Core

This project will attempt to keep all of your Drupal Core files up-to-date; the project drupal-composer/drupal-scaffold is used to ensure that your scaffold files are updated every time drupal/core is updated. If you customize any of the "scaffolding" files (commonly .htaccess), you may need to merge conflicts if any of your modified files are updated in a new release of Drupal core., _(*26)

Follow the steps below to update your core files., _(*27)

Run composer update drupal/core "drupal/core-*" --with-all-dependencies to update Drupal Core and its dependencies.

The Versions

23/06 2018

dev-8.x-pantheon

ThinkShout's project template for Drupal 8 projects with composer

project drupal-project

ThinkShout's project template for Drupal 8 projects with composer

thinkshout/drupal-project

The README.md

:::::::::::::::::::::: Customize code below ::::::::::::::::::::::

Development set-up

Initial build (existing repo) -- do this once

Building

Configure Drush

Installing -- do this regularly (after changing branches especially)

Committing code -- do this regularly

Testing -- do as needed

Updating Drupal Core

The Versions

dev-8.x-pantheon

The Requires

The Development Requires

by ThinkShout

dev-extensions_cleanup

The Requires

The Development Requires

by ThinkShout

dev-no-metatags

The Requires

The Development Requires

by ThinkShout

dev-dev-settings

The Requires

The Development Requires

by ThinkShout

dev-circle-env-for-config

The Requires

The Development Requires

by ThinkShout

dev-use-regular-behat

The Requires

The Development Requires

by ThinkShout

dev-8.x-pantheon-core-8.5.0

The Requires

The Development Requires

by ThinkShout

dev-update-to-84

The Requires

The Development Requires

by ThinkShout

8.x-dev

The Requires

The Development Requires

by ThinkShout

dev-latest-d8-drop

The Requires

The Development Requires

by ThinkShout

dev-update-patches

The Requires

The Development Requires

by ThinkShout

dev-circleci-2

The Requires

The Development Requires

by ThinkShout

dev-issue-5-module-review

The Requires

The Development Requires

by ThinkShout

dev-updates

The Requires

The Development Requires

by ThinkShout

dev-fixing-build

The Requires

The Development Requires

by ThinkShout

dev-config_installer

The Requires

The Development Requires

by ThinkShout

dev-base-install-with-media

The Requires