Plugin-Name:
---------------------------------------------------------------------------
Add Headerelement
Version:
---------------------------------------------------------------------------
01.05.00
Status:
---------------------------------------------------------------------------
stable
Bechreibung:
---------------------------------------------------------------------------
Das Plugin bietet die Möglichkeit dem <head> Elemente anzuhängen und zu ändern
Features:
---------------------------------------------------------------------------
- Hinzufügen von css Dateien über event "add_css"
- Hinzufügen von js Dateien über event "add_js"
- Hinzufügen von beliebigen Elementen über event "add_headelement"
- Ändern des Titles mit event "set_title"
- Über Administration->Projekte ist es möglich den doctype einzustellen (html/xhtml)
Wenn der Parameter nicht administriert ist, wird die Einstellung des layouts übernommen
Autor(en):
---------------------------------------------------------------------------
Oliver Albrecht - dduffy
Jan Hoffmann - smail
Lizenz:
---------------------------------------------------------------------------
GPL
Benötigte Sefrengo Version:
---------------------------------------------------------------------------
>= 01.04.00 (frühere Versionen nicht getestet)
Installation:
---------------------------------------------------------------------------
Wechseln Sie in Ihrer Sefrengo Version in den Bereich "Administration->
Plugins". Wechseln Sie dort in den Bereich "Plugin importieren"). Am
unteren Ende des Bereichs befindet sich ein Uploadfeld. Wählen Sie hier die
gewünschte "*.cmsplugin"- Datei aus. Mit einem Klick auf das Diskettensymbol
wird das Plugin in das CMS importiert. Das Plugin ist nun innerhalb des CMS
nutzbar.
Update/ Migration:
---------------------------------------------------------------------------
abwärtskompatibel zu voherigen Versionen
Dokumentation:
---------------------------------------------------------------------------
Das Plugin stellt neben vier Events auch eine direkte Schnittstelle zur verfügung um
den <head> zu ändern.
(Wenn die Events zum einfügen von Elementen in den head benutzt werden, bestimmt die Aufrufreihenfolge
die Reihenfolge in der die Elemente im head eingefügt werden.)
0. Konfiguration
-------------------------------------------
Unter Administration->Projekte->Projektkonfiguration kann der doctype ausgewählt werden,
der für das Einfügen eines Elements in den <head> gelten soll. Zur Auswahl stehen:
1 - html
2 - xhtml
3 - auto (Einstellung des Layouts wird benutzt) [Voreinstellung]
1. add_css (Stylesheet an den head anhängen)
-------------------------------------------
Das Event wird mit einem array in der Form ("file" => "<pfad/zur/cssdatei.css>", "media" => "<liste,der,medien>")
aufgerufen. Der Parameter media ist dabei optional.
Beispiel: fire_event("add_css", array("file" => "test.css", "media" => "screen"));
2. add_js (Javascript an den head anhängen)
-------------------------------------------
Das Event wird mit einem array in der Form ("file" => "<pfad/zur/jsdatei.css>"))
aufgerufen.
Beispiel: fire_event("add_js", array("file" => "test.js"));
3. add_headerelement (beliebiges Element an den head anhängen)
-------------------------------------------
Das Event wird mit einem array in der Form ("<!--Element 1-->", "<!--Element 2-->")
oder mit dem einzufügenden Element als String aufgerufen.
Beispiel 1: fire_event("add_headelement", array("<!--Element 1-->", "<!--Element 2-->"));
beispiel 2: fire_event("add_headelement", "<!--Element 3-->");
4. set_title (Title des Dokuments ändern)
-------------------------------------------
Das Event wird mit einem array in der Form ("title" => "<neuer title>"))
aufgerufen.
fire_event("set_title", array("title" => "Toller Title"));
Die Benutzung der Events kann auch auf einer http://www.oliver-albrecht.com/spielplatz/add-headerelement.html betrachtet werden.
5. Manuelles Einfügen in den <head>
-------------------------------------------
Weiterhin können Elemente auch manuell in der head eingefügt werden:
require_once($cfg_cms['cms_path']."plugins/headerelement/class.headerelement.php");
$he =& SF_Headerelement::getInstance();
$he->addHeaderItem("<mein Element>" [, $sortindex]);
// darüber hinaus stehen die folgenden methoden zur Verfügung:
$he->setTitle($title);
$he->addJsItem($filname);
$he->addCssItem($filename [, $media]);
Module die dieses Plugin benutzen:
---------------------------------------------------------------------------
ChangeHeader
PicaseWebAlbumViewer
FontSize (v 1.0.0)
Sehr schöne Idee, die Singleton-Implementation an die SF-eigenen Events zu koppeln.
Und eigentlich eine logische Konsequenz, man muss nur erstmal drauf kommen...
Damit könnten wahrscheinlich langsam eine Reihe von FRs als abgedeckt gelten:
Hi duffy, vielen Dank für das Plugin. Den Hinweis mit der Beispielseite verstehe ich aber noch nicht. Der dort stedhende Beispielcode - wo kommt der denn hin, damit er dann im Header erscheint?
beim plugin löschen und dem erneuten impotieren kommt es zur verdopplung der eventeinträge in der db
uninstall.meta
Unterstützt von Invision Power Board (http://www.invisionboard.com)
© Invision Power Services (http://www.invisionpower.com)