= [wiki:ZooomrAPI Zooomr API]: !InfoTags =

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.

!InfoTags and InfoWidgets have been available since Zooomr Mark III revision 0 and remain a core technology of the Zooomr Platform.

== !InfoTag External Formatting ==

When adding and working with !InfoTags, it is important to keep the following format in mind:

{{{
NAMESPACE:DISTINGUISHER=VALUE
}}}

These can be broken down as follows:

 {{{NAMESPACE}}}::
   A common name that this metadata type falls under. Can only contain characters from A-Z; No Spaces Allowed.

 {{{DISTINGUISHER}}}::
   A title that distinguishes this tag from possible other tags under the same namespace. Can be UTF-8 Encoded; No Spaces Allowed.

 {{{VALUE}}}::
   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.

'''''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.

A good standard example is the Color !InfoTag. It is represented like so:

{{{
color:hex=#8a966b
}}}

As you can clearly see, the Namespace is {{{color}}}, the Distinguisher is {{{hex}}} and the Value is an html hex code, {{{#8a966b}}}.

== 1st Party !InfoTags ==

[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.

=== !InfoTags Anyone Can Add ===
 * {{{vimeo:clip=}}}''CLIP_ID''[[BR]](Where ''CLIP_ID'' equals the ID of the Clip found on [http://www.vimeo.com/ Vimeo])
 * {{{youtube:clip=}}}''CLIP_ID''[[BR]](Like Vimeo; Where ''CLIP_ID'' equals the ID of the Clip found on [http://youtube.com/ YouTube])
 * {{{upcoming:event=}}}''EVENT_ID''[[BR]](Where ''EVENT_ID'' equals the ID of the Event found on [http://upcoming.yahoo.com/ Upcoming.org])
 * {{{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}}}''

=== !InfoTags That are Read-Only ===
''This section to be added later. Please check back soon.''

== 3rd Party !InfoTags and GreaseMonkey Support ==
''This section to be added later. Please check back soon.''

== !InfoWidgets ==

''Main article: [wiki:ZooomrAPI/InfoWidgets]''

!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.

{{{
#!html
<img src="http://trac.zooomr.com/trac/attachment/wiki/InfoTags/infowidgets_guide.png?format=raw" />
}}}