Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Siteaccess-Einstellungen

Ein Siteaccess ist ein Gesicht einer Installation - eine öffentliche Website, eine Sprache, die Administration. Wie eine Anfrage ihren Siteaccess auswählt, welche Einstellungen einen festlegen und ein vollständiges…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-2-builder/siteaccess-settings.md

On this page

This page is a translation. Read the English original

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:

EntscheidetTypische Einstellungen
Welches Design die Seiten zeichnetsite.ini [DesignSettings] SiteDesign, AdditionalSiteDesignList[]
In welcher Sprache Inhalte angezeigt werdensite.ini [RegionalSettings] Locale, ContentObjectLocale, SiteLanguageList[]
Wo die Website im Inhaltsbaum beginntcontent.ini [NodeSettings] RootNode, site.ini [SiteSettings] IndexPage, DefaultPage
Ob Besucher sich anmelden müssensite.ini [SiteAccessSettings] RequireUserLogin
Welche Erweiterungen nur für dieses Gesicht eingeschaltet sindsite.ini [ExtensionSettings] ActiveAccessExtensions[]
Der Name der Website und die Metadatensite.ini [SiteSettings] SiteName, MetaDataArray[]

Wie eine Anfrage einen Siteaccess auswählt

Die Regeln stehen in site.ini [SiteAccessSettings]:

EinstellungBedeutung
AvailableSiteAccessList[]Jeder Siteaccess der Installation
MatchOrderWelche Matcher in welcher Reihenfolge probiert werden; Standard ist uri;host;port
URIMatchTypeWie die Adresse geprüft wird; element bedeutet, dass das erste Pfadelement den Siteaccess nennt (/admin/...)
HostMatchMapItems[] und zugehörige Host-EinstellungenOrdnen 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:ezrequestrules

Ein ö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-US

Der 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 der site.ini eines 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

SymptomUrsache
Ein neuer Siteaccess zeigt „module not found“ oder die falsche Websiteer steht nicht in AvailableSiteAccessList[], oder die Zuordnungsregel schickt die Anfrage woandershin
Das Design ändert sich nichtdie 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 WebsiteRelatedSiteAccessList[] oder die Host-Zuordnung
Inhalte erscheinen in der falschen SpracheSiteLanguageList[] (der erste Eintrag ist die Hauptsprache), ShowUntranslatedObjects

Verwandte Seiten

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x