SearchMonkey > Start Overview > Discussion

Discussion - Show the number of comments and thread date for discussions

Example

Description

Display blog or forum information directly in Yahoo! Search. Add code to indicate to Yahoo! that a discussion exists on your page, and when we next crawl your site, we'll take care of the rest. From your markup, we’ll be able to extract structured data from your site and render it automatically in an enhanced result in search results.

Details

  • Types of content permitted: blog posts, forums, question and answer sessions, and other forms of discussion.
  • How soon after I add my markup will I see my enhanced result appear? Assuming your markup is correct, your enhanced result will appear after Yahoo! recrawls your page; this can take between a few days and a few weeks depending on your site.

Get Started

1. Add code / markup to your site

Copy this code and replace the example text with your data to see enhanced discussion information in Yahoo! Search.

  • Use RDFa markup to embed discussion metadata directly in your markup. You can provide a post date, the post content, the author, and more.
  • Use hatom markup for an alternative way to embed discussion metadata.
  • Use DataRSS XML to send your data to Yahoo! privately, using a feed. Once you have constructed your DataRSS feed, you must submit the feed to Yahoo!.

RDFa

Required

Click any item to toggle description on or off

xmlns:sioc(url)
The SIOC namespace, used for marking up blog and forum elements. Format: A valid URL to the SIOC namespace. The only acceptable value is "http://rdfs.org/sioc/ns#".
sioc:Post-
A post. Alternatively, use sioc:Thread to represent a forum thread, with multiple sioc:Post elements.

Recommended

xmlns:dc(url)
The Dublin Core namespace, used for marking up blog and forum elements. Format: A valid URL to the SIOC namespace. The only acceptable value is "http://rdfs.org/sioc/ns#".
sioc:container_of-
Use multiple sioc:container_of with a child sioc:Post or sioc:Thread to represent multiple posts to the same blog, multiple threads in a forum,or multiple questions in a Q&A site.
dc:created dc:date(string)
When nested inside a sioc:Post: the date the post was created. Format: A string of up to 60 characters. The date should be in RFC 3339 format: YYYY-MM-DDTHH:MM:SS+ZZ:ZZ, where only YYYY-MM-DD are required. If the date text does not conform to RFC 3339, you should supply an explicit RFC 3339 value using the content attribute. Otherwise, the system attempts to parse the date string directly. This will succeed on simple, obvious date strings such as "10 October 2009", but fail on more complicated strings or ambiguous dates such as "08/07/09".

Example 1

<div typeof="sioc:Forum"
  xmlns:sioc="http://rdfs.org/sioc/ns#"
  xmlns:dc="http://purl.org/dc/terms/"
>
    <div rel="sioc:container_of">
      <div typeof="sioc:Post">
      <h1 property="dc:title>">A Short Blog Post</h1>
        <div rel="sioc:has_container" />
          <p>This... is... your blog post song! It isn't very long!</p>
          <p>Published <span property="dc:created dc:date">2008-07-19</span></p>
      </div>
    </div>
</div>

This metadata will be available in SearchMonkey and Yahoo! Search BOSS for further use. For more information, refer to the RDFa specification or the RDFa wiki.

Optional

Click any item to toggle description on or off

xmlns:foaf(url)
The Friend-of-a-Friend namespace, used to specify relationships between users. Format: A valid URL. The only acceptable value is "http://xmlns.com/foaf/0.1/".
xmlns:media(url)
The SearchMonkey Media namespace, used to specify product images. Format: A valid URL. The only acceptable value is "http://search.yahoo.com/searchmonkey/media/".
xmlns:rdfs(url)
The RDFS namespace, used for labels and comments. Format: A valid URL. The only acceptable value is "http://www.w3.org/2000/01/rdf-schema#".
xmlns:vcard(url)
The VCard namespace, used for the address, telephone, photo, and URL. Format: A valid URL. The only acceptable value is "http://www.w3.org/2006/vcard/ns#".
xmlns:xsd(url)
The XML Schema namespace. This namespace is only required if you are providing explicit data types for values, such as xsd:float or xsd:integer. Format: A valid URL to the XML Schema namespace. The only acceptable value is "http://www.w3.org/2001/XMLSchema#".
dc:title(string)
When nested inside a sioc:Forum but outside a sioc:Post: the title of the blog or forum. When nested inside a sioc:Post: the title of the post. A sioc:Forum may contain multiple sioc:Post elements (representing multiple posts in a blog, multiple posts in a thread, or multiple answers in a Q&A site). Format: A string of up to 60 characters.
rdfs:seeAlso media:image(gif, jpg, png)
An image that represents the blog or forum. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image must be hosted on the same domain as the search result. The image should be 85 x 65 pixels large.
sioc:has_container(url)
A link to the post's parent sioc:Forum or sioc:Thread. Format: A URL.
sioc:topic(string)
A free-form description of the post's topic. Alternatively, you can use the resource attribute to set the value of sioc:topic to a resource from a taxonomy such as DMOZ, Yahoo! Directory, DBpedia, or Freebase. Format: A string of up to 200 characters.
sioc:content(string)
The content of the post. Format: A string.
sioc:has_creator dc:creator foaf:maker(string)
The creator of the post.
vcard:fn foaf:name-
The creator of the post's full name. Format: A string of up to 60 characters.
vcard:photo foaf:depiction media:image(gif, jpg, png)
An image that represents the creator of the post, either a photograph or a graphical avatar image. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image should be 85 x 65 pixels large.
vcard:url foaf:homepage(url)
The URL to the post creator's homepage. Format: A URL.
sioc:has_reply-
A comment to a post. The reply should be a sioc:Post itself, nested inside the sioc:has_reply. You can use this mechanism to represent comments to blog posts, threaded comments, and replies in a Q&A site. The resource attribute may contain a permalink to the reply. Format: A URL to a GIF, PNG, or JPG image. The image should be 85 x 65 pixels large.
sioc:num_replies-
Indicates the number of replies to a post. Format: An integer

Example 2

    <div about="http://developer.yahoo.net/blog/" typeof="sioc:Forum"
  xmlns:sioc="http://rdfs.org/sioc/ns#"
  xmlns:dc="http://purl.org/dc/terms/"
  xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
  xmlns:vcard="http://www.w3.org/2006/vcard/ns#"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema#"
  xmlns:media="http://search.yahoo.com/searchmonkey/media/"
  xmlns:foaf="http://xmlns.com/foaf/0.1/">
    <h1 property="dc:title">Yahoo! Developer Network blog</h1>
    <div rel="rdfs:seeAlso media:image"
        resource="http://us.i1.yimg.com/us.yimg.com/i/us/nt/ma/ma_devnet_1.gif"/>

    <div rel="sioc:container_of">
      <div typeof="sioc:Post">
        <span property="dc:title">New SearchMonkey Enhanced Result Template</span>
        <span property="dc:created dc:date" datatype="xsd:date">2008-07-19</span>
        <div rel="sioc:has_container" resource="http://developer.yahoo.net/blog/"/>

        <div rel="sioc:topic">
            <span property="rdfs:label">Entertainment &amp; Music > Music > Rap and Hip-Hop </span>
        </div>
        <div rel="sioc:topic" resource="http://dbpedia.org/resource/Semantic_Web"/>

        <span property="sioc:content">
          We are testing a new template design for Enhanced Result applications. This new template contains two key design improvements....
        </span>

        <div rel="sioc:has_creator dc:creator foaf:maker">
          <div typeof="sioc:User foaf:Person vcard:VCard">
            <span property="vcard:fn foaf:name">Jane Smith </span> Yahoo! SearchMonkey Team
            <div rel="vcard:photo foaf:depiction media:image"
                resource="http://www.example.org/image/janesmith.jpg"/>
          </div>
        </div>

        <div rel="sioc:has_reply" resource="http://www.example.org/reply/"/>
        <div rel="sioc:has_reply">
          <div typeof="sioc:Post">
              <span property="sioc:content"> Excellent new feature! </span>
          </div>
        </div>
        <span property="sioc:num_replies">2</span>
      </div>
    </div>
</div>

Microformats

Required

Click any item to toggle description on or off

hentry(string)
Indicates that the markup below is a post.
entry-title(string)
The title of the post. Format: A string of up to 60 characters.
vcard author fn(string)
The author's full name. You may provide any hCard information you like for the author. Format: A string of up to 60 characters.
updated(string)
The date and time when the post was last updated. The last updated date takes precedence over the publication date. Format: A string of up to 60 characters. The date should be in RFC 3339 format: YYYY-MM-DDTHH:MM:SS+ZZ:ZZ, where only YYYY-MM-DD are required. If the date text does not conform to RFC 3339, you should supply an explicit RFC 3339 value using the content attribute. Otherwise, the system attempts to parse the date string directly. This will succeed on simple, obvious date strings such as "10 October 2009", but fail on more complicated strings or ambiguous dates such as "08/07/09".

Example 1

<div class="hfeed">
 <div class="hentry">
   <h1 class="entry-title">New SearchMonkey Enhanced Result Template</h1>
   <div class="entry-content">
       We are testing a new template design for Enhanced Result applications. This new template contains two key design improvements....
   </div>
   Tags: <a href="http://dbpedia.org/resource/Semantic_Web" rel="tag">semantic web</a>
   Author:  <span class="vcard author fn">Jane Smith</span> Yahoo! SearchMonkey Team
   Last updated <abbr class="updated" title="2008-07-19T04:26:18Z">4:26am, July 19, 2008</abbr>
 </div>
</div>

This markup not only displays the post date, but includes tags, the author name, and more.

Recommended

Click any item to toggle description on or off

hfeed(string)
Indicates that the markup below is represented by a feed, containing one or more hentry elements.
entry-content(string)
The content of the post. Format: A string.
published(string)
The date and time when the post was published. The last updated date takes precedence over the publication date Format: A string of up to 60 characters. The date should be in RFC 3339 format: YYYY-MM-DDTHH:MM:SS+ZZ:ZZ, where only YYYY-MM-DD are required. If the date text does not conform to RFC 3339, you should supply an explicit RFC 3339 value using the content attribute. Otherwise, the system attempts to parse the date string directly. This will succeed on simple, obvious date strings such as "10 October 2009", but fail on more complicated strings or ambiguous dates such as "08/07/09".
tag(string)
A tag for the post. You may supply multiple tags. Format: A string of up to 60 characters.

DataRSS XML

Required

Click any item to toggle description on or off

sioc:Post-
A post. Alternatively, use sioc:Thread to represent a forum thread, with multiple sioc:Post elements.

Recommended

sioc:container_of-
Use multiple sioc:container_of with a child sioc:Post or sioc:Thread to represent multiple posts to the same blog, multiple threads in a forum,or multiple questions in a Q&A site.
dc:created dc:date(string)
When nested inside a sioc:Post: the date the post was created. Format: A string of up to 60 characters. The date should be in RFC 3339 format: YYYY-MM-DDTHH:MM:SS+ZZ:ZZ, where only YYYY-MM-DD are required. If the date text does not conform to RFC 3339, you should supply an explicit RFC 3339 value using the content attribute. Otherwise, the system attempts to parse the date string directly. This will succeed on simple, obvious date strings such as "10 October 2009", but fail on more complicated strings or ambiguous dates such as "08/07/09".

Example 1

<y:adjunct xmlns:y="http://search.yahoo.com/datarss/" version="1.0" name="YOURID">
  <y:item rel="dc:subject">
    <y:type typeof="sioc:Forum">
      <y:meta property="dc:title">Yahoo! Developer Network blog</y:meta>
      <y:item rel="rdfs:seeAlso media:image"
          resource="http://us.i1.yimg.com/us.yimg.com/i/us/nt/ma/ma_devnet_1.gif"/>

      <y:item rel="sioc:container_of">
        <y:type typeof="sioc:Post">
          <y:meta property="dc:title">New SearchMonkey Enhanced Result Template</y:meta>
          <y:meta property="dc:created dc:date" datatype="xsd:date">2008-07-19</y:meta>
          <y:item rel="sioc:has_container" resource="http://developer.yahoo.net/blog/"/>

          <y:item rel="sioc:topic">
              <y:meta property="rdfs:label">Entertainment & Music > Music > Rap and Hip-Hop </y:meta>
          </y:item>
          <y:item rel="sioc:topic" resource="http://dbpedia.org/resource/Semantic_Web"/>

          <y:meta property="sioc:content">
            We are testing a new template design for Enhanced Result applications. This new template contains two key design improvements....
          </y:meta>

          <y:item rel="sioc:has_creator dc:creator foaf:maker">
            <y:type typeof="sioc:User foaf:Person vcard:VCard">
              <y:meta property="vcard:fn foaf:name">Jane Smith </y:meta>
              <y:item rel="vcard:photo foaf:depiction media:image"
                  resource="http://www.example.org/image/janesmith.jpg"/>
            </y:type>
          </y:item>

          <y:item rel="sioc:has_reply" resource="http://www.example.org/reply/"/>
          <y:item rel="sioc:has_reply">
            <y:type typeof="sioc:Post">
                <y:meta property="sioc:content"> Excellent new feature! </y:meta>
            </y:type>
          </y:item>
          <y:meta property="sioc:num_replies">2</y:meta>
        </y:type>
      </y:item>
    </y:type>
  </y:item>
</y:adjunct>

This markup would be included in a DataRSS feed.

Optional

Click any item to toggle description on or off

dc:title(string)
When nested inside a sioc:Forum but outside a sioc:Post: the title of the blog or forum. When nested inside a sioc:Post: the title of the post. A sioc:Forum may contain multiple sioc:Post elements (representing multiple posts in a blog, multiple posts in a thread, or multiple answers in a Q&A site). Format: A string of up to 60 characters.
rdfs:seeAlso media:image(gif, jpg, png)
An image that represents the blog or forum. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image must be hosted on the same domain as the search result. The image should be 85 x 65 pixels large.
sioc:has_container(url)
A link to the post's parent sioc:Forum or sioc:Thread. Format: A URL.
sioc:topic(string)
A free-form description of the post's topic. Alternatively, you can use the resource attribute to set the value of sioc:topic to a resource from a taxonomy such as DMOZ, Yahoo! Directory, DBpedia, or Freebase. Format: A string of up to 200 characters.
sioc:content(string)
The content of the post. Format: A string.
sioc:has_creator dc:creator foaf:maker(string)
The creator of the post.
vcard:fn foaf:name-
The creator of the post's full name. Format: A string of up to 60 characters.
vcard:photo foaf:depiction media:image(gif, jpg, png)
An image that represents the creator of the post, either a photograph or a graphical avatar image. CAUTION: irrelevant or commercial-looking images have a strong negative impact on click-through rates. Format: A URL to a GIF, PNG, or JPG image. The image should be 85 x 65 pixels large.
vcard:url foaf:homepage(url)
The URL to the post creator's homepage. Format: A URL.
sioc:has_reply-
A comment to a post. The reply should be a sioc:Post itself, nested inside the sioc:has_reply. You can use this mechanism to represent comments to blog posts, threaded comments, and replies in a Q&A site. The resource attribute may contain a permalink to the reply. Format: A URL to a GIF, PNG, or JPG image. The image should be 85 x 65 pixels large.
sioc:num_replies-
Indicates the number of replies to a post. Format: An integer

2. Validate your markup

Test your markup to make sure your enhanced result will appear.

3. Wait until we recrawl your site for your enhanced result to appear on the search results page

This can take up to a few weeks depending on your site.

Copyright © 2009 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy | Terms of Service

Help us continue to improve the Yahoo! Developer Network: Send Your Suggestions