ActivityPub integration

install/data/defaults.json

@@ -189,5 +189,10 @@
     "composer:allowPluginHelp": 1,
     "maxReconnectionAttempts": 5,
     "reconnectionDelay": 1500,
-    "disableCustomUserSkins": 0
+    "disableCustomUserSkins": 0,
+    "activitypubEnabled": 1,
+    "activitypubAllowLoopback": 0,
+    "activitypubContentPruneDays": 30,
+    "activitypubUserPruneDays": 7,
+    "activitypubFilter": 0
 }

install/data/navigation.json

@@ -41,6 +41,14 @@
 		"textClass": "d-lg-none",
 		"text": "[[global:header.popular]]"
 	},
+	{
+		"route": "/world",
+		"title": "[[global:header.world]]",
+		"enabled": true,
+		"iconClass": "fa-globe",
+		"textClass": "d-lg-none",
+		"text": "[[global:header.world]]"
+	},
 	{
 		"route": "/users",
 		"title": "[[global:header.users]]",

install/package.json

@@ -47,6 +47,7 @@
         "bootswatch": "5.3.3",
         "chalk": "4.1.2",
         "chart.js": "4.4.3",
+        "cheerio": "^1.0.0-rc.12",
         "cli-graph": "3.2.2",
         "clipboard": "2.0.11",
         "colors": "1.4.0",
@@ -99,12 +100,12 @@
         "nodebb-plugin-dbsearch": "6.2.5",
         "nodebb-plugin-emoji": "5.1.15",
         "nodebb-plugin-emoji-android": "4.0.0",
-        "nodebb-plugin-markdown": "12.2.8",
-        "nodebb-plugin-mentions": "4.4.3",
+        "nodebb-plugin-markdown": "13.0.0-pre.8",
+        "nodebb-plugin-mentions": "4.6.6",
         "nodebb-plugin-ntfy": "1.7.4",
         "nodebb-plugin-spam-be-gone": "2.2.2",
         "nodebb-rewards-essentials": "1.0.0",
-        "nodebb-theme-harmony": "1.2.59",
+        "nodebb-theme-harmony": "2.0.0-pre.27",
         "nodebb-theme-lavender": "7.1.8",
         "nodebb-theme-peace": "2.2.5",
         "nodebb-theme-persona": "13.3.21",
@@ -195,4 +196,4 @@
             "url": "https://github.com/barisusakli"
         }
     ]
-}
+}

public/language/en-GB/activitypub.json

@@ -0,0 +1,18 @@
+{
+	"world.name": "World",
+	"world.description": "",
+	"world.popular": "Popular topics",
+	"world.recent": "All topics",
+	"world.help": "Help",
+	"no-topics": "This forum doesn't know of any other topics yet.",
+
+	"help.title": "What is this page?",
+	"help.intro": "Welcome to your corner of the fediverse.",
+	"help.fediverse": "The \"fediverse\" is a network of interconnected applications and websites that all talk to one another and whose users can see each other. This forum is federated, and can interact with that social web (or \"fediverse\"). This page is your corner of the fediverse. It consists solely of topics created by — and shared from — users <strong>you</strong> follow.",
+	"help.build": "There might not be a lot of topics here to start; that's normal. You will start to see more content here over time when you start following other users.",
+	"help.federating": "Likewise, if users from outside of this forum start following <em>you</em>, then your posts will start appearing on those apps and websites as well.",
+	"help.next-generation": "This is the next generation of social media, start contributing today!",
+
+	"announcers": "Announcers",
+	"announcers-x": "Announcers (%1)"
+}

public/language/en-GB/admin/manage/categories.json

@@ -7,6 +7,8 @@
 	"privileges": "Privileges",
 	"back-to-categories": "Back to categories",
 	"name": "Category Name",
+	"handle": "Category Handle",
+	"handle.help": "Your category handle is used as a representation of this category across other networks, similar to a username. A category handle must not match an existing username or user group.",
 	"description": "Category Description",
 	"bg-color": "Background Colour",
 	"text-color": "Text Colour",
@@ -37,6 +39,7 @@
 	"disable": "Disable",
 	"edit": "Edit",
 	"analytics": "Analytics",
+	"federation": "Federation",
 
 	"view-category": "View category",
 	"set-order": "Set order",
@@ -76,6 +79,22 @@
 	"analytics.topics-daily": "<strong>Figure 3</strong> &ndash; Daily topics created in this category</small>",
 	"analytics.posts-daily": "<strong>Figure 4</strong> &ndash; Daily posts made in this category</small>",
 
+	"federation.title": "Federation settings for \"%1\" category",
+	"federation.disabled": "Federation is disabled site-wide, so category federation settings are currently unavailable.",
+	"federation.disabled-cta": "Federation Settings &rarr;",
+	"federation.syncing-header": "Synchronization",
+	"federation.syncing-intro": "A category can follow a \"Group Actor\" via the ActivityPub protocol. If content is received from one of the actors listed below, it will be automatically added to this category.",
+	"federation.syncing-caveat": "N.B. Setting up syncing here establishes a one-way synchronization. NodeBB attempts to subscribe/follow the actor, but the reverse cannot be assumed.",
+	"federation.syncing-none": "This category is not currently following anybody.",
+	"federation.syncing-add": "Synchronize with...",
+	"federation.syncing-actorUri": "Actor",
+	"federation.syncing-follow": "Follow",
+	"federation.syncing-unfollow": "Unfollow",
+	"federation.followers": "Remote users following this category",
+	"federation.followers-handle": "Handle",
+	"federation.followers-id": "ID",
+	"federation.followers-none": "No followers.",
+
 	"alert.created": "Created",
 	"alert.create-success": "Category successfully created!",
 	"alert.none-active": "You have no active categories.",

public/language/en-GB/admin/menu.json

@@ -38,6 +38,7 @@
 	"settings/tags": "Tags",
 	"settings/notifications": "Notifications",
 	"settings/api": "API Access",
+	"settings/activitypub": "Federation (ActivityPub)",
 	"settings/sounds": "Sounds",
 	"settings/social": "Social",
 	"settings/cookies": "Cookies",

public/language/en-GB/admin/settings/activitypub.json

@@ -0,0 +1,20 @@
+{
+	"intro-lead": "What is Federation?",
+	"intro-body": "NodeBB is able to communicate with other NodeBB instances that support it. This is achieved through a protocol called <a href=\"https://activitypub.rocks/\">ActivityPub</a>. If enabled, NodeBB will also be able to communicate with other apps and websites that use ActivityPub (e.g. Mastodon, Peertube, etc.)",
+	"general": "General",
+	"pruning": "Content Pruning",
+	"content-pruning": "Days to keep remote content",
+	"content-pruning-help": "Note that remote content that has received engagement (a reply or a upvote/downvote) will be preserved. (0 for disabled)",
+	"user-pruning": "Days to cache remote user accounts",
+	"user-pruning-help": "Remote user accounts will only be pruned if they have no posts. Otherwise they will be re-retrieved. (0 for disabled)",
+	"enabled": "Enable Federation",
+	"enabled-help": "If enabled, will allow this NodeBB will be able to communicate with all Activitypub-enabled clients on the wider fediverse.",
+	"allowLoopback": "Allow loopback processing",
+	"allowLoopback-help": "Useful for debugging purposes only. You should probably leave this disabled.",
+
+	"server-filtering": "Filtering",
+	"count": "This NodeBB is currently aware of <strong>%1</strong> server(s)",
+	"server.filter-help": "Specify servers you would like to bar from federating with your NodeBB. Alternatively, you may opt to selectively <em>allow</em> federation with specific servers, instead. Both options are supported, although they are mutually exclusive.",
+	"server.filter-help-hostname": "Enter just the instance hostname below (e.g. <code>example.org</code>), separated by line breaks.",
+	"server.filter-allow-list": "Use this as an Allow List instead"
+}

public/language/en-GB/error.json

@@ -264,6 +264,7 @@
 
 	"topic-event-unrecognized": "Topic event '%1' unrecognized",
 
+	"category.handle-taken": "Category handle is already taken, please choose another.",
 	"cant-set-child-as-parent": "Can't set child as parent category",
 	"cant-set-self-as-parent": "Can't set self as parent category",
 
@@ -277,5 +278,12 @@
 	"api.500": "An unexpected error was encountered while attempting to service your request.",
 	"api.501": "The route you are trying to call is not implemented yet, please try again tomorrow",
 	"api.503": "The route you are trying to call is not currently available due to a server configuration",
-	"api.reauth-required": "The resource you are trying to access requires (re-)authentication."
+	"api.reauth-required": "The resource you are trying to access requires (re-)authentication.",
+
+	"activitypub.invalid-id": "Unable to resolve the input id, likely as it is malformed.",
+	"activitypub.get-failed": "Unable to retrieve the specified resource.",
+	"activitypub.pubKey-not-found": "Unable to resolve public key, so payload verification cannot take place.",
+	"activitypub.origin-mismatch": "The received object's origin does not match the sender's origin",
+	"activitypub.actor-mismatch": "The received activity is being carried out by an actor that is different from expected.",
+	"activitypub.not-implemented": "The request was denied because it or an aspect of it is not implemented by the recipient server"
 }

public/language/en-GB/flags.json

@@ -84,11 +84,17 @@
 	"modal-reason-offensive": "Offensive",
 	"modal-reason-other": "Other (specify below)",
 	"modal-reason-custom": "Reason for reporting this content...",
+	"modal-notify-remote": "Forward this report to %1",
 	"modal-submit": "Submit Report",
 	"modal-submit-success": "Content has been flagged for moderation.",
 
+	"modal-confirm-rescind": "Rescind Report?",
+
 	"bulk-actions": "Bulk Actions",
 	"bulk-resolve": "Resolve Flag(s)",
+	"confirm-purge": "Are you sure you want to permanently delete these flags?",
+	"purge-cancelled": "Flag Purge Cancelled",
+	"bulk-purge": "Purge Flag(s)",
 	"bulk-success": "%1 flags updated",
 	"flagged-timeago": "Flagged <span class=\"timeago\" title=\"%1\"></span>",
   	"auto-flagged": "[Auto Flagged] Received %1 downvotes."

public/language/en-GB/global.json

@@ -56,6 +56,7 @@
 	"header.navigation": "Navigation",
 	"header.manage": "Manage",
 	"header.drafts": "Drafts",
+	"header.world": "World",
 
 	"notifications.loading": "Loading Notifications",
 	"chats.loading": "Loading Chats",

public/language/en-GB/notifications.json

@@ -106,5 +106,10 @@
 	"notificationType-post-queue": "When a new post is queued",
 	"notificationType-new-post-flag": "When a post is flagged",
 	"notificationType-new-user-flag": "When a user is flagged",
-	"notificationType-new-reward": "When you earn a new reward"
+	"notificationType-new-reward": "When you earn a new reward",
+
+	"activitypub.announce": "<strong>%1</strong> shared your post in <strong>%2</strong> to their followers.",
+	"activitypub.announce-dual": "<strong>%1</strong> and <strong>%2</strong> shared your post in <strong>%3</strong> to their followers.",
+	"activitypub.announce-triple": "<strong>%1</strong>, <strong>%2</strong> and <strong>%3</strong> shared your post in <strong>%4</strong> to their followers.",
+	"activitypub.announce-multiple": "<strong>%1</strong>, <strong>%2</strong> and %3 others shared your post in <strong>%4</strong> to their followers."
 }

public/language/en-GB/pages.json

@@ -42,6 +42,8 @@
 	"flags": "Flags",
 	"flag-details": "Flag %1 Details",
 
+	"world": "World",
+
 	"account/edit": "Editing \"%1\"",
 	"account/edit/password": "Editing password of \"%1\"",
 	"account/edit/username": "Editing username of \"%1\"",

public/language/en-GB/topic.json

@@ -152,6 +152,7 @@
 	"bookmarks.has-no-bookmarks": "You haven't bookmarked any posts yet.",
 
 	"copy-permalink": "Copy Permalink",
+	"go-to-original": "View Original Post",
 
 	"loading-more-posts": "Loading More Posts",
 	"move-topic": "Move Topic",

public/language/en-GB/user.json

@@ -60,6 +60,7 @@
 	"chat-with": "Continue chat with %1",
 	"new-chat-with": "Start new chat with %1",
 	"flag-profile": "Flag Profile",
+	"profile-flagged": "Already flagged",
 	"follow": "Follow",
 	"unfollow": "Unfollow",
 	"more": "More",

public/openapi/components/schemas/CategoryObject.yaml

@@ -8,6 +8,14 @@ CategoryObject:
         name:
           type: string
           description: The category's name/title
+        handle:
+          type: string
+          description: |
+            An URL-safe name/handle used to represent the category over federated networks (e.g. ActivityPub).
+
+            This value is separate from the `slug`, which is used specifically in the URL as a human-readable representation.
+
+            The handle is unique across-the-board between users/groups/categories.
         description:
           type: string
           description: A variable-length description of the category (usually displayed underneath the category name)

public/openapi/components/schemas/PostObject.yaml

@@ -7,6 +7,15 @@ PostObject:
     tid:
       type: number
       description: A topic identifier
+    toPid:
+      type: number
+      description: The post that this post is in reply to
+      nullable: true
+    url:
+      type: string
+      description: |
+        A permalink to the post content.
+        For posts received via ActivityPub, it is the url of the original piece of content.
     content:
       type: string
     uid:

public/openapi/components/schemas/UserObject.yaml

@@ -449,6 +449,9 @@ UserObjectFull:
       type: boolean
     canFlag:
       type: boolean
+    flagId:
+      type: number
+      nullable: true
     canChangePassword:
       type: boolean
     isSelf:

public/openapi/read.yaml

@@ -100,6 +100,8 @@ paths:
     $ref: 'read/admin/manage/categories/category_id.yaml'
   "/api/admin/manage/categories/{category_id}/analytics":
     $ref: 'read/admin/manage/categories/category_id/analytics.yaml'
+  "/api/admin/manage/categories/{category_id}/federation":
+    $ref: 'read/admin/manage/categories/category_id/federation.yaml'
   "/api/admin/manage/privileges/{cid}":
     $ref: 'read/admin/manage/privileges/cid.yaml'
   /api/admin/manage/tags:
@@ -326,5 +328,7 @@ paths:
     $ref: 'read/groups/slug.yaml'
   "/api/groups/{slug}/members":
     $ref: 'read/groups/slug/members.yaml'
+  "/api/world":
+    $ref: 'read/world.yaml'
   /api/outgoing:
     $ref: 'read/outgoing.yaml'

public/openapi/read/admin/manage/categories/category_id/federation.yaml

@@ -0,0 +1,59 @@
+get:
+  tags:
+    - admin
+  summary: Get category anayltics
+  parameters:
+    - name: category_id
+      in: path
+      required: true
+      schema:
+        type: string
+      example: 1
+  responses:
+    "200":
+      description: ""
+      content:
+        application/json:
+          schema:
+            allOf:
+              - type: object
+                properties:
+                  cid:
+                    type: number
+                  enabled:
+                    type: number
+                    description: Whether ActivityPub integration is enabled in site settings
+                  name:
+                    type: string
+                  following:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                          description: The activity+json uri of the followed actor
+                        approved:
+                          type: boolean
+                          description: Whether the follow request has been accepted
+                  followers:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        userslug:
+                          type: string
+                          description: An URL-safe variant of the username (i.e. lower-cased, spaces removed, etc.)
+                          example: dragon-fruit
+                        picture:
+                          type: string
+                          description: A URL pointing to a picture to be used as the user's avatar
+                          example: 'https://images.unsplash.com/photo-1560070094-e1f2ddec4337?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=256&h=256&q=80'
+                          nullable: true
+                        uid:
+                          type: number
+                          description: A user identifier
+                          example: 1
+                  selectedCategory:
+                    $ref: ../../../../../components/schemas/CategoryObject.yaml#/CategoryObject
+              - $ref: ../../../../../components/schemas/CommonProps.yaml#/CommonProps

public/openapi/read/topic/topic_id.yaml

@@ -184,6 +184,8 @@ get:
                           type: boolean
                         downvoted:
                           type: boolean
+                        attachments:
+                          type: array
                         replies:
                           type: object
                           properties: