Merge pull request #250 from localgovdrupal/feature/group-integration

Feature: Group integration

.github/workflows/test.yml

@@ -101,6 +101,9 @@ jobs:
         with:
           path: ${{ env.LOCALGOV_DRUPAL_PROJECT_PATH }}
 
+      - name: Obtain suggested dependencies
+        run: composer --working-dir=./html/${LOCALGOV_DRUPAL_PROJECT_PATH} suggests --list | xargs composer --working-dir=./html require
+
   phpcs:
     name: Coding standards checks
     needs: build

composer.json

@@ -14,6 +14,7 @@
     },
     "suggest": {
         "drupal/scheduled_transitions": "Gives the ability to schedule the publishing and unpublishing of alert banners",
-        "localgovdrupal/localgov_core": "^1 || ^2"
+        "localgovdrupal/localgov_core": "^1 || ^2",
+        "drupal/group": "For Group integration."
     }
 }

modules/group_alert_banner/README.md

@@ -0,0 +1,16 @@
+# Group Alert banner
+LocalGov Alert banner integration with the [Group module](https://www.drupal.org/project/group).
+
+## Configuration
+### User permissions
+If you are using this module alongside the [localgov_microsites_group](https://github.com/localgovdrupal/localgov_microsites_group) module, then user permissions will be automatically setup during module installation.
+
+Otherwise enable at least the following permissions for **Groups**:
+- "Entity: View any alert banner entities" for both anonymous and authenticated users.
+- "Access Alert banner listing page" for group admins.
+
+### Block placement
+If you are using the [localgov_microsites_base theme](https://github.com/localgovdrupal/localgov_microsites_base), which is the default theme of the [LocalGov Drupal Microsites distribution](https://github.com/localgovdrupal/localgov_microsites_project), an Alert banner block will be automatically placed in the *Header* region.  For all other themes, place an Alert banner block in a theme region towards the top of the page.
+
+## Banner listing
+Once this module is installed, an *Alert banner* tab should appear in each Group page.  This page will list all the banners belonging to a Group.

modules/group_alert_banner/config/optional/block.block.localgov_alert_banner_microsites_base.yml

@@ -0,0 +1,21 @@
+langcode: en
+status: true
+dependencies:
+  module:
+    - localgov_alert_banner
+  theme:
+    - localgov_microsites_base
+id: localgov_alert_banner_microsites_base
+theme: localgov_microsites_base
+region: header
+weight: -10
+provider: null
+plugin: localgov_alert_banner_block
+settings:
+  id: localgov_alert_banner_block
+  label: 'Alert banner'
+  label_display: '0'
+  provider: localgov_alert_banner
+  include_types:
+    localgov_alert_banner: '0'
+visibility: {  }

modules/group_alert_banner/config/optional/group.relationship_type.microsite-41d536b28977e933e431cc.yml

@@ -0,0 +1,16 @@
+langcode: en
+status: true
+dependencies:
+  config:
+    - group.type.microsite
+    - localgov_alert_banner.localgov_alert_banner_type.localgov_alert_banner
+  module:
+    - group_alert_banner
+    - localgov_alert_banner
+id: microsite-41d536b28977e933e431cc
+group_type: microsite
+content_plugin: 'group_localgov_alert_banner:localgov_alert_banner'
+plugin_config:
+  group_cardinality: 0
+  entity_cardinality: 1
+  use_creation_wizard: false