Skip to main content
Last updated: 24 Jan 2024

whitehall: Finders

Retired finders

There used to be finders for announcements, publications and statistics in this application, however these have been replaced by new finders rendered by finder-frontend and published from search-api.

We redirect searches from the old finders to the new in order to maintain a reasonable experience for users. Because we need to translate some of the query parameters, we do it in the controllers:

How to publish a finder in whitehall

Please consider publishing new finders from search-api. There are schema tests for both finders and email signup pages there.

Create a JSON file in lib/finders. You can base it on one of the existing files in that folder.

Double-check the filter format and document noun - the filter format is used for search_api to return the data, while the document noun is displayed to the user.

The default_documents_per_page key can be used to paginate very long finders (see whitehall/lib/finders/case_studies.json for an example).

Running the finders:publish rake task will publish your new finder to the publishing-api, and the route defined in the JSON will be taken over by finder-frontend.