FmtPageName()

für die Liste aller Seiten

Diese Seite beschreibt eine interne Funktion in PmWiki, die FmtPageName() heißt. Diese Seite ist nicht für Leute mit einem schwachen Herzen bestimmt ;-)

Siehe auch Funktionen

FmtPageName($fmt, $pagename)

Die Funktion gibt $fmt wieder zurück, nachdem darin $variable-Ersetzungen und Internationalisierung durchgeführt worden sind unter der Vorgabe, dass der Name der Seite $pagename ist. Dabei wird die Regel angewandt, dass zuerst die Variablen behandelt werden, deren Namen auf 'Fmt' endet (wie $GroupFooterFmt), aber auch solche Strings, die eine Interpolation erfordern, insbesondere die Seitenvorlagendatei (.tmpl). Siehe Variablen wegen einer (unvollständigen) Liste von zur Verfügung stehenden Variablen und Internationalisierungen wegen der Internationalisierung.

Die Funktion FmtPageName() wendet Internationalisierungs- und Variablen-Ersetzungen auf den String $fmt an unter der Vorgabe, der Name der aktuellen Seite sei $pagename.

Das Ersetzen geht so:

1. Ersetze alle Variablen der Form $XyzFmt durch den zugehörenden Wert einer globalen Variable.
2. Bearbeite den String wegen aller $[...] Phrasen (Internationalisierte Phrasen) mit Hilfe der aktuell geladenen Übersetzungstabelle.
3. Ersetze alle Vorkommen von {$ScriptUrl} durch $ScriptUrl (um die Abarbeitung der URI-Bearbeitungs-Phase hinauszuschieben).
4. Ersetze alle Vorkommen von Standard-Seiten-Variablen (beginnend mit einem Großbuchstaben, gefolgt von wenigstens einem Wortzeichen) durch ihre Werte. Hier werden seit Version 2.2.92 auch Seitenvariablen mit Sternen wie {*$FullName} ersetzt (siehe ReleaseNotes). Beachten Sie, dass SVs der Form {Group.Page$Var} nicht ersetzt werden. Wenn es keine weiteren $-Sequenzen gibt, gib den formatierten String zurück und beende die Funktion.
5. Führe alle Musterersetzungen aus dem Array $FmtP (P=pattern/Muster) durch. Typischerweise wird das verwendet, um Dinge wie $Name und $Group etc., die spezifisch für die aktuelle Seite sind, zu behandeln. Das scheint eingesetzt zu werden in robot.php, um Seitenverweise mit einer Aktion (z. B. Seite?action=edit) so umzuwandeln, dass ein Suchroboter ihnen nicht folgt (der Roboter wird gezielt hinters Licht geführt, siehe Sonstige Variablen).
6. Ersetze alle übrig gebliebenen Vorkommen von Seiten-Variablen durch ihre Werte. Annmerkung: Diese Variablen sind dann von der Form $Var , nicht von der übliche SV-Form {$Var}.
7. Wenn $EnablePathInfo nicht gesetzt ist, wandle URIs um in die Schreibweise $ScriptUrl?n=<Group>.<Name> anstelle von $ScriptUrl/<Group>/<Name>. Ersetze $ScriptUrl in beiden Fällen durch seinen Wert. Gibt es keine weiteren $-Sequenzen, gib den formatierten String zurück und beende damit die Funktion.
8. Ersetze alle $-Sequenzen durch globale Variablen gleichen Namens (nötigenfalls zwischenspeichern) in umgekehrter alphabetischer Reihenfolge, filtere alle unsicheren Globalen heraus.
9. Ersetze alle $-Sequenzen durch Werte aus dem Array $FmtV.

Anmerkung: FmtPageName() erkennt alle globalen Variablen automatisch. Allerdings existiert das Array $FmtV, weil globale Variablen zu ändern aufwändig ist. So wird das ständige Wiederaufbauen des Variablenzwischenspeichers für sich häufig ändernde Variablen vermieden.

Sicherheit

PM zufolge ist es generell unklug, die Funktion FmtPageName() für Strings aufzurufen, die aus Seiten-Markups stammen, denn das eröffnet Jemandem die Möglichkeit, Variablenwerte zu sehen, die er vielleicht nicht hätte sehen sollen. Das ist auch der Grund, warum Seiten-Variablen (die aus Markups stammen) PageVar() und PageTextVar() verwenden und nicht durch FmtpageName() gehen.

Erreichbarkeit von Variablen in FmtPageName

Um ganz präzise zu sein, das schreibt PM in Bezug auf verschiedene Wege, eine Variable zu definieren, die von FmtPageName verwendet werden kann (wenn es einen String formatiert):

• Setzen Sie eine globale Variable. FmtPageName() führt automatisch Ersetzungen durch für alle globalen Variablen, die keine Arrays sind. Wenn aber die Variable ihren Wert während wiederholter Aufrufe von FmtPageName() verändern wird, ist es möglicherweise besser, $FmtV zu verwenden wie im nächsten Punkt.
• Fügen Sie ein Variablen/Wert-Paar in das $FmtV-Array ein. $FmtV['$MyVariable']='something' bedeutet, ersetze alle Vorkommen von '$MyVariable' durch 'something'. Verwenden sie dies für Variablen, die ihren Wert während wiederholter Aufrufe von FmtPageName() verändern werden, es ist möglicherweise besser, $FmtV wie im nächsten Punkt zu benutzen.
• Fügen Sie ein Muster/Ersetzung-Paar in das $FmtP-Array ein. Dies wird normalerweise für Ersetzungen gemacht, die dynamisch sein müssen, weil sie in gewisser Weise auf dem referenzierten Seitennamen basieren, so wie '$Title', '$Group', '$Name', $PageUrl', etc.

Siehe auch Cookbook:Functions#FmtPageName

Schließlich gibt es hier noch etwas, das PM geschrieben hat, was sich auf diese Funktion bezieht und erklärt, wozu wir sie haben:

$page = ReadPage($pagename);
PCache($pagename, $page);
$ptitle = FmtPageName('$Title', $pagename);
$pauthor = FmtPageName('$LastModifiedBy', $pagename);

für die Liste aller Seiten