DOC-3174: Add UserLookup partials to revisionhistory and tinycomments pages

Author: kimwoodfield

modules/ROOT/pages/comments-embedded-mode.adoc

@@ -30,6 +30,10 @@ liveDemo::comments-embedded[]
 
 == Options
 
+include::partial$configuration/user_id.adoc[leveloffset=+1]
+
+include::partial$configuration/fetch_users.adoc[leveloffset=+1]
+
 include::partial$configuration/tinycomments_author.adoc[leveloffset=+1]
 
 include::partial$configuration/tinycomments_author_avatar.adoc[leveloffset=+1]

modules/ROOT/pages/revisionhistory.adoc

@@ -109,6 +109,10 @@ include::partial$configuration/revisionhistory_fetch_revision.adoc[leveloffset=+
 
 include::partial$configuration/revisionhistory_allow_restore.adoc[leveloffset=+1]
 
+include::partial$configuration/user_id.adoc[leveloffset=+1]
+
+include::partial$configuration/fetch_users.adoc[leveloffset=+1]
+
 include::partial$configuration/revisionhistory_author.adoc[leveloffset=+1]
 
 include::partial$configuration/revisionhistory_display_author.adoc[leveloffset=+1]

modules/ROOT/partials/DEPRECATED/generic_8_userlookup.adoc

@@ -0,0 +1 @@
+IMPORTANT: This option has been deprecated in {productname} 8.0 and may be removed in a future major {productname} release. Use a combination of `user_id` and `fetch_users` instead. | `xref:apis/tinymce.editor.userlookup.adoc[UserLookup]`

modules/ROOT/partials/configuration/fetch_users.adoc

@@ -1,7 +1,7 @@
 [[fetch_users]]
 == `fetch_users`
 
-A **required callback function** that fetches user data for the Suggested Edits view. This function is called with an array of user IDs and should return a `Promise` that resolves to an array of user objects. The callback is used by the xref:userlookup.adoc[`UserLookup`] API.
+A **required callback function** that fetches user data. This function is called with an array of user IDs and should return a `Promise` that resolves to an array of user objects. The callback is used by the xref:userlookup.adoc[`UserLookup`] API.
 
 *Type:* `Function`
 
@@ -15,10 +15,25 @@ A **required callback function** that fetches user data for the Suggested Edits
 
 [source,javascript]
 ----
+const userDirectory = {
+  'janedoe': { id: 'janedoe', name: 'Jane Doe', avatar: 'https://example.com/avatar/jane.png' },
+  'johnsmith': { id: 'johnsmith', name: 'John Smith' },
+  'alextaylor': { id: 'alextaylor', name: 'Alex Taylor', avatar: 'https://example.com/avatar/alex.png' }
+};
+
 tinymce.init({
-  selector: 'textarea',  // Change this value according to your HTML
-  user_id: 'unique-identifier', // Replace this with a unique string to identify the user
-  fetch_users: (ids) => fetch(`/api/users?ids=${ids.join(',')}`)
-     .then((r) => r.json())
+  selector: '#editor',
+  user_id: 'alextaylor',
+  fetch_users: (userIds) => {
+    const results = userIds.map((id) => {
+      const user = Object.values(userDirectory).find((user) => user.id === id);
+      if (user) {
+        return user;
+      } else {
+        throw new Error(`User ${id} not found`);
+      }
+    });
+    return Promise.resolve(results);
+  }
 });
 ----

modules/ROOT/partials/configuration/revisionhistory_author.adoc

@@ -1,6 +1,8 @@
 [[revisionhistory_author]]
 == `revisionhistory_author`
 
+include::partial$DEPRECATED/generic_8_userlookup.adoc[]
+
 This option configures the author for the `initial` and `draft` revisions.
 
 *Type:* xref:#author[Author] `+Object+`

modules/ROOT/partials/configuration/tinycomments_author.adoc

@@ -1,6 +1,8 @@
 [[tinycomments_author]]
 == `+tinycomments_author+`
 
+include::partial$DEPRECATED/generic_8_userlookup.adoc[]
+
 This option sets the author id to be used when creating or replying to comments.
 
 *Type:* `+String+`

modules/ROOT/partials/configuration/tinycomments_author_avatar.adoc

@@ -1,6 +1,8 @@
 [[tinycomments_author_avatar]]
 == `+tinycomments_author_avatar+`
 
+include::partial$DEPRECATED/generic_8_userlookup.adoc[]
+
 _Optional_: This option sets the URL for the author's avatar to be used when creating or replying to comments. If this option is omitted, a generated avatar will be used instead. The avatar, if provided:
 
 * will be scaled to a 36px diameter circle; and

modules/ROOT/partials/configuration/tinycomments_author_name.adoc

@@ -1,6 +1,8 @@
 [[tinycomments_author_name]]
 == `+tinycomments_author_name+`
 
+include::partial$DEPRECATED/generic_8_userlookup.adoc[]
+
 _Optional_: This option sets the author's display name to be used when creating or replying to comments. If this option is omitted, the author `+id+` is used instead.
 
 *Type:* `+String+`

modules/ROOT/partials/configuration/user_id.adoc

@@ -1,5 +1,5 @@
 [[user_id]]
-== `user_id`
+== `+user_id+`
 
 This option sets the unique identifier for the current user in the editor. It is used in the the xref:userlookup.adoc[`UserLookup`] API.