| 1 | | |
|---|
| 2 | | == Zooomr !InfoTags == |
|---|
| 3 | | |
|---|
| 4 | | Zooomr !InfoTags is a technology that allow users to create dynamic, fully searchable metadata with developers being able to also build ''InfoWidgets'', a fully interactive UI for InfoTags. |
|---|
| 5 | | |
|---|
| 6 | | !InfoTags and InfoWidgets have been available since Zooomr Mark III revision 0 and remain a core technology of the Zooomr Platform. |
|---|
| 7 | | |
|---|
| 8 | | === !InfoTag External Formatting === |
|---|
| 9 | | |
|---|
| 10 | | When adding and working with !InfoTags, it is important to keep the following format in mind: |
|---|
| 11 | | |
|---|
| 12 | | {{{ |
|---|
| 13 | | NAMESPACE:DISTINGUISHER=VALUE |
|---|
| 14 | | }}} |
|---|
| 15 | | |
|---|
| 16 | | These can be broken down as follows: |
|---|
| 17 | | |
|---|
| 18 | | {{{NAMESPACE}}}:: |
|---|
| 19 | | A common name that this metadata type falls under. Can only contain characters from A-Z; No Spaces Allowed. |
|---|
| 20 | | |
|---|
| 21 | | {{{DISTINGUISHER}}}:: |
|---|
| 22 | | A title that distinguishes this tag from possible other tags under the same namespace. Can be UTF-8 Encoded; No Spaces Allowed. |
|---|
| 23 | | |
|---|
| 24 | | {{{VALUE}}}:: |
|---|
| 25 | | The ''value'' or ''data'' of the !InfoTag. Can be either an integer or UTF-8 encoded string. Zooomr is smart enough to tell the two types apart. |
|---|
| 26 | | |
|---|
| 27 | | '''''Important Note:''''' If your Value contains a space {{{(" ")}}}, please wrap the entire structure in double quotes {{{("game:password=The Password is ???")}}}. This will ensure that Zooomr saves your !InfoTag correctly. |
|---|
| 28 | | |
|---|
| 29 | | A good standard example is the Color !InfoTag. It is represented like so: |
|---|
| 30 | | |
|---|
| 31 | | {{{ |
|---|
| 32 | | color:hex=#8a966b |
|---|
| 33 | | }}} |
|---|
| 34 | | |
|---|
| 35 | | As you can clearly see, the Namespace is {{{color}}}, the Distinguisher is {{{hex}}} and the Value is an html hex code, {{{#8a966b}}}. |
|---|
| 36 | | |
|---|
| 37 | | === 1st Party !InfoTags === |
|---|
| 38 | | |
|---|
| 39 | | [http://www.zooomr.com/about/ Zooomr's Team] have already created some interesting !InfoTags to make finding and viewing metadata much more fun and simple. Below is a partial list of these !InfoTags. |
|---|
| 40 | | |
|---|
| 41 | | ==== !InfoTags Anyone Can Add ==== |
|---|
| 42 | | * {{{vimeo:clip=}}}''CLIP_ID''[[BR]](Where ''CLIP_ID'' equals the ID of the Clip found on [http://www.vimeo.com/ Vimeo]) |
|---|
| 43 | | * {{{youtube:clip=}}}''CLIP_ID''[[BR]](Like Vimeo; Where ''CLIP_ID'' equals the ID of the Clip found on [http://youtube.com/ YouTube]) |
|---|
| 44 | | * {{{upcoming:event=}}}''EVENT_ID''[[BR]](Where ''EVENT_ID'' equals the ID of the Event found on [http://upcoming.yahoo.com/ Upcoming.org]) |
|---|
| 45 | | * {{{photowalk:}}}''GROUP_NAME''{{{=}}}''DATE''[[BR]](Where ''GROUP_NAME'' equals the the name of the photowalking club you are with and ''DATE'' equals the date of the photowalk in {{{YYYYMMDD}}} format. ''Example: {{{photowalk:tokyo=20080113}}}'' |
|---|
| 46 | | |
|---|
| 47 | | ==== !InfoTags That are Read-Only ==== |
|---|
| 48 | | ''This section to be added later. Please check back soon.'' |
|---|
| 49 | | |
|---|
| 50 | | === 3rd Party !InfoTags and GreaseMonkey Support === |
|---|
| 51 | | ''This section to be added later. Please check back soon.'' |
|---|
| 52 | | |
|---|
| 53 | | === !InfoWidgets === |
|---|
| 54 | | |
|---|
| 55 | | ''Main article: InfoWidgets'' |
|---|
| 56 | | |
|---|
| 57 | | !InfoWidgets allow developers to build interactive experiences around !InfoTag metadata, allowing users to articulately add meta information to photographs. Below are some visual examples of some 1st-party !InfoWidgets. |
|---|
| 58 | | |
|---|
| 59 | | {{{ |
|---|
| 60 | | #!html |
|---|
| 61 | | <img src="http://trac.zooomr.com/trac/attachment/wiki/InfoTags/infowidgets_guide.png?format=raw" /> |
|---|
| 62 | | }}} |
|---|
| | 1 | This document as since been moved to [wiki:ZooomrAPI/InfoTags]. Please update your links or bookmarks. |