TipTheWebbeta

Multi-Author Websites

If you operate a website on which other people publish, such as a multi-author blog or a service that hosts creative work by different artists, then you may want incoming Tips for your site to go directly to the authors of that content.

Note: While it is completely fine for the operator of a site to use an informal process of sharing any TipTheWeb Award funds with other people, we support a simple integration mechanism such that authors on a multi-author site can claim the pages of that site where their work is published, and Tips get routed automatically to their TipTheWeb accounts.

How TipTheWeb's Multi-Author Support Works

When someone tips a page on a multi-author website, TipTheWeb reads that page and looks for a special <link> element in the <head> of the page, and, if found, uses that <link>’s href value to attribute the Tip to the author’s TipTheWeb account.

Integrating your website with TipTheWeb’s multi-author support can be as simple as adding in that extra <link> element to your pages.

Basic Example

Consider a page served from http://example.com/a-page-by-dave.html:

<head>
    <title>A Page By Dave On Example.com</title>
    <link rel="author" href="http://twitter.com/davefogel" title="Dave" />
</head>

In the above example, this page is declaring itself to be authored by a user identified by the URL to a twitter profile page. A Tip to that page would be grouped together with other Tips to pages on example.com that also specify the same author URL, and would show up in that author’s account, rather than the account that has claimed the whole example.com website.

Use URLs That Can Be Claimed By Authors

The URLs specified in Author <link> elements are used in two ways:

  1. As a unique identifier for that author on the containing website
  2. As part of TipTheWeb’s verification process that publishers use to claim where they publish

The URLs that you use in the href attribute of the author <link> elements should refer to some other site or content that is claimable through TipTheWeb. This means they should refer to websites that the author controls, or accounts on any of the various publishing platforms that TipTheWeb supports, such as Twitter, YouTube, Vimeo, GitHub, etc.

More Examples

Here are some more example author <link> elements that would work with TipTheWeb’s multi-author site feature:

<link rel="author" href="https://github.com/ericf/" title="Eric" />

<!-- OR -->

<link rel="author" href="http://ericf.name/" title="Eric" />

<!-- OR -->

<link rel="author" href="http://www.flickr.com/photos/eric_ferraiuolo/" title="Eric" />

Specify a Short, Human-Readable Name (Optional)

You can use the title attribute of the author <link> element to choose a short display name for the identified author. TipTheWeb will use this name, if available, instead of the author URL when showing Tips to multi-author website content.

<link rel="author" href="http://www.long-personal-url.com/" title="Bob" />

Alternative Link Relation Types

TipTheWeb supports several other types of <link> elements as alternatives to rel="author" links. If you’re already using author links in your site in a way that won’t also work as TipTheWeb multi-author URLs, then you can use an alternative or additional <link> element that will take priority over any existing author links. The two alternatives are rel="publisher" links and rel="ttw.publisher" links.

Publisher Links

Here’s an example where the site is already using author links for the author’s email address (which isn’t a claimable site at TipTheWeb), so the site uses a rel="publisher" link instead:

<link rel="author" href="mailto:bob@example.com" />

<link rel="publisher" href="http://twitter.com/bob_smith" title="Bob" />

TipTheWeb-Specific Publisher Links

In the following example, the site is already using publisher links for a link to the website’s parent company (which isn’t specific to the author). Since publisher links take priority over author links, the site uses rel="ttw.publisher" for author URLs instead:

<link rel="publisher" href="http://owner-of.example.com/" />

<link rel="ttw.publisher" href="http://www.bobsmith.name/" title="Bob" />

Disabling Multi-Author Support

If your website already uses author or publisher link elements but you don’t want TipTheWeb to enable multi-author support for your site, you can add a <link rel="ttw.publisher" href="/" /> element to make sure all tips to content on your site are associated only with your website’s domain:

<link rel="author" href="http://www.bobsmith.name/" />

<link rel="ttw.publisher" href="/" />

Instructions For Authors on Multi-Author Websites

Once a website’s pages have the appropriate author <link> elements, authors should sign up for TipTheWeb, and should claim two sites, in the following order:

  1. The site which is being used to identify the author in the author link URLs
  2. Their pages on the multi-author site itself

Example From the Author’s Perspective

Marcel is one of several chefs postings recipes to the website http://chefs.cooking-show.com/. Marcel’s recipe pages are marked like this:

<link rel="author" href="http://chef-marcel.com/" title="Chef Marcel" />
Steps for Marcel to receive his Tips on chefs.cooking-show.com
  1. Marcel would sign up for an account on TipTheWeb
  2. First claim http://chef-marcel.com/
  3. Then claim his recipe pages on http://chefs.cooking-show.com/

Need More Help?

If you’re still scratching your head after you read through this page, or if you have other questions, check out our Integration FAQs and don’t hesitate to email us.