Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

RelatedSiteAccessList

Summary

List of siteaccesses that use the same database.

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

 

Svitlana Shatokhina (24/05/2006 8:23 am)

Svitlana Shatokhina (09/10/2008 11:34 am)


Comments

There are no comments.