Module integrieren
Sie können jede beliebige PHP-Anwendung (oder auch einfache HTML-Seiten) in den Sitedummy
integrieren. Dies wird über die sog. iFrame-Technik realisiert. Ein iFrame kann man als einen
leeren Rahmen innerhalb Ihrer Sitedummy-Webseite bezeichnen, in welchem, die von Ihnen
gewünschte Anwendung, geöffnet wird. Durch die iFrame-Technik können mehrere Web-Adressen
gleichzeitig innerhalb einer Webseite angezeigt werden.
Modul-Administration
Alle Module haben separate Administrationsbereiche. Es gibt verschiedene Möglichkeiten zu
diesen separaten Administrationsbereichen zu gelangen:
1. Wenn Sie den Administrationsbereich (Link Admin) Ihres Homepagesystems öffnen, erscheint
auf der Startseite eine Liste mit Ihren Modulen.
Dieselbe Liste finden Sie auch, wenn Sie im Administrationsbereich Menü unten links auf den
Button Dateibrowser öffnen klicken. Im Dateibrowser klicken Sie unten rechts bei Modul
Administrationsbereiche auf den Button anzeigen. Im aufgehenden Popup-Fenster werden die
Module aufgelistet. Klicken Sie z.B. für den Administrationsbereich des Kontaktformulars auf
admin.php öffnen.
2. Zu dieser Seite gelangen Sie auch, wenn Sie die entsprechende Adresse direkt in die
Adresszeile Ihres Browserfensters eingeben. Beim Kontaktformular lautet diese zum Beispiel:
http://www.Ihre_Domain.de/module/kontakt/admin.php
Datei für die Modul-Anzeige in der Liste erstellen
Damit Ihr Modul auf der Startseite bzw. im Popup-Fenster angezeigt wird, müssen Sie die Datei
init_sdmodul.txt anlegen und im entsprechenden Modul-Ordner ablegen. Gehen Sie dabei bitte
folgendermaßen vor:
- Öffnen Sie einen Texteditor (z.B. Notepad, Word ist kein Texteditor!)
- Tragen Sie den Pfad zum Administrationsbereich Ihres Moduls ein.
Wenn die Datei, die den Moduladminbereich öffnet z.B. login.php heißt und sich im
Ordner admin befindet, lautet der Pfad: admin/login.php.
- Speichern Sie die Datei als init_sdmodul.txt auf Ihren Computer.
- Wechseln Sie in den Dateibrowser Ihres Sitedummy-Administrationsbereichs.
- Klicken Sie in der mittleren Ansichtsspalte (Objekt zur Beareitung wählen) auf den
Ordner Ihres Moduls.
- Klicken Sie in der Spalte Aktionen auf Durchsuchen... und wählen Sie die Datei
init_sdmodul.txt von Ihrem Computer aus.
- Klicken Sie auf Datei uploaden, um die Datei auf den Server in Ihr Modulverzeichnis
zu übertragen.
Wenn Sie alles richtig gemacht haben, ist der Adminbereich Ihres Moduls jetzt aufgelistet und
anklickbar. Für das Kontaktformular und alle anderen, in unserem
Downloadbereich angebote-
nen, Module existiert diese Datei bereits.
Designanpassungen
Die Höhe des iFrames festlegen
Wenn Sie im Administrationsbereich
Design die Höhe Ihrer Webseite auf
auto stellen, paßt sich
diese automatisch dem Inhalt an. Bei einem Modul funktioniert dies nicht, da ein Modul eine
zweite Internetseite ist, die mit dem Sitedummy-Rahmenlayout aufgerufen wird.
Einstellungen
Klicken Sie in Ihrem Navigationsmenü auf den Link eines Moduls. Am oberen Rand der Modul-
seite erscheint eine Einstellungsleiste für die iFramehöhe. Sie können zwischen der Bildschirm-
höhe und einem Pixelwert wählen. Mit der Einstellung Bildschirmhöhe nimmt der Sitedummy-
Rahmen die gesamte, zur Verfügung stehende, Höhe des Browserfensters ein. Ihr Modul wird
dann in einem scrollbaren Bereich angezeigt. Mit der Einstellung Wert können Sie dem iFrame
eine feste Höhe in Pixeln geben. Ist das iFrame durch den eingestellten Wert kleiner als die
aufgerufene Seite, erscheint ein Scrollbalken.
Automatische iFrame-Höhe
Wenn Sie möchten, daß sich das iFrame automatisch der Höhe des Inhalts der aufgerufenen
Modulseite anpasst, dann ist auch dies möglich. Dafür müssen Sie Ihr Modul nur durch eine
JavaScript-Funktion erweitern. Fügen Sie einfach folgendes Script in den <head>-Bereich der
Dateien Ihres Moduls ein:
<script language="JavaScript" type="text/javascript">
<!--
function iFrameResize() {
if (parent.frames.length != 0) {
parent.document.getElementById('moduleframe').style.height =
document.body.scrollHeight + 20 + "px";
}
}
window.onload = iFrameResize();
//-->
</script>
Stylesheets
Wenn Sie eine fremde, nicht von uns bereitgestellte, Anwendung verwenden möchten, können
Sie zur Designanpassung folgendes Stylesheet in den <head>-Bereich Ihrer Dateien einfügen:
<link href="http://www.Ihre_Domain.tld/style/css/modstyle.css"
rel="stylesheet" type="text/css" />
Ihre Anwendung sollte in
XHTML geschrieben sein. Der Pfad zur Stylesheetdatei muß komplett,
also inkluvisve Domain, angegeben werden. Ein relativer Pfad (../../) ist nicht möglich!
Das Stylesheet stellt alle, im Administrationsbereich
Design gemachten, Einstellungen zur Verfü-
gung. Spezielle Styles Ihrer Anwendung, wie z.B. Größenangaben, müssen beibehalten werden.
Fügen Sie die Zeile deshalb
nach den vorhandenen Stylesheet-Dateien Ihres Moduls ein.
Abhängig vom Doctyp (Typ des Dokuments) Ihrer Anwendung, entsteht im Internet Explorer ab
Version 6 am unteren Ende des iFrame-Fensters ein horizontaler Scrollbalken. Diesen Scroll-
balken können Sie mit folgendem Stylesheet unterdrücken:
<style type="text/css">
<!--[if gte IE 6]>
html { overflow-x: hidden; }
body { width: 97%; }
<![endif]-->
</style>
Diese Stylesheet-Definition haben wir vom allgemeinen Modul-Stylesheet getrennt, damit der
Scrollbalken nur auf Wunsch ein- bzw. ausgeschaltet werden kann.
Das Modul mit Javascript ins iFrame zwingen
Die iFrame-Technik hat auch einen Nachteil. Ihre Anwendung kann ohne das Rahmenlayout des
Sitedummys geöffnet werden. Dies passiert z.B. wenn ein Besucher über die Suchmaschine
direkt auf eine Seite Ihrer Anwendung gelangt. Dieses Problem läßt sich mit JavaScript
folgendermaßen beheben:
Laden Sie als erstes folgende Datei herunter:
framing.zip. Entpacken Sie die Datei und über-
tragen Sie sie in Ihr Modulverzeichnis. Dieses Script integrieren Sie dann anhand folgender Zeile
in den <head>-Bereich der Dateien Ihrer Anwendung:
<script src="framing.js" language="JavaScript" type="text/javascript"></script>
Direkt danach fügen Sie folgendes Script ein:
<script language="JavaScript" type="text/javascript">
<!--
var seturl = GetCookie("url");
if(seturl != null) {
if(self.location != unescape(seturl)) {
self.location = unescape(seturl);
}
}
if (parent.frames.length == 0) {
var expdate = new Date ();
expdate.setTime(expdate.getTime() + (3 * 1000));
SetCookie("url", self.location, expdate);
top.location = "?????";
}
//-->
</script>
Ersetzten Sie die Fragezeichen nach top.location mit dem Link, welcher Ihr Modul aufrufen soll,
z.B. http://www.Ihre_Domain.de/module-Beispiel.phtml. Wichtig ist, daß Sie den gesamten Pfad,
inklusive http:// eintragen. Durch die Scripte wird automatisch für jede Ihrer Modulseiten das
Sitedummy-Rahmenlayout nachgeladen. Nach dem Reload wird nicht die Startseite Ihres Moduls
aufgerufen, sondern die ursprüngliche, vom Besucher aufgerufene Modulseite bleibt erhalten.
Das Script funktioniert nur mit Seiten, die von der selben Domain stammen wie der Sitedummy.
Das Modul, welches das Script beinhaltet, muß sich also in Ihrem Modulordner befinden. Bei
externen Seiten, z.B. einem Gästebuch, welches ein Dienstleistungsanbieter kostenlos zur
Verfügung stellt, verhindern die JavaScript-Sicherheitseinstellungen des Browsers die Ausfüh-
rung des Scriptes.
