hubermedia documentation 2015 html
Default

Each object has to be a item element. There can be as many items in the feed as needed.

Copy Code
<rss [...]>
    <channel>
        [...]
        <item>
        [...]
        </item>
        [...]
        <item>
        [...]
        </item>
        [...]
    </channel>
</rss>
title
Copy Code
<item>
    [...]
    <title>Hofkäserei Lang</title>
    [...]
</item>

Title is an obligatory element.

link
Copy Code
<item>
    [...]
    <link>http://api.esuchwas.de/Details.ashx?Id=qowqOuYK</link>
    [...]
</item>

Hyperlink to detailpage of object.

description
Copy Code
<item>
    [...]
    <description><![CDATA[Dies ist eine <b>Demo</b>-Beschreibung]]></description>
    [...]
</item>

Item-description in HTML. The HTML-text has to be correctly encoded.

Either encode the html entities ("<strong>boldtext</strong>" --> "&lt;strong&gt;boldtext&lt;/strong&gt;")

or use CDATA (<![CDATA[<strong>boldtext</strong>]]>)

shortdescription
Copy Code
<item>
    [...]
    <shortdescription><![CDATA[Dies ist eine kurze <b>Demo</b>-Beschreibung]]></shortdescription>
    [...]
</item>

Item-shortdescription in HTML. The HTML-text has to be correctly encoded.

Either encode the html entities ("<strong>boldtext</strong>" --> "&lt;strong&gt;boldtext&lt;/strong&gt;")

or use CDATA (<![CDATA[<strong>boldtext</strong>]]>)

category
Copy Code
<item>
    [...]
    <category>Direktvermarkter</category>
    <category>Kategorie X</category>
    <category>Kategorie Y</category>
    [...]
</item>

Category-element is obligatory. It has to be a valid category hat is supported by the category-tree of the experience.

ec:link
Copy Code
<item>
    [...]
     <ec:link rel="default" url="coverimage.jpg" type="image/jpeg">cover image</ec:link>
     <ec:link rel="imagegallery" url="image1.jpg" type="image/jpeg">image 1</ec:link>
     <ec:link rel="imagegallery" url="image2.jpg" type="image/jpeg">image 2</ec:link>
     <ec:link
         rel="imagegallery"
         url="image3.jpg"
         type="image/jpeg"        
         author="email@author.de"
         source="Quelle des Bildes als Text"
         latitude="49.7591181049"
         longitude="12.0774078369141">Bild 3</ec:link> <!-- Link(Bild) mit weiteren Details -->

     <ec:link rel="download" type="application/xml" url="http://link/download_gpx.aspx?id=15">GPX</ec:link>
     <ec:link rel="audio" type="audio/mpeg" url="http://www.seite-mit-audio/audio.mp3" type="autio/mpeg">MP3</ec:link>
     <ec:link rel="print" type="application/pdf" url="http://www.seite-mit-ausdruck.de/print.aspx?id=15">Drucken</ec:link>
    [...]
</item>

You can use as many ec:link elements as you need to.

Obligatory parameters:

Parameter Type Description Sample

rel

 

String

 

Defines the type of ec:link. Possible values are:

  • default (cover picture)
  • summer (summer image)
  • winter (winter image)
  • imagegallery (images)
  • logo
  • print (printpage/pdf)                                        
  • download (e.g. tour-gpx)
  • video
  • audio
  • qrcode
  • booking
  • ticket                                                            
  • socialmedia
  • rating
  • externimagegallery
  • esuchwas
  • other

rel="default"

url String url to file/homepage url=http://link/download_gpx.aspx?id=15
type String mime-type of file type="audio/mpeg"

Optional parameters:

Parameter Type Description Sample
author String eMail adress of author author="support@hubermedia.de"
source String source source="eSuchWasV4"
latitude String Latitude: WGS84 coordinate latitude="49.4685"
longitude String Longitude: WGS84 coordinate longitude="12.07740"
geo:lat / geo:long
Copy Code
<item>
    [...]
    <geo:lat>49.7591181049</geo:lat>
    <geo:long>12.0774078369141</geo:long>
    [...]
</item>

Latitude / Longitude are obligatory elements. You can let us geocode the object based on its adress, but please provide this data if you can.

georss:elevation
Copy Code
<item>
    [...]
    <georss:elev>20</georss:elev>
    [...]
</item>

Elevation above sea level in meters.

Source
Copy Code
<item>
    [...]
    <source url="http://www.et4.de">eTourist V4</source>
    <ec:source_image>http://api.esuchwas.de/logo.png/</ec:source_image>
    <ec:source_id>15</ec:source_id>     [...]
</item>

source > Name and hyperlink of the source of the object.

ec:source_image > Image of the source.

ec:source_id > Unique id of the object.

author
Copy Code
<item>
    [...]
    <author>support@hubermedia.de</author>
    [...]
</item>

The eMail adress of the person who is responsible for this object.

Adress
Copy Code
<item>
    [...]
    <ec:street>Oed 2</ec:street>
    <ec:plz>92665</ec:plz>
    <ec:city>Kirchendemenreuth</ec:city>
    <ec:county>Neustadt an der Waldnaab</ec:county>
    <ec:country>DE</ec:country>
    [...]
</item>

In these fields the complete address of the object is stored.

If no Latitude/Longitude is provided, these data will be used to geocode the object.

ec:area
Copy Code
<item>
    [...]
    <ec:area>Oberbayern</ec:area>
    <ec:area>Gebiet2</ec:area>
    <ec:area>WeiteresGebiet</ec:area>
    [...]
</item>

An unlimited number of tourist areas that apply to the object.

ec:created
Copy Code
<item>
    [...]
    <ec:created>2009-07-20T10:00:00</ec:created>
    [...]
</item>

Creation-date of the object.

ec:changed
Copy Code
<item>
    [...]
    <ec:changed>2011-02-01T16:00:00</ec:changed>
    [...]
</item>

Date of the last change of the object.

ec:keywords
Copy Code
<item>
    [...]
    <ec:keywords>
        <ec:keyword>Test1</ec:keyword>
        <ec:keyword>Test2</ec:keyword>
    </ec:keywords>
    [...]
</item>

Use as many keywords/tags as possible. These are immanent important for searching.

ec:text
Copy Code
<item>
    [...]
    <ec:text>Dies ist die detailierte Beschreibung des Objektes</ec:text>
    <ec:text rel="openings">Die Öffnungszeiten sind von ... bis ...</ec:text>
    <ec:text rel="directions">Anfahrtsbeschreibung: ...</ec:text>
    [...]
</item>

Detailed texts for the object. It's a plain-text field, so no html tags may be used.

The type of the text is defined by the attribute "rel". Possible values:

ec:shorttext
Copy Code
<item>
    [...]
    <ec:shorttext>Dies ist eine kurze Beschreibung des Objektes</ec:shorttext>
    [...]
</item>

Short text for the object. It's a plain-text field, so no html tags may be used.

ec:highlight
Copy Code
<item>
    [...]
    <ec:highlight>true</ec:highlight>
    [...]
</item>

If the object shall be marked as highlight, its value has to be "true".

ec:tel
Copy Code
<item>
    [...]
    <ec:tel>0815/815</ec:tel>
    [...]
</item>

Phonenumber of the object.

ec:email
Copy Code
<item>
    [...]
    <ec:email>email.des.objektes@provider.xy</ec:email>
    [...]
</item>

Contact-email of the object.

ec:contact_*
Copy Code
<item>
    [...]
    <ec:contact_name>Fam. Huber</ec:contact_name> 
    <ec:contact_street>Oed 2</ec:contact_street> 
    <ec:contact_plz>92665</ec:contact_plz> 
    <ec:contact_city>Kirchendemenreuth</ec:contact_city> 
    <ec:contact_tel>0815/815</ec:contact_tel> 
    <ec:contact_email>email.des.objektes@provider.xy</ec:contact_email> 
    <ec:contact_link>http://www.ansprechpartner-website.de</ec:contact_link> 
    [...]
</item>

Contact-partner.

ec:author_*
Copy Code
<item>
    [...]
    <ec:autor_name>Stefan Huber</ec:autor_name> 
    <ec:autor_street>Gaberlplatz 5</ec:autor_street> 
    <ec:autor_plz>93462</ec:autor_plz> 
    <ec:autor_city>Lam</ec:autor_city> 
    <ec:autor_tel>0815/815</ec:autor_tel> 
    <ec:autor_email>stefan.huber@hubermedia.de</ec:autor_email> 
    <ec:autor_link>http://www.hubermedia.de</ec:autor_link>
    [...]
</item>

Author.

ec:organisation_*
Copy Code
<item>
    [...]
    <ec:organisation_name>Chiemgau Tourismus</ec:organisation_name>
    <ec:organisation_link>http://www.chiemgau-tourismus.de</ec:organisation_link>
    <ec:organisation_image>http://www.chiemgau-tourismus.de/logo.png</ec:organisation_image>
    <ec:organisation_email>info@chiemgau-tourismus.de</ec:organisation_email>
    [...]
</item>

Organisation/Region/Area information.

ec:timeintervalsNew
Copy Code
<item>
    [...]
    <ec:timeIntervalsNew>
        [...]
    </ec:timeIntervalsNew>
    [...]
</item>

Dates/Openinghours.

These TimeIntervals are rules based on daily, weekly, monthly, yearly or single frequencies. The rules can be mixed. Events shall not overlap. DateTimes have to be in IS= 8601 Format: yyyy-MM-DDThh:mm:ss+hh:mm + diff to UTC. StartTime is inclusive, EndTime exclusive. TimeZone has to be IANA Time Zone Database ID and is obligatory (for germany, use Europe/Berlin).

There are different types to transfer the information.

All parameters:

Copy Code
<item>
    [...]
    <ec:timeIntervalsNew>
            <ec:timeInterval ...>
                <!-- Attribute:
                start="2015-01-01T08:00:00+01:00" - startdate first date, obligatory
                end="2015-01-01T17:00:00+01:00" - enddate first date, obligatory
                tz="Europe/Berlin" - timezone, obligatory
                freq="single" - ruletype, obligaotry (single,daily,weekly,monthly,yearly)
                
                repeatUntil="2020-01-01T00:00:00+01:00" - enddate when repeated interval
                repeatCount="100" - max count repetition, use repeatUntil OR repeatCount, not both at once
                interval="1" - repetition-interval, default 1
                dayOrdinal="2" weekday="0" - only with freq=monthly/yearly: every 2. sunday of month
                dayOfMonth="5" - only with freq=monthly/yearly: every 5. day of month
                month="5" - only with freq=yearly: which month
                -->
                
                <ec:weekdays> <!-- only with freq=weekly -->
                    <ec:weekday>0</ec:weekday> <!-- 0=sunday - 6=saturday-->
                    ...
                </ec:weekdays>
                
            </ec:timeInterval>
            [...]
    </ec:timeIntervalsNew>
</item>
ec:rating
Copy Code
<item>
    [...]
    <ec:rating type="Panorama">75</ec:rating>
    <ec:rating type="Kondition">50</ec:rating>
    <ec:rating type="Fahrtechnik">5</ec:rating>
    [...]
</item>

There can be many different ratings. Value has to be between 0 and 100. Values for attribute "type" can be set free

Samle for start-rating 1-5 into percentage values:

ec:season
Copy Code
<item>
    [...]
    <ec:season month="1">qualified</ec:season> <!-- january qualified -->
    <ec:season month="2">dependent</ec:season> <!-- february dependent on weather-->
    [...]
</item>

Primarily used in module tour, but can also be used in all other modules.

Month: 1-12 (1=january)

Value

Default-value if not set: undefined

 

 


© hubermedia 2018 Privacy Statement Imprint