1. Entwickler Dokumentation
  2. Templates
  3. Custom Templates

Custom Templates

Custom Templates müssen in diesem Verzeichnis abgelegt werden: /template/

Informationsstand

alphaNEXT v3.3.0

Stand: 02/2024

Voraussetzungen für ein Custom-Template

Damit alphaNEXT ein Template als solches erkennen kann, ist es nötig, die Voraussetzungen zu beachten.

  1. Jedes Template muss in dem Verzeichnis /public/template/ abgelegt werden.
  2. Der Ordnername sollte ausschließlich Kleinbuchstaben oder Zahlen enthalten.
    1. Keine Leer- oder Sonderzeichen im Ordnernamen! Unterstrich ist erlaubt.
    2. Der Ordnername stellt gleichzeitig den technischen Namen des Template dar.
  3. In dem Unterordner /_resources/css/  kann eine .less-Datei für die Angabe von CSS/LESS angelegt werden. 
    1. Diese Less-Datei muss den gleichen Namen, wie der Template-Ordner haben!
    2. Wird autom. von alphaNEXT erkannt und beim Cache leeren kompiliert.
  4. In dem Unterordner /_resources/js/  kann eine .js Datei für die Angabe von Scripten angelegt werden. 
    1. Diese Js-Datei muss den gleichen Namen, wie der Template-Ordner haben!
    2. Wird autom. von alphaNEXT erkannt und beim Cache leeren kompiliert.
  5. Template Informationen müssen innerhalb der Datei "template.inc.php" angegeben werden.
    1. Diese Datei muss im Template-Ordner an oberster Ebene liegen.
    2. Muss für die Erkennung des Template zwingend angelegt werden.
  6. Jedes Template benötigt eine index.tpl
  7. Sofern im Backend ein Vorschaubild des Template dargestellt werden soll, muss eine PNG-Datei mit dem Dateinamen "preview.png" an oberster Ebene im Template-Ordner hinterlegt werden.

TIPP! 

Du könntest dir aus unserem Template-Store ein beliebiges Template herunterladen und dieses als Vorlage für den Aufbau von deinem Template verwenden. Denk dabei daran, einen eigenen Template-Namen zu vergeben und alle Dateien entsprechend umzubenennen!

Custom-Template Datenstruktur Beispiel

  • /template/beispiel_template/
    • _resources/
      • /img
        • beispiel_bild.jpg
      • /css
        • beispiel_template.less
      • /js
        • beispiel_template.js
    • /mail_templates/
      • default.html
      • system_message.html
    • maintenance.html
    • index.tpl
    • preview.png
    • template.inc.php

template.inc.php | Beispiel

Alle Angaben aus der template.inc.php müssen vorhanden sein, aber nicht zwingend genutzt werden.


TEMPLATE_TYPE
Definiert, um welchen Templatetyp es sich handelt:

  • normal 
  • fullpage


Class
Muss den gleichen Namen wie der Template-Ordner haben.


$label
Lesbarer Templatename, der auch im Backend angezeigt wird


$author & $author_email
Name des Autor sowie E-Mail Adresse des Autor.


$version
Versionierung des Templates.


$required_minCore
Die mindestens erforderliche alphaNEXT Version für dieses Template.


info()
Gibt die Beschreibung des Template im Backend aus.


install()
Optionale Anweisungen z.B. für Automatische Änderung von Templatetyp, Farben,... bei Installation

PHP-START
defined('TEMPLATE_TYPE') or define('TEMPLATE_TYPE', 'normal');

class fullwidth_nav {

public label = ' Beispiel Template';
public author = 'Beispiel Author';
public author_email = 'beispiel@alphanext.de';
public version = '1.0.0';
public required_minCore= '3.3.0';
public function info(){

return "Das ist meine Beispiel Template-Beschreibung."; }

function install() {
pdo = GLOBALS['pdo'];
return true;
}
}
}
PHP-END

Zurück zur Übersicht