FixMyStreet Pro deep linking
Your user will most likely be starting their journey of reporting an issue on your own website. That may be a generic report an issue page, but could be a page on a particular type of issue, such as Graffiti or Potholes.
Generic reporting page
On a generic page, you can link directly to the FixMyStreet Pro front page with a normal link, or embed a FixMyStreet Pro search form into the page, taking the user straight to a map page.
Your website will have its own way of adding links.
<a href="https://your.fixmystreet.example/">Report a problem</a>
An embedded form should be a normal HTML form
whose action is
https://your.fixmystreet.example/around and contains a text
input with name
pc. Ideally it would also have a hidden field called
If you want to get really fancy and add geolocation to your own site, you can
also link to an
/around page with parameters
<form action="https://your.fixmystreet.example/around"> <label for="pc">Search term:</label> <input type="text" id="pc" name="pc" value=""> <input type="submit" value="Go"> </form>
Specific category page
On a category page, you can include a direct link or embedded form while also including parameters that will restrict the default map view - and the reporting page reached by clicking the map - to particular categories (including top-level categories and subcategories, if applicable to your installation).
To restrict the map and reporting pages to a single category that is neither a top-level category nor subcategory, you need only add a
If you use subcategories in your installation and you wish to restrict pages to a particular top-level category, you should use a
If you wish to restrict pages to a particular subcategory, you need to provide the top-level category (using
filter_group) alongside the subcategory (
Any space should be replaced by a + sign.
To link to multiple categories, separate them with a comma. Note that this will only work for
filter_group; additionally, this will prevent a category from being preselected on the reporting page.
If a category itself contains a comma, surround the category with double quotes:
Please note that if you use the ‘Display name’ feature for categories, you must use original category names, not display names.
Within a web form, specify the
filter_group as a hidden
field for equivalent behaviour to the link.
filter_category will restrict the map pins to that category, and
automatically use that category when a report is begun; if you use multiple
categories, the map is filtered but no category is selected when a report is
filter_group will restrict the map pins to all subcategories in
that category, preselect that category when a report is begun and the user will
still need to pick the correct subcategory.
<form action="https://your.fixmystreet.example/around"> <input type="hidden" name="filter_category" value="Graffiti"> <label for="pc">Search term:</label> <input type="text" id="pc" name="pc" value=""> <input type="submit" value="Go"> </form>
<input type="hidden" name="filter_group" value="Trees">
<input type="hidden" name="filter_category" value='Trees,"Cars, bikes, trains"'>