Knowledgebase

Article number: 301407

Guestbooks, Blogs and Forums via XML

Sitekit CMS Guestbooks and Forums can be inserted anywhere on a page with XML data islands, similar to <navigation> and <breadcrumb>.

The following code is used to accomplish this for forums:

<FORUM><FORUMID>528</FORUMID></FORUM>

The following code is used to accomplish this for Guestbooks:

<GUESTBOOK><GUESTBOOKID>339</GUESTBOOKID></GUESTBOOK>

Currently the only way to find out the ID number of a guestbook or forum is to locate it in the page source of the "Guestbooks" or "Forums" area of Sitekit CMS. Then change the number in the code above to the guestbook or forum ID.

It is advised that both types of island are  used on the same page as there is some conflict on certain display modes.

The feature is particularly useful when using a specific content type, and add additional information above and below the guestbook or forum. This also enables easier and more flexible guestbook and forum styling.
This also makes it possible to add guestbooks to layouts or even global variables to appear on multiple pages.

An extension of the Guestbook XML island is the Blog XML island. This can be specified by using:

<GUESTBOOK>
<BLOG>1</BLOG>
</GUESTBOOK>

The following variables can be set in the XML island. These can be used even if the guestbook is not a blog:

Variable

Application

Possible Values

Default Value

<MODERATED>1</MODERATED>

Whether the blog is moderated via email

1, 0

0

<APPROVETOEMAIL>bob.paul@
sitekit.net</APPROVETOEMAIL>

The email address that moderated emails will be sent to

any email address

 

<DAYSTOARCHIVE>100</DAYS
TOARCHIVE>

How long before the blog archived

1 or above

365

<REQUIREEMAIL>1</REQUIRE
EMAIL>

If the user is required to post their email with their blog

1, 0

0

<SHOWADDRESS>1</SHOWADD
RESS>

Whether the address will be shown beside blog

1, 0

1

<SHOWTELEPHONE>1</SHOW
TELEPHONE>

Whether the telephone number will be shown beside blog

1, 0

0

<SHOWPROFESSION>1</SHOW
PROFESSION>

Whether the profession will be shown beside blog

1, 0

0

<SHOWCAPTCHA>1</SHOWCA
PTCHA>

Show Captcha Field

1, 0

1

Blogs are archived after the specified period above. When there are 1 or more blogs in the archive, the island will automatically display a "View Archive" button.

Please note, the "add a submission" form for guestbooks and blogs is displayed at the bottom of the XML island, below the archive button. "Require email" is explained to the user in the "Add a submission" form.

The XML island for guestbooks and blogs does have security features such as a unique GUID for every submission which is valid for 1 hour.

The name of the new automatically created guestbook needs to be unique and will be of the format:

Blog_#PAGEID#_#LANG#

Where #PAGEID# is the unique id from the editorial table and #LANG# is the language of the page

Rather than use this guestbook name in Headings/buttons etc the following fixed text is used from the multi-lingual Sitekit CMS dictionary:

Submit Comment
Leave a Comment
Your comment has been added
Back To Latest Comments
Archived Comments
View Archived Comments
There are currently no archived comments
You must enter your name before you can leave a comment on this page
all comments are moderated - your submission will be posted on approval
Comments

Related questions