nodebb-plugin-mentions 4.4.3 → 4.5.0

package/.eslintrc

@@ -1,3 +1,3 @@
-{
-	"extends": "nodebb/lib"
+{
+	"extends": "nodebb/lib"
 }

package/LICENSE

@@ -1,8 +1,8 @@
-Copyright (c) 2013-2014, Julian Lam <julian@designcreateplay.com>
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Copyright (c) 2013-2014, Julian Lam <julian@designcreateplay.com>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,14 +1,14 @@
-# Username/Group Mentions
-
-This NodeBB plugin allows posters to reference (or *mention*) other users or groups on a NodeBB by simply
-precluding the `@` symbol before a username.
-
-A link is automatically added to the post.
-
-## Installation
-
-This plugin is bundled with every NodeBB install. If not, you can install it via the Plugins page of the ACP.
-
-Alternatively,
-
+# Username/Group Mentions
+
+This NodeBB plugin allows posters to reference (or *mention*) other users or groups on a NodeBB by simply
+precluding the `@` symbol before a username.
+
+A link is automatically added to the post.
+
+## Installation
+
+This plugin is bundled with every NodeBB install. If not, you can install it via the Plugins page of the ACP.
+
+Alternatively,
+
     npm install nodebb-plugin-mentions

package/languages/ar/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> ذكرَ اسمك في <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> ذكرَ اسمك في <strong>%2</strong>"
 }

package/languages/bg/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> Ви спомена в <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> Ви спомена в <strong>%2</strong>"
 }

package/languages/bn/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong>, <strong>%2</strong> এ আপনার নাম উল্লেখ করেছেন"
+{
+    "user-mentioned-you-in": "<strong>%1</strong>, <strong>%2</strong> এ আপনার নাম উল্লেখ করেছেন"
 }

package/languages/da/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> nævnte dig i <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> nævnte dig i <strong>%2</strong>"
 }

package/languages/de/notifications.json

@@ -1,6 +1,6 @@
-{
-    "mentions": "Erwähnungen",
-    "user-mentioned-you-in": "<strong>%1</strong> erwähnte dich in <strong>%2</strong>",
-    "user-mentioned-group-in": "<strong>%1</strong> erwähnte <strong>%2</strong> in <strong>%3</strong>",
-    "notificationType_mention": "Wenn dich jemand erwähnt"
+{
+    "mentions": "Erwähnungen",
+    "user-mentioned-you-in": "<strong>%1</strong> erwähnte dich in <strong>%2</strong>",
+    "user-mentioned-group-in": "<strong>%1</strong> erwähnte <strong>%2</strong> in <strong>%3</strong>",
+    "notificationType_mention": "Wenn dich jemand erwähnt"
 }

package/languages/el/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "Ο/Η <strong>%1</strong> σε ανέφερε στο <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "Ο/Η <strong>%1</strong> σε ανέφερε στο <strong>%2</strong>"
 }

package/languages/en@pirate/notifications.json

@@ -1,4 +1,4 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> spoke yer name in <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> called fer <strong>%2</strong> in <strong>%3</strong>"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> spoke yer name in <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> called fer <strong>%2</strong> in <strong>%3</strong>"
+}

package/languages/en_GB/mentions.json

@@ -1,3 +1,3 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>"
+}

package/languages/en_GB/notifications.json

@@ -1,7 +1,7 @@
-{
-	"mentions": "Mentions",
-	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
-	"user-mentioned-you-in-room": "<strong>%1</strong> mentioned you in <strong class=\"text-nowrap\"><i class=\"fa %2\"></i>%3</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>",
-	"notificationType-mention": "When someone mentions you"
-}
+{
+	"mentions": "Mentions",
+	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
+	"user-mentioned-you-in-room": "<strong>%1</strong> mentioned you in <strong class=\"text-nowrap\"><i class=\"fa %2\"></i>%3</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>",
+	"notificationType-mention": "When someone mentions you"
+}

package/languages/en_US/notifications.json

@@ -1,4 +1,4 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>"
+}

package/languages/es/notifications.json

@@ -1,4 +1,4 @@
-{
-    "mentions": "Menciones",
-    "user-mentioned-you-in": "<strong>%1</strong> te mencionó en <strong>%2</strong>"
+{
+    "mentions": "Menciones",
+    "user-mentioned-you-in": "<strong>%1</strong> te mencionó en <strong>%2</strong>"
 }

package/languages/et/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> mainis sind postituses <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> mainis sind postituses <strong>%2</strong>"
 }

package/languages/fa_IR/notifications.json

@@ -1,4 +1,4 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> شما رو در <strong>%2</strong> منشن کرده",
-	"user-mentioned-group-in": "<strong>%1</strong> گروه <strong>%2</strong> رو در <strong>%3</strong> منشن کرده"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> شما رو در <strong>%2</strong> منشن کرده",
+	"user-mentioned-group-in": "<strong>%1</strong> گروه <strong>%2</strong> رو در <strong>%3</strong> منشن کرده"
+}

package/languages/fi/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> mainitsi sinut viestissä <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> mainitsi sinut viestissä <strong>%2</strong>"
 }

package/languages/fr/notifications.json

@@ -1,6 +1,6 @@
-{
-	"mentions": "Mentions",
-	"user-mentioned-you-in": "<strong>%1</strong> vous a mentionné dans <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> a mentionné <strong>%2</strong> dans <strong>%3</strong>",
-	"notificationType_mention": "Lorsque quelqu'un vous mentionne"
+{
+	"mentions": "Mentions",
+	"user-mentioned-you-in": "<strong>%1</strong> vous a mentionné dans <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> a mentionné <strong>%2</strong> dans <strong>%3</strong>",
+	"notificationType_mention": "Lorsque quelqu'un vous mentionne"
 }

package/languages/gl/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> mencionóute en <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> mencionóute en <strong>%2</strong>"
 }

package/languages/id/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> menyebut mu di <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> menyebut mu di <strong>%2</strong>"
 }

package/languages/it/notifications.json

@@ -1,4 +1,4 @@
-{
-    "mentions": "Menzioni",
-    "user-mentioned-you-in": "<strong>%1</strong> ti ha menzionato in <strong>%2</strong>"
+{
+    "mentions": "Menzioni",
+    "user-mentioned-you-in": "<strong>%1</strong> ti ha menzionato in <strong>%2</strong>"
 }

package/languages/ja/notifications.json

@@ -1,5 +1,5 @@
-{
-	"mentions": "メンション",
-	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>"
+{
+	"mentions": "メンション",
+	"user-mentioned-you-in": "<strong>%1</strong> mentioned you in <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> mentioned <strong>%2</strong> in <strong>%3</strong>"
 }

package/languages/jbo/notifications.json

@@ -1,4 +1,4 @@
-{
-	"user-mentioned-you-in": "la .<strong>%1</strong>. klacpe do la .<strong>%2</strong>.",
-	"user-mentioned-group-in": "la .<strong>%1</strong>. klacpe la .<strong>%2</strong>. la .<strong>%3</strong>."
-}
+{
+	"user-mentioned-you-in": "la .<strong>%1</strong>. klacpe do la .<strong>%2</strong>.",
+	"user-mentioned-group-in": "la .<strong>%1</strong>. klacpe la .<strong>%2</strong>. la .<strong>%3</strong>."
+}

package/languages/ko/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong>님이 <strong>%2</strong>에서 나를 언급했습니다."
+{
+    "user-mentioned-you-in": "<strong>%1</strong>님이 <strong>%2</strong>에서 나를 언급했습니다."
 }

package/languages/lt/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> paminėjo Jus <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> paminėjo Jus <strong>%2</strong>"
 }

package/languages/ms/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> sebut anda di <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> sebut anda di <strong>%2</strong>"
 }

package/languages/nl/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "Onze naam is genoemd door <strong>%1</strong> in <strong>%2</strong>."
+{
+    "user-mentioned-you-in": "Onze naam is genoemd door <strong>%1</strong> in <strong>%2</strong>."
 }

package/languages/pl/mentions.json

@@ -1,3 +1,3 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> wspomniał o Tobie w <strong>%2</strong>"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> wspomniał o Tobie w <strong>%2</strong>"
+}

package/languages/pl/notifications.json

@@ -1,6 +1,6 @@
-{
-	"mentions": "Wspomnienia",
-	"user-mentioned-you-in": "<strong>%1</strong> wspomniał o Tobie w <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> wspomniał <strong>%2</strong> w <strong>%3</strong>",
-	"notificationType_mention": "Kiedy ktoś o Tobie wspomni"
-}
+{
+	"mentions": "Wspomnienia",
+	"user-mentioned-you-in": "<strong>%1</strong> wspomniał o Tobie w <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> wspomniał <strong>%2</strong> w <strong>%3</strong>",
+	"notificationType_mention": "Kiedy ktoś o Tobie wspomni"
+}

package/languages/pt-PT/notifications.json

@@ -1,6 +1,6 @@
-{
-	"mentions": "Menções",
-	"user-mentioned-you-in": "<strong>%1</strong> mencionou-te no tópico <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> mencionou o grupo <strong>%2</strong> no tópico <strong>%3</strong>",
-	"notificationType_mention": "Quando alguém te menciona"
-}
+{
+	"mentions": "Menções",
+	"user-mentioned-you-in": "<strong>%1</strong> mencionou-te no tópico <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> mencionou o grupo <strong>%2</strong> no tópico <strong>%3</strong>",
+	"notificationType_mention": "Quando alguém te menciona"
+}

package/languages/pt_BR/notifications.json

@@ -1,4 +1,4 @@
-{
-    "mentions": "Menções",
-    "user-mentioned-you-in": "<strong>%1</strong> mencionou você em <strong>%2</strong>"
+{
+    "mentions": "Menções",
+    "user-mentioned-you-in": "<strong>%1</strong> mencionou você em <strong>%2</strong>"
 }

package/languages/ro/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> te-a menționat în <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> te-a menționat în <strong>%2</strong>"
 }

package/languages/rw/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> yakuvuze muri <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> yakuvuze muri <strong>%2</strong>"
 }

package/languages/sl/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> te je omenil v <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> te je omenil v <strong>%2</strong>"
 }

package/languages/sr/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> вас помену у <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> вас помену у <strong>%2</strong>"
 }

package/languages/sv/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> nämnde dig i <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> nämnde dig i <strong>%2</strong>"
 }

package/languages/tr/notifications.json

@@ -1,6 +1,6 @@
-{
-	"mentions": "Bahsedilmeler",
-	"user-mentioned-you-in": "<strong>%1</strong> sizden şu konuda bahsetti: <strong>%2</strong>",
-	"user-mentioned-group-in": "<strong>%1</strong> kullanıcısı <strong>%2</strong> grubundan şu konuda bahsetti: <strong>%3</strong>",
-	"notificationType_mention": "Biri sizden bahsettiğinde"
-}
+{
+	"mentions": "Bahsedilmeler",
+	"user-mentioned-you-in": "<strong>%1</strong> sizden şu konuda bahsetti: <strong>%2</strong>",
+	"user-mentioned-group-in": "<strong>%1</strong> kullanıcısı <strong>%2</strong> grubundan şu konuda bahsetti: <strong>%3</strong>",
+	"notificationType_mention": "Biri sizden bahsettiğinde"
+}

package/languages/vi/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> nhắc đến bạn trong <strong>%2</strong>"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> nhắc đến bạn trong <strong>%2</strong>"
 }

package/languages/zh-CN/mentions.json

@@ -1,3 +1,3 @@
-{
-	"user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong> 中提到了您"
-}
+{
+	"user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong> 中提到了您"
+}

package/languages/zh-CN/notifications.json

@@ -1,6 +1,6 @@
-{
-	"mentions": "提到",
-	"user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong> 中提到了你",
-	"user-mentioned-group-in": "<strong>%1</strong> 在 <strong>%3</strong> 中提到了 <strong>%2</strong>",
-	"notificationType_mention": "当有人提到你时"
+{
+	"mentions": "提到",
+	"user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong> 中提到了你",
+	"user-mentioned-group-in": "<strong>%1</strong> 在 <strong>%3</strong> 中提到了 <strong>%2</strong>",
+	"notificationType_mention": "当有人提到你时"
 }

package/languages/zh_TW/notifications.json

@@ -1,3 +1,3 @@
-{
-    "user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong>提到你"
+{
+    "user-mentioned-you-in": "<strong>%1</strong> 在 <strong>%2</strong>提到你"
 }

package/library.js

@@ -12,6 +12,7 @@ const winston = require.main.require('winston');
 const db = require.main.require('./src/database');
 const api = require.main.require('./src/api');
 const meta = require.main.require('./src/meta');
+const categories = require.main.require('./src/categories');
 const Topics = require.main.require('./src/topics');
 const posts = require.main.require('./src/posts');
 const User = require.main.require('./src/user');
@@ -393,18 +394,34 @@ Mentions.parseRaw = async (content) => {
 		const slug = slugify(match.slice(1));
 		match = removePunctuationSuffix(match);
 		const uid = await User.getUidByUserslug(slug);
-		const { groupExists, user } = await utils.promiseParallel({
+		const cid = await categories.getCidByHandle(slug);
+		const { groupExists, user, category } = await utils.promiseParallel({
 			groupExists: Groups.existsBySlug(slug),
-			user: User.getUserFields(uid, ['uid', 'username', 'fullname']),
+			user: User.getUserFields(uid, ['uid', 'username', 'fullname', 'url']),
+			category: categories.getCategoryFields(cid, ['slug']),
 		});
 
-		if (user.uid || groupExists) {
+		if (uid || groupExists || cid) {
 			let url;
-			if (user.uid) {
-				url = utils.isNumber(user.uid) ? `${nconf.get('url')}/uid/${user.uid}` : user.uid;
-			} else {
-				url = `${nconf.get('url')}/groups/${slug}`;
+
+			switch (true) {
+				case !!uid: {
+					url = utils.isNumber(user.uid) ? `${nconf.get('url')}/uid/${user.uid}` : (user.url || user.uid);
+					break;
+				}
+
+				case !!cid: {
+					url = `${nconf.get('url')}/category/${category.slug}`;
+					console.log('setting url', url);
+					break;
+				}
+
+				case !!groupExists: {
+					url = `${nconf.get('url')}/groups/${slug}`;
+					break;
+				}
 			}
+
 			const regex = isLatinMention.test(match) ?
 				RegExp(`${parts.before}${match}${parts.after}`, 'gu') :
 				RegExp(`${parts.before}${match}`, 'gu');
@@ -432,7 +449,7 @@ Mentions.parseRaw = async (content) => {
 						}
 					}
 
-					const str = `<a class="mention plugin-mentions-${user.uid ? 'user' : 'group'} plugin-mentions-a" href="${url}">${match}</a>`;
+					const str = `<a class="plugin-mentions-${user.uid ? 'user' : 'group'} plugin-mentions-a" href="${url}">${match}</a>`;
 
 					return plain + str;
 				});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-mentions",
-  "version": "4.4.3",
+  "version": "4.5.0",
   "description": "NodeBB Plugin that allows users to mention other users by prepending an '@' sign to their username",
   "main": "library.js",
   "scripts": {

package/plugin.json

@@ -1,32 +1,32 @@
-{
-	"id": "nodebb-plugin-mentions",
-	"name": "Username Mentions",
-	"description": "NodeBB Plugin that allows users to mention other users by prepending an '@' sign to their username",
-	"url": "https://github.com/julianlam/nodebb-plugin-mentions",
-	"library": "./library.js",
-	"upgrades": [
-        "upgrades/mentions_delete_mentions_set_zset.js"
-    ],
-	"hooks": [
-		{ "hook": "static:app.load", "method": "init" },
-		{ "hook": "filter:admin.header.build", "method": "addAdminNavigation" },
-		{ "hook": "filter:parse.post", "method": "parsePost" },
-		{ "hook": "filter:parse.raw", "method": "parseRaw" },
-		{ "hook": "action:post.save", "method": "notify" },
-		{ "hook": "action:post.edit", "method": "notify" },
-		{ "hook": "action:posts.purge", "method": "actionPostsPurge" },
-		{ "hook": "action:messaging.save", "method": "notifyMessage" },
-		{ "hook": "filter:notifications.addFilters", "method": "addFilters" },
-		{ "hook": "filter:user.notificationTypes", "method": "notificationTypes" },
-		{ "hook": "filter:users.addFields", "method": "addFields" }
-	],
-	"scripts": [
-		"static/autofill.js"
-	],
-	"modules": {
-		"../admin/plugins/mentions.js": "./static/admin.js"
-	},
-	"languages": "languages",
-	"defaultLang": "en_GB",
-	"templates": "templates"
+{
+	"id": "nodebb-plugin-mentions",
+	"name": "Username Mentions",
+	"description": "NodeBB Plugin that allows users to mention other users by prepending an '@' sign to their username",
+	"url": "https://github.com/julianlam/nodebb-plugin-mentions",
+	"library": "./library.js",
+	"upgrades": [
+        "upgrades/mentions_delete_mentions_set_zset.js"
+    ],
+	"hooks": [
+		{ "hook": "static:app.load", "method": "init" },
+		{ "hook": "filter:admin.header.build", "method": "addAdminNavigation" },
+		{ "hook": "filter:parse.post", "method": "parsePost" },
+		{ "hook": "filter:parse.raw", "method": "parseRaw" },
+		{ "hook": "action:post.save", "method": "notify" },
+		{ "hook": "action:post.edit", "method": "notify" },
+		{ "hook": "action:posts.purge", "method": "actionPostsPurge" },
+		{ "hook": "action:messaging.save", "method": "notifyMessage" },
+		{ "hook": "filter:notifications.addFilters", "method": "addFilters" },
+		{ "hook": "filter:user.notificationTypes", "method": "notificationTypes" },
+		{ "hook": "filter:users.addFields", "method": "addFields" }
+	],
+	"scripts": [
+		"static/autofill.js"
+	],
+	"modules": {
+		"../admin/plugins/mentions.js": "./static/admin.js"
+	},
+	"languages": "languages",
+	"defaultLang": "en_GB",
+	"templates": "templates"
 }

package/static/.eslintrc

@@ -1,3 +1,3 @@
-{
-	"extends": "nodebb/public"
-}
+{
+	"extends": "nodebb/public"
+}

package/static/autofill.js

@@ -3,6 +3,8 @@
 
 $(document).ready(function () {
 	let groupList = [];
+	let categoryList;
+	const categorySlugMap = new Map();
 	let localUserList = [];
 
 	$(window).on('composer:autocomplete:init chat:autocomplete:init', function (ev, data) {
@@ -12,6 +14,10 @@ $(document).ready(function () {
 			loadGroupList();
 		}
 
+		if (!categoryList) {
+			loadCategoryList();
+		}
+
 		let slugify;
 		const strategy = {
 			match: /\B@([^\s\n]*)?$/,
@@ -20,7 +26,7 @@ $(document).ready(function () {
 					slugify = _slugify;
 					let mentions = [];
 					if (!term) {
-						mentions = usersToMentions(sortUsers(localUserList), helpers);
+						mentions = entriesToMentions(sortEntries(localUserList), helpers);
 						return callback(mentions);
 					}
 
@@ -37,10 +43,12 @@ $(document).ready(function () {
 						const localMatches = localUserList.filter(
 							u => u.username.toLocaleLowerCase().startsWith(termLowerCase)
 						);
+						const categoryMatches = categoryList.filter(c => c.handle.startsWith(termLowerCase));
 
-						// remove local matches from search results
+						// remove local matches from search results, add category matches
 						users = users.filter(u => !localMatches.find(lu => lu.uid === u.uid));
-						mentions = usersToMentions(sortUsers(localMatches).concat(sortUsers(users)), helpers);
+						users = sortEntries(localMatches).concat(sortEntries([...users, ...categoryMatches]));
+						mentions = entriesToMentions(users, helpers);
 
 						// Add groups that start with the search term
 						const groupMentions = groupList.filter(function (groupName) {
@@ -62,7 +70,14 @@ $(document).ready(function () {
 				mention = $('<div/>').html(mention);
 				// Strip letter avatar
 				mention.find('span').remove();
-				return '@' + slugify(mention.text(), true) + ' ';
+
+				const text = mention.text().trim();
+				const categoryHandle = categorySlugMap.get(text.toLowerCase());
+				if (categoryHandle) {
+					return `@${categoryHandle}`;
+				}
+
+				return '@' + slugify(text, true) + ' ';
 			},
 			cache: true,
 		};
@@ -75,23 +90,25 @@ $(document).ready(function () {
 		composer.attr('data-mentions', '1');
 	});
 
-	function sortUsers(users) {
-		return users.sort(function (user1, user2) {
-			return user1.username.toLocaleLowerCase() > user2.username.toLocaleLowerCase() ? 1 : -1;
+	function sortEntries(entries) {
+		return entries.sort(function (entry1, entry2) {
+			const comparator1 = entry1.username || entry1.name;
+			const comparator2 = entry2.username || entry2.name;
+			return comparator1.toLocaleLowerCase() > comparator2.toLocaleLowerCase() ? 1 : -1;
 		});
 	}
 
-	function usersToMentions(users, helpers) {
-		return users.reduce(function (carry, user) {
+	function entriesToMentions(entries, helpers) {
+		return entries.reduce(function (carry, entry) {
 			// Don't add current user to suggestions
-			if (app.user.username && app.user.username === user.username) {
+			if (app.user.username && app.user.username === entry.username) {
 				return carry;
 			}
 
-			// Format suggestions as 'avatar username (fullname)'
-			const avatar = helpers.buildAvatar(user, '24px', true);
-			const fullname = user.fullname ? `(${user.fullname})` : '';
-			carry.push(`${avatar} ${user.username} ${helpers.escape(fullname)}`);
+			// Format suggestions as 'avatar username/name (fullname)'
+			const avatar = entry.uid ? helpers.buildAvatar(entry, '24px', true) : '';
+			const fullname = entry.fullname ? `(${entry.fullname})` : '';
+			carry.push(`${avatar} ${entry.username || entry.name} ${helpers.escape(fullname)}`);
 
 			return carry;
 		}, []);
@@ -141,4 +158,14 @@ $(document).ready(function () {
 			groupList = groupNames;
 		});
 	}
+
+	function loadCategoryList() {
+		require(['api'], async (api) => {
+			const { categories } = await api.get('/categories');
+			categoryList = categories;
+			categories.forEach((category) => {
+				categorySlugMap.set(category.name.toLowerCase(), category.handle);
+			});
+		});
+	}
 });