Reactions revamp & profile widgets

core/classes/DTO/Reaction.php

@@ -0,0 +1,71 @@
+<?php
+/**
+ * Represents a reaction.
+ *
+ * @package NamelessMC\DTO
+ * @author Aberdeener
+ * @version 2.1.0
+ * @license MIT
+ */
+class Reaction {
+
+    public const TYPE_POSITIVE = 2;
+    public const TYPE_NEGATIVE = 0;
+    public const TYPE_NEUTRAL = 1;
+    public const TYPE_CUSTOM = 3;
+
+    public int $id;
+    public string $name;
+    public string $html;
+    public string $raw_html;
+    public bool $enabled;
+    public int $type;
+    public int $order;
+    public ?int $custom_score;
+
+    public function __construct(object $row) {
+        $this->id = $row->id;
+        $this->name = $row->name;
+        $this->html = Text::renderEmojis($row->html);
+        $this->raw_html = $row->html;
+        $this->enabled = $row->enabled;
+        $this->type = $row->type;
+        $this->custom_score = $row->custom_score;
+        $this->order = $row->order;
+    }
+
+    /**
+     * @return array<int, Reaction>
+     */
+    public static function all(): array {
+        $rows = DB::getInstance()->query('SELECT * FROM nl2_reactions ORDER BY `order`')->results();
+        $fields = [];
+        foreach ($rows as $row) {
+            $fields[$row->id] = new Reaction($row);
+        }
+        return $fields;
+    }
+
+    /**
+     * @param string $value
+     * @param string $column
+     * @return array<int, Reaction>|Reaction
+     */
+    public static function find(string $value, string $column = 'id') {
+        $rows = DB::getInstance()->query("SELECT * FROM nl2_reactions WHERE `$column` = $value ORDER BY `order`");
+        if (!$rows->count()) {
+            return [];
+        }
+
+        if ($rows->count() === 1) {
+            return new Reaction($rows->first());
+        }
+
+        $fields = [];
+        foreach ($rows->results() as $row) {
+            $fields[$row->id] = new Reaction($row);
+        }
+
+        return $fields;
+    }
+}

core/classes/DTO/UserData.php

@@ -21,7 +21,6 @@ class UserData {
     public bool $active;
     public ?string $signature;
     public int $profile_views;
-    public int $reputation;
     public ?string $reset_code;
     public bool $has_avatar;
     public bool $gravatar;
@@ -56,7 +55,6 @@ public function __construct(object $row) {
         $this->active = $row->active;
         $this->signature = $row->signature;
         $this->profile_views = $row->profile_views;
-        $this->reputation = $row->reputation;
         $this->reset_code = $row->reset_code;
         $this->has_avatar = $row->has_avatar;
         $this->gravatar = $row->gravatar;

core/classes/Database/DB.php

@@ -184,6 +184,15 @@ public function count(): int {
         return $this->_count;
     }
 
+    /**
+     * Get whether any results exist.
+     *
+     * @return bool Whether any results exist.
+     */
+    public function exists(): bool {
+        return $this->_count > 0;
+    }
+
     /**
      * Get the last inserted ID
      *
@@ -206,21 +215,29 @@ public function error(): bool {
      * Perform a SELECT query on the database.
      *
      * @param string $table The table to select from.
-     * @param array $where The where clause.
+     * @param mixed $where The where clause. If not an array, it will be used for "id" column lookup.
      * @return static|false This instance if successful, false otherwise.
      */
-    public function get(string $table, array $where = []) {
+    public function get(string $table, $where = []) {
+        if (!is_array($where)) {
+            $where = ['id', '=', $where];
+        }
+
         return $this->action('SELECT *', $table, $where);
     }
 
     /**
      * Perform a DELETE query on the database.
      *
      * @param string $table The table to delete from.
-     * @param array $where The where clause.
+     * @param mixed $where The where clause. If not an array, it will be used for "id" column lookup.
      * @return static|false This instance if successful, false otherwise.
      */
-    public function delete(string $table, array $where) {
+    public function delete(string $table, $where) {
+        if (!is_array($where)) {
+            $where = ['id', '=', $where];
+        }
+
         return $this->action('DELETE', $table, $where);
     }
 

core/classes/Database/DatabaseInitialiser.php

@@ -155,23 +155,45 @@ private function initialiseIntegrations(): void {
     private function initialiseReactions(): void {
         $this->_db->insert('reactions', [
             'name' => 'Like',
-            'html' => '<i class="fas fa-thumbs-up text-success"></i>',
+            'html' => '👍',
             'enabled' => true,
-            'type' => 2
+            'type' => Reaction::TYPE_POSITIVE,
         ]);
 
         $this->_db->insert('reactions', [
             'name' => 'Dislike',
-            'html' => '<i class="fas fa-thumbs-down text-danger"></i>',
+            'html' => '👎',
             'enabled' => true,
-            'type' => 0
+            'type' => Reaction::TYPE_NEGATIVE,
         ]);
 
         $this->_db->insert('reactions', [
             'name' => 'Meh',
-            'html' => '<i class="fas fa-meh text-warning"></i>',
+            'html' => '😐',
             'enabled' => true,
-            'type' => 1
+            'type' => Reaction::TYPE_NEUTRAL,
+        ]);
+
+        $this->_db->insert('reactions', [
+            'name' => 'Helpful',
+            'html' => '🛠️',
+            'enabled' => true,
+            'type' => Reaction::TYPE_POSITIVE,
+        ]);
+
+        $this->_db->insert('reactions', [
+            'name' => 'Creative',
+            'html' => '🌈',
+            'enabled' => true,
+            'type' => Reaction::TYPE_POSITIVE,
+        ]);
+
+        $this->_db->insert('reactions', [
+            'name' => 'Amazing',
+            'html' => '⭐',
+            'enabled' => true,
+            'type' => Reaction::TYPE_CUSTOM,
+            'custom_score' => 5,
         ]);
     }
 

core/classes/Misc/ProfilePostReactionContext.php

@@ -0,0 +1,70 @@
+<?php
+
+class ProfilePostReactionContext extends ReactionContext {
+
+    public function name(): string {
+        return 'profile_post';
+    }
+
+    public function friendlyName(Language $language): string {
+        return $language->get('user', 'profile_posts_score');
+    }
+
+    public function getUserReceived(User $user): array {
+        return DB::getInstance()->query('SELECT r.reaction_id FROM nl2_user_profile_wall_posts_reactions r JOIN nl2_user_profile_wall_posts w ON r.post_id = w.id WHERE w.author_id = ?', [
+            $user->data()->id
+        ])->results();
+    }
+
+    public function getUserGiven(User $user): array {
+        return DB::getInstance()->get('user_profile_wall_posts_reactions', ['user_id', $user->data()->id])->results();
+    }
+
+    public function validateReactable(int $reactable_id, User $user) {
+        // TODO check blocked?
+        $result = DB::getInstance()->get('user_profile_wall_posts', ['id', $reactable_id]);
+
+        if ($result->exists()) {
+            return $result->first();
+        }
+
+        return false;
+    }
+
+    public function hasReacted(User $user, Reaction $reaction, int $reactable_id) {
+        $result = DB::getInstance()->get('user_profile_wall_posts_reactions', [
+            ['post_id', $reactable_id], ['user_id', $user->data()->id], ['reaction_id', $reaction->id]
+        ]);
+
+        if ($result->exists()) {
+            return $result->first()->id;
+        }
+
+        return false;
+    }
+
+    public function giveReaction(User $user, User $receiver, Reaction $reaction, int $reactable_id): void {
+        DB::getInstance()->insert('user_profile_wall_posts_reactions', [
+            'post_id' => $reactable_id,
+            'user_id' => $user->data()->id,
+            'reaction_id' => $reaction->id,
+            'time' => date('U'),
+        ]);
+    }
+
+    public function deleteReaction(int $reactable_reaction_id): void {
+        DB::getInstance()->delete('user_profile_wall_posts_reactions', $reactable_reaction_id);
+    }
+
+    public function getAllReactions(int $reactionable_id): array {
+        return DB::getInstance()->get('user_profile_wall_posts_reactions', ['post_id', $reactionable_id])->results();
+    }
+
+    public function reactionUserIdColumn(): string {
+        return 'user_id';
+    }
+
+    public function determineReceiver(object $reactable): User {
+        return new User(DB::getInstance()->get('user_profile_wall_posts', ['id', $reactable->id])->first()->author_id);
+    }
+}

core/classes/Misc/ReactionContext.php

@@ -0,0 +1,36 @@
+<?php
+
+abstract class ReactionContext {
+
+    abstract public function name(): string;
+
+    abstract public function friendlyName(Language $language): string;
+
+    public function isEnabled(): bool {
+        return true;
+    }
+
+    abstract public function getUserReceived(User $user): array;
+
+    abstract public function getUserGiven(User $user): array;
+
+    /**
+     * @return false|object Returns false if the reactable does not exist or is not viewable to the user, otherwise returns the reactable object.
+     */
+    abstract public function validateReactable(int $reactable_id, User $user);
+
+    /**
+     * @return false|int Returns false if the user has not reacted, otherwise returns the reactable reaction ID.
+     */
+    abstract public function hasReacted(User $user, Reaction $reaction, int $reactable_id);
+
+    abstract public function giveReaction(User $user, User $receiver, Reaction $reaction, int $reactable_id): void;
+
+    abstract public function deleteReaction(int $reactable_reaction_id): void;
+
+    abstract public function getAllReactions(int $reactionable_id): array;
+
+    abstract public function reactionUserIdColumn(): string;
+
+    abstract public function determineReceiver(object $reactable): User;
+}

core/classes/Misc/ReactionContextsManager.php

@@ -0,0 +1,35 @@
+<?php
+
+class ReactionContextsManager extends Instanceable {
+
+    /** @var ReactionContext[]  */
+    private array $_contexts = [];
+
+    public function provideContext(ReactionContext $context): void {
+        $this->_contexts[$context->name()] = $context;
+    }
+
+    public function getContext(string $name): ?ReactionContext {
+        if (!isset($this->_contexts[$name])) {
+            throw new InvalidArgumentException('Invalid reaction context name: ' . $name);
+        }
+
+        return $this->_contexts[$name];
+    }
+
+    public function getContexts(): array {
+        return $this->_contexts;
+    }
+
+    public function validContextNames(): array {
+        return array_map(static function (ReactionContext $context) {
+            return $context->name();
+        }, $this->_contexts);
+    }
+
+    public function validContextFriendlyNames(Language $language): array {
+        return array_map(static function (ReactionContext $context) use ($language) {
+            return $context->friendlyName($language);
+        }, $this->_contexts);
+    }
+}