bloqyDokumentation

Entwicklung

Automationen

PHP-Skripte, die Seiten und Medien ändern, per Hand, nach Zeitplan oder bei Ereignissen.

Automationen sind PHP-Dateien in /config/automations/<name>.php, die Seiten und Medien ändern dürfen, im Gegensatz zu PHP-Snippets. Sie laufen nie während eines Seitenaufrufs, sondern von Hand, nach Zeitplan oder bei Ereignissen. Du findest sie unter Entwicklung → Automationen (Recht „Automationen“, standardmäßig nur Admin).

Liste der Automationen mit Cron-Adresse
Entwicklung → Automationen

Was sie können

Alle Lese-Funktionen der PHP-Snippets und zusätzlich zum Beispiel bloqy_update_page(), bloqy_set_status(), bloqy_update_blocks(), bloqy_create_page(), bloqy_media_update(), bloqy_mail(), bloqy_http_get() und bloqy_log().

Vorlagen beim Anlegen: Alt-Text aus Dateiname, Abgelaufene Seiten offline, PDF-Vorschau bei Upload, Formular-Eingang ans Team, SEO-Beschreibung ergänzen.

Sicher ausführen

  1. Probelauf: führt den Code aus und listet, was sich ändern würde. Gespeichert wird nichts.
  2. Ausführen: Änderungen gehen sofort live.
  3. Im Protokoll steht jede Änderung mit dem vorherigen Stand. Ein Lauf lässt sich dort zurücknehmen.

Seiten, die gerade jemand im Editor offen hat, werden übersprungen. Höchstens 500 Änderungen und 120 Sekunden je Lauf.

Auslöser

  • Zeitplan an der Automation: stündlich, täglich zu einer Uhrzeit oder wöchentlich.
  • Ereignisse hängen an Ordnern: Rechtsklick auf einen Ordner → Eigenschaften → Reiter Automationen. Seitenordner: Seite gespeichert, veröffentlicht, offline genommen, angelegt, gelöscht, Formular gesendet. Medienordner: Datei hochgeladen. Unterordner erben die Auswahl.

Für pünktliche Zeitpläne richte die Cron-Adresse ein; ohne Cron laufen sie nach Seitenaufrufen.

Benachrichtigung

Je Automation: E-Mail an alle Admins bei Fehlern (Standard), nach jedem Lauf mit Änderungen oder keine. Die Übersicht zeigt Automationen, die in den letzten 7 Tagen mit Fehler abgebrochen sind.

Referenz: docs/automationen.md deiner Installation. Automationen müssen in der Lizenz enthalten sein.