PNPD:Data Fields

From PubNight
Jump to: navigation, search

Purpose of the fields

The fields allow us to implement a very basic database inside the Wiki.

Format

The format of each field is very simple:

fieldname=value|

The trailing | is very important as this is what we use as a field separator. When editing using the internal Wiki editor place each field on its own line - this is purely to make it easy to edit the fields, it is not needed from a data point of view.


Current Fields

name

The name of the Pub. Note: This is NOT necessarily the name of the PubNight Wiki page. This is the name that is displayed when the pnlink tag is used.

address

The address of the pub. Separate each line of the address with a comma - for example: 8 Townsend St, Cheltenham,Gloucestershire

postcode

The postcode of the pub. This is added to the address when the address is asked for. It is a separate field as it is used to link to the external map site

phone

The phone number of the pub

website

If the pub has a website then enter it here. Do not provide the leading http:// as this is added by the extension

page

The name of the PubNight wiki page. This is used as the link to item when the pnlink tag is used - So the NAME is displayed but the clicking on the link takes you to the PAGE.

image

If there is a image associated with this pub then put the name of the file here

nickname

Does the pub have a nick name? If it does then put it here

lastvisit

When was the pub last visited. The date should be in the format dd/mm/yyyy. If the exact date is not known then you can use 00/mm/yyyy or 00/00/yyyy which will give either the month and year or just the year as the visit date. If the contents of this field are not in the format specified then the contents of the field are displayed instead of the date.

who

A list of who attended the pubnight. This should be a comma separated list of names. When this is displayed the names are turned into links to PubNight wiki pages.

brewery

A list of brewers providing beer at the pub. This is a comma separated list

beers

A list of the beers available at the pub. This is a comma separated list

rating

What is the rating of the pub. This can be a value between 0 and 10. When this is displayed it is formatted using the format specified (see Formatting for details on this

beer_rating

What is the rating of the beer quality. This follows the CAMRA approved method and should be a value between 0 and 5. When this is displayed it is formatted using the format specified (see Formatting for details on this

previous

In discussion

description

In discussion

summary

A brief summary of the pub.

notes

Quick notes which may be of use

history

In discussion

lat

The Latitude of the pub - for GoogleMaps

lon

The Longditude of the pub - for GoogleMaps

group

The group a pub belongs to - this allows disparate pubs to be group together into a logical group such as oot (for out of town pub venues)

Special Fields

The Pndata extension has some special fields that are not real fields. So although these can be used in the extension tag they do not exist as data fields in the data pages

header

This displays a predefined header block

footer

This displays a predefined footer block

thumb

This displays a thumbnail of the image associated with the digraph along with the caption

picture=

This displays the image associated with the digraph, framed with the caption text underneath it

googlemap

If the lat and lon fields are set then display a Googlemap with the pub at the centre

addmarker

This adds a marker to an existing googlemap.

user_content

This basically outputs the text between the open and close extension tags as part of the output. Its primary use is to allow you to insert your content between field output

gmfeed

This is not a field that would normally be used. Its primary usage is for creating lists of googlemap points for inclusion in the googlemap extension. So if you wanted to create a googlemap with some pubs on it then you'd use this field to create a list of points to put into the googlemap extension.


For more information on these you should refer to the PubNight Extensions page