Falcon Development

Naming conventions

Custom modules should be placed into the modules/custom directory and prefixed with falcon_ string, for instance falcon_example.

Packaged features should be placed into modules/features directory and prefixed with falcon_feature_ string, for instance falcon_feature_example.

Adding a new module

When adding a new module to the Falcon distribution developer should decide if it is needed on every site consuming the distribution. If this is the case then it should be enabled using hook_update_N() in the falcon_deploy module and also added as a dependency into falcon.info.yml file so it gets installed on new installations. If the module is not required on every site then it should either be a dependency for some other modules/features or enabled by the team managing specific client site.

Falcon Dashboard

Falcon provides a lightweight administration dashboard for users who don’t need full access to all Drupal administration tools.

The dashboard is available at /dashboard and integrated with Admin Toolbar.

Permissions

  • Users need “Use the administration toolbar” permission to access Dashboard from the toolbar.
  • Users need “Use default admin toolbar” permission to access Administration menu from the toolbar.

There are two ways to place new categories and items on the dashboard:

  1. Export config menu items into features using Config menu link module. Preferred option for Falcon features.
  2. Add normal menu items (content level) and flush cache.

Creating releases

Requirements

  • New release should be based on master branch.
  • New release tag should look like “1.0.0”.

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make incompatible API changes.
  • MINOR version when you add functionality in a backwards-compatible manner.
  • PATCH version when you make backwards-compatible bug fixes.

You can read documentation for more info about version standardization.

Create new release

  1. Make sure you switched to the master branch and have the latest version of it.
  2. Create a new tag git tag -a 1.1.0 -m "Version 1.1.0"
  3. Push a new tag to github.com git push origin 1.1.0
  4. Go to Releases page on github and Draft a new release
  5. Choose tag version, add Release title (e.g. “1.1.0 (March 7, 2019)”), mention main changes since last release in Description (e.g. 1.1.0) and publish the release.

You can read official Github instruction for more info how to create releases.