Kompakte Anleitung Installation Addon XYZ

1. Inhalt ZIP-Paket
=====================

- 2 ZIP-Archive

I. doku
- Schnellinstallation.txt (diese Anleitung hier)
- pwd.txt (enthält Kennwort für Start der Installation)
- sonstige Dokumentationen

II. inhalt
- wesentlicher Inhalt; muß auf Server kopiert werden
- Addon-spezifisch
- enthält 3 Dateien + 1 Ordner:

Datei    install-addon.php               (Installationsprogramm)
Datei    install-addon-config.conf       (Parameter Install-Routine)
Datei    install-addon-usersyntax.txt    (Benutzerdefinierte Syntaxelemente)
Ordner   addons/
            packages/
                XYZ???/           (Addon-name: z. B. akk-box, grid-box, ...)
                    XYZ???.css    (Name CSS-Datei)
                    own_js.js           (Name JS-Datei; für alle Addons gültig)
                    ...                 (zusätzliche Daten / Ordner)
            receipts/                   (Protokolle)
            backups/                    (Backup; Dateien vor Moddifikation)
    
2. Installation
===============
2.1. Schaffung Voraussetzungen
- Name des Layouts bereithalten (im Ordner layouts), welches um Addon erweitert werden soll
- Kennwort / Token (in Datei pwd.txt)
- Inhalt von inhalt.zip (3 Dateien + 1 Ordner) im root des Servers ablegen; bereits Vorhandenes überschreiben

2.2. Installation starten
- Aufruf install-Routine mit:
  localhost/install-addon.php
  oder
  domain/install-addon.php

2.3. Bedienoberfläche Install-Routine
- Ausfüllen: Layoutname, Kennwort
- Wählen: Installation / Deinstallation
- A) Simulationslauf zum Prüfen - Bildschirmausschrift / Protokolle beachten!
- B) echte Installation nach erfolgreicher Simulation wählen
****************************************************************************

3. Manuelle Installation
========================
Das ganze läßt sich auch manuell realisieren, ohne Install-Routine.
1. CSS-Datei (addonname.css) in Ordner css kopieren
2. JS-DAtei (own_js.js) in Ordner js kopieren
3. zusätzliche Ordner mit Daten (icons, fonts, images, ...) in Ordner css kopieren
4. addonname.css in style.css einbinden
5. own_js.js in template.html einbinden
6. Benutzer-Syntax-Elemente aus Datei install-addon-usersyntax.txt kopieren und in Admin --> Einstellungen bei benutzerspezifischen Syntaxelementen einfügen / anhängen
7. Beispiel aus Schnellinstallation kopieren und in Inhaltsseite einfügen
****************************************************************************

4. Test Addon auf Website
=========================
4.1. Einbau Benutzer-Syntax-Elemente

[akkordeon_container = styling-class optional(*)|
[akkordeon_element = Titel Klickbalken | versteckter Inhalt]
]

Modifikationen:
- (*) optionale Klasse für Styling; leer ist Stadardaussehen
- momentan verfügbar: is-compact,  theme-softblue , light-sky , warm-sand , dark-slate , is-inline 

4.2. Testbeispiel

Folgendes Beispiel ist lauffähig (inkl. benötigter Demodaten). Komplett in eine Inhaltsseite kopieren.

WICHTIG! Evtl. harter Reload der Seite mit STRG + F5

---- Beispiel Anfang -----------------

[akkordeon_container=|
[akkordeon_element=Titel 1|Inhalt des ersten Klickbalkens]
[akkordeon_element=Titel 2|Inhalt des zweiten Klickbalkens]
[akkordeon_element=Titel 3|Inhalt des dritten Klickbalkens]
]

---- Beispiel Ende -------------------

