hproduct: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
(removing random text on top of page)
m (Replace <entry-title> with {{DISPLAYTITLE:}})
 
(43 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<entry-title>hProduct</entry-title>
{{DISPLAYTITLE:hProduct}}
{{latest|h-product}}
{{DraftSpecification}}
{{DraftSpecification}}
__TOC__
__TOC__
Line 16: Line 17:
* Aaron Gustafson, [http://easy-designs.net/ Easy! Designs]
* Aaron Gustafson, [http://easy-designs.net/ Easy! Designs]


Microformats [http://microformats.org/wiki/hresume#Copyright copyright] and [http://microformats.org/wiki/hresume#Patents patents] statements apply.
Microformats [[hproduct#Copyright|copyright]] and [[hproduct#Patents|patents]] statements apply.


== Status ==
== Status ==
Draft, version 0.1.
Draft, version 0.3.


== Introduction ==
== Introduction ==
The web is a thriving consumer marketplace with a plethora of manufacturers and vendors scattered across the globe. Sifting through massive amounts of unstructured product data is a difficult task for both browsers and machines alike. The hProduct microformat gives structure to this metadata by providing constructs to identify universal product attributes, plus a mechanism to accomodate the wide variation in product attributes.
The web is a thriving consumer marketplace with a plethora of manufacturers and vendors scattered across the globe. Sifting through massive amounts of unstructured product data is a difficult task for both browsers and machines alike. The hProduct microformat gives structure to this metadata by providing constructs to identify universal product attributes, plus a mechanism to accomodate the wide variation in product attributes.


The hProduct microformat can assist consumers, manufacturers and retailers in a number of ways. If a browser or application understands that a specific web page contains the hProduct microformat, it can inform and help facilitate the best product choice by the consumer to fulfill their needs. An adpoted, open standard will ensure the correct product data is published between manufacturers and retailers, to the benefit of the consumer. Bringing order and structure to product data makes it easy for people and organizations to list the products and services they offer, and easy for web services to consume that product data for analysis and syndication.
The hProduct microformat can assist consumers, manufacturers and retailers in a number of ways. If a browser or application understands that a specific web page contains the hProduct microformat, it can inform and help facilitate the best product choice by the consumer to fulfill their needs. An adopted, open standard will ensure the correct product data is published between manufacturers and retailers, to the benefit of the consumer. Bringing order and structure to product data makes it easy for people and organizations to list the products and services they offer, and easy for web services to consume that product data for analysis and syndication.


=== Semantic XHTML Design Principles ===
=== Semantic XHTML Design Principles ===
Line 48: Line 49:


*hproduct
*hproduct
** availability. optional. text. can be further refined by type (instore, online, preorder, backorder, specialorder).
** brand. optional. text. can also use [[hcard|hCard]] for manufacturer.
** brand. optional. text. can also use [[hcard|hCard]] for manufacturer.
** buy. optional. text. purchase messaging and/or rel="purchase" indicating target url for purchasing item.
** category. optional. text. can also use rel-tag. re-used from [[hcard|hCard]].
** category. optional. text. can also use [[rel-tag]]. re-used from [[hcard|hCard]].
** price. optional. floating point number. can use currency format.  
** condition. optional. text. examples: 'new', 'used', 'refurbished'.
** description. optional. text. can also include valid HTML markup. re-used from [[hreview|hReview]].
** description. optional. text. can also include valid HTML markup. re-used from [[hreview|hReview]].
** model. optional. text.
** fn. '''required.''' text. product name or title. re-used from [[hcard|hCard]].
** '''n'''. required. text. product name or title. re-used from [[hcard|hCard]].
** photo. optional. image element or link. re-used from [[hcard|hCard]].
** photo. optional. image element or link. re-used from [[hcard|hCard]].
** price. optional. floating point number. can be further refined by type (msrp, regular, sale, clearance), can use [[currency]] format.
** url. optional. href. can contain rel-tag rel='product'. re-used from [[hcard|hCard]].
** quantity. optional. integer.
** review. optional. [[hreview|hReview]], or [[hreview-aggregate|hReview-aggregate]].
** shipping. optional. text. shipping messaging.
** listing. optional. [[hlisting|hListing]], or [[aggregate-microformat-template-examples|hListing-aggregate]].
** url. optional. href. can contain [[rel-tag]] rel='product'. re-used from [[hcard|hCard]].
** version. optional. text. re-used from [[hreview|hReview]].
** identifier. optional.
** identifier. optional.
***'''type'''. required. - examples:
*** type. required. - examples:
****mpn
**** model
****upc
**** mpn
****isbn
**** upc
****issn
**** isbn
****ean
**** issn
****jan
**** ean
****sn
**** jan
****vin
**** sn
****sku
**** vin
***'''value'''. required. - label may be implied
**** sku  
** p-v. optional. property-value pair.
*** value. required. - label may be implied
***'''property'''. required - examples:
****accessory for
****artist
****author
****color
****compatible with
****quantity in lot
****rating - can be further denoted into rating types (product || merchant || mpaa || esrb || others)
****released - hcalendar event for date of release
****size
***'''value'''. required. - label may be implied


=== Field details ===
=== Field details ===
Class names <code class="class-name">category</code>, <code class="class-name">n</code>, <code class="class-name">photo</code>, <code class="class-name">url</code> are reused from [[hcard|hCard]]. <code class="class-name">version</code> and <code class="class-name">description</code> are reused from [[hreview|hReview]].
Class names <code class="class-name">category</code>, <code class="class-name">fn</code>, <code class="class-name">photo</code>, <code class="class-name">url</code> are reused from [[hcard|hCard]]. <code class="class-name">description</code> is reused from [[hreview|hReview]].


The fields of the hProduct schema represent the following:
The fields of the hProduct schema represent the following:


*'''<code class="class-name">hproduct::</code>''' Root class name
*'''<code class="class-name">hproduct::</code>''' Root class name
*'''<code class="class-name">availability::</code>''' the class name availability is used to determine availability of product. {{must}} be singular.
*'''<code class="class-name">brand::</code>''' the class name brand is used identify brand of the product. {{should}} use [[hcard|hCard]] for manufacturer name. {{must}} be singular.
*'''<code class="class-name">brand::</code>''' the class name brand is used identify brand of the product. {{should}} use [[hcard|hCard]] for manufacturer name. {{must}} be singular.
*'''<code class="class-name">buy::</code>''' the class name buy contains messaging on how to buy product and/or relevant URLs to facilitate purchase. {{may}} be plural.
*'''<code class="class-name">category::</code>''' the class name category identifies product category. {{may}} use [[rel-tag]] microformat. {{may}} be plural to represent multiple categories.
*'''<code class="class-name">category::</code>''' the class name category identifies product category. {{may}} use [[rel-tag]] microformat. {{may}} be plural to represent multiple categories.
*'''<code class="class-name">condition::</code>''' the class name condition identifies the product condition. {{may}} include text like "new", "used", "refurbished".{{must}} be singular.
*'''<code class="class-name">price::</code>''' the class name price is used to indicate the price of the product. {{must}} be singular.
*'''<code class="class-name">model::</code>''' the class name model identifies the manufacturer model name/ number associated with the item. {{must}} be singular.
*'''<code class="class-name">description::</code>''' the class name description is used to describe the product. {{must}} be singular.
*'''<code class="class-name">n::</code>''' product text name. {{must}} be singular.
*'''<code class="class-name">fn::</code>''' product text name. {{must}} be singular.
*'''<code class="class-name">photo::</code>''' the class name photo {{may}} be applied to an <img> or <a> element. {{may}} be plural.
*'''<code class="class-name">photo::</code>''' the class name photo {{may}} be applied to an <img> or <a> element. {{may}} be plural.
*'''<code class="class-name">price::</code>''' the class name price is used to identify a floating point number. {{may}} be refined by type, including msrp, regular, sale, or clearance. {{may}} use currency format. {{may}} be plural.
*'''<code class="class-name">quantity::</code>''' the class name quantity quantifies the number of available units of a product. {{must}} be singular.
*'''<code class="class-name">shipping::</code>''' the class name shipping {{may}} define the method, timeframe, and cost associated with shipping the product. {{must}} be singular.
*'''<code class="class-name">url::</code>''' the class name url {{should}} refer to the web page associated with product details. {{may}} use [[rel-tag]], rel='product'. {{must}} be singular.
*'''<code class="class-name">url::</code>''' the class name url {{should}} refer to the web page associated with product details. {{may}} use [[rel-tag]], rel='product'. {{must}} be singular.
*'''<code class="class-name">version::</code>''' the class name version {{should}} indicate the version of the hProduct format used for the item. by omitting this field, the publisher is stating that implementations {{may}} interpret the hProduct according to any version of the hProduct specification. {{must}} be singular.
*'''<code class="class-name">review::</code>''' the class name review identifies review(s) for the product. {{should}} use [[hreview|hReview]]. {{may}} be plural.
*'''<code class="class-name">identifier::</code>''' the identifier structure is used to describe product identifiers like UPC or SKU, and is designed to accommodate new or as-yet-unidentified identifiers. {{should}} be singular.
*'''<code class="class-name">listing::</code>''' the class name listing identifies product listings. {{should}} use [[hlisting|hListing]]. {{may}} be plural.
*'''<code class="class-name">identifier::</code>''' the identifier structure is used to describe product identifiers like Model, UPC or SKU, and is designed to accommodate new or as-yet-unidentified identifiers. {{should}} be singular.
**'''<code class="class-name">type::</code>''' the class name type identifies the identifier type.
**'''<code class="class-name">type::</code>''' the class name type identifies the identifier type.
**'''<code class="class-name">value::</code>''' label {{may}} be implied
**'''<code class="class-name">value::</code>''' label {{may}} be implied
*'''<code class="class-name">p-v::</code>''' the class p-v is the mechanism used to accomodate the wide variation in product attributes. {{may}} be plural.
**'''<code class="class-name">property::</code>''' the class name property is used to identify unique product attributes used in class p-v.
**'''<code class="class-name">value::</code>''' label {{may}} be implied.


=== Additional Details ===
=== Additional Details ===
'''Note:''' If hProduct markup is used in a "standalone" fashion (eg. a manufacturer site that's not commerce enabled, strictly informational), it is assumed that the price attribute represents the manufacturer's suggested retail price. Any transactional (commerce) representation of price should be delegated to [[hlisting|hListing]].
''Internationalization'': Though there are many English-language tokens, they are only used as invisible class-names; user-visible listing information can be completely localized. Note that (X)HTML LANG attribute rules still apply as usual, for multilingual aggregators of hProduct.
''Internationalization'': Though there are many English-language tokens, they are only used as invisible class-names; user-visible listing information can be completely localized. Note that (X)HTML LANG attribute rules still apply as usual, for multilingual aggregators of hProduct.
=== Relationships with other microformats ===
Products can be complex structures with attributes and features that may fall outside the bounds of the proposed hProduct microformat. Care has been taken to provide just enough attributes to accurately represent products while not overloading the hProduct spec. This means that complete semantic solutions would rely on using hProduct in combination with other microformats to achieve their goals. Through [[hproduct-examples#Coded_examples|examples]] (see also: [[hproduct-recipes|recipes]]) and [[hproduct-examples#Analysis_of_Product.2FCommerce_Sites|analysis]], there are some clear relationships between hProduct and these microformats:
* [[hlisting|hListing]] :: provides additional context to the transaction side of a product, including elements like the transactional price.
* [[hReview|hReview]]/hAggregate(concept) :: research shows that many commerce sites include product reviews, and they are often aggregated to provide overall ratings and reviews on the web. Utilizing these microformats can provide additional data around a product or service.
* [[xoxo|xoxo]] :: to address property-value data that may be necessary for a complete data representation of a product.
Of course, these are just a few of many that could be used with the hProduct microformat.


=== XMDP Profile ===
=== XMDP Profile ===
<pre>
<pre>
<dl class="profile">
<dl class="profile">
Line 131: Line 119:
<dt>hproduct</dt>
<dt>hproduct</dt>
<dd>Used to identify and describe metadata universally common to products.</dd>
<dd>Used to identify and describe metadata universally common to products.</dd>
<dt>availability</dt>
<dd>The details around the availability of the product.</dd>
<dt>brand</dt>
<dt>brand</dt>
<dd>The brand name of the product.</dd>
<dd>The brand name of the product.</dd>
<dt>buy</dt>
<dd>Details on how to buy the product</dd>
<dt>category</dt>
<dt>category</dt>
<dd>The product category/ categories the product belongs to.</dd>
<dd>The product category/ categories the product belongs to.</dd>
<dt>condition</dt>
<dt>price</dt>
<dd>The condition of the product.</dd>
<dd>The price of the product.</dd>
<dt>model</dt>
<dt>description</dt>
<dd>The model identifier of the product.</dd>
<dd>The full text representing the written description of the product.</dd>
<dt>n</dt>
<dt>fn</dt>
<dd>The common name of the product.</dd>
<dd>The common name of the product.</dd>
<dt>photo</dt>
<dt>photo</dt>
<dd>Accompanying image of the product.</dd>
<dd>Accompanying image of the product.</dd>
<dt>price</dt>
<dd>The price of the product.</dd>
<dt>quantity</dt>
<dd>The number of this type of product available.</dd>
<dt>shipping</dt>
<dd>Shipping information like method, timeframe or cost.</dd>
<dt>url</dt>
<dt>url</dt>
<dd>A link to the product details.</dd>
<dd>A link to the product details.</dd>
<dt>version</dt>
<dt>review</dt>
<dd>The version of the hProduct microformat being used in the example.</dd>
<dd>A review of the product.</dd>
<dt>listing</dt>
<dd>Listing details of the product.</dd>
<dt>identifier</dt>
<dt>identifier</dt>
<dd>The product identifier like SKU, ISBN, or EAN associated with the product</dd>
<dd>The product identifier like Model, SKU, ISBN, or EAN associated with the product</dd>
<dt>p-v</dt>
<dd>Lists property-value pairs that identify unique product attributes.</dd>
</dl>
</dl>
</dd>
</dd>
</dl>
</dl>
</pre>
</pre>


Line 171: Line 148:
*...
*...


=== Examples in Production ===
== Examples ==
* Description of [http://jay.beweep.com/index.php/2008/10/14/reviving-shop-urls-with-hproduct BestBuy.com implementation]
* need actual simple demonstration hProduct examples here! (not examples of what actual sites are doing - that's the next section)


=== Other examples ===
Editors: please see http://microformats.org/wiki/hrecipe#Examples for example of an example in spec.


==== Simple Product ====
...


The Pick of Destiny
== Examples in the wild ==
by Tenacious D
This section is '''informative'''.   
The Pick of Destiny is the highly anticipated soundtrack to the upcoming
New Line Cinema comedy, Tenacious D in the Pick of Destiny. An epic
musical adventure, the film follows Tenacious D (Jack Black and Kyle Gass)
on their quest to obtain the Pick and become The Greatest Band on Earth.
Released: November 14, 2006
Label: Sony
  UPC: 82796948912


<pre><nowiki><div class="hproduct">
Sites and pages that publish hProducts.
   <h4 class="name">The Pick of Destiny</h4>
 
   <h5 class="p-v">by <span class="property artist">Tenacious D</span></h5>
See [[hproduct-examples-in-wild|hProduct Examples in the wild]].
   <p class="description summary">The Pick of Destiny is the highly
 
  anticipated soundtrack to the upcoming New Line Cinema comedy, Tenacious
== Implementations ==
   D in the Pick of Destiny. An epic musical adventure, the film follows
This section is '''informative'''.
   Tenacious D (Jack Black and Kyle Gass) on their quest to obtain the Pick
 
   and become The Greatest Band on Earth.</p>
Tools for generating and consuming hProducts. When it gets too big we can move it to a separate page like [[hproduct-implementations]].
  <ul>
 
    <li class="p-v"><span class="property">Released</span>:
* Google parses some hProduct properties and adds extensions:
      <span class="value"><abbr title="2006-11-14T12:00:01-05:00">November
An example is a HP printer product page parsed with the help of Google Rich Snippets Tool: [http://www.google.com/webmasters/tools/richsnippets?url=http%3A%2F%2Fwww.shopping.hp.com%2Fproduct%2Fprinter%2Finkjet%2F1%2Fstorefronts%2FC9295A%252523B1H HP Printer Product] from which Google extracted the following hProduct elements:
      14, 2006</abbr></span></li>
 
    <li>Label: <span class="brand">Sony</span></li>
<pre>
    <li class="p-v"><span class="property">UPC</span>:
hproduct
      <span class="value">82796948912</span></li>
   availability = In stock
  </ul>
   fn = HP Officejet 6000 Wireless Printer
</div></nowiki></pre>
   identifier
      type = SKU
      value = C9295A#B1H
   price = $119.99
   review hreview-aggregate
      item fn = HP Officejet 6000 Wireless Printer
      rating
        average (normalized to 5.0 scale) = 3.5
        average = 3.4
   count = 69
</pre>
 
The "availability" extension was added by Google to further improve details about the availability of a product when it's listed. Google also provides the [http://www.google.com/support/webmasters/bin/answer.py?hl=en&answer=146750#offer_properties "availability" values reference]:
<pre>
- out_of_stock
- in_stock
- instore_only
- preorder
</pre>
 
The "availability" value can be typed in without the linking underscores, to reduce the visual impact e.g.:
<pre>
    <span class="availability">In stock</span>
</pre>




* more complicated examples can be found at [[hproduct-examples|hProduct examples]]
* Karniyarik.com [http://www.karniyarik.com/karniyarik-web] is a vertical search engine for online goods and has experimental hProduct support.
* ...


== Copyright ==
== Copyright ==
Line 222: Line 216:
* [[hproduct-faq]]
* [[hproduct-faq]]
* [[hproduct-examples]]
* [[hproduct-examples]]
* [[hproduct-recipes]]


* [[product]]
* [[product]]

Latest revision as of 16:27, 18 July 2020

See latest version: h-product

This document represents a draft microformat specification. Although drafts are somewhat mature in the development process, the stability of this document cannot be guaranteed, and implementers should be prepared to keep abreast of future developments and changes. Watch this wiki page, or follow discussions on the #microformats IRC channel to stay up-to-date.

hProduct is a microformat suitable for publishing and embedding product data. hProduct is one of several open microformats standards suitable for embedding in HTML, XHTML, Atom, RSS, and arbitrary XML.

hProduct Microformat Draft Specification

Editors/Authors

(alphabetical)

Contributors

(alphabetical)

Microformats copyright and patents statements apply.

Status

Draft, version 0.3.

Introduction

The web is a thriving consumer marketplace with a plethora of manufacturers and vendors scattered across the globe. Sifting through massive amounts of unstructured product data is a difficult task for both browsers and machines alike. The hProduct microformat gives structure to this metadata by providing constructs to identify universal product attributes, plus a mechanism to accomodate the wide variation in product attributes.

The hProduct microformat can assist consumers, manufacturers and retailers in a number of ways. If a browser or application understands that a specific web page contains the hProduct microformat, it can inform and help facilitate the best product choice by the consumer to fulfill their needs. An adopted, open standard will ensure the correct product data is published between manufacturers and retailers, to the benefit of the consumer. Bringing order and structure to product data makes it easy for people and organizations to list the products and services they offer, and easy for web services to consume that product data for analysis and syndication.

Semantic XHTML Design Principles

XHTML is built on XML, and thus XHTML-based formats can be used not only for convenient display presentation, but also for general-purpose data exchange. In many ways, XHTML-based formats exemplify the best of both HTML and XML worlds. However, when building XHTML-based formats, it helps to have a guiding set of principles.

  1. Reuse the schema (names, objects, properties, values, types, hierarchies, constraints) as much as possible from pre-existing, established, well-supported standards by reference. Avoid restating constraints expressed in the source standard. Informative mentions are ok.
    1. For types with multiple components, use nested elements with class names equivalent to the names of the components.
    2. Plural components are made singular, and thus multiple nested elements are used to represent multiple text values that are comma-delimited.
  2. Use the most accurately precise semantic XHTML building block for each object etc.
  3. Otherwise use a generic structural element (e.g. <span> or <div>), or the appropriate contextual element (e.g. an <li> inside a <ul> or <ol>).
  4. Use class names based on names from the original schema, unless the semantic XHTML building block precisely represents that part of the original schema. If names in the source schema are case-insensitive, then use an all lowercase equivalent. Components names implicit in prose (rather than explicit in the defined schema) should also use lowercase equivalents for ease of use. Spaces in component names become dash '-' characters.
  5. Finally, if the format of the data according to the original schema is too long and/or not human-friendly, use <abbr> instead of a generic structural element, and place the literal data into the 'title' attribute (where abbr expansions go), and the more brief and human-readable equivalent into the element itself. Further informative explanation of this use of <abbr>: Human vs. ISO8601 dates problem solved

Inspiration and Acknowledgment

Many thanks go out to the contributors who laid the foundation for the current hProduct draft spec.

Scope

Giving details about a particular product is sometimes very complex as parameters are different for books and CDs than they are for iPods or cars. It should be very easy to mark up an item using hProduct and the syntax should be simple yet flexible enough for more advanced applications.

Out of Scope

This microformat does not intend to replicate any of the content proposed within hListing and would defer all money/transactional matters to that microformat. This microformat also does not attempt to specify a product ontology, or category-specific attributes; instead, it aims to create a framework to allow for flexible expression of both.

Format

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.

In General

The hProduct format is based on a set of fields common to numerous ecommerce sites and formats in use today on the web.

Schema

The hProduct schema consists of the following (see existing class names for reference):

  • hproduct
    • brand. optional. text. can also use hCard for manufacturer.
    • category. optional. text. can also use rel-tag. re-used from hCard.
    • price. optional. floating point number. can use currency format.
    • description. optional. text. can also include valid HTML markup. re-used from hReview.
    • fn. required. text. product name or title. re-used from hCard.
    • photo. optional. image element or link. re-used from hCard.
    • url. optional. href. can contain rel-tag rel='product'. re-used from hCard.
    • review. optional. hReview, or hReview-aggregate.
    • listing. optional. hListing, or hListing-aggregate.
    • identifier. optional.
      • type. required. - examples:
        • model
        • mpn
        • upc
        • isbn
        • issn
        • ean
        • jan
        • sn
        • vin
        • sku
      • value. required. - label may be implied

Field details

Class names category, fn, photo, url are reused from hCard. description is reused from hReview.

The fields of the hProduct schema represent the following:

  • hproduct:: Root class name
  • brand:: the class name brand is used identify brand of the product. SHOULD use hCard for manufacturer name. MUST be singular.
  • category:: the class name category identifies product category. MAY use rel-tag microformat. MAY be plural to represent multiple categories.
  • price:: the class name price is used to indicate the price of the product. MUST be singular.
  • description:: the class name description is used to describe the product. MUST be singular.
  • fn:: product text name. MUST be singular.
  • photo:: the class name photo MAY be applied to an <img> or <a> element. MAY be plural.
  • url:: the class name url SHOULD refer to the web page associated with product details. MAY use rel-tag, rel='product'. MUST be singular.
  • review:: the class name review identifies review(s) for the product. SHOULD use hReview. MAY be plural.
  • listing:: the class name listing identifies product listings. SHOULD use hListing. MAY be plural.
  • identifier:: the identifier structure is used to describe product identifiers like Model, UPC or SKU, and is designed to accommodate new or as-yet-unidentified identifiers. SHOULD be singular.
    • type:: the class name type identifies the identifier type.
    • value:: label MAY be implied

Additional Details

Note: If hProduct markup is used in a "standalone" fashion (eg. a manufacturer site that's not commerce enabled, strictly informational), it is assumed that the price attribute represents the manufacturer's suggested retail price. Any transactional (commerce) representation of price should be delegated to hListing.

Internationalization: Though there are many English-language tokens, they are only used as invisible class-names; user-visible listing information can be completely localized. Note that (X)HTML LANG attribute rules still apply as usual, for multilingual aggregators of hProduct.

Relationships with other microformats

Products can be complex structures with attributes and features that may fall outside the bounds of the proposed hProduct microformat. Care has been taken to provide just enough attributes to accurately represent products while not overloading the hProduct spec. This means that complete semantic solutions would rely on using hProduct in combination with other microformats to achieve their goals. Through examples (see also: recipes) and analysis, there are some clear relationships between hProduct and these microformats:

  • hListing :: provides additional context to the transaction side of a product, including elements like the transactional price.
  • hReview/hAggregate(concept) :: research shows that many commerce sites include product reviews, and they are often aggregated to provide overall ratings and reviews on the web. Utilizing these microformats can provide additional data around a product or service.
  • xoxo :: to address property-value data that may be necessary for a complete data representation of a product.

Of course, these are just a few of many that could be used with the hProduct microformat.

XMDP Profile

<dl class="profile">
	<dt>class</dt>
	<dd><p>
  <a rel="help" href="http://www.w3.org/TR/html401/struct/global.html#adef-class">
   HTML4 definition of the 'class' attribute.</a>
  This meta data profile defines some 'class' attribute values (class names) 
  and their meanings as suggested by a 
  <a href="http://www.w3.org/TR/WD-htmllink-970328#profile">
   draft of "Hypertext Links in HTML"</a>.</p>
	<dl>
		<dt>hproduct</dt>
		<dd>Used to identify and describe metadata universally common to products.</dd>
		<dt>brand</dt>
		<dd>The brand name of the product.</dd>
		<dt>category</dt>
		<dd>The product category/ categories the product belongs to.</dd>
		<dt>price</dt>
		<dd>The price of the product.</dd>
		<dt>description</dt>
		<dd>The full text representing the written description of the product.</dd>
		<dt>fn</dt>
		<dd>The common name of the product.</dd>
		<dt>photo</dt>
		<dd>Accompanying image of the product.</dd>
		<dt>url</dt>
		<dd>A link to the product details.</dd>
		<dt>review</dt>
		<dd>A review of the product.</dd>
		<dt>listing</dt>
		<dd>Listing details of the product.</dd>
		<dt>identifier</dt>
		<dd>The product identifier like Model, SKU, ISBN, or EAN associated with the product</dd>
	</dl>
	</dd>
</dl>

Notes

This section is informative.

  • ...

Examples

  • need actual simple demonstration hProduct examples here! (not examples of what actual sites are doing - that's the next section)

Editors: please see http://microformats.org/wiki/hrecipe#Examples for example of an example in spec.

...

Examples in the wild

This section is informative.

Sites and pages that publish hProducts.

See hProduct Examples in the wild.

Implementations

This section is informative.

Tools for generating and consuming hProducts. When it gets too big we can move it to a separate page like hproduct-implementations.

  • Google parses some hProduct properties and adds extensions:

An example is a HP printer product page parsed with the help of Google Rich Snippets Tool: HP Printer Product from which Google extracted the following hProduct elements:

hproduct
   availability = In stock
   fn = HP Officejet 6000 Wireless Printer
   identifier
      type = SKU
      value = C9295A#B1H
   price = $119.99
   review hreview-aggregate
      item fn = HP Officejet 6000 Wireless Printer
      rating
         average (normalized to 5.0 scale) = 3.5
         average = 3.4
   count = 69

The "availability" extension was added by Google to further improve details about the availability of a product when it's listed. Google also provides the "availability" values reference:

- out_of_stock 
- in_stock 
- instore_only 
- preorder 

The "availability" value can be typed in without the linking underscores, to reduce the visual impact e.g.:

    <span class="availability">In stock</span>


  • Karniyarik.com [1] is a vertical search engine for online goods and has experimental hProduct support.
  • ...

Copyright

  • JayMyers: I release all of my contributions to the public domain.

Public Domain Contribution Requirement. Since the author(s) released this work into the public domain, in order to maintain this work's public domain status, all contributors to this page agree to release their contributions to this page to the public domain as well. Contributors may indicate their agreement by adding the public domain release template to their user page per the Voluntary Public Domain Declarations instructions. Unreleased contributions may be reverted/removed.

Patents

This specification is subject to a royalty free patent policy, e.g. per the W3C Patent Policy, and IETF RFC3667 & RFC3668.

Related