localgov
LocalGov Drupal is a distribution and install profile built to help UK councils publish public facing websites quicker, cheaper and better.
Find out more at https://localgovdrupal.org/
Read the docs at: https://docs.localgovdrupal.org/
It has been supported by:
- Ministry of Housing Communities and Local Government Local Digital Fund
- Brighton and Hove City Council
- Croydon Council
- Agile Collective
Contributions
We have a separate project to track and credit non-code contributions: https://www.drupal.org/project/localgov_contribution
Active development is now here on drupal.org!
It was previously on Github at
https://github.com/localgovdrupal/localgov
Supported branches
We are actively supporting and developing the 3.x branch.
The 1.x branch is no longer actively supported and not recommended for new sites.
The 2.x branch for Drupal 9 is no longer actively supported and not recommended for new sites.
If you are still using the 1.x or 2.x branch on your site, please create an issue to let us know.
Requirements for installing LocalGov Drupal locally
To install locally, you will need Composer and we recommend using DDEV or Lando.
See the respective requirements section for details of Docker requirements.
https://docs.lando.dev/basics/installation.html#system-requirements
Installing LocalGov Drupal locally on Drupal 11
Drupal 11 is supported on the 4.x branch. To install LocalGov Drupal locally for testing or development, use the composer-based project template.
Change MY_PROJECT to whatever you'd like your project directory to be called.
composer create-project --no-install drupal/localgov_project:^4.0 MY_PROJECT
Change directory into the MY_PROJECT directory and run ddev start.
cd MY_PROJECT
ddev start
Once ddev has finished building, run composer install.
ddev composer installthen run the site installer.
ddev drush si localgov -y
If you run into memory limit errors when running Composer commands, prefix the commands with COMPOSER_MEMORY_LIMIT=-1. For example:
COMPOSER_MEMORY_LIMIT=-1 composer create-project drupal/localgov_project:^4.0 MY_PROJECT
Drupal 10
Drupal 10 is supported on the 3.x branch.
For Drupal 10 rojects, we recommend using the composer project template with:
composer create-project drupal/localgov_project MY_PROJECT
Upgrading from Drupal 9 to Drupal 10
There are some significant changes to localgov_geo module that will need attention if you have geolocation entities in Drupal 9.
We have moved from using a localgov_geo entity to geo entity provide by https://www.drupal.org/project/geo_entity
Please read the localgov_geo 2.0.0 release notes on GutHub.
Also see more guidence on upgrading LocalGov Drupal from Drupal 9 to Drupal 10 at https://github.com/localgovdrupal/localgov/wiki/Upgrading-from-Drupal-9-...
Contributing
See CONTRIBUTING.md for current contribution guidelines.
Issue tracking
In the early development stages, most issues will be tracked in the github repository https://github.com/localgovdrupal/localgov/issues.
Development issues relating to specific projects or module should be tracked in the project repository. In the future we might set up a separate repository for centralised issue tracking of bug reports for end users.