Siteaccess-Einstellungen
Teil 2, Kapitel 3. Eine Exponential-Installation bedient aus derselben Datenbank mehrere „Gesichter“: die öffentliche Website, dieselbe Website in einer anderen Sprache, eine zweite Website, die Administration, eine Oberfläche für Redakteure. Jedes Gesicht ist ein Siteaccess. Dieses Kapitel erklärt, wie eine Anfrage ihren Siteaccess auswählt und was in die Einstellungen eines Siteaccess gehört.
Was ein Siteaccess entscheidet
Ein Siteaccess ist ein Name (zum Beispiel site, ger, admin) und ein Ordner mit Einstellungen,
settings/siteaccess/<name>/. Diese Einstellungen entscheiden für jede Anfrage, die ihn verwendet:
| Entscheidet | Typische Einstellungen |
|---|---|
| Welches Design die Seiten zeichnet | site.ini [DesignSettings] SiteDesign, AdditionalSiteDesignList[] |
| In welcher Sprache Inhalte angezeigt werden | site.ini [RegionalSettings] Locale, ContentObjectLocale, SiteLanguageList[] |
| Wo die Website im Inhaltsbaum beginnt | content.ini [NodeSettings] RootNode, site.ini [SiteSettings] IndexPage, DefaultPage |
| Ob Besucher sich anmelden müssen | site.ini [SiteAccessSettings] RequireUserLogin |
| Welche Erweiterungen nur für dieses Gesicht eingeschaltet sind | site.ini [ExtensionSettings] ActiveAccessExtensions[] |
| Der Name der Website und die Metadaten | site.ini [SiteSettings] SiteName, MetaDataArray[] |
Wie eine Anfrage einen Siteaccess auswählt
Die Regeln stehen in site.ini [SiteAccessSettings]:
| Einstellung | Bedeutung |
|---|---|
AvailableSiteAccessList[] | Jeder Siteaccess der Installation |
MatchOrder | Welche Matcher in welcher Reihenfolge probiert werden; Standard ist uri;host;port |
URIMatchType | Wie die Adresse geprüft wird; element bedeutet, dass das erste Pfadelement den Siteaccess nennt (/admin/...) |
HostMatchMapItems[] und zugehörige Host-Einstellungen | Ordnen Hostnamen Siteaccesses zu (www.example.com;site, admin.example.com;admin) |
RelatedSiteAccessList[] | Siteaccesses, die Inhalte und Links teilen, zum Beispiel die Sprachen einer Website |
Mit URI-Matching verwendet https://example.com/ger/about den Siteaccess ger und zeigt /about. Mit Host-Matching
hat jeder Siteaccess seinen eigenen Hostnamen. Jede Regel und ihr Werkzeug zur Fehlersuche sind in
Siteaccess-Zuordnung nach Host und Sprache und beim
Befehl für die Anfrageregeln beschrieben:
./console exp:ezrequestrulesEin öffentlicher Siteaccess, kommentiert
Eine typische settings/siteaccess/<name>/site.ini.append.php einer öffentlichen Website (ohne Datenbankangaben):
[SiteSettings]
SiteName=My site
# The front page and where "home" links go
IndexPage=/content/view/full/2
DefaultPage=/content/view/full/2
[SiteAccessSettings]
# Visitors do not have to sign in
RequireUserLogin=false
# The siteaccesses that share this site's content
RelatedSiteAccessList[]
RelatedSiteAccessList[]=site
RelatedSiteAccessList[]=ger
RelatedSiteAccessList[]=admin
[DesignSettings]
# Your own design first, then the ones it falls back to
SiteDesign=mysite
AdditionalSiteDesignList[]
AdditionalSiteDesignList[]=base
[RegionalSettings]
Locale=eng-US
ContentObjectLocale=eng-US
SiteLanguageList[]
SiteLanguageList[]=eng-USDer Siteaccess der Administration sieht ähnlich aus, mit SiteDesign=admin4 (oder einem anderen Admin-Design),
RequireUserLogin=true und einer eigenen AdditionalSiteDesignList[].
Siteaccesses und Erweiterungen
Zwei Einstellungen verbinden sie:
ActiveAccessExtensions[]in dersite.inieines Siteaccess schaltet eine Erweiterung nur für diesen Siteaccess ein. Verwenden Sie es für Erweiterungen, die nur für ein Gesicht sinnvoll sind (ein Admin-Werkzeug, das Theme einer Website).- Eine Erweiterung kann einen Siteaccess besitzen, indem sie
extension/<ext>/settings/siteaccess/<sa>/enthält. Dann liegen alle Einstellungen des Siteaccess in der Erweiterung, unter Versionskontrolle. Siehe Einstellungen in einer Erweiterung.
Siteaccess-Einstellungen lesen
./console exp:ini list site.ini/DesignSettings -s <siteaccess>
./console exp:ini get site.ini/DesignSettings/SiteDesign -s <siteaccess>
./console exp:ini scopes siteaccess-s wertet die Einstellungen so aus, wie dieser Siteaccess sie sieht. scopes siteaccess listet die Siteaccesses auf,
die einen Einstellungsordner haben.
In einem Template steht der aktuelle Siteaccess im Pagelayout als $access_type.name zur Verfügung, in PHP über
eZSiteAccess::current().
Häufige Fehler
| Symptom | Ursache |
|---|---|
| Ein neuer Siteaccess zeigt „module not found“ oder die falsche Website | er steht nicht in AvailableSiteAccessList[], oder die Zuordnungsregel schickt die Anfrage woandershin |
| Das Design ändert sich nicht | die extension/<ext>/settings/site.ini.append.php einer Erweiterung setzt SiteDesign und gewinnt gegen den Siteaccess-Ordner (siehe die Reihenfolge in Einstellungsebenen) |
| Links springen zu einer anderen Website | RelatedSiteAccessList[] oder die Host-Zuordnung |
| Inhalte erscheinen in der falschen Sprache | SiteLanguageList[] (der erste Eintrag ist die Hauptsprache), ShowUntranslatedObjects |
Verwandte Seiten
- Zurück: Einstellungsebenen und die Reihenfolge, in der sie gewinnen
- Weiter: Einstellungen in einer Erweiterung
- Siteaccess-Zuordnung nach Host und Sprache
- Anfrageregeln
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.