Getting Started Guide

To get started with implementing barnebys markup, specify the details for your object by adding the following HTML markup to the HEAD section of the page:

<meta name="barnebys:title" content="title of your object" />
<meta name="barnebys:url" content="url for the object" />

Barnebys properties are simple key-value pairs, each defined in an HTML meta tag as seen above. The combined collection of properties defines the overall object experience on Barnebys, and each object type supports and requires a specific set of properties.

Reference and Types

Before starting make sure you read the reference for Barnebys Markup Tags and Data Types. This sections provides you with available tags and data types that should be used for each tag.

Object classification

Depending on what markup tags used Barnebys will identify an object as an auction or fixed price item. If barnebys:auction:end is present the object will be classified as an auction item.

Auction item example

<meta name="barnebys:title" content="title of your auction object" />
<meta name="barnebys:description" content="some description" />
<meta name="barnebys:url" content="https://yoursite.com/object/12345" />
<meta name="barnebys:image" content="https://yoursite.com/media/12345.jpg" />
<meta name="barnebys:category" content="some category" />
<meta name="barnebys:price:estimate" content="50.00" />
<meta name="barnebys:price:bid" content="55.00" />
<meta name="barnebys:price:currency" content="EUR" />
<meta name="barnebys:auction:start" content="2017-05-02T07:11:00+00:00" />
<meta name="barnebys:auction:end" content="2017-06-02T07:17:00+00:00" />

Fixed price item example

<meta name="barnebys:title" content="title of your fixed price object" />
<meta name="barnebys:description" content="some description" />
<meta name="barnebys:url" content="https://yoursite.com/object/12345" />
<meta name="barnebys:image" content="https://yoursite.com/media/12345.jpg" />
<meta name="barnebys:category" content="some category" />
<meta name="barnebys:price:amount" content="50.00" />
<meta name="barnebys:price:currency" content="EUR" />

Fixed price item example for object being sold

<meta name="barnebys:title" content="title of your fixed price object" />
<meta name="barnebys:description" content="some description" />
<meta name="barnebys:url" content="https://yoursite.com/object/12345" />
<meta name="barnebys:image" content="https://yoursite.com/media/12345.jpg" />
<meta name="barnebys:category" content="some category" />
<meta name="barnebys:price:amount" content="50.00" />
<meta name="barnebys:price:currency" content="EUR" />
<meta name="barnebys:availabiltiy" content="sold" />

Implementation

To simplify the integration Barnebys has an open source library that will validate data types silently and speed up the development process if needed. Currently we only offer a library for PHP but will extend with more libraries.

Testing your implementation

When you integration is completed it's time to test and validate some of your lot pages. This can be done using Barnebys Debugger, enter the URL for the object and we will let you know if it's OK or if you need do adjust something.