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.

Changes between Version 1 and Version 2 of MediaExplorer


Ignore:
Timestamp:
01/25/13 07:51:10 (5 years ago)
Author:
sebastian
Comment:

Improve parameter list

Legend:

Unmodified
Added
Removed
Modified
  • MediaExplorer

    v1 v2  
    1414   Show all media of a specific location 
    1515 '''date/'''YYYY![/MM[/DD]]:: 
    16    Show media of a specific date. The date can be given in years or month or even a specifc date. ''[http://demo.phtagr.org/explorer/date/2008 date/2008]'' shows all media of the year 2009, while ''[http://demo.phtagr.org/explorer/date/2008/05/11 date/2008/05/11]'' shows media of 11th may of 2008 
    17  '''query/''':: 
    18    General query which is used to build an own query with parameters. E.g. [http://demo.phtagr.org/explorer/query/tags:night/sort:-date query/tags:night/sort:-date] 
     16   Show media of a specific date. The date can be given in years or month or even a specifc date. ''[http://demo.phtagr.org/explorer/date/2008 date/2008]'' shows all media of the year 2008, while ''[http://demo.phtagr.org/explorer/date/2008/05/11 date/2008/05/11]'' shows media of 11th may of 2008 
     17 '''view/''':: 
     18   General view which is used to build an own query with parameters. E.g. [http://demo.phtagr.org/explorer/view/tags:night/sort:-date view/tags:night/sort:-date] 
    1919 '''search/''':: 
    2020   Shows the advanced search form 
     
    3131= Parameters = 
    3232 
    33 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 [http://demo.phtagr.org/explorer/query/tags:night/categories:vacation/sort:-date/ query/tags:night/categories:vacation/sort:-date]. 
     33Parameters 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 [http://demo.phtagr.org/explorer/view/tag:night/category:vacation/sort:-date/ view/tag:night/category:vacation/sort:-date]. 
    3434 
    35  '''tags''':tag[,tag2,...]:: 
    36    List of tags which the media should include. Note: ''-flower'' exclude the tag ''flower'' 
    37  '''categories''':category[,category2,...]:: 
    38    List of categories which the media should include. Also possible ''-vacation'' for exclusion 
    39  '''locations''':location[,location2,...]:: 
    40    List of locations which the media should include. ''-cambodia'' to exclude location ''cambodia'' 
     35== Parameter exclusion == 
     36 
     37Some parameter do support exclusion. A excluded parameter has a minus (-) sign prefixed. For example ''tag:-night'' will exclude all media with tag ''night''. 
     38 
     39== Required parameter == 
     40 
     41Some 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''. 
     42 
     43== Optional Parameter == 
     44 
     45By 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). 
     46 
     47For example: [http://demo.phtagr.org/explorer/view/tag:night/category:vacation/sort:newest view/tag:night/category:vacation/sort:newest] is equivalent to [http://demo.phtagr.org/explorer/view/tag:night/category:vacation/sort:newest view/tag:+night/category:+vacation/sort:newest]. ''sort'' parameter does not support required flag. With [http://demo.phtagr.org/explorer/view/tag:night/category:+vacation/sort:newest 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. 
     48 
     49== Special Values == 
     50 
     51There 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.  
     52 
     53== Parameter List == 
     54 
     55 '''category''':''word''|any|none:: 
     56   Show media with category of ''word''. Exclusion and required is supported. 
     57 '''city''':''word''|any|none:: 
     58   Show media with city of ''word''. Exclusion and required is supported. 
     59 '''country''':''word''|any|none:: 
     60   Show media with country of ''word''. Exclusion and required is supported. 
    4161 '''from''':YYYY-MM-DD:: 
    42    All media starting with a specific date. Eg. ''from:2009-03-26'' shows all media at or older than 26th march of 2009 
    43  '''to''':YYYY-MM-DD:: 
    44    All media until a specific date 
     62   All media starting with given date. Eg. ''from:2009-03-26'' shows all media at not older than 26th march of 2009 
     63 '''geo''':none|any:: 
     64   Show media with no or any geo information 
     65 '''location''':''word''|any|none:: 
     66   List of locations which the media should include. The location include tags from ''sublocation'', ''city'', ''state'', and ''country''. Exclusion and required is supported 
     67 '''order''':sort order:: 
     68   Sort order. Possible values are: ''date'' (youngest first), ''-date'' (oldest first), ''random'', ''newest'', ''changes'' 
    4569 '''page''':number:: 
    4670   Set the page number. Eg. ''page:2'' shows the 2nd page 
    4771 '''show''':number:: 
    4872   Page size. Eg. ''show:36'' displays 36 media 
    49  '''order''':sort order:: 
    50    Sort order. Possible values are: ''date'' (youngest first), ''-date'' (oldest first), ''random'', ''newest'', ''changes'' 
     73 '''state''':''word''|any|none:: 
     74   Show media with state of ''word''. Exclusion and required is supported. 
     75 '''similar''':''word'':: 
     76   Show media with similar values of ''word''. Similar includes values from ''tag'', ''category'', ''sublocation'', ''city'', ''state'', and ''country''. 
     77 '''sublocation''':''word''|any|none:: 
     78   Show media with sub location of ''word''. Exclusion and required is supported. 
     79 '''tag''':''word''|any|none:: 
     80   Show media with tag of ''word''. Exclusion and required is supported. 
     81 '''to''':YYYY-MM-DD:: 
     82   All media until given date. Expample: ''to:2013-01-25'' show all media until 25th January 2013. 
    5183      
    52   
    5384== Parameters for Users == 
    5485 
    5586Following parameters are only for phTagr users 
    5687 
     88 '''group''':''word''|group ID:: 
     89   Show only a specific group given by group name or group ID 
    5790 '''user''':user name/user ID:: 
    5891   Show only media from a specific user given by user name or user ID 
    59  '''group''':group name/group ID:: 
    60    Show only a specific group given by group name or group ID 
    61  '''visibility''':level:: 
    62    Level of visibility. Possible values are: ''any'', ''private'', ''group'', ''user'', and ''public'' 
    63  '''type''':media type:: 
    64    Select specific media type. Values are: ''any'', ''image'', or ''video'' 
     92 '''visibility''':private|group|user|public|any:: 
     93   Level of visibility. ''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. 
     94 '''type''':image|video|any:: 
     95   Select specific media type. ''any'' is default value. 
    6596