hwgroupsa

Holzweg Group Site Access Extension

What is the Group Site Access Extension?

This extension enables you to use subdirectories inside your siteaccess settings directories to create additional overrides to siteaccess settings (e.g. for different languages)

→ This extension is for those of you using multi site implementations (e.g. 3 different websites with 5 different languages each)

How does it work?

hwgroupsa overrides two kernel files (ezsiteaccess.php and ezini.php) to push the subdirectory's settings (further referred to as "sub-siteaccess settings" to the settings override array.

Additionaly, it provides a custom language switcher to allow switching between sub-siteaccesses, while not leaving the main siteaccess.

A new MatchOrder Setting was introduced in the site.ini settings, to allow an easy setup for multi-site-multi-language installations (see in the configuration section)

Installation:

1. Clone this repository into your extension directory

2. Activate kernel overrides in your {ezpublish-root}/config.php (this file eventually needs to be created)

   define( 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE', true );
?>
3. Activate the extension from the ezpublish backend (or override/site.ini.append.php)

4. Regenerate your autoload array (don't forget the "-o" flag to override kernel and lib classes)

   $ bin/php/ezpgenerateautoloads.php -o

Configuration:

1. Update your settings/override/site.ini.append.php

   MatchOrder=host_uri_group
HostUriGroupMatchMapItems[]
HostUriGroupMatchMapItems[]=www.website1.com;de|en|it;website1
HostUriGroupMatchMapItems[]=www.website2.com;de|en|it;website2
HostUriGroupMatchMapItems[]=www.website3.com;de|en|it;website3

The Syntax for each HostUriGroupMatchMapItems is:
[hostname];[sub-siteaccess1]|[sub-siteaccess2]|[...];[main-siteaccess]

2. Create the directory structure

   settings/siteaccess/website1
settings/siteaccess/website1/de
settings/siteaccess/website1/en
settings/siteaccess/website1/it
settings/siteaccess/website2
settings/siteaccess/website2/de
settings/siteaccess/website2/en
settings/siteaccess/website2/it
settings/siteaccess/website3
settings/siteaccess/website3/de
settings/siteaccess/website3/en
settings/siteaccess/website3/it

3. Setup site.ini.append.php

   in each main siteaccess, create a site.ini.append.php just like you normally would

in each sub-siteaccess, only create those settings files that need to override the main siteaccess:

settings/siteaccess/website1/de/site.ini.append.php:

[RegionalSettings]
Locale=ger-DE
ContentObjectLocale=ger-DE
SiteLanguageList[]
SiteLanguageList[]=ger-DE
SiteLanguageList[]=eng-US
SiteLanguageList[]=ita-IT
4. Kick back, clear the cache and enjoy! (:

Feedback and Feature Requests

We're happy to receive your feedback at technik[at]holzweg.com

Please feel to contribute by contacting us or simply sending us a pull request.

Initially brought to you by Holzweg e-commerce Solutions, with love.

Note: No kernel files were harmed during the development of this extension.

Contributions by

(this could be you!)

(For more document and questions please visit http://github.com/holzweg/hwgroupsa)

Tak!