Free-Conversant Support / How-To Add Labels To DG Calendars
 Home   About Conversant   Free Sites   Hosting   Support   XML-RPC 

Search



Documentation >> Outline of How-To Docs >> How-To Add Labels To DG Calendars

Content

If labels aren't already displayed in your DG Calendar page, we'll see here how to add them. If you use more than one DG Calendar page in your conversation, this will have to be done for each of them.

Depending on the case, we'll:

Decide What To Do

Each DG Calendar page has two templates called List Day Page Template and List Day Item Template. These templates are located at:

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

Did you modify these templates?

  • No
    You don't even have to look at the templates. All you have to do is to delete your DG Calendar page and to recreate it. The new default templates will include the labels. Jump to Reset The DG Calendar Page To Defaults.
  • Yes
    You'll have to edit the DG Calendar page's templates. Jump directly to Edit The Templates.

Reset The DG Calendar Page To Defaults

Resetting the DG Calendar 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 DG Calendar page (like the stylesheet, the Javascript or the magicNavbars it uses). If needed, write them down. You'll have to restore your own settings, there.

  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 "calendar"). Select "DG Calendar 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, and voilĂ . The page will reload, confirming the changes, and you're done. click on the View Page link to jump to your calendar, and enjoy using labels.

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

Edit the templates

Each DG Calendar page has two templates called List Day Page Template and List Day Item Template.

That's the templates we'll edit. They're are located at:

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

List Day Page Template

This template contains the header of the DG Calendar table (that's where are the links to sort the page by subject, author, etc). We'll add a new column, here.

If you find easier to edit the templates in a text editor that doesn't force the text to wrap, use copy/paste.

Macros

There's only one macro call you can use here:

  • listDayLabelSortLink
    This will be replaced with a label icon. Depending on the sort order, it will be a link, or it won't.

Example

Here's what we added to the default template:

<TH NOWRAP ALIGN='center' VALIGN='middle' CLASS='listDayHeaderCell'><!--#listDayLabelSortLink--></TH>

Note: If your template is based on the default one, you'll also have to increase by one the value of the colspan in the first <td> tag of the table.

List Day Item Template

This template is used for each message displayed in the DG Calendar page.

Macros

There's only one macro to use here too.

  • listDayMsgLabel
    This will be replaced with a colored block (colored with the label's color, of course).

Example

Here's what we added to the default template:

<TD NOWRAP ALIGN='center' VALIGN='middle' CLASS='<!--#listDayLabelCellClass-->'>
	<SPAN CLASS='listDayText'>
		 <!--#listDayMsgLabel--> 
	</SPAN>
</TD>

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

That's it, you're done. Click on "View Page" to jump to your Calendar page.

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 DG Calendar Page, see the DG Calendar Pages documentation.

View in DG