Eigenen Inhalt in Xoops mit einem Modul einbinden | Falls du eine normale Seite mit freiem Inhalt in Xoops einbauen willst, gibt es verschiedene Möglichkeiten. Entweder, man nimmt das Sections- oder Tutorials-Modul1, man läd die Seite mit dem Framebrowser in einem iFrame oder man bindet eine beliebige Seite mit dem Modul freecontent ein.
Einige Sachen lassen sich aber mit den oben genannten Modulen garnicht realisieren. In diesem Fall kann man ein eigenes kleines Modul machen. Dies ist kaum schwieriger und viel flexibler.
Zuerst musst du ein Verzeichnis anlegen. Dieses Verzeichnis wird nachher nach ./modules/ geladen.
Nun brauchst du eine Datei in der steht, wie das Modul heißt, ob es im Hauptmenü eingetragen werden soll etc.. Diese Datei kann z.B. so aussehen:
__________________________________________________
<?php
$modversion['name'] = "Dein Modul";
$modversion['version'] = 1.00;
$modversion['description'] = "Beschreibung";
$modversion['author'] = "Dein Name";
$modversion['credits'] = "http://www.xoops.org";
$modversion['help'] = "";
$modversion['license'] = "GPL see LICENSE";
$modversion['official'] = 1;
$modversion['image'] = "free.jpg";
$modversion['dirname'] = "free";
// Admin things
$modversion['hasAdmin'] = 0;
$modversion['adminpath'] = "";
// Menu
$modversion['hasMain'] = 1;
?>
__________________________________________________
Du darfst immer nur den Inhalt zwischen den beiden Anführungszeichen verändern.
$modversion['name'] = "Dein Modul";
Der Name deines Modules. Solltest du anpassen, da dieser Name falls gewünscht, nachher auch im Hauptmenü erscheint.
$modversion['version'] = 1.00;
Die Version deines Modules. Am besten einfach so lassen.
$modversion['description'] = "Beschreibung";
Eine Beschreibung deines Modules
$modversion['author'] = "Dein Name";
Der Name des Autors des Modules, also deiner
$modversion['credits'] = "http://www.xoops.org";
Da kannst du dich dann selber ehren :o)
$modversion['image'] = "free.jpg";
Hier musst du den Dateinamen eines Bildes angeben, welches nacher bei der Installation des Modules angezeigt wird. Das Bild sollte die Größe 88x31 haben und muss im Verzeichnis deines Modules liegen.
$modversion['dirname'] = "free";
Der Name des Verzeichnisses welches du am Anfang erstellt hast.
// Admin things
$modversion['hasAdmin'] = 0;
$modversion['adminpath'] = "";
Diese Angaben sind nur notwendig wenn dein Modul ein Admin-Menü hat
// Menu
$modversion['hasMain'] = 1;
Hier gibst du an, ob das Modul automatisch im Hauptmenü stehen sollen, oder nicht. 1 = ja; 0 = nein
Speichere die angepasste Datei dann im Ordner des Modules unter dem Namen xoops_version.php.
Jetzt brauchst du noch eine Datei, in der dein Inhalt steht. Diese sollte index.php heißen und kann wie folgt aussehen.
__________________________________________________
<?php
include("../../mainfile.php");
$xoopsOption['show_rblock'] = 0;
include($xoopsConfig['root_path']."header.php");
OpenTable();
echo "Hallo, <br /><br />ich bin ein Modul und hier steht das, was die anderen sehen, wenn sie mich aufrufen.";
CloseTable();
include($xoopsConfig['root_path']."footer.php");
?>
__________________________________________________
Mit $xoopsOption['show_rblock'] = 0; gibst du an, ob der rechte Seitenblock in deinem Modul angezeigt werden soll. Falls ja, musst du aus der 0 eine 1 machen.
Der eigentliche Inhalt deines Modules steht zwischen OpenTable(); und CloseTable();. Dort kannst du nun beliebigen php-code reinschreiben. In unserem Beispiel geben wir einfach einen kleinen Text mit dem php-Befehl echo aus. Bei HTML Tags musst du darauf achten, dass du vor die Anführungszeichen in den Tags ein Backslash machst. Also nicht <a href=“http://xoops.org“> sondern <a href=“http://xoops.org“>
Als letzes musst du den Ordner inklusiv der beiden php-Dateien (xoops_version.php und index.php) und dem Bild in den Modules Ordner auf deinem Webspace hochladen und dann das Modul im Administrationsmenü unter Module installieren. Nun kannst du dein Modul nutzen.
Falls ihr noch Fragen, Anregungen oder Kritik habt, schickt mir eine Mail an xoops-modul-tutorial@abi07.com
Viele Grüße, Matthias
http://abi07.com :: http://community.planet-school.de
Beispiel-Dateien könnt ihr euch von http://osnanet.de/guido.steffen/eigenes-modul.zip runterladen. |
|
[ zurück zu Module | zurück zum Index |  ] |
|
|
|
