thinkshout / drupal-project
ThinkShout's project template for Drupal 8 projects with composer
Installs: 83
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 5
Forks: 940
Open Issues: 1
Type:project
Requires
- php: ^7.4
- composer/installers: ^1.2
- cweagans/composer-patches: ^1.6
- dmore/behat-chrome-extension: ^1.3
- drupal/admin_toolbar: ^2.2
- drupal/config_split: ^1.3
- drupal/core-composer-scaffold: ^9.0.0
- drupal/core-recommended: ^9.0.0
- drupal/editor_advanced_link: ^1.4
- drupal/email_registration: ^1.0-rc5
- drupal/fast_404: ^2.0@alpha
- drupal/field_group: ^3.0-beta1
- drupal/honeypot: ^1.27
- drupal/inline_entity_form: ^1.0-rc1
- drupal/linkit: ^5.0.0-beta7
- drupal/menu_block: ^1.5
- drupal/metatag: ^1.5
- drupal/pathauto: ^1.2
- drupal/redirect: ^1.2
- drupal/redis: ^1.0
- drupal/simple_sitemap: ^4.1
- drupal/smart_trim: ^1.1
- pantheon-systems/drupal-integrations: ^8
- webflo/drupal-finder: ^1.2
- webmozart/path-util: ^2.3
Requires (Dev)
- drupal/coder: ^8.3
- drupal/config_suite: ^2.0
- drupal/devel: ^4.1
- drupal/drupal-extension: ^4.1
- drupal/field_tools: ^1.0@alpha
- drupal/stage_file_proxy: ^1.2
- thinkshout/robo-drupal: ^3.1
- zaporylie/composer-drupal-optimizations: ^1.2
Conflicts
- dev-8.x-pantheon
- 8.x-dev
- 7.x-dev
- dev-build-project-customizations
- dev-composer-scaffold-example
- dev-core_patch_update
- dev-pantheon-quicksilver
- dev-scaffold
- dev-prod-branch
- dev-compile_css
- dev-82-allow-php-7-3
- dev-update-plugin-lazy-load-patch
- dev-prod-branch-test
- dev-ajax_timeout
- dev-add_field_tools_dev
- dev-ticket-templates
- dev-improved-memory
- dev-drupal-recommends-update
- dev-pr-template
- dev-no-symfony
- dev-dotenv
- dev-drupal-composer-8.x
- dev-71-dumb-404s
- dev-encp_updates
- dev-8.x-upstream
- dev-minimal-config
- dev-issue-53
- dev-57-update-circle-readme
- dev-remove-page-cache
- dev-database-source-of-truth
- dev-extensions_cleanup
- dev-dev-settings
- dev-8.x-pantheon-core-8.5.0
- dev-latest-d8-drop
- dev-update-patches
- dev-circleci-2
- dev-issue-5-module-review
- dev-updates
- dev-fixing-build
- dev-config_installer
- dev-base-install-with-media
- dev-hash-salt
This package is auto-updated.
Last update: 2024-10-08 04:01:24 UTC
README
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.
:::::::::::::::::::::: 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.
This site uses PHP 7.4: make sure your local environment is running PHP 7.4 (you can run php --version
to verify).
First you need to install composer.
brew install composer
Next add ./vendor/bin
to your PATH, at the beginning of your PATH variable, if it is not already there.
Check with:
echo $PATH
Update with:
export PATH=./vendor/bin:$PATH
You can also make this change permanent by editing your ~/.zshrc
file:
export PATH="./vendor/bin:...
Initial build (existing repo) -- do this once
From within your ~/Sites
directory run:
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.
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:
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:
DRUSH_OPTIONS_URI="https://web.new-project-name.localhost"
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.
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:
git checkout production
git pull
git checkout -b issue-123-short-description
As a best practice, you should now re-install
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
.
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.
Testing -- do as needed
Test are run automatically on CircleCI, but can be run locally as well with:
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:
composer code-sniff
If you have errors, you can run this command to fix most of those errors automagically:
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.
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.
To add a patch to drupal module "foobar" insert the patches section in the extra
section of composer.json:
"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.
Follow the steps below to update your core files.
- Run
composer update drupal/core "drupal/core-*" --with-all-dependencies
to update Drupal Core and its dependencies.