Theme Builder Plugin

[All Adaptavist Apps]

Page tree

Versions Compared

Old Version 8

changes.mady.by.user Unknown User (gfraser)

Saved on

compared with

New Version 9

changes.mady.by.user Unknown User (gfraser)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Why are my comments not shown?

Wiki Markup
First of all, check that the following wiki notation is included in one of the theme panels:

{code}
{builder-comments}
{code}

If it's not, then add it ;)

Also, check that the panel which contains the macro is enabled - if the panel isn't shown, it's contents aren't shown.

If you have hidden comments (eg. using the "Hide Comments" link), then they will not be shown on any pages until you re-display them again. There are a few ways you can display comments again...

The best way is to use the [menulink macro] to display a link or menuitem that allows users to show/hide comments{footnote}This link is included as default on the View menu for pages that have comments.{footnote}:

{code}
{menuitem:flat=true}{menulink:comments}Show comments (%count%){menulink}{menuitem}
{code}

{display-footnotes}

Which displays: {menuitem:flat=true}{menulink:comments}Show comments (%count%){menulink}{menuitem}

We've wrapped the link in the [menuitem macro] so that pages which do not have comments will not display an inactive link.

Another alternative is to allow the user to post new comments{footnote}If the user has sufficient privileges, they'll see this link on the Edit > New menu{footnote}:

{code}
{menuitem:flat=true}{menulink:newcomment}Post a comment{menulink}{menuitem}
{code}

{display-footnotes}

Which displays: {menuitem:flat=true}{menulink:newcomment}Post a comment{menulink}{menuitem}

The disadvantage of this second approach is that it doesn't let the user know if there are any existing comments until they click the link. Also, if the user does not have permission to add comments, they won't see the link.

A third approach is to include the showComments=true setting on the page URL. For example, the URL to this page is:

{{http://www.adaptavist.com/display/USERGUIDE/builder-comments+macro}}

You would change that to:

{{http://www.adaptavist.com/display/USERGUIDE/builder-comments+macro?showComments=true}}

Anyone accessing this link would automatically get the display of comments switched on, regardless of what previous settings they had used.