PHPackages                             localgovdrupal/localgov\_microsites - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. localgovdrupal/localgov\_microsites

ActiveDrupal-profile

localgovdrupal/localgov\_microsites
===================================

LocalGov Drupal Microsites distribution

4.4.0(6mo ago)611.3k↓50%2[105 issues](https://github.com/localgovdrupal/localgov_microsites/issues)GPL-2.0-or-laterPHPPHP &gt;=8.1CI failing

Since May 20Pushed 4mo ago8 watchersCompare

[ Source](https://github.com/localgovdrupal/localgov_microsites)[ Packagist](https://packagist.org/packages/localgovdrupal/localgov_microsites)[ Docs](https://github.com/localgovdrupal/localgov_microsites)[ RSS](/packages/localgovdrupal-localgov-microsites/feed)WikiDiscussions 4.x Synced 1mo ago

READMEChangelog (10)Dependencies (27)Versions (97)Used By (0)

[![GitHub Release](https://camo.githubusercontent.com/1230de9c0fc2ce19a32a940c5a285311609129d6d1b96610190532816999bcda/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c6f63616c676f7664727570616c2f6c6f63616c676f765f6d6963726f7369746573)](https://camo.githubusercontent.com/1230de9c0fc2ce19a32a940c5a285311609129d6d1b96610190532816999bcda/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6c6f63616c676f7664727570616c2f6c6f63616c676f765f6d6963726f7369746573)[![GitHub License](https://camo.githubusercontent.com/91231fc099f5ccb2da40861f49378a8d230fefb649ecfe9702680104e56362c0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c6f63616c676f7664727570616c2f6c6f63616c676f765f6d6963726f7369746573)](https://camo.githubusercontent.com/91231fc099f5ccb2da40861f49378a8d230fefb649ecfe9702680104e56362c0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6c6f63616c676f7664727570616c2f6c6f63616c676f765f6d6963726f7369746573)[![Tests](https://github.com/localgovdrupal/localgov_microsites/actions/workflows/test.yml/badge.svg)](https://github.com/localgovdrupal/localgov_microsites/actions/workflows/test.yml/badge.svg)

LocalGov Drupal Microsites
==========================

[](#localgov-drupal-microsites)

Drupal distribution and install profile to help UK councils collaborate and share Drupal code for publishing website content across a number of microsites from a single Drupal installation.

This repository is the Drupal installation profile that is best installed using composer to require a project template, localgov\_microsites\_project, to scaffold and build the codebase which includes this profile.

Please see [https://github.com/localgovdrupal/localgov\_microsites\_project](https://github.com/localgovdrupal/localgov_microsites_project)

Funding
-------

[](#funding)

This work was initially funded by the Local Digital Fund () from the Department for Levelling Up, Housing and Communities (DLUCH).

Supported branches
------------------

[](#supported-branches)

We are actively supporting and developing the 4.x branch for Drupal 10.

The 1.x, 2.x and 3.x branches are no longer actively supported and not recommended for new sites.

If you are still using the 1.x, 2.x or 3.x branches on your site, please [create an issue on Github](https://github.com/localgovdrupal/localgov_microsites/issues) to let us know.

Documentation
-------------

[](#documentation)

Further documentation for developers, content designers and other audiences can be found at .

Installation
------------

[](#installation)

For installation steps, see: [https://github.com/localgovdrupal/localgov\_microsites\_project](https://github.com/localgovdrupal/localgov_microsites_project)

Requirements for installing LocalGov Drupal locally for testing and development
-------------------------------------------------------------------------------

[](#requirements-for-installing-localgov-drupal-locally-for-testing-and-development)

To install LocalGov Drupal locally you will need an appropriate versions of:

- PHP (see )
- A database server like MySQL (see )
- A web server like APache2 (see )

Many of us use the Lando file included to run a local docker environmnent for testing and development, but seom people prefer to run the web servers natively on their host machine.

### PHP requirements

[](#php-requirements)

We folllow Drupal's PHP recomendations:

We currently recomend and test against PHP 8.1 and 8.2.

You will also need to have certain PHP extensions enabled (see ) including:

- PHP mbstring
- PHP cURL
- GD library
- XML

If you see errors when running composer require, double check your PHP extensions.

Developer notes for default content
-----------------------------------

[](#developer-notes-for-default-content)

This profile creates a single node of demo content using the [https://www.drupal.org/project/default\_content](https://www.drupal.org/project/default_content) module.

This node includes layout paragraphs and paragraph content to demonstrate some of the content components available for a new microsite. When a new microsite is created, it attempts to clone this node into the new microsite.

As developers, we often want to update the default content, using drush.

To export an item of content and all references:

```
lando drush dcer   --folder=profiles/contrib/localgov_microsites/content/
```

So for node/1:

```
lando drush dcer node 1 --folder=profiles/contrib/localgov_microsites/content/
```

Composer and Lando
------------------

[](#composer-and-lando)

To install locally, you will need Composer and we recommend using Lando for a consistent developer environment.

-
-

Please also see the Lando requirements section for details of Docker requirements for different operating systems.

Installing LocalGov Drupal locally with composer
------------------------------------------------

[](#installing-localgov-drupal-locally-with-composer)

To install LocalGov Drupal locally for testing or development, use the [Composer-based project template](https://github.com/localgovdrupal/localgov_microsites_project).

Change `MY_PROJECT` to whatever you'd like your project directory to be called.

```
composer create-project drupal/localgov_microsites_project --stability alpha --no-install MY_PROJECT
```

Change directory into the MY\_PROJECT directory and run lando start.

```
cd MY_PROJECT
lando start
```

Once lando has finished building, use lando to run composer install and the site installer.

```
lando composer install
lando drush si localgov_microsites -y
```

Note: As you might be running a different version of PHP on your host machine from the version that Lando runs, it is advisable to run composer install from within Lando. This ensures dependencies reflect the PHP version that the webserver is actually running.

Composer notes
--------------

[](#composer-notes)

If developing locally and you want to force composer to clone again from source rather than use composer cache, you can add the `--no-cache` flag.

```
lando composer create-project drupal/localgov_microsites_project --stability alpha --no-cache --no-install  MY_PROJECT
```

If you just want to pull in the latest changes to LocalGov Drupal run composer update with the `--no-cache` flag.

```
lando composer update --no-cache
```

If you want to be sure you are getting the latest commits when developing, clearing composer cache, deleting the folders and re-running composer update seems to be a solid approach:

```
rm -rf web/profiles/contrib/ web/modules/contrib/ web/themes/contrib/;
composer clear-cache; composer update --with-dependencies --no-cache;
lando start;
lando drush si localgov_microsites -y;
```

If you run into [memory limit errors](https://getcomposer.org/doc/articles/troubleshooting.md#memory-limit-errors)when running Composer commands, prefix the commands with `COMPOSER_MEMORY_LIMIT=-1`. For example, to install the project run:

```
COMPOSER_MEMORY_LIMIT=-1 composer create-project drupal/localgov_microsites_project MY_PROJECT
```

Contributing
------------

[](#contributing)

See [CONTRIBUTING.md](CONTRIBUTING.md) for current contribution guidelines.

Issue tracking
--------------

[](#issue-tracking)

Most issues will be tracked in this repository [https://github.com/localgovdrupal/localgov\_microsites/issues](https://github.com/localgovdrupal/localgov_microsites/issues).

Development issues relating to specific projects or module should be tracked in the project repository.

Development setup
-----------------

[](#development-setup)

The main development environment in use is currently [Lando](https://docs.lando.dev/) – a Docker based development environment that works on Linux, MacOS and Windows.

@todo Document Lando setup.

Coding standards
----------------

[](#coding-standards)

PHP CodeSniffer is installed as a dev dependency by Composer and configured to use Drupal coding standards and best practices. It is a good idea to run these before committing any code. All code in pull requests should pass all CodeSniffer tests.

To check code using Lando run:

```
lando phpcs
```

To attempt to automatically fix coding errors in Lando run:

```
lando phix
```

### Coding standards resources

[](#coding-standards-resources)

- [Drupal coding standards](https://www.drupal.org/docs/develop/standards)

Running tests
-------------

[](#running-tests)

The included `phpunit.xml.dist` file contains configuration for automatically running the LocalGov Drupal test suite.

To run all LocalGov Drupal tests with Lando use:

```
lando phpunit
```

To run all the tests for a specific module use:

```
lando phpunit web/modules/contrib/localgov_my_module
```

Tests can be filtered using the `--filter` option. To only run a specific test use:

```
lando phpunit --filter=myTestName
```

### Testing resources

[](#testing-resources)

- [PHPUnit documentation](https://phpunit.readthedocs.io/en/7.5/)
- [Drupal 8 PHPUnit documentation](https://www.drupal.org/docs/8/testing/phpunit-in-drupal-8)
- [Drupal 8 testing documentation](https://www.drupal.org/docs/8/testing)
- [Workshop: Automated Testing and Test Driven Development in Drupal 8](https://github.com/opdavies/workshop-drupal-automated-testing)

Maintainers
-----------

[](#maintainers)

This project is currently maintained by:

- Ekes:
- Finn Lewis:
- Maria Young:
- Mark Conroy:
- Stephen Cox:

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance52

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~34 days

Total

35

Last Release

127d ago

Major Versions

1.0.0-alpha1 → 2.0.0-beta-12022-12-08

2.1.x-dev → 3.0.0-alpha12023-10-02

3.0.0-alpha1 → 4.0.0-alpha12024-02-29

3.0.0-alpha2 → 4.0.12024-11-19

4.0.2 → 5.x-dev2025-05-29

PHP version history (2 changes)1.x-devPHP &gt;=7.4

2.0.0-beta-1PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/dd550678a915c9a6d451d08851556a1c866f8cc7c0e3f864b498a45d4d930577?d=identicon)[stephen-cox](/maintainers/stephen-cox)

![](https://www.gravatar.com/avatar/c215b54edbf914998f6f63747814fd96f117c2c6e1bb5ea0c0a0db24fd9b3901?d=identicon)[finnlewis](/maintainers/finnlewis)

![](https://www.gravatar.com/avatar/848d88262b2f9d984d12b55bd4a2e2f0e1d3c7abe9c63fc5cc13ecbab75cd19e?d=identicon)[ekes](/maintainers/ekes)

---

Top Contributors

[![finnlewis](https://avatars.githubusercontent.com/u/326588?v=4)](https://github.com/finnlewis "finnlewis (75 commits)")[![msayoung](https://avatars.githubusercontent.com/u/3852805?v=4)](https://github.com/msayoung "msayoung (47 commits)")[![stephen-cox](https://avatars.githubusercontent.com/u/7189914?v=4)](https://github.com/stephen-cox "stephen-cox (43 commits)")[![ekes](https://avatars.githubusercontent.com/u/237186?v=4)](https://github.com/ekes "ekes (30 commits)")[![markconroy](https://avatars.githubusercontent.com/u/2183332?v=4)](https://github.com/markconroy "markconroy (22 commits)")[![AWearring](https://avatars.githubusercontent.com/u/95761929?v=4)](https://github.com/AWearring "AWearring (3 commits)")[![FinnERLewis](https://avatars.githubusercontent.com/u/82151042?v=4)](https://github.com/FinnERLewis "FinnERLewis (2 commits)")[![tonypaulbarker](https://avatars.githubusercontent.com/u/4941711?v=4)](https://github.com/tonypaulbarker "tonypaulbarker (1 commits)")[![millnut](https://avatars.githubusercontent.com/u/8024370?v=4)](https://github.com/millnut "millnut (1 commits)")[![anthonylindsay](https://avatars.githubusercontent.com/u/3294888?v=4)](https://github.com/anthonylindsay "anthonylindsay (1 commits)")

### Embed Badge

![Health badge](/badges/localgovdrupal-localgov-microsites/health.svg)

```
[![Health](https://phpackages.com/badges/localgovdrupal-localgov-microsites/health.svg)](https://phpackages.com/packages/localgovdrupal-localgov-microsites)
```

###  Alternatives

[thunder/thunder-distribution

The thunder distribution

50634.8k3](/packages/thunder-thunder-distribution)[localgovdrupal/localgov

LocalGovDrupal distribution

100110.9k2](/packages/localgovdrupal-localgov)[voidagency/vactory_starter_kit

Vactory is a custom Drupal profile which is developed and released by VOID Agency.

1019.7k](/packages/voidagency-vactory-starter-kit)[drupalwxt/wxt

Project template for Drupal 10 sites built with the WxT distribution.

29159.8k8](/packages/drupalwxt-wxt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
