Skip to the content
Documentation

Cross-siteaccess links

No ratings yet

When using the multisite feature, it is sometimes useful to be able to generate cross-links between the different sites.
This allows you to link different resources referenced in the same content repository, but configured independently with different tree roots.

Usage

Twig example

See ez_urlalias documentation page, for more information about linking to a Location

 

 

PHP example

Important

As siteaccess matchers can involve hosts and ports, it is highly recommended to generate cross-siteaccess links in an absolute form (e.g. using url() Twig helper).

Troubleshooting

  • The first matcher succeeding always wins, so be careful when using catch-all matchers like URIElement.
  • If passed siteaccess name is not a valid one, an InvalidArgumentException will be thrown.
  • If matcher used to match the provided siteaccess doesn't implement VersatileMatcher, the link will be generated for the current siteaccess.
  • When using Compound\LogicalAnd, all inner matchers must match. If at least one matcher doesn't implement VersatileMatcher, it will fail.
  • When using Compound\LogicalOr, the first inner matcher succeeding will win.

Under the hood

To implement this feature, a new VersatileMatcher was added to allow siteaccess matchers to be able to reverse-match.
All existing matchers implement this new interface, except the Regexp based matchers which have been deprecated.

The siteaccess router has been added a matchByName() method to reflect this addition. Abstract URLGenerator and DefaultRouter have been updated as well.

Note

Siteaccess router public methods have also been extracted to a new interface, SiteAccessRouterInterface.

 

Related topics:

Contributors

Comments (1 historical)

Written by readers of the earlier documentation sites, kept as they were.

  1. Comment by pr pr, 2014-11-28 01:28

    pr pr ·

    Hi, in the PHP code example, since you meant to generate absolute URL's, you need to pass the constant UrlGeneratorInterface::ABSOLUTE_URL to $this->generateUrl instead of UrlGeneratorInterface::ABSOLUTE_PATH.

     

Comments

Add a comment

Comments are read by a moderator before they appear.