mvccore/ext-router-module-media-localization

MvcCore - Extension - Router - Modules With Media & Localization - extension to manage multiple websites in a single project, to manage website media versions (full/tablet/mobile) for different templates/CSS/JS files rendering and to manage website localizations (language or language and locale), op

Maintainers

Details

github.com/mvccore/ext-router-module-media-localization

Source

Issues

Installs: 11

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 1

Open Issues: 0

v5.2.0 2023-12-12 13:07 UTC

Requires

BSD-3-Clause 6a10a898ff98156f3bfef25cee13255df001536a

frameworkroutingmediaaddresspluginversionmvclocalerouterextensionsiteroutesmoduleslanguagemobilemultipleflaglocalizationtabletplug-inlangextsitesprojectsfullmulti langmulti languagemvccorelanguage versionlocale versionlocalized url

This package is auto-updated.

Last update: 2024-04-12 14:15:23 UTC

README

Latest Stable Version License PHP Version

MvcCore Router extension to manage multiple websites in single project, to manage website media versions website media versions (full/tablet/mobile for different templates/css/js files rendering, optionaly contained in URL address domain part or in URL address beinning) and to manage website localizations (language or language and locale, optionaly contained in URL address domain part or in URL address beinning), defined by domain routes, targeted by module property in URL completing.

This router is the way, how to route your requests in domain level with website media versions and localizations with params or variable sections, namespaces, default param values and more.

Outline

  1. Installation
  2. Features
  3. How It Works
  4. Usage

1. Installation

composer require mvccore/ext-router-module-media-localization

go to top

2. Features

Extension has the same features as extensions bellow together:

Website media version and localization could be contained in any module domain route as params named <media_version> and/or <localization> match URL requests like this:

  • http://en-US.example.com/anything
  • http://de-DE.example.com/etwas
  • http://mobile.en-US.example.com/anything
  • http://mobile.de-DE.example.com/etwas
new \MvcCore\Ext\Routers\Modules\Route([
    "pattern"              => "//[<media_version>.]<localization>.example.com",
    "module"               => "main",
    "constraints"          => ["media_version" => "www|mobile", "localization" => "-a-zA-Z0-9"],
]);

If there is not contained param <media_version> and/or <localization> in matched module domain route pattern, website media version and/or localization param has to be contained (or is automaticly inserted) in URL address beginning like this:

  • http://www.example.com/en-US/anything
  • http://www.example.com/mobile/en-US/anything
  • http://www.example.com/de-DE/etwas
  • http://www.example.com/mobile/de-DE/etwas

How precisely is conained in URL address depends on advanced router configuration like allowed media version and more...

go to top

3. How It Works

Extension works in the same way as extensions bellow together:

Router is composed from traits in extensions named above.

go to top

4. Usage

Usage - Bootstrap Initialization

Add this to /App/Bootstrap.php or to very application beginning, before application routing or any other extension configuration using router for any purposes:

$app = \MvcCore\Application::GetInstance();
$app->SetRouterClass('\MvcCore\Ext\Routers\ModuleMediaAndLocalization');
...
// to get router instance for next configuration:
/** @var \MvcCore\Ext\Routers\ModuleMediaAndLocalization $router */
$router = \MvcCore\Router::GetInstance();

All other specific usage and advanced configuration is the same as extensions bellow together:

go to top