Project-Id-Version: Trac 0.12
Report-Msgid-Bugs-To: trac-dev@googlegroups.com
POT-Creation-Date: 2008-01-30 09:20+0100
PO-Revision-Date: 2010-07-19 23:05+0200
Last-Translator: Jeroen Ruigrok van der Werven <asmodai@in-nomine.org>
Language-Team: en_US <trac-dev@googlegroups.com>
Plural-Forms: nplurals=2; plural=(n != 1)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Generated-By: Babel 0.9.6

Warning: Can't synchronize with repository "(default)" (Unsupported version control system "git": Can't find an appropriate component, maybe the corresponding plugin was not enabled? ). Look in the Trac log for more information.
Last modified 5 years ago Last modified on 01/25/13 13:13:11

After taging and enrich your media with MetaData you would like how to select or find specific media selected by the MetaData. Follwoing page describes the search parameters for the media explorer.

The media explorer of phTagr has some top level sections followed by parameters to query only a subset of the media.

Top Levels

The top levels are immediatly followed by the URL of the media explorer.

tag/tag[,tag2,...]
Show all media with a specific tag
category/category[,category2,...]
Show all media of a specific category
location/location[,location2,...]
Show all media of a specific location
date/YYYY[/MM[/DD]]
Show media of a specific date. The date can be given in years or month or even a specifc date. date/2008 shows all media of the year 2008, while date/2008/05/11 shows media of 11th may of 2008
view/
General view which is used to build an own query with parameters. E.g. view/tags:night/sort:-date
search/
Shows the advanced search form
user/user
Shows only media of a specific user

Top Levels for Users

Following top level is only for users

group/group:group name or group ID
Select a specific group

Parameters

Parameters can be attached to the URL of the media explorer (and RSS, MediaRSS URL, too). All parameters are concatenated with a slash. E.g. media explorer URL/query/parameter1/parameter2/parameter3. Each parameter has a name and a value which is separated by a colon. Eg. name:value. A full example looks like view/tag:night/category:vacation/sort:-date.

Parameter exclusion

Some parameter do support exclusion. A excluded parameter has a minus (-) sign prefixed. For example tag:-night will exclude all media with tag night.

Required parameter

Some parameter do support to be required. A required parameter has a plus (+) sign prefixed. For example tag:+night will match all media with at least tag night.

Optional Parameter

By default all parameter are required and do not need to be prefixed with plus sign. However, if at least one parameter is explicitly marked as required all other parameter become optional (Only parameter which support required flag are optional. Other parameters are still required).

For example: view/tag:night/category:vacation/sort:newest is equivalent to view/tag:+night/category:+vacation/sort:newest. sort parameter does not support required flag. With view/tag:night/category:+vacation/sort:newest means that the media must have the the category vacation and can have the tag night. Media with most matches are shown first even if a media with less matches follows the sort order. In our example: A media B with category vacation and tag night is shown before a media A with only category vacation while media A is newer than media B.

Special Values

There are special values like any or none. Value any matches any assigned meta data of given parameter. Value none matches all media which have no assignments for given parameter.

Parameter List

category:word|any|none
Show media with category of word. Exclusion and required is supported.
city:word|any|none
Show media with city of word. Exclusion and required is supported.
country:word|any|none
Show media with country of word. Exclusion and required is supported.
from:YYYY-MM-DD|YYYY-MM|YYYY
All media starting with given date. Eg. from:2009-03-26 shows all media at not older than 26th march of 2009
geo:none|any
Show media with no or any geo information
location:word|any|none
List of locations which the media should include. The location include tags from sublocation, city, state, and country. Exclusion and required is supported
order:date|-date|newest|name|changes|random
Sort order. date is youngest first, -date oldest first
page:number
Set the page number. Eg. page:2 shows the 2nd page.
show:number
Page size. Eg. show:36 displays 36 media. For performance reasons not more than 240 media at once are shown.
similar:word|any|none
Show media with similar values of word. Similar includes values from tag, category, sublocation, city, state, and country.
state:word|any|none
Show media with state of word. Exclusion and required is supported.
sublocation:word|any|none
Show media with sub location of word. Exclusion and required is supported.
tag:word|any|none
Show media with tag of word. Exclusion and required is supported.
to:YYYY-MM-DD|YYYY-MM|YYYY
All media until given date. Expample: to:2013-01-25 show all media until 25th January 2013.
type:image|video|any
Select specific media type. any is default value.
user:username
Show only media from a specific user given by user name
view:default|compact|small
Switch thumbnail view size and information

Parameters for Users

Following parameters are only for phTagr users

group:groupname
Show only a specific group given by group name or group ID
visibility:private|group|user|public|any
Level of own media visibility. This parameter is only active if you select your own images with user parameter. any is default value. Example: visibility:public show all media which are public and only public visible. Media which can be seen by user or only through group assignments are not shown.