====== Admidio Sprachanpassungen-Plugin — ändern, wie Admidio formuliert ======

{{admidioplugins>info}}

==== Beschreibung ====
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.

==== Downloads ====
<WRAP download 60%>
{{admidioplugins>releases}}
</WRAP>

==== Installation ====
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).

==== Funktionsweise ====
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.

==== Gut zu wissen ====
  * 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.

==== Dateien und Sicherungen ====
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“).

==== Einstellungen ====
**Administration → Einstellungen → Inhalt → Sprachanpassungen**

^ Einstellung ^ Standard ^ Bedeutung ^
| Sicherungen pro Sprache | 20 | Wie viele Kopien jeder Anpassungsdatei im Sicherungsordner aufbewahrt werden; 0 schaltet die Kopien ab. |
| Installationstexte durchsuchen | aus | Die Texte, die nur die Installation und das Update anzeigen (''INS_…''), werden von der Suche ausgelassen, solange dies nicht eingeschaltet ist. |

==== In dieser Version nicht enthalten ====
  * 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.

==== Quellcode ====
Der Quellcode ist auf [[https://github.com/kainhofer/admidio-language-overrides|GitHub]] verfügbar.