TheCommunityRequests extension is a system for managing a wiki community's requests and suggestions for technical development.It is used by the WMF for theCommunity Wishlist.
The lifecycle of the Community Wishlist system is generally:
You'll need three manually created wiki pages for your wishlist.If you are usingTranslate, be sure to setup the page for translation and add the<languages/> navigation box at the top.
Located at[[Community Wishlist]].
This is the homepage for the Wishlist.It can be designed however you'd like, and usually will displayrecent wishes andfocus areas, and link to thewish intake form.Special:Wishlist is available as a shortcut to wherever the home page is located, and you can link to individual entities with i.e.Special:Wishlist/W123.
Example content:
Welcome to the Community Wishlist!'''[[Special:WishlistIntake|Submit a new wish]]'''== Recent focus areas =={{#CommunityRequests:focus-area-index|limit=4}}'''[[Community Wishlist/Focus areas|All focus areas]]'''== Recent wishes =={{#CommunityRequests:wish-index|limit=5}}'''[[Community Wishlist/Wishes|All wishes]]'''
This page allows users to browse through all wishes.
Example content:
{{#CommunityRequests:wish-index}}'''[[Special:WishlistIntake|Create a new wish]]'''
This page lists all focus areas.
Example content:
{{#CommunityRequests:focus-area-index}}
Wishes are technical proposals submitted by members of the community.They can belong tofocus areas and can bevoted on to gauge public interest.
New wishes can be submitted using theintake form which is available atSpecial:WishlistIntake.
The intake form has ways to add a title, description, status of a wish, (that is only available to Wishlist managers) type, audience, tags and any existing Phabricator tasks.The Wishlist managers also have the option to assign a status and focus area, that allows grouping.
When submitting a wish it automatically gets assigned the "Under review" status.
The data for individual wishes are stored using the{{#CommunityRequests: wish}}parser function.
It takes the following parameters:
|type= – The type of the wish. The possible values are configured by$wgCommunityRequestsWishTypes.|status= – The status of the wish. The possible values are configured by$wgCommunityRequestsStatuses.|title= – The title of the wish|focusarea= – The entity ID for the associated focus area such asFA123.|description= – The description of the wish. This field may contain wikitext or use of templates.|audience= – Free-form field to describe the group(s) of users the wish would benefit. May contain wikitext.|tags= – A comma-separated list of tags that apply to the wish. The possible values are configured by$wgCommunityRequestsTags.|phabtasks= – A comma-separated list of thePhabricator task IDs, such asT123,T456.|proposer= – The username of the user who submitted the wish.|created= – TheISO 8601 timestamp of when the wish was created, such as2025-01-23T12:59:59Z.|baselang= – The MediaWikilanguage code for the base language of the wish, from which translations are made.A table of available wishes can be displayed using the{{#CommunityRequests: wish-index}} parser function.
It takes the following parameters:
| Name | Description | Default |
|---|---|---|
|lang= | The language to fetch wishes in. If wishes are not available in that language, the same wishes are shown infallback languages where possible. | (the page language) |
|sort= | The column to sort by. This should be one of the validsort values accepted by thelist=communityrequests-wishes API. | created |
|dir= | The direction to sort by. Should be eitherascending ordescending. | descending |
|limit= | The number of results to show per page. | 10 |
|showfilters= | Whether to show the wishes filters form. | 0 |
Focus areas group together related wishes that share a common theme.Just like wishes, focus areas can bevoted on.Stakeholders can treat a focus area's collection of wishes as a long-term project, and offer updates to voters through the Community Wishlist system.
Focus area pages are titledCommunity Wishlist/FA<number>, where<number> is the unique focus area ID.The title prefix is configurable.Editing these pages is only available to users with themanage-wishlistright and is usually done via the editing form at Special:EditFocusArea.
Each focus area page uses a parser function to store its data, and another parser function is available for displaying an index to all focus areas.
The data for individual focus areas are stored using the{{#CommunityRequests: focus-area}} parser function.
It takes the following parameters:
|status= – The status of the focus area. The possible values are configured by$wgCommunityRequestsStatuses.|title= – The title of the focus area.|description= – The description of the focus area. This field may contain wikitext or use of templates.|shortdescription= – The short description for the focus area; shown on the wishlist homepage and the focus area index page. This field may contain links and other simple wikitext.|owners= – The organizational teams that own this focus area and are responsible for its management and progress. May contain wikitext.|volunteers= – Volunteers who are not part of the organization but contributed to the focus area in some way. May contain wikitext.|created= – TheISO 8601 timestamp of when the focus area was created, such as2025-01-23T12:59:59Z.|baselang= – The MediaWikilanguage code for the base language of the focus area, from which translations are made.A list of focus area cards can be displayed using the{{#CommunityRequests: focus-area-index}} parser function.
It takes the following parameters:
| Name | Description | Default |
|---|---|---|
|lang= | The language to fetch focus areas in. If focus areas are not available in that language, the same focus areas are shown infallback languages where possible. | (the page language) |
|sort= | The column to sort by. This should be one of the validsort values accepted by thelist=communityrequests-wishes API. | created |
|dir= | The direction to sort by. Should be eitherascending ordescending. | decending |
It is possible to fetch data for a wish or focus area in wikitext using the{{#CommunityRequests: data}} parser function:
{{#CommunityRequests: data| id= W123| field= status}}
Parameters:
|id= – The ID of the wish or focus area, i.e. W123 or FA123.|field= – The field to fetch. One of:statustitlefocus_area – returns the focus area ID (i.e. FA123)proposervote_counttitle_lang – The language that the title is in.|lang= – The language to use (only applicable for thetitle field). Defaults to the page content language.The data parser function can be used in a template to make it easier to link to wishlist entities in discussions, etc.On the Wikimedia installation, this is available atmeta:Template:Community Wishlist link.
[[Community Wishlist/{{{1}}}|{{{1}}}:{{#CommunityRequests: data| id={{{1|}}}| field= title}}]]
Once wishes/focus areas are reviewed and have any other status than "Under Review", "Declined" and "Done" status assigned, they can be voted on.Voting is done by clicking a button and entering an optional comment.Votes are stored on a votes subpage, that people can see on their contributions, and which is not intended to edited directly.
To use machine translation, first ensure you have the "Enable automatic machine translation in theCommunity Wishlist." preference set in yourInternationalisation preferences.All Community Wishlist pages offer machine translation.
This will add a banner at the top of any page that has any parts written in languages other than a user's current interface language.The banner contains a toggle switch that can be used to enable the page translation.
The state of the toggle switch is maintained between page loads, as the user navigates around the wiki, so that text in other languages will be translated as soon as a new page is opened.