template_create

Erstellung eines Templates

1. Composer

Zuerst muss in Git ein neues Projekt erstellt werden. Der Name soll aus "template" und nach dem Bindestrich dem Templatenamen bestehen:

template-templatename

Im Composer bitte keine Großbuchstaben verwenden.

Jetzt kann eine composer.json Datei erstellt werden. Hier eine Vorlage:

{
    "name": "quiqqer/template-templatename",
    "type": "quiqqer-template",
    "description": "Name des Templates",
    "version": "dev-master",
    "license": "MIT",
    "authors": [
        {
            "name": "...",
            "email": "...",
            "homepage": "...",
            "role": "Developer"
        }
    ],
    "support": {
        "email": "...",
        "url": "..."
    },
    "require": {
        "php": ">=5.3",
        "quiqqer\/quiqqer": "*@dev",
        "quiqqer\/bricks": "*@dev",
        "quiqqer\/fontawesome": "*@dev",
        "quiqqer\/sitetypes": "*@dev",
        "quiqqer\/menu": "1.*|dev-dev",
        "quiqqer\/unsemantic": "*@dev",
        "quiqqer\/utils": ">=1.7|dev-dev",
    },

    "autoload": {
        "psr-4": {
            "QUI\\TemplateName\\": "src/QUI/TemplateName"
        }
    }
}

Es empfiehlt sich direkt eine README.md Datei zu entwerfen. Eine entsprechende Vorlage ist hier zu finden.

Der Inhalt einer README.md Datei wird geladen und auf der Projektseite in Files unter der Dateien- und Ordnerliste dargestellt. So kann jeder den ersten Überblick von unserem Template erhalten.

2. Server Update

Jetzt muss ein Serverupdate vom Administrator durchgeführt werden.

3. Aktualisierung

Das Projekt muss jetzt unserem Projektordner auf dem Rechner erscheinen. Dazu führen wir folgenden Befehlt aus:

./console composer nameDesTemplates:dev-master

4. Das Template zuweisen

Jetzt muss QUI upgedatet werden. Unter

QUIQQER Logo > System, Plugins und Paket-Manager

im ersten Reiter (Updates) Menü --> System Setup ausführen klicken.

5. Funktionalitäten einbauen

Um dem Benutzer bestimmte Aktionen zu erlauben (z. B. eigenes Logo hochladen) wird eine settings.xml Datei benötigt.

Mehr über die settings.xml Datei können Sie hier erfahren.

7. WYSIWYG Editor CSS zuweisen

Damit die Inhalte im Editor die Styles der (Frontend-) Seite haben, muss die CSS Datei dem Editor zugewiesen werden. Das erfolgt in der settings.xml Datei:

             <!-- (...) -->
             </category>
            </categories>
        </window>
    </settings>

    <project>
        <wysiwyg class="main-content">
            <css src="//fonts.googleapis.com/css?family=Open+Sans:300,400,700,400italic"/>
            <css src="URL_OPT_DIR/quiqqer/template-presentation/bin/css/style.css"/>
            <css src="URL_OPT_DIR/quiqqer/template-presentation/bin/css/editor.css"/>
        </wysiwyg>
    </project>
</quiqqer>

7. Weitere Dateien

Nun können weitere Dateien und Ordner erstellt werden:

• site.xml
• brick.xml
• locale.xml