DF
DF is a distribution consisting of modules, themes and libraries. It highlights powerful features created by the Drupal community. It is intended to be used as a starterkit for promoting enterprise-ready solutions.
Installation
Installation currently only supported via Drush commands. First, build the profile using Drush make.
drush make build-df.make ~/Destination/docroot
Use Composer Manager to install additional dependencies in the Drupal 8 docroot.
php profiles/df/modules/contrib/composer_manager/scripts/init.php && composer drupal-update
Note: depending on how you have gitignore set up, you may need to run composer drupal-update --no-dev
if you get a runtime error on drupal-update.
Use the site-install
command to install Drupal with the DF installation profile.
drush si df
Enable a DF Scenario using the enable-scenario
command.
drush es dfs_dev
If everything worked correctly, you should see console output that some migrations ran.
You may now login to your site.
drush uli -l http://mysite.dd
You may also reset the content of a DF Scenario if it is enabled.
drush rs dfs_dev
Using the Zurb Foundation Sub Theme
To motify the CSS/JS you must use the scss files. You will find various different SCSS files in SCSS directory that root. There are specifc ones for the theme in base & layout. All the variables are set in _settings.scss, you will also be able to override variables there.
To compile scss you will need a few things installed on your machine:
- NPM IF you need to install
- Bower
npm install -g bower
Then you will need to run:
npm install
bower install
if you need to update the vendor js, I added in some gulp files that make that easy.
gulp copy
will copy the bower_component files for zurb and motion uigulp concat
will concatenate all the files into a single vendor.all.js file and put it in your js/ folder where its already being called by drupal
Once that is installed, start the gulp file which will watch for scss changes:
npm start
Behat tests
Install the drupal-extension for mink/behat from the DF profile.
cd profiles/df/tests && composer install
Set up a behat.yml file replacing @BASE_URL@
with the URL to your site and @DRUPAL_ROOT@
with the path to your site on disk.
cp behat.template.yml behat.yml
Check that behat is installed and running.
bin/behat --help
Execute a batch of tagged features that apply to all DF Scenarios.
bin/behat --tags=df
Execute a batch of tagged features for a specific DF Scenario.
bin/behat --tags=dfs_dev