haringsrob / drupal-icecat-base
Icecat project template
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:project
Requires
- ext-curl: *
- composer/installers: ^1.0.20
- cweagans/composer-patches: ~1.0
- drupal-composer/drupal-scaffold: ^2.0.1
- drupal/console: ~1.0
- drupal/core: ~8.2.0
- drupal/icecat: 1.x-dev
Requires (Dev)
- behat/mink: ~1.7
- behat/mink-goutte-driver: ~1.2
- jcalderonzumba/gastonjs: ~1.0.2
- jcalderonzumba/mink-phantomjs-driver: ~0.3.1
- mikey179/vfsstream: ~1.2
- phpunit/phpunit: ~4.8
- symfony/css-selector: ~2.8
Conflicts
This package is auto-updated.
Last update: 2020-06-07 16:19:04 UTC
README
Use Composer to get Drupal + Icecat with all dependencies.
Based on drupal-composer/drupal-project.
Usage
First you need to install composer.
Note: The instructions below refer to the global composer installation. You might need to replace
composer
withphp composer.phar
(or similar) for your setup.
After that you can create the project:
composer create-project haringsrob/drupal-icecat-base some-dir --stability dev --no-interaction
Done! Use composer require ...
to download additional modules and themes:
cd some-dir
composer require "drupal/devel:1.x-dev"
The composer create-project
command passes ownership of all files to the
project that is created. You should create a new git repository, and commit
all files not excluded by the .gitignore file.
What does the template do?
- Drupal is installed in the
web
directory. - Modules (packages of type
drupal-module
) are placed inweb/modules/contrib/
- Theme (packages of type
drupal-theme
) are placed inweb/themes/contrib/
- Profiles (packages of type
drupal-profile
) are placed inweb/profiles/contrib/
- Creates default writable versions of
settings.php
andservices.yml
. - Creates the
sites/default/files
directory. - Latest version of DrupalConsole is installed locally for use at
bin/drupal
.
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 --with-dependencies
to update Drupal Core and its dependencies. - Run
git diff
to determine if any of the scaffolding files have changed. Review the files for any changes and restore any customizations to.htaccess
orrobots.txt
. - Commit everything all together in a single commit, so
web
will remain in sync with thecore
when checking out branches or runninggit bisect
. - In the event that there are non-trivial conflicts in step 2, you may wish
to perform these steps on a branch, and use
git merge
to combine the updated core files with your customized files. This facilitates the use of a three-way merge tool such as kdiff3. This setup is not necessary if your changes are simple; keeping all of your modifications at the beginning or end of the file is a good strategy to keep merges easy.
FAQ
Should I commit the contrib modules I download
Composer recommends no. They provide argumentation against but also workrounds if a project decides to do it anyway.
How can I apply patches to downloaded modules?
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" } } }