Sunday 24th September, 2017    Search:
      Not logged in
Saying

[saying set="name" format="name" refresh="30" iframe="yes" width="300" height="100" background="red" style="font-family: Arial, 'Sans Serif'; font-size: 12pt; color: black"]

Note: If you do not want to use an iframe for a 'saying' do not mention iframe="yes", do not say anything at all! If you do not specify an iframe then any specified width, height or background would create a borderless box around the saying.

Omitting set="name" will make use of set "default". Omitting format="name" will make use of format "default".


[saying] is an incredibly powerful tag that will display the contents of the client's selected sayings database, which can be maintained via the site maintenance menu. A saying can be composed of multiple fields (named field1:, field2: etc. the uses of which are arbitrary) (note the trailing colon).

Some of these fields may be used for control purposes rather than being displayed. e.g. You may use earliest: to identify the earliest date this particular saying will ever be shown and you can use latest: to identify the latest date this particular saying will ever be shown. (Dates are specified as the four-digit year, the two digit month and the two digit day of the month, all zeros are significant).

You can use a field inside a tag, e.g. [image file="[field4]"] or [window page="[field3]"], so that the contents of the image or the location of the window link are taken from the specified field of the saying. Both these could use full URLs (e.g. field4: http://build-a.ultrastore.com/images/build-a/logo.gif) or relative addresses for pages/images (e.g. field3: contactus).

You can specify the layout and use of each field in the display. All these controls are performed within the scope of that saying set when you use site maintenance.

Sayings are maintained through the site maintenance menu option and first you must select which set you want to maintain.

The display format can also contain tags [repeat n]...[/repeat] (which repeats the contents of the tag n times, each with a different record e.g. "[repeat 5][field1][/repeat]" will display the first fields of 5 randomly chosen records), and [current_record format_name] (which creates a URL pointing to a display of the single current record in the specified format (which would probably show more of the fields with long descriptions), and which can be used in the page parameter of link/window/iframe,
e.g. "[window page="[current_record detaileddisplay]"][field1][/window]")

Then you can edit the actual 'sayings', which are compiled in groups of consecutive lines, each preceded with fieldn: where 'n' is any number of your choice, the colon is compulsory. Values of 'n' which should be small numbers distinguish one line from another in the next section and should be used to identify specific types of content..

Each group of lines in a single saying are separated from the next by a single blank line.

Some lines can be used to contain data used for control information and two specific lines are those that start with 'earliest:' and 'latest:' followed by long-date information in the format yyyymmdd. These are used to define when those particular sayings will be visible.

In the format section you can specify how the data will be presented for each group of data. This is done in a combination of standard formatted-text tags and fields mentioned inside e.g. [field3]. Fields that identify URLs can be used appropriately as page names within the current site, full URLs of pages elsewhere on the Net and as image names within the current site or full URLs of images elsewhere on the Net. (Images may be standard static images or animated GIFs or even flash files these would need to be referenced within an appropriate flash tag to be viewed.

A formatting extension on the call to the saying allows the client to identify a deep iframe in which an unlimited number of sayings will be presented one after another down the page. If there are too many sayings to be seen at once then scroll bars will be evident.
Build-a ServicesSite authors: Nightingale Services