Dokumentation

Einfache Dokumentation zu meiner Software

Inhaltsverzeichnis
  1. Ressourcen-Caching
  2. CMS optimieren
  3. Meta-Tags
  4. Javascript
  5. SEO-URLs
  6. Bewertungssystem
  7. Config.php & Codes
  8. Cronjobs einrichten
Inhaltsverzeichnis
  1. Ressourcen-Caching
  2. CMS optimieren
  3. Meta-Tags
  4. Javascript
  5. SEO-URLs
  6. Bewertungssystem
  7. Config.php & Codes
  8. Cronjobs einrichten

Vorwort

Baroni Suite™ kannst du mit der mitgelieferten .htaccess im Hauptverzeichnis optimieren. Damit hilfst du nicht nur Suchmaschinen beim Indexieren, sondern kannst auch Ressourcen auf deinem Server sparen. Eine passende .htaccess ist bereits enthalten und kann auf deine Wünsche angepasst werden.

1. Ressourcen-Caching

Browser-Caching sorgt für schnellere Ladezeiten und spart Datenvolumen. Die mitgelieferte .htaccess enthält bereits eine entsprechende Grundkonfiguration. Falls du die Einstellungen selbst anpassen möchtest, kannst du dich an folgendem Aufbau orientieren: 
###########

# CACHING

###########

# Aktiviert Symbolische Links (falls noch nicht gesetzt)

Options +FollowSymLinks

# Ablaufdatum (Expires) für verschiedene Dateitypen setzen

<IfModule mod_expires.c>
  ExpiresActive On

# Bilder

ExpiresByType image/x-icon "access plus 7 days"
ExpiresByType image/gif "access plus 7 days"
ExpiresByType image/jpg "access plus 7 days"
ExpiresByType image/jpeg "access plus 7 days"
ExpiresByType image/png "access plus 7 days"
ExpiresByType image/webp "access plus 7 days"

# CSS und JavaScript

ExpiresByType text/css "access plus 7 days"
ExpiresByType text/javascript "access plus 7 days"
ExpiresByType application/javascript "access plus 7 days"
ExpiresByType application/x-javascript "access plus 7 days" </IfModule>

# Cache-Control Header setzen

<IfModule mod_headers.c>
  <FilesMatch ".(ico|jpe?g|png|gif|swf|webp)$">
    Header set Cache-Control "max-age=604800, public"
  </FilesMatch>

<FilesMatch ".css$">
Header set Cache-Control "max-age=604800, private" </FilesMatch>

<FilesMatch ".js$">
Header set Cache-Control "max-age=604800, private" </FilesMatch>

Header unset ETag </IfModule>

FileETag None

2. CMS optimieren

Mach deinen Webauftritt fit für Suchmaschinen und deine Besucher.
Leg in deinem Theme-Ordner (/themes/NAME) eine Datei doctype.php an mit folgendem Inhalt: 
<!DOCTYPE html>
Baroni Suite™ verwendet diese Datei automatisch, wenn sie im aktiven Theme vorhanden ist.

2.1 Meta-Tags

Zusätzliche Meta-Tags und andere Inhalte für den Head-Bereich kannst du über eine meta.php in deinem Theme-Verzeichnis einbinden. Ein einfaches Beispiel: 
<meta name="description" content=""> <meta name="generator" content="Copyright (c) 2026 by Tobias Baroni">
Baroni Suite™ erzeugt verschiedene Meta-Informationen wie Beschreibung und Keywords zusätzlich dynamisch anhand der jeweiligen Seite bzw. des jeweiligen Moduls.
Die meta.php kannst du für zusätzliche Inhalte verwenden, die im Head-Bereich deiner Webseite benötigt werden.

2.2 Javascript

Eigene Javascript-Dateien kannst du über eine javascript.php in deinem Theme-Ordner einbinden. Baroni Suite™ lädt diese Datei automatisch im Head-Bereich des Themes. Beispiel: 
<script src="themes/NAME/assets/js/app.js" defer></script>
Wenn ein Script nicht direkt für den Seitenaufbau benötigt wird, solltest du nach Möglichkeit defer verwenden. Dadurch kann der Browser die Seite weiter aufbauen, während die Javascript-Datei geladen wird.

3. SEO-URLs

In der mitgelieferten .htaccess findest du bereits Beispiele für SEO-URLs. Diese kannst du entsprechend anpassen. Damit die internen Links ebenfalls zu deinen URLs passen, werden die entsprechenden Pfade in der config.php festgelegt: 
$maintenancepath = "maintenance";
$joinuspath = "register";
$startsitepath = "home";
$feedbackpath = "contact";
$protectedpath = "protected";
$shopdetails = "products_";
$shopaddpath = "order";
$shopcheckoutpath = "orderprocess";
$storedetails = "products_";
$storeaddpath = "order";
$storebasketpath = "basket";
$storecheckoutpath = "orderprocess";
URLs anpassen – fertig.

4. Bewertungssystem

Baroni Suite™ hat ein eingebautes Bewertungssystem, das du in dein Theme einbauen kannst. Füge dafür folgenden Code an der gewünschten Stelle ein: 
<script src="ratings.php?op=widget" type="text/javascript"></script>
Aktivieren und konfigurieren kannst du das Bewertungssystem unter Kunden Module → Bewertungen → Einstellungen. Jetzt können deine Kunden Bewertungen abgeben.
Eine Bewertung kann entsprechend der vorgenommenen Einstellungen nach einer Bestellung bzw. Zahlung angefordert werden. Die Benachrichtigung kann per Mail und im Kundenbereich erfolgen.

5. Config.php & Codes

Du kannst verschiedene Funktionen von Baroni Suite™ über Codes in der config.php steuern.

Shop & Store Einstellungen

$shopcodes = "0000000";
Die einzelnen Stellen können je nach Funktion durch 0, 1 oder 2 ersetzt werden.
Telefon 
$shopcodes = "X000000";
  • 0 – Pflichtfeld
  • 1 – freiwillig
  • 2 – wird nicht angezeigt
Kunden Login 
$shopcodes = "0X00000";
  • 0 – wird angezeigt
  • 1 – wird nicht angezeigt
Lieferanschrift 
$shopcodes = "00X0000";
  • 0 – wird abgefragt
  • 1 – wird nicht abgefragt, ist gleich der Rechnungsanschrift
Kundenkonto-Erstellung 
$shopcodes = "000X000";
  • 0 – wird bei Bestellung angelegt
  • 1 – wird nicht angelegt
Versandart 
$shopcodes = "0000X00";
  • 0 – wird abgefragt
  • 1 – wird nicht abgefragt
Widerrufsrecht anzeigen 
$shopcodes = "00000X0";
Das Widerrufsrecht solltest du nur deaktivieren, wenn dies für deinen konkreten Anwendungsfall rechtlich passend ist.
  • 0 – Aktiviert
  • 1 – Deaktiviert
Automatischer Rechnungsversand nach einer Bestellung 
$shopcodes = "000000X";
  • 0 – Aktiviert
  • 1 – Deaktiviert

Kundenbereich & Globale Einstellungen

Für die aktuellen Einstellungen werden 7 Stellen verwendet: 
$wicodes = "0000000";
Jede Stelle besitzt eine eigene Funktion. Das X in den folgenden Beispielen ersetzt du durch den gewünschten Wert.
Kundenbereich (members.php) und Kundenverwaltung im Adminbereich 
$wicodes = "X000000";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Ist diese Einstellung deaktiviert, wird der Aufruf von members.php auf die normale Webseite umgeleitet und der Menüpunkt "Kunden" im Adminbereich ausgeblendet.
Kundenkonto bearbeiten 
$wicodes = "0X00000";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Damit steuerst du, ob ein Kunde seine Profildaten im Kundenbereich selbst bearbeiten kann.
Kündigung im Kundenbereich 
$wicodes = "00X0000";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Damit steuerst du, ob Kunden ihre Produkte bzw. Verträge direkt über den Kundenbereich kündigen können.
Anzahl offener Rechnungen im Adminbereich 
$wicodes = "000X000";
  • 0 – Standardwert: maximal 20 offene Rechnungen
  • 1 bis 9 – maximale Anzahl entsprechend der eingetragenen Zahl
Diese Stelle ist keine einfache An/Aus-Einstellung. Baroni Suite™ verwendet den Wert als Limit für die Liste der offenen Rechnungen. Da nur eine Stelle ausgewertet wird, sind hier praktisch nur die Werte 0 bis 9 sinnvoll.
Spenden im Kundenbereich 
$wicodes = "0000X00";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Damit steuerst du den Spenden-Bereich im Kundenbereich.
Kundenbereich Menüpunkt "Eigene Erweiterungen" 
$wicodes = "00000X0";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Adminbereich Menüpunkt "Eigene Erweiterungen" 
$wicodes = "000000X";
  • 0 – Aktiviert
  • 1 – Deaktiviert
Eine achte Stelle wird vom aktuellen Baroni Suite™ Code nicht ausgewertet.

Wartungsmodus

Aktivieren kannst du den Wartungsmodus unter CMS Module → Module. 
$maintenancecodes = "00000000000";
Setze eine Stelle von 0 auf 1, um das entsprechende Modul in den Wartungsmodus zu versetzen. Die Reihenfolge lautet:
  • 1 – Blog
  • 2 – FAQ
  • 3 – Feedback
  • 4 – Forum
  • 5 – Registrierung
  • 6 – News
  • 7 – Profil
  • 8 – Sections
  • 9 – Shop
  • 10 – Store
  • 11 – Kunden Login
Beispiel: 
$maintenancecodes = "10000000000";
Damit befindet sich das Blog-Modul im Wartungsmodus.

6. Cronjobs einrichten

Baroni Suite™ benötigt Cronjobs für verschiedene Automatisierungen wie Rechnungen, Prepaid-Laufzeiten und Mahnungen. Die Cronjobs sollten unter dem Webserver-Benutzer www-data ausgeführt werden. Öffne dafür: 
crontab -u www-data -e
Füge anschließend beispielsweise folgende Cronjobs ein und ersetze PASSWORT durch deinen in Baroni Suite™ hinterlegten Cron-Schlüssel: 
# ===================== #

# Baroni Suite Cronjobs

# =====================

BSPASSWORD="PASSWORT"

# Rechnungsmonat abschließen

0 0 1 * * wget --no-check-certificate -q --post-data="op=finoutperiod&key=$BSPASSWORD" "https://localhost/jobs.php"

# Rechnungen erstellen

0 8 * * * wget --no-check-certificate -q --post-data="op=createbill&key=$BSPASSWORD" "https://localhost/jobs.php"

# Prepaid Berechnung

0 9 * * * wget --no-check-certificate -q --post-data="op=prepaid&key=$BSPASSWORD&days=1" "https://localhost/jobs.php"

# Rechnungen versenden

0 12 * * * wget --no-check-certificate -q --post-data="op=sendbill&key=$BSPASSWORD" "https://localhost/jobs.php"

# Mahnstufe prüfen, Mahnung erstellen und versenden

0 13 * * * wget --no-check-certificate -q --post-data="op=reminder&key=$BSPASSWORD" "https://localhost/jobs.php"

# ==========================

# Ende Baroni Suite Cronjobs

# ========================== #

Cronjobs erklärt

  • finoutperiod – Wird einmal am Monatsanfang ausgeführt und legt die nächste Finanzperiode an bzw. archiviert die entsprechenden Geschäftsvorfälle.
  • createbill – Prüft täglich alle abrechenbaren Kundenpakete und erstellt nur Rechnungen, deren nächstes Rechnungsdatum erreicht ist.
  • prepaid – Verarbeitet die Prepaid-Laufzeiten.
  • sendbill – Erstellt die finalen Rechnungs-PDFs und versendet noch nicht versendete Rechnungen.
  • reminder – Prüft fällige Rechnungen und verarbeitet die entsprechende Mahnstufe.
Zwischen createbill und sendbill sollte ausreichend Zeit liegen, damit neu erstellte Rechnungen vor dem Versand bei Bedarf noch geprüft werden können.
Damit die Cronjobs über https://localhost/jobs.php auf die richtige Baroni Suite™ Installation zugreifen, muss localhost als ServerAlias in der aktiven Apache2-VHost-Konfiguration eingetragen sein. Öffne dafür die aktive Konfiguration deiner Domain, zum Beispiel: 
nano /etc/apache2/sites-available/DOMAIN.conf
Ergänze im passenden <VirtualHost> neben deinem ServerName: 
ServerName DOMAIN
ServerAlias localhost
Speichere die Datei und prüfe anschließend die Apache-Konfiguration: 
apache2ctl configtest
Wenn Syntax OK angezeigt wird, lade Apache2 neu: 
systemctl reload apache2
Füge ServerAlias localhost nur der aktiven Apache2-Konfiguration hinzu, über die auch deine Baroni Suite™ Installation erreichbar ist.