getIdentity

Ermittelt die Identität der Page. Die Identität ist ein eindeutiger Bezeichner für ein Page-Objekt und enthält 3 wichtige Parameter:
site (Mandanten-Bezeichnung), lang (Sprache), id (ID der Page) 

<strong>Beispiel: $identifier = $page->getIdentity(); echo $identifier;  // <strong>beispielmandant.de.123</strong>

Der Identifier wird als String ausgegeben. Aus diesem String kann im späteren Verlauf jederzeit das Page-Objekt ermittelt werden. Dazu wird an allen Stellen im System die statische Page-Methode "byIdentitiy" zur Verfügung gestellt:

$p = Page::byIdentity($identifiert); echo $p->field['id']; //  123

Hintergrund:
In früheren Version wurde vermehrt die Page-URL als "Identifier" genutzt.
Diese enthält ebenso alle 3 benötigten Parameter (Beispiel: "index.php?id=123&site=beispielmandant&lang=de"). Sie kann über die Funktion Ego_System::urltopage($url) ebenso in ein Page-Objekt umgewandet werden. Das hat allerdings zentrale Nachteile:

  • Der Link muss an einigen Stellen manuell umständlich erzeugt werden
  • Bei Verwendung des Links im Javascript ist es schwieriger an die einzelnen Parameter zu kommen (stattdessen kann der Identity-String einfach über die "split"-Funktion zerlegt werden). Die Weiterverarbeitung der URL ist daher etwas schwieriger in der Handhabung.
  • Die index.php-Url ist länger und schwieriger zu lesen
  • Die index.php URL ist vom Typ ein Link. Es ist nicht jedem Entwickler sofort ersichtlich dass dieser auch ein Identifier ist.