BBC Home

Explore the BBC


6th March 2015
Accessibility help
Text only
default banner
BBC Homepage

DNA Hub
Knowledge Base
Feedback
Search
Who's Online

h2g2
360
iCan
collective
Book of the Future
Talk Buffy
Get Writing
WW2
Parent's Music Room

Contact Us


Like this page?
Send it to a friend!

 
New visitors: Create your membership
Returning members: Sign in


GuideML: GUESTBOOK Tag

The <GUESTBOOK> tag allows you to insert a form into your articles that allows Researchers to post comments to Conversation Forums or Conversations that you specify in the tag.

It can be used to conduct a simple poll, or to create a friendly guest book on your Space, for example.

This tag does not form part of Approved GuideML.


Syntax and Usage

Optional attributes are shown in italics.

<GUESTBOOK FORUM="...forum number..."
SUBJECT="...subject..."
BUTTON="...button text..."
ROWS="...rows..."
COLS="...cols..."
>
...default text...
</GUESTBOOK>
<GUESTBOOK INREPLYTO="...posting number..."
SUBJECT="...subject..."
BUTTON="...button text..."
ROWS="...rows..."
COLS="...cols..."
>
...default text...
</GUESTBOOK>

Both these tags insert a subject field, a text area and a button into your article. The tags work as follows:

  • If the FORUM attribute is present, then when your visitors click on the button, a page is shown from which clicking on 'Post Message' will start a new Conversation in the Forum with number ...forum number... (explained below). The subject of the Conversation is taken from the subject field, and the initial Posting is set to the contents of the text area.

    You can find out the number of a Forum by visiting it and looking at the URL; the number for the Peer Review Forum, whose URL ends in F48874, is 48874. Similarly, the number of the Forum at the bottom of this page is 72732.

  • If the INREPLYTO attribute is present, then when your visitors click on the button, a page is shown from which clicking on 'Post Message' will start create new Posting in reply to the Posting with unique number ...posting number... (this is not the same number as the number shown as 'Posting n' in Conversations). The subject of the reply is taken from the subject field, and the reply is set to the contents of the text area.

    You can find out the number of a Posting by hovering your pointer over the 'Reply' button in that Posting, and looking at the URL, which will end in something like AddThread?inreplyto=1234567. The number after inreplyto= is the Posting's unique number.

  • If the SUBJECT attribute is present, then ...subject... will be inserted into the subject field.

  • If the BUTTON attribute is present, then ...button text... will be used as the text for the button, otherwise a default of 'Submit' is used.

  • If the ROWS attribute is present, then the text area will be ...rows... rows long, otherwise a default of 6 rows will be used.

  • If the COLS attribute is present, then the text area will be ...columns... columns wide, otherwise a default of 70 columns will be used.


Known Issues

None.


Example

Here's a form that demonstrates every attribute and posts a reply to the 'Example Conversation' Conversation in the Forum below:




Further Information

Discuss this Article

People have been talking about this Article. Here are the most recent Conversations:
Example Conversation (Last Posting: Feb 1, 2004)
Help! (Last Posting: Apr 22, 2002)
wrong thread (Last Posting: Apr 19, 2002)
MMMmm (Last Posting: Jul 19, 2001)






Article Data
Article ID: A596793 (Help Page)
Edited by:
Mark Moxon

Date: 18   July   2001

Most of the content on this site is created by our Members, who are members of the public. The views expressed are theirs and unless specifically stated are not those of the BBC. The BBC is not responsible for the content of any external sites referenced. In the event that you consider anything on this page to be in breach of the site's House Rules, please click here to alert our Moderation Team. For any other comments, please start a Conversation below.