Unterschiede

no way to compare when less than two revisions

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

@@ Zeile 1: / Zeile 1: @@
+====== 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.