Öffentliche Seiten/Inhalte auf externen Webseiten

Die öffentlichen Inhalte aus t-Point sind über die /public/-URL erreichbar (/public/de für deutschsprachige Inhalte).

Um die Inhalte auf Ihrer Organisations-Webseite einzubinden, bieten wir Ihnen folgende möglichkeiten:

‘normale’ Seiten-Ansicht

  • Die Ihnalte kölnnen über den link ./public erreicht, wobei die standard-Systemsprache geladen wird.
  • Über die URL ./public/{_locale} erreichen Sie die übersetzten Inhalte

Normale Links schauen also folgendermaßen aus:

https://demo.t-point.eu/public/projects/de
https://demo.t-point.eu/public/events/de
https://demo.t-point.eu/public/contacts/de
https://demo.t-point.eu/public/reports/de

Bemerkung

https://demo.t-point.eu/ wird hier standardmäßig als Beispiel verwendet.

Natürlich müssen Sie die Root-URL mit der URL zu Ihrer t-Point Installation anpassen.

‘iframe’-Ansicht

Dies ist die einfachste Möglichkeit zur Integration. Verwenden Sie die URLs von oben und fügen sie ?view=frame hinzu und betten sie sie als <iframe> ein.

Folgende Unterschiede gibt es zu der ‘normalen’ Ansicht:

  • Keine Navigationsleiste (am oberen Bildschirmrand), kein Navigationsspalte und Systemabhängige Inhalte werden angezeigt.
  • Die Unterseiten werden in einem neuen Pop-Up Fenster angezeigt.

Fügen Sie einfach den folgenden HTML-Code in Ihre Webseite ein.

Achtung: Bei Verwendung eines CMS müssen sie Sicherstellen, dass der Inhalt als (unformatierter) HTML-Text eingefügt wird.

<iframe src="https://demo.t-point.eu/public/projects/de?view=frame"
    id="projectFrame" style="width: 100%; height: 400px; border: none;">
</iframe>

Um die Webseite auf die ganze höhe des Frame-Inhalts zu strecken, und damit die Scrollbalken auszublenden, verwenden Sie folgenden Code:

Alternative, wenn das jQuery-Framework nicht verwendet wird:

<iframe src="https://demo.t-point.eu/public/projects/de?view=frame"
    id="projectFrame" onload="iframeLoaded()"></iframe>
<script>
    function iframeLoaded() {
        var iFrameID = document.getElementById('projectFrame');
        if(iFrameID) {
            iFrameID.style.height =
                (iFrameID.contentWindow.document.body.offsetHeight+20) + "px";
        }
    }
</script>

Bemerkung

Die “+20” werden verwendet, um sicherzustellen dass die gesamte höhe der inneren seite errechnet wird, wenn es mit CSS angepasst wird (margin).

JSON

Die öffentlichen Inhalte sind auch als JSON-Verfügbar. Sie können z.b. via ‘curl’ von Externen Servern aufgerufen werden.

Die Haupt-JSON-Seite (https://demo.t-point.eu/public/en.json) Zeigt die Json-Links zu den erreichbaren Infos.

Sie können Ihre Seiteninhalte via JS (siehe: stackoverflow) oder ihrer bevorzugten Scriptsprache in Ihrer Zeite einfügen.

Die Haupt-Json URLs sind hier aufgelistet.

https://demo.t-point.eu/public/projects/de.json
https://demo.t-point.eu/public/events/de.json
https://demo.t-point.eu/public/contacts/de.json
https://demo.t-point.eu/public/reports/de.json

Der Inhalt dieser URLs enthält neben den Daten auch einige Links zu ‘sub-contents’. Diese sind mit den folgenden Schlüsselwerten aus dem Json-Objekt abrufbar

  • link: Link zur Zielseite mit allen erreichbaren Informationen
  • inframe: Link zum Inhalt, der in einem Frame oder Popup angezeigt werden kann.
  • json_detail: Link zu detailierten JSON-Informationen des gewählten Objekts.

JSONP

Die JSON-Url kann mit dem parameter callback (z.B. ?callback=jsonpFunction) versehen werden, um sie als JSONP-Daten auszugeben. Dies funktioniert mit allen JSON-Inhalten.

Danach können Sie die Daten aus der JSON-Quelle in Ihre Seite wie folgt einfügen.

<script type="text/javascript">
    function getData(data) {
        console.log(data);
    }
</script>
<script src="https://demo.t-point.eu/public/projects/
    de.json?callback=getData"></script>

RSS

Sie könenne den RSS-Feed nutzen, um auf die Daten via Feed-Reader zuzugreifen, oder die Inhalte mit einer Programmiersprache auszulesen (z.B. via PHP)

Die Zugriffslinks für RSS sind gleich wie zu den JSON-Links (nur mit der Endung .rss)

Projects:       https://demo.t-point.eu/public/projects/de.rss
Events:         https://demo.t-point.eu/public/events/de.rss
Contacts:       --- kein RSS-Feed verfügbar
Reports:        https://demo.t-point.eu/public/reports/de.rss

Die folgenden Beispiele (englisch) zeigen, wie die Feeds z.B. mit Javascript auf einer Webseite dargesetllt werden könnte.

Zusätliche Infos:

  • Für die Kontaktdaten gibt es keinen Feed.
  • Der Link des Feeds zeigt auf die ‘Frame’-Ansicht der Detail-Seite des Inhalts.
  • Der Feed beinhaltet das Firmen-Logo (welches für die Seiten-Navbar des Systemskonfiguriert wurde)

vCard

Die öffentlichen Kontakte stehen als vCards zur verfügung. Sie haben dazu folgende Möglihkeiten:

  • Kontaktliste: über einen Klick auf den Download-Icon (download-icon)
  • Kontakt-Detail: über einen klick auf den Download-Icon (download-icon)
  • JSON-Data: Der vCard-Inhalt ist in die JSON-Response von https://demo.t-point.eu/public/contacts/de.json eingebettet.
  • Für weitere Kontaktdaten-Verarbeitung sind die formatierten Kontakt-Informationen auch als JSON-LD Objekt im Json-Detail jedes Kontaktes eingebettet.