Summary

Usage

 

RelatedSiteAccessList[]=siteaccess_name1

RelatedSiteAccessList[]=siteaccess_name2
...

Description

This configuration array contains a list of siteaccesses that use the same database and belong together. These are called "related siteaccesses". This setting is typically useful when running multiple sites on the same eZ Publish installation.

Note that this setting also controls which siteaccesses the view cache should be cleared for when it is cleared for the current siteaccess. (When clearing the view cache of a node, the system will clear it for all related siteaccesses, unless you use different VarDir settings for them.) If the RelatedSiteAccessList setting is not specified, the cache subsystem will use the "AvailableSiteAccessList" setting instead.

If you have several siteaccesses that are using different databases, this setting must be set per siteaccess.

Examples

Example 1

Let's say that you have several siteaccesses called "gb", "no", "fr" and "myadmin" using the same database. When you change the site pages using the admin interface, the view cache of these pages should be cleared not only for your admin siteaccess but for three public siteaccesses as well. Add the following lines to the "settings/override/site.ini.append.php":

RelatedSiteAccessList[]=gb
RelatedSiteAccessList[]=no
RelatedSiteAccessList[]=fr
RelatedSiteAccessList[]=myadmin

This will instruct the system to clear the view caches for all your siteaccesses.

If you remove "RelatedSiteAccessList[]=gb" then only three siteaccesses will be considered as related and thus editing a site page in the admin interface will lead to clearing the view cache of this page for "myadmin", "no" and "fr" siteaccess (the view cache for "gb" will not be cleared).

Example 2

Let's say that you have the following siteaccesses:

• "gb", "no" and "myadmin" using the "mydb" database
• "shop" and "shopadmin" using the "myshopdb" database

This means you have to specify the following settings in their "site.ini.append.php" configuration files:

settings/siteaccess/gb/site.ini.append.php

RelatedSiteAccessList[]=no
RelatedSiteAccessList[]=myadmin

settings/siteaccess/no/site.ini.append.php

RelatedSiteAccessList[]=gb
RelatedSiteAccessList[]=myadmin

settings/siteaccess/myadmin/site.ini.append.php

RelatedSiteAccessList[]=gb
RelatedSiteAccessList[]=no

settings/siteaccess/shop/site.ini.append.php

RelatedSiteAccessList[]=shopadmin

settings/siteaccess/shopadmin/site.ini.append.php

RelatedSiteAccessList[]=shop