From f3972aeb5a54bd426f5c9dac03cdc3d63b80fa8b Mon Sep 17 00:00:00 2001
From: Rupert Jabelman <rupert@jabelman.org>
Date: Wed, 31 Jul 2024 13:11:26 +0100
Subject: [PATCH 1/2] Adds new install step, which calls a new hook
 (hook_localgov_post_install), so modules can run tasks at the end of a site
 install.

---
 localgov.api.php | 16 ++++++++++++++++
 localgov.profile | 26 ++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)
 create mode 100644 localgov.api.php

diff --git a/localgov.api.php b/localgov.api.php
new file mode 100644
index 0000000..4febb03
--- /dev/null
+++ b/localgov.api.php
@@ -0,0 +1,16 @@
+<?php
+
+/**
+ * Run a task during the site installation process.
+ *
+ * This is intended for work that needs to happen when installing a localgov
+ * site, that can't happen in a module's hook_install(). This hook is invoked
+ * later in the install process, when everything bar the importing of
+ * translations is done.
+ *
+ * It can also be used to only run code during a site install, and not when a
+ * module is installed in an existing site.
+ */
+function hook_localgov_post_install() {
+
+}
diff --git a/localgov.profile b/localgov.profile
index 89a3619..7e92115 100644
--- a/localgov.profile
+++ b/localgov.profile
@@ -20,3 +20,29 @@ function localgov_page_attachments(array &$attachments): void {
     }
   }
 }
+
+
+/**
+ * Implements hook_install_tasks().
+ */
+function localgov_install_tasks(array &$install_state): array {
+  return [
+    'localgov_post_install_task' => [
+      'display_name' => t('Localgov post install'),
+      'display' => TRUE,
+    ],
+  ];
+}
+
+/**
+ * This is an install step, added by localgov_install_tasks().
+ *
+ * We use this step to call a hook to allow other localgov modules to set things
+ * up as part of the site installation process that they can't do in their
+ * install hooks.
+ */
+function localgov_post_install_task(): void {
+  \Drupal::moduleHandler()->invokeAllWith('localgov_post_install', function (callable $hook, string $module) {
+    $hook();
+  });
+}

From 73ea233575f0c9fc1ede57e9d34cb5df02d5582d Mon Sep 17 00:00:00 2001
From: Rupert Jabelman <rupert@jabelman.org>
Date: Wed, 31 Jul 2024 14:11:40 +0100
Subject: [PATCH 2/2] Code style.

---
 localgov.api.php | 18 ++++++++++++++++--
 localgov.profile |  1 -
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/localgov.api.php b/localgov.api.php
index 4febb03..e5bb791 100644
--- a/localgov.api.php
+++ b/localgov.api.php
@@ -1,5 +1,15 @@
 <?php
 
+/**
+ * @file
+ * Hooks provided by the LocalGov install profile.
+ */
+
+/**
+ * @addtogroup hooks
+ * @{
+ */
+
 /**
  * Run a task during the site installation process.
  *
@@ -11,6 +21,10 @@
  * It can also be used to only run code during a site install, and not when a
  * module is installed in an existing site.
  */
-function hook_localgov_post_install() {
-
+function hook_localgov_post_install(): void {
+  // Whatever your module needs to do goes here.
 }
+
+/**
+ * @} End of "addtogroup hooks".
+ */
diff --git a/localgov.profile b/localgov.profile
index 7e92115..af6aafa 100644
--- a/localgov.profile
+++ b/localgov.profile
@@ -21,7 +21,6 @@ function localgov_page_attachments(array &$attachments): void {
   }
 }
 
-
 /**
  * Implements hook_install_tasks().
  */