DiscusWare, LLC.
Download Purchase Contact Us
Home
Support Home Documentation Knowledge Base Support Forums Support Request Advanced Services
Discus 4.0 Skin Customization - Topics Page

This document describes how to customize the appearance of the topics list and topics page for a board running Discus 4.0 or higher. Unless you hold a support contract that includes support for customization, DiscusWare does not provide support for the procedures in this section.
Support Site Search
 
Manuals and Docs
  Installation
  Upgrade
  Administration - 4.0
  Administration - 3.1
  Customization
    Skin Primer
    Skin Editing
    Interface Customization
    Templates: Variables
    Templates: Substitution
    Templates: IF-THEN
    Templates: FOREACH
    Templates: FOR
    Templates: DEFINE
    Templates: Arrays
    Templates: Skins
    Templates: Text Ops
    Templates: Subroutines
    Templates: Flow Control
    Templates: Math
    Templates: Global Options
    Templates: Colors
    Templates: Language Files
Introduction

IMPORTANT! Please use extreme caution when editing skins, making sure you do not change any HTML comment tags, like <!--Top: $topic->{number}-->, when you edit skins.

Topic Variable Substitutions

The following variables are available to individual topics within the topics list (these refer to topics -- for categories, see below):

    Variable Result
    $topic->{type} 1 (1 = regular topic, 2 = category)
    $topic->{hidden} Whether topic is hidden (1 = yes, 0 = no)
    $topic->{number} Unique identifying page number for topic
    $topic->{name} The topic's name
    $topic->{icon} Topic icon (e.g., 'tree_n.gif')
    $topic->{descr} Topic description
    $topic->{last_poster} Name of last poster
    $topic->{msg_count} Message count (number of messages in this topic)
    $topic->{subs} Page count (number of pages in topic, including 1 for the page itself)
    $topic->{lastmod} Last modified date (unix time format)
Category Variable Substitutions

The following variables are available to individual categories within the topics list (these refer to categories -- for topics, see above):

    Variable Result
    $topic->{type} 2 (1 = regular topic, 2 = category)
    $topic->{bgcolor} Background color for category (hex code or valid HTML color)
    $topic->{number} Unique identifying page number for topic
    $topic->{text} Category text (much line a topic's name)
    $topic->{descr} Category description
General Variable Substitutions

It is possible to insert various bits of data about your discussion board onto the topics page. For example, you can insert the number of topics, number of registered users, and even the version of Discus you are running. The following variable substitutions can be used anywhere in the "topics" part of the skin:

    Variable Result
    $topicinfo->{topics_total} Total number of ordinary topics on entire board
    $topicinfo->{topics_displayed} Total number of ordinary topics that aren't hidden
    $topicinfo->{categories} Total number of categories on topics page
    $topicinfo->{last_post} Unix time format for the time of the most recent post
    $topicinfo->{last_post_visible} Unix time format for the time of the most recent post in a non-hidden topic
    $topicinfo->{last_poster} Name of most recent poster anywhere on board
    $topicinfo->{last_poster_visible} Name of most recent poster to a non-hidden topic
    $topicinfo->{messages_total} Total number of messages on board
    $topicinfo->{pages_total} Total pages on board in non-hidden topics
    $topicinfo->{pages_displayed} Total pages on board in non-hidden topics
    $topicinfo->{discus_version} Version number of Discus you are currently using
    $topicinfo->{registered_users} Total number of registered users

Download Purchase Contact Us
Privacy Policy
Copyright © 2005, DiscusWare, LLC, All Rights Reserved