mvccore/ext-router-module-media

MvcCore - Extension - Router - Modules With Media - extension to manage multiple websites in a single project and to manage website media versions (full/tablet/mobile) for different templates/CSS/JS files rendering, optionally contained in a domain or in URL address in the beginning.

Maintainers

Details

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

Source

Issues

Installs: 13

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 2

Forks: 1

Open Issues: 0

v5.3.0 2024-11-21 15:01 UTC

Requires

BSD-3-Clause 2d08cfbeb99bca9e205d3812ed98c86c7644b52a

frameworkroutingmediaaddresspluginversionmvcrouterextensionsiteroutesmodulesmobilemultipleflagtabletplug-inextsitesprojectsfullmvccore

This package is auto-updated.

Last update: 2024-11-21 16:00:24 UTC

README

Latest Stable Version License PHP Version

MvcCore Router extension to manage multiple websites in single project and to manage 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), 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 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

go to top

2. Features

Extension has the same features as extensions bellow together:

Website media version could be contained in any module domain route as param named <media_version> match URL requests like this:

  • http://www.example.com/anything
  • http://mobile.example.com/anything
new \MvcCore\Ext\Routers\Modules\Route([
    "pattern"              => "//<media_version>.example.com",
    "module"               => "main",
    "constraints"          => ["media_version" => "www|mobile"],
]);

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

  • http://www.example.com/anything
  • http://www.example.com/mobile/anything 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\ModuleMedia');
...
// to get router instance for next configuration:
/** @var \MvcCore\Ext\Routers\ModuleMedia $router */
$router = \MvcCore\Router::GetInstance();

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

go to top