chCmsExposeRoutingPlugin: expose your symfony routes to javascript

Goal

chCmsExposeRoutingPlugin is a symfony 1.(3|4) plugin used to expose routing definition to the client side.

if you use symfony2, have a look to FriendsOfSymfony/FOSJsRoutingBundle

Requirement

You need jquery to use this plugin. jQuery is not bundeled with this plugin, you have to include it yourself.

How does it work ?

Enable

First, enable the plugin in your project configuration:

<?php
// config/ProjectConfiguration.class.php

public function setup()
{
  $this->enablePlugins(array('chCmsExposeRoutingPlugin'));
}

Then enable chCmsExposeRouting in your application:

# app/{your_app}/config/settins.yml

    enabled_modules:
      - chCmsExposeRouting

And finaly publish assets

$ symfony plugin:publish-assets

you're done !

More conf

You can disable the script auto inclusion by adding the following in your routing.yml

app:
  ch_cms_expose_routing:
    register_scripts: false # you will have to register scripts manually

You can disable the route auto declaration by adding the following in your routing.yml

app:
  ch_cms_expose_routing:
    register_routes: false # you will have to register script route manually

and the register your route this way:

my_custom_route_name:
  url: /my/url/route.js
  params: { module: chCmsExposeRouting, action: index }

register your exposed routes

make a route exposable

the only thing you need to do is to add an app_expose option:

// app/{your_app}/config/routing.yml

# this route will be exposed if auto_discover is true
my_route_to_expose:
  url:  /foo/:id/bar
  params: { action: foo, module: bar }
  options:
    app_expose: true

# this route will NEVER be exposed
my_secret_route:
  url:  /foo/:id/bar/1
  params: { action: foo, module: bar }
  options:
    app_expose: false

# this route will be exposed if forced, but not autodetected
a_default route:
  url:  /foo/:id/bar/2
  params: { action: foo, module: bar }

force a route exposition

in your application config ( app.yml ), add the following:

app:
  ch_cms_expose_routing:
    routes_to_expose:
      - my_first_route_to_expose
      - another_route

expose all exposable routes

if you want to expose all routes with app_expose option to true, just add the following to your application config ( app.yml ):

app:
  ch_cms_expose_routing:
    auto_discover: false

custom filter on exposed params

in your application config ( app.yml ), add the following:

app:
  ch_cms_expose_routing:
    params_blacklist:
      - module
      - action
      - my_param

access routes in browser

It's as simple as calling Routing.generate('route_id', /* your params */).

Routing.generate('route_id', {id: 10});
// will result in /foo/10/bar
Routing.generate('route_id', {"id": 10, "foo":"bar"});
// will result in /foo/10/bar?foo-bar

$.get(Routing.generate('route_id', {"id": 10, "foo":"bar"}));
// will call /foo/10/bar?foo=bar

Documentation

•  Javascript Documentation
• PHP Plugin Documentation

Test suite

You can help us improving code quality by running the JS Test Suite. if you find something wrong, please Report Isssue

TODO

• cache js routing
• add simple way to call server with sf_method and csrf_token