Détails sur OLE

Interface ouverte de données événementielles

La fonction principale de Hinto est que les informations sur les événements se diffusent automatiquement d'une nouvelle manière dynamique, au-delà des frontières des sites web et des plateformes individuelles. Grâce à l'échange automatique de données avec d'autres sites web & ; plateformes, la visibilité des praticiens de la culture est accrue avec peu d'efforts. Les connaissances sur notre riche paysage culturel se diffusent ainsi plus facilement et deviennent plus tangibles.

Sans interface OLE (Auparavant)

Les événements doivent être publiés manuellement

L'organisateur doit saisir son événement manuellement sur différentes plateformes.

Cela signifie : L'organisateur doit investir beaucoup de temps pour publier ses événements. En cas de changement, les informations doivent être adaptées partout à la main.

Si une interface est proposée par la plateforme, elle doit être mise en œuvre pour chaque plateforme individuelle.

Cela signifie: Dépendance à l'égard de la plateforme et coûts de mise en œuvre et de maintenance.

Avec interface OLE (Nouveau)

Les événements se propagent automatiquement

L'interface standardisée OLE est offerte par vous Les plateformes viennent à vous pour aller chercher. Les plates-formes viennent à vous pour les données pick up.

Cela signifie : Pas d'effort de publication d'événements. Une seule fois Coûts de mise en œuvre de l'interface OLE pour fournir des données à un nombre quelconque de plates-formes.

Pour Wordpress ;(version 5.2-5.7) il existe un gratuit OLE plugin pour alimenter le réseau OLE en données d'événements en quelques clics. Le plugin prend en charge divers plugins de gestion d'événements (par exemple, Event Organiser, WP Event Manager, Event Calendar), mais peut également être étendu par un pilote personnalisé.

Un petit bibliothèque PHP que nous avons sur bitbucket.org (GIT, licence MIT) afin que les plugins pour Typo3, Drupal, Joomla! et d'autres solutions peuvent être créées plus facilement.
Nous avons également préparé cette bibliothèque en tant que package composer afin que vous puissiez l'intégrer encore plus rapidement (composer require fugugmbh/oledata dev-master).

Contactez nous pour intégrer l'interface dans votre site web ou si vous avez d'autres questions.

Si vous avez développé un plugin OLE, nous serons heureux de le communiquer ici sur hinto.ch.

Licence

OLE a été développé par fugu GmbH et est sous licence Creative Commons Attribution-Share Alike 4.0 International License.

Les plates-formes/agrégateurs qui utilisent l'interface OLE pour l'agrégation de données sont tenus de communiquer les interfaces OLE (URLs) utilisées. publiquement et sous une forme lisible par machine afin d'assurer la redistribution des données de l'événement.

L'utilisation de l'interface OLE doit être communiquée d'une manière appropriée pour assurer la diffusion du concept OLE. A cet effet, nous avons créé un texte d'exemple dans la section suivante.

Ainsi, le concept OLE peut être utilisé librement pour des applications commerciales et non commerciales dans le respect de la licence.

Licensor

fugu GmbH
Schwarztorstrasse 9
CH-3007 Bern

www.fugu.ch.

Exemple pour une mention dans l'impressum ou le pied de page

Le texte suivant peut être utilisé directement dans le masthead de votre site web:

Ce site web fait partie du réseau OLE (Open Linked Event Data) , une initiative de l'association Hinto.ch. Tous les événements sont également publiés automatiquement sur www.hinto.ch..

Comment cela fonctionne

Après que l'interface basée sur XML a été mise en œuvre dans votre site web par un programmeur, les données peuvent être lues automatiquement et très efficacement par des systèmes distants avec l'URL correspondante.

Les systèmes distants appellent l'URL plusieurs fois par jour et peuvent ainsi lire les données d'événement actuelles.

Comme le document basé sur XML est bien structuré et documenté, il n'y a pas d'interprétations incorrectes de vos données d'événement. L'interface OLE est également beaucoup plus efficace que la récolte sur le site web, donc votre site web/hébergement sera moins occupé et l'expérience de tous les autres visiteurs du site web sera maintenue.

En mettant en œuvre l'interface OLE, vous consentez explicitement à ce que les données de votre événement soient lues par des systèmes tiers et par conséquent utilisées dans des systèmes distants/étrangers..

Mise en œuvre minimale de l'interface

Voici un exemple de la structure que doit avoir le XML.

Nous recommandons de publier un maximum de 20 événements par requête. Cette recommandation protège votre infrastructure et celle du destinataire. Si vous souhaitez publier plus de 20 événements, vous pouvez mettre en œuvre une pagination en utilisant <next_url> ;.

Toutes les données doivent être codées en UTF-8..

Exemple de XML

<!--
We recommend to wrap all values by CDATA <![CDATA[...]]>

lang attribute ist optional (ISO-639-1)

source_id on event,show element must be unique and required for update purpose

-->
<!--
This XML interface is licensed under a Creative Commons 4.0 BY-SA license, https://www.hinto.ch/olelicense.html
-->
<ole>
    <meta>
        <max_pages>8</max_pages><!-- Used to generate a progress info on client side -->
        <next_url><![CDATA[https://www.mydomain.ch/myolepath/for/next/page]]></next_url>

        <!-- extended functions, optional -->
        <changedsince_supported>true</changedsince_supported><!-- boolean -->
        <source_version><![CDATA[my version value]]></source_version>
    </meta>
    <events>
        <event source_id="event-XXX">

            <name lang="de"><![CDATA[My event name]]></name>
            <name lang="fr"><![CDATA[]]></name>
            <name lang="en"><![CDATA[]]></name>
            <name lang="xx"><![CDATA[]]></name>

            <!-- optional -->
            <lead lang="de"><![CDATA[My lead]]></lead>
            <lead lang="fr"><![CDATA[]]></lead>
            <lead lang="en"><![CDATA[]]></lead>

            <!-- optional -->
            <description lang="fr"><![CDATA[My description]]></description>
            <description lang="fr"><![CDATA[]]></description>
            <description lang="en"><![CDATA[]]></description>

            <costs></costs><!-- 0|1 : Int value for no or yes (optional) -->

            <location>
                <name><![CDATA[My name]]></name>
                <street><![CDATA[My street]]></street>
                <code><![CDATA[My postal code]]></code>
                <locality><![CDATA[My city/locality]]></locality>
            </location>

            <!-- optional -->
            <categories>
                <category><![CDATA[My category A (Jazz)]]></category>
                <category><![CDATA[My category B (Fest)]]></category>
                <category><![CDATA[...]]></category>
            </categories>

            <!-- optional -->
            <targetgroups>
                <targetgroup><![CDATA[My target group A (Kinder)]]></targetgroup>
                <targetgroup><![CDATA[My group B (Senioren)]]></targetgroup>
                <targetgroup><![CDATA[...]]></targetgroup>
            </targetgroups>

            <shows>

                <show source_id="show-YYY">
                    <!-- ISO-8601 -->
                    <date_start>2019-09-30T18:00:00+02:00</date_start>
                    <!-- ISO-8601 (optional) -->
                    <date_end>2019-09-30T20:00:00+02:00</date_end>
                    <!-- Additional info (e.g. door opening) -->
                    <info lang="xx"><![CDATA[...]]></info>
                    <!-- Overwrites event.url (optional) -->
                    <url><![CDATA[...]]></url>
                    <!-- Overwrites event.ticket_url (optional) -->
                    <ticket_url><![CDATA[...]]></ticket_url>
                </show>

                <show source_id="...">
                    ...
                </show>

            </shows>

            <!-- optional -->
            <files>
                <image>
                    <!-- Absolute url to the file -->
                    <src><![CDATA[...]]></src>
                    <!-- Copyright of the source (optional) -->
                    <copyright><![CDATA[...]]></copyright>
                </image>
               ...
            </files>

            <!-- Absolute url to the original event page -->
            <url><![CDATA[...]]></url>
            <!-- Absolute url to the event ticket/reservation/booking url (optional)-->
            <ticket_url><![CDATA[...]]></ticket_url>

            <links>
               <url><![CDATA[...]]></url>
               ...
            </links>
        </event>
        <event>
            ...
        </event>
    </events>
</ole>

Optimisations de l'interface

Pour rendre l'échange de données encore plus efficace, nous avons mis en place différentes options.

Paramètre URL "changedsince" (ISO-8601) : ce paramètre peut être fourni afin que seules les données depuis la date spécifiée soient envoyées. L'interface doit répondre avec <changedsince_supported>true</changedsince_supported> ; pour que l'importation différentielle fonctionne.
Si "changedsince" est supporté, le paramètre URL "checksourceids" (liste séparée par des virgules de "source_id "s) est appelé à la fin de l'importation pour connaître les éventuelles suppressions.
L'interface doit répondre à la requête "?checksourceids=show-YYY,a,b,c" comme suit:.

<ole>
    <checksourceids>
        <delete>a,b,c</delete>
    </checksourceids>
</ole>

Optionnellement, l'interface peut envoyer un <source_version> ; celui-ci est alors envoyé par le client à chaque requête. Si la version est différente, l'interface ne doit pas réagir à un "changed_since" et donc fournir à nouveau toutes les données..

Plateformes/Aggrégateurs

Les plateformes/agrégateurs ne doivent pas transmettre les données OLE importées comme leurs propres données, mais toujours faire référence à l'origine des données (URL). A cet effet, l'interface OLE fournit le format XML suivant.

De plus, les plateformes disposant de leurs propres masques d'entrée doivent transmettre/publier les données d'événements à l'aide de l'interface OLE.

Hinto publie ses sources et ses données d'événements à l'adresse https://www.hinto.ch/oleexport.

OLE Sources

<!--
This XML interface is licensed under a Creative Commons 4.0 BY-SA license, https://www.hinto.ch/olelicense.html
-->
<ole>
    <sources>
        <source><![CDATA[my source URL]]></source>
        <source><![CDATA[...]]></source>
    </sources>
</ole>

Topnavigation

Navigation principale