FmtPageName()

Administratoren (Fortgeschrittene), System

Diese Seite beschreibt eine interne Funktion in PmWiki. Diese Seite ist nicht für Leute mit einem schwachen Herzen bestimmt ;-)

Siehe auch Funktionen

(Edit Section ↓)

FmtPageName($fmt, $pagename)

Die Funktion gibt $fmt wieder zurück, nachdem darin Variablen-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 (Internationalisierungsphrasen), benutze die aktuell geladene Übersetzungstabelle.
  3. Ersetze alle Vorkommen von {$ScriptUrl} durch $ScriptUrl.
  4. Ersetze alle Vorkommen von Standard-Seiten-Variablen (beginnend mit einem Großbuchstaben, gefolgt von wenigstens einem Wortzeichen) durch ihre Werte. 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) 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 (kleines 'v'), 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. Gibt es keine weiteren $-Sequenzen, gib den formatierten String zurück und beende damit die Funktion.
  8. Ersetze alle $-Sequenzen durch globalen 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.

(Edit Section ↓)

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.

(Edit Section ↓)

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.
  • 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:

Um seine Ausgabe zu erstellen, muss PmWiki eine Vielfalt von Stringersetzungen vornehmen:
  1. zum Erzeugen des vollen Namen, der Gruppe, des Titels oder der URL einer Seite (die verschieden ist von der aktuell angezeigten Seite),
  2. zum Einsetzen der globalen Variablenwerte,
  3. zum Durchführen der Internationalisierung,
  4. zum Umwandeln von $ScriptUrl/$Group/$Name in $ScriptUrl?n=$Group.$Name für Sites, die keine PATH_INFO-Urls handhaben können,
  5. für andere Ersetzungen, die bestimmte Funktionen brauchen.
PmWiki führt alle dieser Ersetze-einen-Dynamische-Wert-in-einem-String in der FmtPageName()-Funktion zusammen. Weil einige Dinge extrem dynamisch sind, solche wie die Url oder die Gruppe für eine beliebige Seite, die nicht die aktuelle angezeigte ist, können diese Dinge nicht einfach globale Variablen sein. Oder wenn sie doch globale Variablen würden, wären sie Variablen, die nicht zuverlässig Werte für eine lange Zeit behielten, weile einige andere Routinen (die gerade einen String einer anderen Seite formatieren) daherkommen und den Wert auf etwas setzen, was sie gerade brauchen.
Ein begrenzter Satz von $-Ersetzungen — grundsätzlich alles, was mit einem Seitenattribut korrespondiert — sind keine PHP-Variablen und sind nur erreichbar über die FmtPageName()-Funktion. Der vollständige Satz dieser speziellen Variablen ist

$Group, $Name, $FullName, $PageUrl, $Title, $Titlespaced, $Namespaced, $Groupspaced, $LastModifiedBy, $LastModifiedHost und $LastModified. Diese Dinge können nicht einfach PHP-Standardvariablen sein, weil sich PmWiki oft die URL, den Namen, die Gruppe, den Titel etc. einer anderen Seite besorgen muss als der aktuell im Browser betrachteten Seite.

Im Moment können $Title, $LastModified, $LastModifiedBy und $LastModifiedHost nur funktionieren, wenn die Attribute der Seite geladen und zwischengespeichert sind unter Verwendung der PCache-Funktion. So muss man, um an diese Werte zu kommen, typischerweise Folgendes ausführen: 
$page = ReadPage($pagename);
PCache($pagename, $page);
$ptitle = FmtPageName('$Title', $pagename);
$pauthor = FmtPageName('$LastModifiedBy', $pagename);

<< | Dokumentationsindex | >>

Übersetzung von PmWiki.FmtPageName Originalseite auf PmWikiDe.FmtPageName - Rückverweise
Zuletzt geändert:
PmWikiDe.FmtPageName am 10.09.2011
PmWiki.FmtPageName am 10.09.2011