Eigene Stile und Funktionen
===========================

Einführung
..........

Es ist relativ einfach, PlexMap mit neuen (Frontend-)Funktionalitäten und
eigenen CSS-Stilen auszustatten. Hierzu muss eine neue App erstellt werden,
die wiederum eine Komponente enthält.

App und Komponente erzeugen
...........................

Um eine Kompoenent ``custom`` zu erzeugen, legen sie folgende Ordnerstruktur im
Installationsverzeichnis an. ``custom`` kann hier durch einen beliebigen Namen in
Kleinbuchstaben und ohne Sonderzeichen ersetzt werden::

    custom/
        __init__.py
        static/
            css/
                custom.css
        templates/
            plexgis/
                custom/
                    component.js

Hierbei ist ``__init__.py`` eine leere Textdatei, ``custom.css`` eine Textdatei
mit CSS-Anweisungen, und ``component.js`` kann JavaScript-Code enthalten. Falls
tatsächlich benutzerdefinierter JavaScript-Code eingebunden werden soll, sollte
die Datei folgende Form aufweisen::

    (function(o, $, undefined) {
        o.init = function () {
            // initialisierungscode
            alert("Komponente {{ component }} geladen!");
        }

        o.createWidgets = function () {
            // initialisierungscode für UI
        }
    }( Plexgis.components.{{ component }} = Plexgis.components.{{ component }} || {}, jQuery ));

App und Komponente einbinden
............................

Die App muss nun in ``settings.py`` eingefügt werden unter ``INSTALLED_APPS``,
und zwar vor dem Eintrag ``plexgis``.

Die Komponente mit dem gleichen Namen muss darüber hinaus in der ``config.yaml``
am Ende der Liste ``plexgis.components`` eingefügt werden.