Glossary Item Box

Modules: Modules

See Also CmsDeveloperGuide Send comments on this topic.

Page top

This module allows you to collect page annotations from several pages lists into one list (with the links to the full text of the pages and scaled pictures). It is also supported data output by the pages (using TemplatePaging control) and displaying pages for the certain month of the year (with the help of ArchiveNavigator control). Using HTML WYSISYG editor you can easily edit pages content through the administrative interface. The tape can also be displayed in RSS format (if the tape is displayed, the links to RSS versions are automatically added to Meta tags).

 

In a PageList tag you can use the following tags:

 

Using a PageSize attribute of the PageList tag you can determine, how many pages will be displayed on a site page (by default 10). When displaying a single page a Page module template is used. 

 

Use <%# Container.RSSUrl %> in the TopPart and BottonPart tags to get a link to RSS version
 

In the Template and TemplateWithoutText tags of the PageList tag you can use the following parameters:

Template's part Description
<%# Container.DateTime %> Date (as DateTime object)
<%# Container.Date %> Date (as string)
<%# Container.IsDate %> Whether there is a date at the given article
<%# Container.Head %> Header
<%# Container.Annotation %> Page's annotation
<%# Container.IsDate %> Whether there is a date at the given page or not
<%# Container.IsEmptyText %> Whether there is a text at the given page or not
<%# Container.PathToFullPage %> Path to the page with full information
 
   
You can place a pages list connected with a menu item everywhere on the site and edit these pages through the CMS administrative interface.
 
For that you should set a MenuItemGuid attribute into required menu item key:

<%@ Register TagPrefix="cmspt" Namespace="CMSLib.Modules.PageTop" Assembly="CMSLib" %>

...

<cmspt:PageList ID="PageTop1" PageSize="5" runat="server" MenuItemGuid="651d9451-e5ea-43fe-a56a-1e3243b36b75" />

 

A template file for this module lies in a modules/pagetop folder. It is used when displaying pages list and can look as follows:

<%@ Control Language="c#" Language="c#" Inherits="CMSLib.Pages.SiteControl" %>
<%@ Register TagPrefix="cmspt" Namespace="CMSLib.Modules.PageTop" Assembly="CMSLib" %>
<%@ Register TagPrefix="cmsctp" Namespace="CMSLib.Controls.TemplatePaging" Assembly="CMSLib" %>

<cmspt:PageList id="PageTop1" runat="server" MenuItemGuid="bf24a1d6-5aaf-4019-835d-cd64eb18a22b" PageSize="5">
    <Template>
        <%# Container.Annotation %>
        <a href="<%# Container.PathToFullPage %>">More info...</a>
    </Template>
    <TemplateWithoutText>
        <%# Container.Annotation %>
    </TemplateWithoutText>
    <Separator>
        <hr>
    </Separator>
</cmspt:PageList>

<cmsctp:TemplatePaging runat="server" ControlForNavigate="PageTop1"></cmsctp:TemplatePaging>
 

Showing pages “by rubrics” 

To show pages “by rubrics” set the ShowByRUbrics attribute of the PageList tag into “True” and set  TemplateRubricTopPart, TemplateRubricBottomPart, TemplateRubricSeparator, TemplateRubricPageSeparator, TemplateRubricWithoutText, TemplateRubricWithText tags content.
 
TemplateRubricWithoutText, TemplateRubricWithText tags parameters are similar to the Template and TemplateWithoutLink tags parameters.
 

In the TemplateRubricTopPart and TemplateRubricBottomPart you can use the following parameters: 

Template's part Description
<%# Container.Name %> Rubric's name
<%# Container.Link %> Link to all pages of the rubric
 
 
Example:
 

<%@ Control Language="c#" Language="c#" Inherits="CMSLib.Pages.SiteControl" %>
<%@ Register TagPrefix="cmspt" Namespace="CMSLib.Modules.PageTop" Assembly="CMSLib" %>
 

<cmspt:PageList id="PageTop1" runat="server" ShowByRubrics="true">
    <TemplateRubricTopPart>
        <%# Container.Name %><A href="<%# Container.Link %>">All articles >></A>
    </TemplateRubricTopPart>
    <TemplateRubricBottomPart>
        <%# Container.Name %><A href="<%# Container.Link %>">All articles >></A>
    </TemplateRubricBottomPart>

    <TemplateRubricSeparator>
        <hr size=2>
    </TemplateRubricSeparator>
    <TemplateRubricPageSeparator>
        <hr>
    </TemplateRubricPageSeparator>
    <TemplateRubricWithText>
        <A href="<%# Container.PathToFullPage %>">
        <%# Container.IsDate ? "" + Container.Date + "-" : "" %><%# Container.Head %>
        <br>
        <%# Container.Annotation %></A>
    </TemplateRubricWithText>
    <TemplateRubricWithoutText>
        <%# Container.IsDate ? "<b>" + Container.Date + "-" : "" %><%# Container.Head %><br>
        <%# Container.Annotation %>
    </TemplateRubricWithoutText>
</cmspt:PageList>

 
When using showing “by rubrics”, data output by the pages is not supported (you can not use TemplatePaging control)

Modules: Modules

 

 


© 2005-2007 Astron Digital Ltd. All Rights Reserved.