System fuer Wigets
Eine Box ist ein rechteckiger Bereich, der auf einigen Seiten (vorerst nur auf der Startseite) angezeigt werden kann. Diese werden durch Dateien in einem bestimmten Verzeichnis beschrieben.
Der Inhalt der Boxen ist der Phantasie des Entwicklers überlassen (Grafiken, Text, Tabellen, ...), aber ein Grundgerüst ermöglicht eine einfache tabellenbasierte Darstellung.
Ein neues Widget erstellen
Every standard box is stored inside the htdocs/core/boxes directory.
There is one file for each box.
Each file is a class inherited from the ModeleBoxes class.
To create a new box, you may copy an existing box file, rename it, for example to box_myownbox.php and change its content to match the new name.
You can now define the informations you want to show inside the box.
However if you plan distributing your box to other users, you must create a module and store your box files inside your module.
- Go to Module development page to learn how to create a module
- Create your box file into htdocs/mymodule/core/boxes/
- Once your module descriptor is created, add these lines to declare your box file
$this->boxes = array(
0 => array(
'file' => 'box_myownbox@mymodule',
'note' => 'My notes',
'enabledbydefaulton' => 'Home'
)
// You can declare as much boxes as you want by simply incrementing the index.
);
- For distribution, package the module containing your box (See Module development page).
Activate a widget
To activate a box, go to Home - Setup - Boxes page and click activate on the box you want to see.
It will be displayed on the page for which you have activated the box.