GH-126 Add recipient data fetchers, by uid & by name

mdziekon · Sep 23, 2020 · 41e73c6 · 41e73c6
1 parent a70e259
commit 41e73c6
Show file tree

Hide file tree

Showing 3 changed files with 112 additions and 0 deletions.
diff --git a/modules/messages/_includes.php b/modules/messages/_includes.php
@@ -14,6 +14,8 @@
     include($includePath . './utils/batchMessageUpdates.utils.php');
     include($includePath . './utils/createReplyMessageSubject.utils.php');
     include($includePath . './utils/fetchFormDataForReply.utils.php');
+    include($includePath . './utils/fetchRecipientDataByUserId.utils.php');
+    include($includePath . './utils/fetchRecipientDataByUsername.utils.php');
     include($includePath . './utils/getMessageCopyId.utils.php');
     include($includePath . './utils/sendMessage.utils.php');
     include($includePath . './validators/validateWithIgnoreSystem.validators.php');

diff --git a/modules/messages/utils/fetchRecipientDataByUserId.utils.php b/modules/messages/utils/fetchRecipientDataByUserId.utils.php
@@ -0,0 +1,55 @@
+<?php
+
+namespace UniEngine\Engine\Modules\Messages\Utils;
+
+/**
+ * Fetches necessary data of a message recipient.
+ *
+ * @param array $params
+ * @param string $params['userId']
+ */
+function fetchRecipientDataByUserId($params) {
+    $userId = intval($params['userId']);
+
+    if (!($userId > 0)) {
+        return [
+            'isSuccess' => false,
+            'errors' => [
+                'isUserIdInvalid' => true,
+            ],
+        ];
+    }
+
+    $query_fetchRecipientData = (
+        "SELECT `id`, `username`, `authlevel` " .
+        "FROM {{table}} " .
+        "WHERE `id` = '{$userId}' " .
+        "LIMIT 1 " .
+        ";"
+    );
+    $result_fetchRecipientData = doquery($query_fetchRecipientData, 'users', true);
+
+    if (!$result_fetchRecipientData) {
+        return [
+            'isSuccess' => false,
+            'errors' => [
+                'notFound' => true,
+            ],
+        ];
+
+        return;
+    }
+
+    $recipientData = [
+        'id' => $result_fetchRecipientData['id'],
+        'username' => $result_fetchRecipientData['username'],
+        'authlevel' => $result_fetchRecipientData['authlevel'],
+    ];
+
+    return [
+        'isSuccess' => true,
+        'payload' => $recipientData,
+    ];
+}
+
+?>
diff --git a/modules/messages/utils/fetchRecipientDataByUsername.utils.php b/modules/messages/utils/fetchRecipientDataByUsername.utils.php
@@ -0,0 +1,55 @@
+<?php
+
+namespace UniEngine\Engine\Modules\Messages\Utils;
+
+/**
+ * Fetches necessary data of a message recipient.
+ *
+ * @param array $params
+ * @param string $params['username']
+ */
+function fetchRecipientDataByUsername($params) {
+    $username = trim($params['username']);
+
+    if (!preg_match(REGEXP_USERNAME_ABSOLUTE, $username)) {
+        return [
+            'isSuccess' => false,
+            'errors' => [
+                'isUsernameInvalid' => true,
+            ],
+        ];
+    }
+
+    $query_fetchRecipientData = (
+        "SELECT `id`, `authlevel` " .
+        "FROM {{table}} " .
+        "WHERE `username` = '{$username}' " .
+        "LIMIT 1 " .
+        ";"
+    );
+    $result_fetchRecipientData = doquery($query_fetchRecipientData, 'users', true);
+
+    if (!$result_fetchRecipientData) {
+        return [
+            'isSuccess' => false,
+            'errors' => [
+                'notFound' => true,
+            ],
+        ];
+
+        return;
+    }
+
+    $recipientData = [
+        'id' => $result_fetchRecipientData['id'],
+        'username' => $username,
+        'authlevel' => $result_fetchRecipientData['authlevel'],
+    ];
+
+    return [
+        'isSuccess' => true,
+        'payload' => $recipientData,
+    ];
+}
+
+?>