Store comments in a shared network folder

If you want to provide a trust-based collaboration framework for internal users, specify a shared network location to store comments. Users can read and add comments if they have read/write access to that network location. Comments from each user are stored in a separate XML file at the location.

For information about how to specify a shared network location, see Configurecollaboration.

Store comments on a RoboHelp server

If you want to allow commenting by users outside a corporate network, store comments on a Robo­Help server. The server authenticates users before allowing them to read or add comments.

note:    RoboHelp Server provides user authentication through both database and LDAP.

Key steps to implement and use collaboration using a RoboHelp server

1)(Author) In RoboHelp HTML, generate AIR Help with the following layout settings:

Enable Topic Rating

Enable Commenting

Enable Comment Moderation

In Set Location For Comments And Topic Ratings, select RoboHelp Server and specify the server URL.

For more detailed steps, see Configure collaboration.

2)(Administrator) In RoboHelp Server Web Administrator, sign in as an administrator and click Settings > Moderation. Specify the following settings:

Select Allow Post Anonymous if you want to let users comment anonymously on Help content.

note:    RoboHelp Server authenticates all users. When anonymous posting is enabled, users have the option to post a comment without their usernames being displayed.

Select Mark New Comments As Pending if you want to display user comments only after a moderator approves them.

For more detailed steps, see Using RoboHelp Server 10.

3)(User) Launch the AIR Help application. Click Show/Hide Comments Pod and add comments. See Add comments and Moderate comments.

Configure preferences for comments

Users can configure the following preferences for comments in AIR Help (output):

Always Use Log-In Name For Reviewer Name

If comments are stored in a shared network folder, users can specify the name they want to display with their comments. By default, RoboHelp displays the user name as defined in the user area.

note:    If comments are stored on a RoboHelp server, RoboHelp uses the login name.

Use Default Location To Sync Comments

Users can select this option to specify a new location for storing comments. The default loca­tion is the location specified at the time of generating AIR Help.

Receive Comments From Shared Folder

Users can select this option to receive all comments automatically when the Comments pod is displayed after launching AIR Help.

Show Moderation Pod

Users can select this option to enable the moderation mode if they have moderator privileges. In trust-based commenting (shared network location), moderators only need access to the password specified by the author at the time of generating AIR Help. In server-based commenting, moderators need admin privileges.

note:    Users can enable the moderation mode only if the author has enabled moderation at the time of generating AIR Help.

Delete All Comments

Select to delete all comments from your local database. When you click Send And Receive after selecting this option, all your comments are deleted from the shared location or the RoboHelp server.

Add comments

Users can add comments if commenting is enabled when generating the Adobe AIR output. Comments are stored locally until you click Send To Server or Send and Receive option.

1)Click Show/Hide Comments Pod to display the Comments pod.

2)To add a comment, click Show/Hide Add Comment. Enter the comment and click Save.

3)Click Send And Receive to publish saved comments.

Comment moderation

Regardless of whether you store comments in a shared network location or on a RoboHelp server, RoboHelp supports comment moderation. If moderation is enabled, the status of an unmoderated comment is Pending or Accepted as set in the SSL. A rejected comment can be seen only by the user who added the comment.


Shared location

RoboHelp server

Enabling moderation

Disabled by default

Enabled by default

Admins can modify the settings using the Admin UI on RoboHelp Server


Not required to read or add comments

Required to moderate comments

Moderator password is provided by authors and can’t be changed

Required to read or add comments if anonymous commenting is not allowed

Admin privileges required to moderate comments

Status of new comments

Moderators can modify the settings.xml file in the location where comments are centrally located.

If the moderation state attribute is set to ‘on’, new comments remain in the Pending state until they are moderated. If it is set to ‘off’, all new comments are marked Accepted by default and are not queued for moderation. A moderator can still reject or delete the comments later.

The Mark New Comments As Pending option set on the server determines the status of new comments.

Moderate comments

In the AIR Help output, do the following:

1)Click Preferences.

2)Click Comment.

3)Specify the password.

4)Select Show Moderation Pod. Click OK.

5)Use the following options to filter comments:

View All list

Select Pending, Rejected, or Accepted to filter comments by status.

Comments By list

Select an author name to filter comments by an author.

Comments For Current Topic

Click to view comments on the current topic only.

Comments For All Topics

Click to view comments on all topics.

6)Click Accept, Reject, or Delete to moderate a comment.

7)Click Send And Receive to synchronize the comments with the shared location or the server.

September 30, 2016

Legal Notices | Online Privacy Policy