IFRAME-API

Mittels der IFRAME-API können Sie eigene Inhalte nahtlos in LiveConfig integrieren und somit dessen Funktionen erweitern. Dies erfolgt durch das Einbetten externer Inhalte in die LiveConfig-Oberfläche über ein <IFRAME>-Tag. Die externe Webseite erhält via CGI-Variablen Informationen zum jeweils angemeldeten Benutzer.

Erstellung eigener Inhalte

Wenn auf eine Eigene Links-Seite geklickt wird, erstellt LiveConfig einen <IFRAME> welcher die konfigurierte Ziel-URL enthält. Dieser IFRAME hat eine Breite von 100%, die Höhe wird mittels JavaScript auf die Höhe des eingebetteten Inhalts skaliert, so dass normalerweise kein zweiter Scrollbalken erscheinen sollte.

Ein Beispielskript sowie einige Hilfsfunktionen finden Sie in der Wissensdatenbank.

Bei der Gestaltung der einzubettenden Inhalte sind fast keine Grenzen gesetzt. Lediglich ein paar Dinge müssen beachtet werden:

  • Verwendung von lc-api.js

    Um die Höhe des IFRAMEs automatisch anzupassen, muss eine bestimmte JavaScript-Funktion aufgerufen werden sobald die Inhalte vollständig geladen wurden. Die Datei lc-api.js enthält den notwendigen Code.

  • CGI-Parameter sid, ts, chk und lang

    LiveConfig fügt die CGI-Parameter sid (Session-ID des LiveConfig-Benutzers), ts (aktueller Zeitstempel), chk (Prüfsumme) und lang (gewählte Sprache) automatisch an die aufzurufende URL hinzu. Mit der Prüfsumme können Manipulationen an den CGI-Parametern schnell erkannt werden. Mit der Session-ID kann die SOAP-Funktion SessionCheck aufgerufen werden um zu erkennen ob der Benutzer noch in LiveConfig angemeldet ist - dabei werden auch weitere Informationen wie etwa der Benutzername, der vollständige Name und eine Liste aller zugewiesenen Verträge zurückgeliefert.

    Wenn Sie in eingebetteten Seiten eigene Eingabeformulare erstellen, ist es am besten diese CGI-Parameter mit durchzureichen, so dass Sie die Gültigkeit der Session zu jedem Zeitpunkt prüfen können. In komplexeren Anwendungen können Sie auch Ihre eigene PHP-Session für diesen Besucher erstellen und diese CGI-Parameter in den Session-Daten speichern-

    Für ein vollständiges Beispiel werfen Sie einen Blick auf example.php in dem Beispiel-Paket (siehe oben).

Wenn die angezeigten Daten visuell zu den LiveConfig-Seiten passen sollen, finden Sie die richtigen CSS-Stile in lc-api.css.


Zuletzt aktualisiert am 04.05.2020.
weiter: Anpassungen
zurück: LC.timeout.*