Download the PHP package lin3s/wp-routing without Composer
On this page you can find all versions of the php package lin3s/wp-routing. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package wp-routing
WP Routing
Symfony style routing for WordPress.
Why?
WordPress routing system is a magical awesome but dark system. For non developers this routing just "works" but, when you need to customize it, this process is not very intuitive. In LIN3S, we are proud PHP developers that like Symfony ecosystem so, this library is a simple but powerful approach to Symfony Routing component you can easily add to your WordPress project.
If you want to test it, we already have a functional WordPress project that includes this library ready to use, WordPress Standard Edition :).
Installation
The recommended and the most suitable way to install this library is through Composer. Be sure that the tool is installed in your system and execute the following command:
Usage
Before you start using this library we highly recommend getting familiar with WordPress template hierarchy.
WP-Routing uses YAML to match routes with your methods. For example you can write the following in your
routing.yml
:
As you can see in the example above you can use the following parameters for each route:
controller
: Defines with method will be called when a match for the given route exists.type
: Which type of route will match the current controller. It uses WordPress standard naming conventions and you can check the available ones in Router class.template
: Can be used in pages to select a custom template. Internally it usesget_page_template_slug()
to get the template the page requires. We use our template-selector plugin to let the user select the template to be used.- other parameters: In case you need to target a specific category, post type (archive or single), taxonomy or page you can use extra parameters like slug, id or posttype (see variable names on WordPress's template hierarchy page).
To resolve the routes added above just include the following code in your theme's index.php
:
Make sure WPRouting library is autoloaded using composer's autoload script
To Do
- [ ] Add more specs
- [ ] Route registration wih XML
- [ ] Route registration wih annotations