Documentation Center

Customizing comments

An application developer can customize commenting behavior and appearance.

Commentator profiles

You can upload a user's photo. This will appear along with his or her credentials in the comment stream on the Legacy Content Delivery landing page .

Customizing status

You can customize the behavior of the default status types. (For example, you can specify that a particular status does not allow replies, effectively ending a comment thread.)

You can create new status types that meet your specific needs.

Commenting identifiers

An administrator can configure the XML attributes used to identify the text or image that the user selects when adding an inline comment.

To add an inline comment, a commenting identifier attribute must exist on one of the elements or ancestor elements of the text or image that the user selects when adding a comment. By default, SDL Tridion Docs configures two XML attributes, cid and id, for this purpose. To support third-party content management systems, or schemas and DTDs other than the DITA standard, an administrator can configure additional, or different, attributes.

The XSL transform renders attribute names in the HTML output prepended with data-, which allows any attribute to be HTML5-compliant. For example, data-cid and data-id (rather than cid and id) .

Note: The commenting identifier attributes are passed to the XSL transform, which does its best to transform all specified attributes to data- attributes. However, the administrator must modify the dita2htmlImpl.xsl file to specify that different attributes should be used as the commenting identifier:
  • Search for @cid in this XSL file to see how to add new attributes.
  • Search for data-id to see how to modify existing attributes.

New comment types

Have your account manager contact SDL ProServ to add custom comment types that meet your specific needs.

Comment priority

Have your account manager contact SDL ProServ to add comment priorities that meet your specific needs.