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

URIMatchType

Summary

Configures the URI match access method

Usage

 

URIMatchType=disabled|map|element|text|regexp

Description

URI matching is used to select the siteaccess from the location part of the URL: URL matching can be used in two different modes or be disabled completely. The options you have for this settings are:

  • disabled - Disables URI matching. If URI matching is present in the MatchOrder setting it will be ignored.
  • map - Select the siteaccess to use based on the first element of a given URL. Specify the mapping between the URL element and the siteaccess to use with the URIMatchMapItems setting.
  • element - Select the siteaccess to use based on the elements separated by "/" in the location part. If you specify "URIMatchElement=N", the system will take N parts of the URL (separated by "/") and replace slashes with underscores in the resulting string.
  • text - Match URL using pre- or post- substrings (URIMatchSubtextPre, URIMatchSubtextPost).
  • regexp - Works similarly to the element setting but you can specify the delimiter with a regular expression. The settings URIMatchRegExp and URIMatchRegExpItem control how to split the URL and what part to use for the siteaccess.

Examples

Example 1 (element matching)

URIMatchType=element
URIMatchElement=1

With this configuration the second element (the first element is element 0) of the URI will be used as the siteaccess. For example, in the URL "http://www.mysite.com/news/site/admin/content/view/full/32" the siteaccess name will be "news".

Example 2 (element matching)

URIMatchType=element
URIMatchElement=3

With this configuration the second element (the first element is element 0) of the URI will be used as the siteaccess. For example, in the URL "http://www.mysite.com/news/site/admin/content/view/full/32" the siteaccess name will be "news_site_admin".

Example 3 (map matching)

URIMatchType=map
URIMatchMapItems[]=myadmin_de;admin_de
URIMatchMapItems[]=MYADMIN_DE;admin_de

This will tell the system to use the "admin_de" siteaccess when the first element of a given URI is 'myadmin_de' or 'MYADMIN_DE'.

Frederik Holljen (04/03/2005 2:28 pm)

Svitlana Shatokhina (21/09/2006 2:44 pm)

Frederik Holljen, Svitlana Shatokhina


Comments

There are no comments.