Admidio Sprachanpassungen-Plugin — ändern, wie Admidio formuliert

Erlaubt Administratoren, alle Texte von Admidio zu durchsuchen und beliebige davon durch eigene Formulierungen zu ersetzen, zum Beispiel „Mitgliederliste“ statt „Kontakte“, ohne XML-Dateien zu bearbeiten.

Gehe als Administrator zum Plugin-Manager von Admidio (Admidio 6.0 oder neuer und PHP 8.2 oder neuer erforderlich), wähle „Plugin hinzufügen“, lade die Plugin-ZIP-Datei hoch und aktiviere das Plugin. Das Plugin hat keine Datenbanktabellen. Seine Seite erscheint im Menü unter Erweiterungen nur für Administratoren. Seine Texte gibt es auf Englisch und Deutsch (Du- und Sie-Form).

Admidio liest adm_my_files/languages/<Sprache>.xml vor seiner eigenen Sprachdatei dieser Sprache (und vor den Sprachdateien der Plugins); ein Eintrag in einer solchen Datei ersetzt also den Text. Das Plugin ist die Oberfläche für diese Dateien:

• Text finden: Live-Suche (während der Eingabe) nach dem, was ein Text sagt, oder nach seiner Text-ID, in einer im Auswahlfeld gewählten Sprache und, wenn angehakt (Standard), auch in Englisch. Mit angehaktem „Regulärer Ausdruck“ ist die Suche ein PHP-Ausdruck (PCRE), ohne Groß-/Kleinschreibung und ohne Begrenzer, der gegen die Texte, wie sie in den Dateien stehen (^Kont.*e$), und gegen die Text-IDs geprüft wird; ein ungültiger Ausdruck wird gemeldet. Durchsucht werden Texte des Kerns und der Plugins. Texte, die nur das Installationsprogramm anzeigt (INS_…), werden ausgelassen, sofern die Einstellung nichts anderes sagt.
• Text ändern: zeigt das Original und deinen Text für die Sprache, und für Englisch, wenn angehakt. Ein Text, der dem Original entspricht, entfernt die Anpassung; eine Sprache, die du nicht bearbeitet hast, wird nicht geschrieben. Für Deutsch gibt ein Kontrollkästchen (standardmäßig angehakt) der anderen Anredeform, de (Du) oder de-DE (Sie), denselben Text.
• Deine Anpassungen: alle Einträge aller Anpassungsdateien mit ihrem Original und diesen Zuständen: Der Originaltext wurde seit dem Schreiben der Anpassung durch ein Update geändert, die Text-ID existiert nicht mehr, oder die Anpassung lässt einen Wert (#VAR1#) aus, den das Original zeigt. „Original wiederherstellen“ entfernt eine Anpassung.

• Eine Anpassung gehört zu einer Sprache. Ein in en geänderter Text wird von Benutzern von de nicht gesehen, weil die deutsche Datei den Text bereits enthält. de und de-DE sind getrennte Sprachen.
• Anpassungen gelten für die gesamte Installation, nicht für eine einzelne Organisation.
• Nur Text-IDs, die Admidio nachschlägt, können geändert werden. Namen, die Benutzer in die Datenbank eingegeben haben (Rollen, Kategorien, Listen), und die Ländernamen sind keine Sprachtexte.
• Einträge tragen ein Attribut original mit dem Text des Kerns zum damaligen Zeitpunkt. Admidio ignoriert es.
• Ein Text darf die Werte #VAR1#, #VAR2# … verwenden, die auch das Original verwendet. Ein Wert, der nicht im Original vorkommt, wird abgelehnt. Ein Zeilenumbruch wird als neue Zeile eingegeben und als \n gespeichert.
• Beim Speichern werden die laufenden Sitzungen neu aufgebaut; dadurch wird eine neue oder geänderte Datei auch für angemeldete Benutzer wirksam.

Eine Datei wird unter einer Sperre geändert, indem das vorhandene Dokument bearbeitet wird – Kommentare darin bleiben also erhalten –, und per Umbenennen ersetzt. Zuvor wird die alte Datei in den Sicherungsordner der Installation (die Einstellung system_backup_path, standardmäßig adm_my_files/backups/) in den Unterordner language-overrides/ kopiert, als <Sprache>-JJJJMMTT-HHMMSS-mmm.xml. Kann die Kopie nicht angelegt werden, wird nichts geändert.

Ein Formular, das geöffnet wurde, bevor jemand anderes die Datei geändert hat, wird abgelehnt („Text erneut öffnen“).

Administration → Einstellungen → Inhalt → Sprachanpassungen

• Suchen und Ersetzen eines Wortes über viele Texte, mit Vorschau.
• Export und Import der Anpassungsdateien, eine Kommandozeilenschnittstelle.
• Eine Prüfung der Auszeichnung in einem Text. Ein Text gelangt wie jeder Text von Admidio als HTML in die Seiten, und nur Administratoren können ihn schreiben.

Der Quellcode ist auf GitHub verfügbar.