Creating sidebars – Apple Mac OS X Server (Extending Your Wiki Server For Version 10.5 Leopard) User Manual
Page 18
Creating Sidebars
If you haven’t created a sidebar before, it might be easier to customize an example
sidebar to suit your needs.
In the wireframe theme’s theme.plist file, there is a sidebars section that contains an
array of sidebars you can customize:
sidebar keys and values
sidebar keys and values
Understanding the Types of Sidebars
There are several types of sidebars, each with a specific purpose and set of keys:
Sidebar Type
Description
Related Section
static
A list of URLs.
“Static Unique Keys,” on page 19
search
A list of search results using tag-
based or text-based searching.
“Search Unique Keys,” on page 20
calendar
A list of upcoming events.
“Calendar Unique Keys,” on page 21
tag
A list of search results using tag-
based searching.
“Tag Unique Keys,” on page 22
recentActivity
A list of pages sorted by recent
viewing frequency. Based on the
last 100 page views in a wiki, this list
displays the most-viewed page first,
followed by the next most-viewed,
and so on.
“Recent Activity Unique Keys,” on page 22
admin
A sidebar that appears automatically
if someone logs in as an admin. This
sidebar isn’t customizable.
Not applicable
Shared Keys
All sidebars require the following keys:
Key
Example Values
Possible Values
Optional or Required
Description
displayName
What’s Hot, What’s New,
Useful Links, Upcoming
Events
Any string
Required
Name of the sidebar.
type
search, static, calendar
static, search, calendar, tag,
recentActivity, admin
Required
Type of sidebar used.
uid
HotList, RecentAddsList,
UsefulLinks
Any string
Required
Identifier for the sidebar.
This value must be unique.
18
Chapter 1
Customizing How the Wiki Looks