From 6e957d14b60612a6b501a8fa3c3f3130f16ca61e Mon Sep 17 00:00:00 2001
From: Michael Stenta <mike@mstenta.net>
Date: Fri, 29 Sep 2017 10:21:41 -0400
Subject: [PATCH] Issue #2912780: Add a hook that fires when sensor data is
 POSTed

---
 .../farm_sensor_listener.api.php              | 43 +++++++++++++++++++
 .../farm_sensor_listener.module               |  3 ++
 2 files changed, 46 insertions(+)
 create mode 100644 modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.api.php

diff --git a/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.api.php b/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.api.php
new file mode 100644
index 00000000..49b7272b
--- /dev/null
+++ b/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.api.php
@@ -0,0 +1,43 @@
+<?php
+
+/**
+ * @file
+ * Hooks provided by farm_sensor_listener.
+ *
+ * This file contains no working PHP code; it exists to provide additional
+ * documentation for doxygen as well as to document hooks in the standard
+ * Drupal manner.
+ */
+
+/**
+ * @defgroup farm_sensor_listener Farm sensor module integrations.
+ *
+ * Module integrations with the farm_sensor_listener module.
+ */
+
+/**
+ * @defgroup farm_sensor_listener_hooks Farm sensor's hooks
+ * @{
+ * Hooks that can be implemented by other modules in order to extend farm_sensor_listener.
+ */
+
+/**
+ * Do more with sensor data after it has been stored to the database.
+ *
+ * @param FarmAsset $sensor
+ *   The sensor asset.
+ * @param string $key
+ *   The measurement name (ie: value, sensor1, sensor2, temperature, etc).
+ * @param string $value
+ *   The sensor value.
+ *
+ * @return array
+ *   Returns a build array to be merged into the sensor asset view page.
+ */
+function hook_farm_sensor_listener_data($sensor, $key, $value) {
+
+}
+
+/**
+ * @}
+ */
diff --git a/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.module b/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.module
index 6d7f3691..4334760a 100644
--- a/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.module
+++ b/modules/farm/farm_sensor/farm_sensor_listener/farm_sensor_listener.module
@@ -238,6 +238,9 @@ function farm_sensor_listener_process_data($sensor, $data) {
 
     // Enter the reading into the {farm_sensor_data} table.
     drupal_write_record('farm_sensor_data', $row);
+
+    // Invoke hook_farm_sensor_listener_data().
+    module_invoke_all('farm_sensor_listener_data', $sensor, $key, $value);
   }
 }