Die Bearbeiten-Variablen

für die Liste aller Seiten

Zum Setzen der meisten der unten aufgeführten Variablen tragen Sie sie in die config.php-Datei ein.

$AutoCreate

wird in Verbindung mit der 'AutoCreateTargets edit'-Funktion benutzt, dies Array enthält einen Satz von Seiten, die erzeugt werden sollen, falls sie nicht existieren. Die Syntax ist:

    $AutoCreate[REGEXP] = PAGE_PARAMETERS;

wobei REGEXP ein regulärer Ausdruck ist, der die automatisch zu erzeugenden Seiten identifiziert und PAGE_PARAMETERS ein Array von Attributen für die neu zu erzeugenden Seiten ist. Zum Beispiel:

    $AutoCreate['/^Category\\./'] = array('ctime' => $Now);

erzeugt eine leere Seite mit der aktuellen Erstellungszeit für alle fehlenden Kategorien-Seiten.

$DefaultPageTextFmt

Der Text, der angezeigt werden soll, wenn eine Seite nicht gefunden wurde. PmWiki benutzt dazu den Inhalt der Seite Site.PageNotFound.

$DefaultPageTextFmt = '(:include $[{$SiteGroup}.PageNotFound]:)';

$DeleteKeyPattern

Das Muster, das verwendet wird, um zu löschende Seiten zu markieren. Der Standard ist, dass Seiten gelöscht werden, die nur das eine Wort "delete" und sonst höchstens Leerzeichen enthalten.

## ändere Löschenwort auf "remove":
$DeleteKeyPattern = "^\\s*remove\\s*$";
## lösche Seiten ohne sichtbaren Text, d. h. leere Seiten:
$DeleteKeyPattern = "^\\s*$";

$DiffKeepDays

Diese Variable setzt die minimale Zeitspanne fest, während der die Versionen von Änderungen aufbewahrt werden. Standard sind 3650 Tage, fast 10 Jahre. Sie können den Wert durch einen Eintrag in eine Anpassungsdatei (z. B. local/Gruppe.Seitenname.php) verringern, z. B.:

    $DiffKeepDays = 30; # Revisionen wenigstens 30 Tage aufbewahren

Wollen Sie für eine Seite die Versionen der Änderungen ganz unterdrücken, fügen Sie in die Anpassungsdatei das Folgende ein:

    $DiffKeepDays = $DiffKeepNum = -1; # suppress revision history

(siehe auch Individuelle Anpassungen pro Seite)

Beachten Sie, dass eine bestimmte Seitenrevision nicht gelöscht wird, bis die Seite nach der eingestellten Zeit wieder geändert wird. So ist es immer noch möglich, Seiten wiederherzustellen, deren Änderung länger zurückliegt als die eingestellte Zeitspanne, wenn sie nach dieser Zeit nicht mehr angerührt wurden. Die Änderungen werden bei der nächsten Änderung (z. B. bei eben diesem Wiederherstellen) gelöscht.

$DiffKeepNum

Diese Variable enthält die Mindestzahl an Änderungen, die in den Versionen aufgehoben werden, sogar wenn einige von ihnen älter sind als die eingestellte Grenze $DiffKeepDays. Das verhindert den Verlust von Änderungen auf Seiten, die lange bestehen, aber selten geändert wurden.

## Behalte wenigstens 50 Änderungen (Standard ist 20): 
$DiffKeepNum = 50;

Um die Aufbewahrung der Änderungen mit $DiffKeepNum = -1 zu unterdrücken, siehe $DiffKeepDays weiter oben.

$DraftActionsPattern

Die Aktionen, die es erlauben, die volle draft.php-Funktionalität für eigenen Aktionen zu laden. Voreingestellt ist 'edit'. Sie können Entwürfe auch für weitere Aktionen aktivieren:

## Aktiviere Entwürfe für die Aktionen 'edit', 'pmform' und 'translate':
$DraftActionsPattern = 'edit|pmform|translate';

$DraftSuffix

Der Anhang für die Entwurfsversion von Seiten (Standard ist "-Draft").

$EditFunctions

Dieses Array enthält die Sequenz der Funktionen, die aufgerufen werden, wenn eine Seite editiert wird. Es kann angepasst werden, um zusätzliche Funktionen einzufügen und diese zum Bestandteil des Veröffentlichungsprozesses zu machen. Die Standardeinstellung ist:

$EditFunctions = array('EditTemplate', 'RestorePage', 'ReplaceOnSave',
                       'SaveAttributes', 'PostPage', 'PostRecentChanges',
                       'AutoCreateTargets', 'PreviewPage'); 

Viele Rezepte manipulieren dieses Array, deshalb wird empfohlen, statt das komplette Array neu zu definieren, Funktionen wie array_unshift(), array_push() und array_splice() zu benutzen.

$EditRedirectFmt

Die Seite, zu der ein Autor geführt wird, nachdem er den Speichern- oder Abbrechen-Button in dem Editierformular gedrückt hat, per Standard gesetzt auf "$Fullname", wodurch der Autor auf die gerade bearbeitete Seite geführt wird, aber das kann verändert werden, um eine andere Seite anzuzeigen.

## Umleiten zur Hauptstartseite Main.HomePage:
$EditRedirectFmt = 'Main.HomePage';  
## Umleiten zur Startseite der aktuellen Gruppe:
$EditRedirectFmt = '{$Group}.HomePage';

$EditTemplatesFmt

Name der Seite (oder ein Array von Namen), die als Vorlage benutzt wird (werden) für neu anzulegende Seiten.

## Benutze 'Main.NewPageTemplate' als Standardtext für alle neuen Seiten:
$EditTemplatesFmt = 'Main.NewPageTemplate';
## Benutze 'Template' in der aktuellen Gruppe als Vorlage:
$EditTemplatesFmt = '$Group.Template';
## Benutze 'Template' in der aktuellen Gruppe, wenn die Datei existiert,
## andernfalls benutze 'Main.NewPageTemplate':
$EditTemplatesFmt = array('$Group.Template', 'Main.NewPageTemplate');

$EnableDrafts

Wenn diese Variable auf '1' gesetzt wird, wird unterm 'Bearbeiten'-Fenster ein 'Als Entwurf speichern'-Button angezeigt und die eingebaute Handhabung von Entwürfen eingeschaltet, wobei

1. erstmaliges 'Als Entwurf speichern' einer existierenden Seite ("SeitenName") die Änderungen in einer neuen Seite mit dem Namen ("SeitenName-Draft") speichert,
2. nachfolgende Versuche, "SeitenName" zu bearbeiten, in der Bearbeitung von "SeitenName-Draft" münden,
3. nachfolgendes 'Als Entwurf speichern' das Speichern der Änderungen in der Datei "SeitenName-Draft" bewirkt,
4. erst der Button 'Veröffentlichen' das Speichern der Änderungen in der Datei "SeitenName" und das Löschen des Entwurfes "SeitenName-Draft" bewirkt,
5. ein Aufruf der Seite ohne ''action=edit' die "alte" Seite anzeigt.

   ## Einschalten der Entwurfsversionen:
   $EnableDrafts = 1;

Eine verwandte Variable, $EnablePublishAttr, fügt eine neue Ebene zum Autorisieren der Veröffentlichung ein, um eine Unterscheidung zwischen dem Editieren von Entwürfen und deren Veröffentlichung zu erreichen.

$EnableDraftAtomicDiff

Wenn diese Variable auf '1' gesetzt wird, werden durch das Veröffentlichen eines Entwurfes die Entwurfsversionen gelöscht. Es bleibt eine einzige alles zusammenfassende Änderung (diff) übrig zwischen der zuvor veröffentlichten Version und der letzten veröffentlichten Version, dem nun veröffentlichten letzten Entwurf.

Beachten Sie, dass dadurch auch die Autorennamen, die Daten und die Beiträge der unveröffentlichten Entwurfsversionen gelöscht werden. (Drafts müssen aktiv sein, siehe $EnableDrafts.)

$EnableGUIButtons

Wenn diese Variable auf '1' gesetzt wird, werden die grafischen Buttons am oberen Rand der Editierfeldes angezeigt.

## Schalte die grafischen Bearbeiten-Buttons ein:
$EnableGUIButtons = 1;

$EnableGuiEditFixUrl

Aktiviert einen -Button im Editor, der dabei hilft, spezielle Zeichen in URL-Links zu kodieren, siehe Cookbook:GuiButtons. Enthält der Link die Zeichen <>"{}|\^`()[]', müssen diese durch ihre Prozentdarstellung ersetzt werden.(z. B. '%20' für ein Leerzeichen, siehe Cookbook:FixURL). $EnableGUIButtons muss dazu aktiviert sein.

## Setze den Button weit nach rechts in der Buttonleiste:
$EnableGuiEditFixUrl = 2000;

$EnablePreviewChanges

Wenn diese Variable auf '1' gesetzt wird, zeigt die "Vorschau"-Funktion die hervorgehobenen Änderungen im Wiki-Quelltext vor der erstellten Seitenvorschau. Siehe Cookbook:PreviewChanges.

$EnablePreviewChanges = 1;

$EnablePostAuthorRequired

Wenn diese Variable auf '1' gesetzt wird, erfordert das Bearbeiten von Seiten – eigentlich erst das Speichern der Seiten – die Angabe eines Autorennamen. Andernfalls kann ohne einen Namen gearbeitet werden, als Autorenname erscheint dann die IP des Autors.

## Verlange vom Autoren die Angabe eines Namen:
$EnablePostAuthorRequired = 1;

$EnableUploadAuthorRequired

Diese Variable bestimmt, ob das Hochladen von Dateien die Eingabe des Namen des Hochladenden erfordert (hinzugefügt in 2.2.117). Wenn diese Variable nicht gesetzt ist, wird die Variable $EnablePostAuthorRequired ausgewertet.

$EnableRevUserAgent

Wenn diese Variable auf '1' gesetzt wird, wird der "User agent"-String des Browsers in den Seitenversionen gespeichert (standardmäßig ist das deaktiviert). Das kann nützlich sein, wenn man Fehler in einer eigenen Applikation aufspüren will, indem man die Dateien in wiki.d/ untersucht.

## Speichere den "User agent" des Browsers in den Seitenversionen:
$EnableRevUserAgent = 1;

$GUIButtons

Erlaubt die Konfiguration der Schaltflächen, die über dem Eingabefeld erscheinen, wenn man eine Seite bearbeitet. Siehe scripts/guiedit.php wegen der Standarddefinition. Beachten Sie, dass das fünfte Element auch HTML-Kode sein kann anstelle des URL einer GIF-Datei – das erlaubt mehr Flexibilität in der Definition des diesbezüglichen JavaSkripts.

$HandleEditFmt

Wie $HandleBrowseFmt gibt dies das vollständige Ausgabeformat einer Seite für ?action=edit an.

$IsPagePosted

wird auf einen Wahr-Wert gesetzt, wenn die Seite aktuell gespeichert wurde (das wird z. B. benutzt, um den 'Aktuelle Änderungen'-Behandlern (RecentChanges handlers) zu signalisieren, dass ein Update nötig ist.

$PageEditFmt

ist per Standardeinstellung der HTML-Kode, der als Editformular angezeigt wird.

$PageEditForm

gibt das Editformular für die Aktion Edit (?action=edit) an, standardmäßig '$SiteGroup.EditForm'.

$ROEPatterns

Mit diesem Array können Sie Muster als Schlüssel hinzufügen und Text als Wert setzen, der das Muster bei jedem Aufruf zum Editieren ersetzt, wobei die preg_replace-Funktion benutzt wird. Insbesondere werden die Ersetzungen vorgenommen, wenn die Seite in das Editierformular eingefügt wird, wann auch immer eine Vorschau vorgenommen wird und wenn die Seite gespeichert wird. (ab PmWiki 2.2.0beta45). Siehe Cookbook:ROSPatterns für Beispiele.

$ROSPatterns

Mit diesem Array können Sie Muster als Schlüssel hinzufügen und Text als Wert setzen, der das Muster ersetzt, wenn die bearbeitete Seite veröffentlicht wird (geposted wird), wie es durch die Variable $EnablePost signalisiert wird. Das Muster wird weder ersetzt, wenn die Seite in das Editierformular eingefügt wird, noch wenn eine Vorschau vorgenommen wird, sondern nur, wenn die Seite gespeichert wird. Siehe Cookbook:ROSPatterns für Beispiele.

$EnableROSEscape

Wenn diese Variable auf '1' gesetzt wird, werden die $ROEPatterns- und die $ROSPatterns-Ersetzungen geschützten Text (umgeben von [=...=] oder [@...@]) überspringen. Nicht gesetzt oder auf 0 gesetzt werden die Ersetzungen sogar in geschütztem Text vorgenommen.

Kategorie: PmWiki Developer für die Liste aller Seiten