Back to Search Back to Search Results

Comment Management

The Titania Comment Manager is a plug-in that allows users to leave comments on Portal content. The default Portal Themes add a comment area to the bottom of any content-containing page. If the content is XML-based, then it is configured to also allow for commenting on any block-level element. Metadata is stored on the comment to map it back to its source document and element.

The Comment Manager allows for collecting feedback directly from Portal users. It is highly configurable to allow for different levels of read and write access, which elements can be commented on, and more. The comments are available via a CSV in the "Reports" Tab of the admin application.

Document-Level comments are those that are left on the entire document, whether it is a static, file such as a PDF or Word document, or dynamic content such as a DITA topic or map. Document-level comments can be included on any page by adding: <#include "components/comments/documentCommentThread.ftl"/> to any template.

Element-level comments are those that can be left on a specific HTML element in the page. In Titania Delivery, these comments are meant to be left on the HTML-transformed version of XML content. Titania Delivery then takes care of mapping the comment back to the element in the source XML, so that comments can be easily identified with their source. Element-level comments can be added to a template via <#include "components/comments/elementLevelComments.ftl"/>.

Commenting is only available to Organization-owned Portals. Attempting to allow commenting on a personal Portal will result in 400-level response codes from the server.