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 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 2009, while date/2008/05/11 shows media of 11th may of 2008
- query/
- General query which is used to build an own query with parameters. E.g. query/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 query/tags:night/categories:vacation/sort:-date.
- tags:tag[,tag2,...]
- List of tags which the media should include. Note: -flower exclude the tag flower
- categories:category[,category2,...]
- List of categories which the media should include. Also possible -vacation for exclusion
- locations:location[,location2,...]
- List of locations which the media should include. -cambodia to exclude location cambodia
- from:YYYY-MM-DD
- All media starting with a specific date. Eg. from:2009-03-26 shows all media at or older than 26th march of 2009
- to:YYYY-MM-DD
- All media until a specific date
- page:number
- Set the page number. Eg. page:2 shows the 2nd page
- show:number
- Page size. Eg. show:36 displays 36 media
- order:sort order
- Sort order. Possible values are: date (youngest first), -date (oldest first), random, newest, changes
Parameters for Users
Following parameters are only for phTagr users
- user:user name/user ID
- Show only media from a specific user given by user name or user ID
- group:group name/group ID
- Show only a specific group given by group name or group ID
- visibility:level
- Level of visibility. Possible values are: any, private, group, user, and public
- type:media type
- Select specific media type. Values are: any, image, or video
