settings: Add key 'smtpResult'

This is not meant to be a user (admin) configurable key.  Rather, this
is a mechanism for success/failure results from interactions with
PHPMailer to make their way back to the UI.  Down the road, email
sending functions should publish their true/false return value to this
configuration key.  The initial default value of "NULL" means no mail
send attempts have taken place.

1 files changed, 8 insertions, 0 deletions

diff --git a/app/class/settings.class.php b/app/class/settings.class.php
index 19fba6a..d936a62 100644
--- a/app/class/settings.class.php
+++ b/app/class/settings.class.php
@@ -147,6 +147,14 @@ abstract class settings
     {
         return self::option("smtpPasswd", "", $value);
     }
+
+    /*
+     * SMTP result of last attempted send - 'true', 'false', 'NULL'
+     */
+    public static function smtpResult(?string $value = NULL) : string
+    {
+        return self::option("smtpResult", "NULL", $value);
+    }
 }
 
 ?>