Background
The Special:Nearby page (https://en.wikipedia.org/wiki/Special:Nearby) allows users to explore Wikipedia articles about nearby places, but its functionality is currently limited to a standalone page and cannot be easily embedded elsewhere. This task proposes adding a parser function that enables embedding Special:Nearby within any wiki page, increasing the feature’s visibility. For example, on the mobile web version (Minerva), the Special:Nearby link is hidden in the left drawer, and embedding it directly onto main pages could improve access.
User story
As a Wikipedia template maintainer, I want to use a parser function to embed Special:Nearby on any page, so that users can explore nearby articles without navigating away from the page they are currently viewing.
Requirements
- Implement a parser function to embed Special:Nearby into any Wikipedia page.
- Ensure the parser function can be configured to specify the number of results and sorting preferences.
- Ensure compatibility with all skins (desktop and mobile) and make the function usable through templates.
- Provide documentation or examples of how the function can be incorporated into templates for editors to use.
BDD
_For QA engineer to fill out._
Test Steps
_For QA engineer to fill out._
Design
- Mockups or design examples for how Special:Nearby would appear when embedded in different contexts, like the main page or article sidebars.
- Ensure that the embedded Nearby section adheres to Wikipedia's existing design and UI guidelines.
Acceptance criteria
- A parser function is implemented and functional for embedding Special:Nearby in any Wikipedia page.
- Editors and template maintainers can use this parser function within templates to display nearby articles.
- The function works across all skins, desktop, and mobile versions.
- The embedded content is configurable (e.g., number of nearby results, sorting order).
Communication criteria
- Announce the availability of the parser function in the release notes.
- Propose a community discussion on embedding Special:Nearby on main or high-traffic pages.
- Update documentation for template maintainers on how to use the parser function.
Rollback plan
- If issues arise, disable the parser function and revert the changes.
This task was created by Version 1.2.0 of the Web team task template using phabulous