Difference between revisions of "h-review-aggregate"

From Microformats Wiki
Jump to navigation Jump to search
(→‎Change control: rm section)
(→‎Properties: proposed properties from hReview-aggregate awaiting citations of publishing and consuming examples)
Line 25: Line 25:
  
 
== Properties ==
 
== Properties ==
 +
=== Proposed Properties ===
 +
Proposed properties from [[hReview-aggregate]] awaiting citations of publishing and consuming examples.
 +
 +
* '''<code>p-item</code>''' - Required: the thing been reviewed, including embedded microformat for e.g. business or person ([[h-card]]), event ([[h-event]]), place ([[h-adr]] or [[h-geo]]), product ([[h-product]]), website, url, or other item ([[h-item]]).
 +
* '''<code>p-rating</code>''' - Required: the fixed point integer [1.0-5.0] of the average rating (5.0 best)
 +
* '''<code>p-best</code>'''  - Optionally define best rating value. can be numerically lower than worst.
 +
* '''<code>p-worst</code>'''  - Optionally define worst rating value. can be numerically higher than best.
 +
* '''<code>p-count</code>'''  - the total number of reviews
 +
* '''<code>p-votes</code>'''  - the total number of users who have rated the product or service, contributing to the average rating. For some sites, the number of votes is equal to the number of reviews, so <code>count</code> may be used and this property omitted.
 +
* '''<code>p-name</code>''' - This optional property can be the title for the review collection or a very short summary of the consensus opinion from the collection.
  
 
== Property Details ==
 
== Property Details ==

Revision as of 23:54, 20 August 2018

This article is a stub. You can help the microformats.org wiki by expanding it.

This page is a placeholder for the h-review-aggregate specification, an upgrade of hReview-aggregate 0.2 to microformats2. Please refer to the #Todo section.


<entry-title>h-review-aggregate</entry-title> h-review-aggregate is a simple, open format for embedding review information (of products, services, businesses, etc). Whereas h-review is intended for an individual review, h-review-aggregate is meant for summary information about a collection of user or critic reviews about an item.

h-review-aggregate is one of several open microformat draft standards suitable for embedding data in HTML and is the microformats2 update to hReview-aggregate 0.2.

Status
This is a Draft Specification.
Participate
#microformats on freenode: #microformats on Freenode
License
Per CC0, to the extent possible under law, the editors have waived all copyright and related or neighboring rights to this work. In addition, as of 2020-08-04, the editors have made this specification available under the Open Web Foundation Agreement Version 1.0.

Example

Here is a simple example showing aggregate review information for a restaurant:

Properties

Proposed Properties

Proposed properties from hReview-aggregate 0.2 awaiting citations of publishing and consuming examples.

  • p-item - Required: the thing been reviewed, including embedded microformat for e.g. business or person (h-card), event (h-event), place (h-adr or h-geo), product (h-product), website, url, or other item (h-item).
  • p-rating - Required: the fixed point integer [1.0-5.0] of the average rating (5.0 best)
  • p-best - Optionally define best rating value. can be numerically lower than worst.
  • p-worst - Optionally define worst rating value. can be numerically higher than best.
  • p-count - the total number of reviews
  • p-votes - the total number of users who have rated the product or service, contributing to the average rating. For some sites, the number of votes is equal to the number of reviews, so count may be used and this property omitted.
  • p-name - This optional property can be the title for the review collection or a very short summary of the consensus opinion from the collection.

Property Details

Examples in the wild

Validating

Main article: microformats validators

Test and validate microformats2 markup in general with:

Implementations

Backward Compatibility

Todo

Tasks for this page.

In summary:

  • copy h-review
  • use root class name "h-review-aggregate" instead of "h-review"
  • add "p-count", "p-votes" properties as defined in hReview-aggregate 0.2
  • prune set of properties to those listed in hReview-aggregate 0.2
  • change backcompat parsing for root class name to "hreview-aggregate"
  • change backcompat parsing property class names to those listed in hReview-aggregate 0.2

See Also