API
Below are described some of the parameters that can be passed to Wists to control outputs.
These will form part of a REST based API later.
Content:
http://wists.com/username/tag
username = everyone shows items from all users.
e.g. http://wists.com/everyone/wishlist shows items from everyone’s wishlist tag.
Metatags
Groups of tags can be created using the format group=tag, e.g. location=nyc
where any group name can be invented when adding items while logged into Wists.
Dates
A date can be entered after the tag or username to filter by date, dates are entered in the format: year(4 digit)-month (2 digit) - day (2 digit)
Dates preceded by a less than ‘< ' sign show items added before that date, dates preceded by a greater than '>‘ sign, show items added after that date. To include items add on the date entered, add an ‘=’ sign after the ‘< ' or '>‘ sign.
e.g.
http://wists.com/david/all/< =2005-03-25
Layout:
The ‘cols=’ parameter determines how many columns to display, overriding the default.
The ‘rows=’ parameter determines how many rows to display, overriding the default.
e.g.
http://wists.com/david/?out=plain&cols=6&rows=4
Item skins:
The ‘item_skin=’ parameter determines what an individual item looks like, the default skin is ’simple’ (and therefore does not need to be specified).
Item_skin=full may aslo be used (other skins will be added in future).
e.g.
http://wists.com/david/product=furniture/?out=plain&item_skin=full&cols=1&rows=4
Outputs:
The out= parameter changes the type of page that is output.
out=plain removes Wists branding and sidebars, allowing creation of gallery or store pages based upon your Wists.
e.g. http://wists.com/david/all/<2005-03-25?out=plain
out=rdf outputs your wists in RSS 1.0 to subscribe to wists in an RSS aggregator.
Styles:
You can add your own stylesheet to customise the look and feel of your gallery when using the out=plain parameter in conjuntion with css_url=
Below are descriptions of proprietary classes used in wists output, that can be used to change the look and feel of wists output, when using a remotely referenced stylesheet, using the css_url= parameter. Standard elements such as text and page background properties can of course be changed using standard css styles.
Grid view (default) styles
class:thumbnailtable
element type=table description: the table containing an item’s thumbnail image.
class: h_add
element type=text description: ‘add’ text which adds to another gallery (or leads to signup, on clicking)
class: h_itemtitle
element type=text description: text showing the title of an element
class: addedlinked
element type=text description: text showing which user an item was added from and/or which users have added an item, where applicable.
Detailed view styles
A detailed view, with items shown vertically with description and tags can be displayed using the layout=v parameter
e.g. http://wists.com/everyone?out=plain&layout=v
class:thumbnailtable
element type=table description: the table containing an item’s thumbnail image.
class: add
element type=text description: ‘add’ text which adds to another gallery (or leads to signup, on clicking)
class: itemtitle
element type=text description: text showing the title of an element
class: itemdesc
element type=text description: text showing the full description of an element
class: addedlinked
element type=text description: text showing which user an item was added from and/or which users have added an item, where applicable