External files for urls.xml

[laurentj]

At this time, when we integrate a module into an application, we have to include in the urls.xml all urls definitions. It is not really cool when we want to update a module, since we have to update also the urls.xml file.

So we could have a new element like this :

  <classicentrypoint ...>
    ...
      <includeurls  basepathinfo="foo/bar/" file="mymodule~urls.xml" />
   ...
  </classicentrypoint>

It says that the urls.xml file of the module "mymodule" defines urls for this module. And all of this urls will begin by foo/bar/.

The urls.xml of a module will have a different grammar : no 'entrypoint' element and no module attribute on url elements.

<moduleurls xmlns="...">
   <url pathinfo="user/edit"  action="default:edit">...</url>
</moduleurls>

In this example, the resulting defined url will be foo/bar/user/edit.

The urls definition files of a module could be store at the root of the module (near modules.xml for example).

[laurentj]

done. ​http://hg.jelix.org/jelix/jelix-trunk/rev/41e238fc1006

Syntax in the main urls.xml :

   <url pathinfo="/base/path" module="foo" include="urls.xml" />

It will declare all urls defined in the "urls.xml" file of the module foo, under the pathinfo /base/path. See urls.xml of some modules to know the syntax of such files declaring "sub urls".

[laurentj]

doc done

• ​http://jelix.org/articles/fr/manuel-1.2/urls/significant#inclure-un-fichier-d-urls-d-un-module-particulier
• ​http://jelix.org/articles/en/manual-1.2/urls/significant#including-urls-files-of-modules