Modulintegration

Version vom 2. März 2007, 16:44 Uhr

Bitte beachten Sie zum Einbinden die Systemvoraussetzungen.

Allgemeines

Bei der Programmierung ist die Groß- und Kleinschreibung zu beachten.

Funktionsaufruf

Um einen Informationsblock in Ihre Seite einzubinden, gehen Sie wie folgt vor:

1. Ändern Sie die Endung Ihrer Datei in php.
2. Öffnen Sie Ihren Editor.
3. Passen Sie ggf. die Links auf diese Seite an die neue Endung an.
4. Öffnen SIe die Datei.
5. Wechseln Sie in Ihrem Editor ggf. zur Codeansicht.
6. Bewegen Sie den Cursor an die Stelle, an der die Ausgabe erfolgen soll.
7. Rufen Sie die gewünschte Funktion an dieser Stelle mit folgendem Code auf:

   <?php include("http://lib.itrack.de/MODULE/?FUNCTION&PARAMETER1=VALUE1&PARAMETER2=VALUE2") ?>

Die großgeschriebenen Wörter sind durch entsprechende Angaben zu ersetzen wie folgt:

• MODULE: jeweiliger Modulname
• FUNCTION: Funktionsname
• PARAMETERn: Name des n. Parameters
• VALUEn: Wert des n. Parameters

HIER ANGABEN FÜR SONDERZEICHEN: ' ','&','=','/','?',etc. ERGÄNZEN

Die Angaben für die eine Funktion entnehmen Sie bitte der zugehörigen Funktionsbeschreibung im jeweiligen Modul.

Funktionsausgabe

HTML

Die Ausgabe einer Funktion besteht aus einer reinen XHTML-Struktur. Je nach Funktion befindet sich diese Struktur in einem DIV oder UL-TAG. Dieses TAG ist mit einer HTML-ID versehen. Innerhalb der XHTML-Struktur sind einzelne Bereiche durch Klassen gekennzeichnet. Die Auflistung ist in der jeweiligen Funktion beschrieben.

CSS

Damit die Darstellung der XHTML-Struktur auch ohne eigene Stylesheet-Angaben bereits ordentlich aussieht, werden diese bei manche Funktionen mittels CSS-Definitionen vorformatiert. Dabei findet die jeweilige HTML-ID Verwendung. Die Definitionen können an die eigenen Bedürfnisse angepaßt werden. Eine Auflistung der Definitionen Angaben finden Sie jeweils in der Beschreibung des Moduls.[1]

Wenn Sie Ihre CSS-Definitionen an einer beliebeigen Stelle in der Datei plazieren wollen, müssen Sie Selektoren mit höherer Priorität verwenden (z.B. durch Einschließen in ein HTML-TAG mit ID). Sie können dieselben Selektoren verwenden, wenn Sie Ihre CSS-Definitionen in der Datei hinter den Funktionsaufruf plazieren.

JavaScript

Beinhaltet die Ausgabe ein Formular, wird in manchen Funktionen bei der Ausgabe eine JavaScript-Funktion mitgeliefert, die bei aktiviertem JavaScript die Formulareingaben überprüft.

ÜBERSCHREIBEN DER INIT-FUNKTION VERHINDERN
ÜBERSCHREIBEN DER INIT-VARIABLEN VERHINDERN
VORGEHEN BEI EIGENEM onLoad-EVENT ERGÄNZEN
Die JS-Unterstützung benötigt eine Initialisierung per window.onload-Event.
Was ist mit eigenen window.onload-Initialisierungen?
Z.B. UserFunktion initUser mit 1 array für Parameter?
Wenn man die JS-Unterstützung nutzen will, dürfen die nachfolgend aufgelisteten, vordefinierten Objekte nicht überschrieben werden.

Fehlermeldungen

Fehlermeldungen haben folgende Struktur:

<div class="info error">
  <h3>Fehlertyp</h3>
  <p>Fehlermeldung</p>
</div>

Desweitern können in der weitern Ausgabe die Fehlerstellen genauer markiert sein.

Sie werden durch folgende Stylesheet-Angaben vorformatiert:

<style>
.info h3 {
  margin-bottom: 0;
}
.info p {
  margin-top: 0;
}
.error p,
.error label,
p.error,
td.error,
span.error,
label.error {
  color: red;
  font-weight: bold;
}
</style>

Diese Definitionen können nach eigenen Bedürfnissen überschrieben werden.[1]

• [1] Zur Anpassung der Stylesheet-Angaben sollten Sie mit CSS vertraut sein.