Free-Conversant Support / How-To Add Labels To FullThread Pages
 Home   About Conversant   Free Sites   Hosting   Support   XML-RPC 

Search



Documentation >> Outline of How-To Docs >> How-To Add Labels To FullThread Pages

Content

If the labels aren't already displayed in your FullThread page, we'll see here how to add them. If you're using several FullThread pages, you'll have to do this for each of them.

Depending on the case we'll:

Decide What To Do

As for the DG Calendar Page, the first thing to ask is "did you modify the page's templates?" The FullThread pages have two templates called Page Template and Item Template. These templates are located at:

"/yourSite/admins/conversation/yourSite/structure$path=yourSite%2FpageName"

... where pageName defaults to "fullThread".

Did you edit them?

Reset The FullThread Page

Resetting the FullThread page will allow you to get the new default templates. If you use your own templates, you certainly don't want to overwrite them. In this case, jump to Editing The Templates.

  1. If you're not already there, go to:

    "/yourSite/admins/conversation/yourSite/structure$path=yourSite%2FpageName"

  2. Look at the current settings of your FullThread page (like the stylesheet, the Javascript or the magicNavbars it uses). If needed, write them down. You'll have to restore your own settings.

  3. Scroll the page all the way down and click on Delete.

  4. You'll be prompted to confirm. Make sure you're not deleting the wrong page and click on OK. The page will be deleted and you'll be returned to the listing of the folder which contained it.

  5. Scroll the window all the way down, to get the Add New File Or Folder form.

  6. In the Navigation Title field enter the name of your calendar page (by default it's "fullThread"). Select "FullThread Page" in the File Type popup menu, and click on Add New File.

  7. When the page has reloaded, locate in the listing the page you just created, and click on its name.

  8. Then, you'll get the File Properties screen of that page, where you'll just have to restore your settings. A few choices in popup menus, and you're done.

  9. Finally, click on Change File Properties. That's it, the page will reload, confirming the changes, and you're done. Jump to your DG calendar, find a message that has replies, click on its subject, then click on the "Thread" link, and enjoy using labels.

If you need to add labels to other areas of your conversation, see More Infos.

Edit the templates

Each FullThread page has two templates called Page Template and Item Template.

They're are located at:

"/yourSite/admins/conversation/yourSite/structure$path=yourSite%2FpageName"

We'll edit only the latter, as there's no macro to call from Page Template.

Item Template

This template is used for each message displayed in the FullThread pages.

Macros

Here are the macro you may call from this template. As usual, macro calls are on the form "<!--#macroName-->".

  • threadMsgLabel
    This will be replaced with a colored block (colored with the label's color, of course). You may use it alone.
  • threadMsgLabelColor
    This will be simply replaced with the label's color. Use it if you want to display the label's name on its background, for example.
  • threadMsgLabelTextColor
    This will be simply replaced with the label's text color. You may call it from a <font> tag, for example.
  • threadMsgLabelName
    This will be replaced with the label's name.
  • threadMsgLabelId
    This will be replaced with the label's id (its unique, non editable identifier).

Example

Here's what we added to the default item template:

<!--#threadMsgLabel-->

If you wanted to add the label's name to the default template, you could add this:

<span style="background-color:<!--#threadMsgLabelColor-->; color:<!--#threadMsgLabelTextColor-->">
	<!--#threadMsgLabelName-->
</span>

When you're done editing the template (and pasting it back in the File Properties screen if you edited it in an external text editor), click on Change File Properties. The page will reload, confirming the changes.

That's it, you're done. Jump to your calendar, find a message that has replies (and label), click on its subject, then on Thread.

More Infos

If you're adding labels to your whole conversation, you may want to go back to the labels documentation, where you'll find links to the other How-To's about labels.

If you need more infos about the FullThread Page, see the FullThread Pages documentation.

View in DG


This site managed with Conversant, © Copyright 2007 Macrobyte Resources