Template:Uganda/ProjectTitleSummary/doc

From OpenStreetMap Wiki
Jump to navigation Jump to search

Summary

Template:Uganda/ProjectTitleSummary is a template to place summary information of a project on to a wiki page. It is set up for projects in Uganda, but can be used globally. The template places a short text description in the page itself, showing essential basic information about a projects name, administrator, dates, state and links to other project wiki pages.

Parameters

The following parameters can be used in the template:

Parameter
name
Required Purpose
project_name yes The name of the project. Is required to link the template and it's data uniquely to a project. The next parameter is used to select if you want it displayed in the template.
project_name_display no If you want the project name to be displayed in the template enter any value or string for this parameter. In some cases you don't want to display the project name, f.i. to avoid duplicating data in the page, like f.i. using this template after a title which already displays the project name.

Displaying without the project name is the standard, so you don't need this parameter if the name is not required to display.

project_admin yes Name of the administrator(s) of the project. Is a string or even a transclusion, URL of the administrators of the project. A commonly used transclusion is an OSM user with the template {{Template:User}}.
date_start yes Start date of the project. The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.
date_completed state 0, 1 or 2=no; state 3 or 4=yes Completion date of the project. Only used, required and displayed when the project is completed but waiting for validation (state = 3) or validated and closed (state = 4). The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.
date_validated state 0, 1, 2 or 3=no; state 4=yes Validation or closing date of the project. Only used, required and displayed when the project is validated and closed (state = 4). The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.
state yes A number representing the state of the project. The state is then reflected in the template with a coloured block:
  • State (0/4) state = 0 - the project is not active, it either has to be started, was started but is stopped without map or wiki changes;
  • State (1/4) state = 1 - there is no activity since a considerable time, the project was started but never completed, no further actions are planned. There were changes to the map and/or wiki;
  • State (2/4) state = 2 - the project is active and activities are ongoing;
  • State (3/4) state = 3 - the project is completed, no further planned or ongoing actions within the project. Results needs confirmation and / or validation.
  • State (4/4) state = 4 - the project is completed, no further planned or ongoing actions within the project. Results are confirmed and validated.

When no state is assigned the template will display an error message.

project_overview no If the project has an overview page or a page with more information you can enter the link or url to this page here. When not used the line will not show in the template.

Usage

Default (without displaying the project name)

{{Uganda/ProjectTitleSummary
| project_name = My project name
| project_admin = {{User|Bert Araali}}
| date_start = 27/12/2019
| state = 2
| project_overview = [https://wiki.openstreetmap.org/wiki/WikiProject_Uganda/My project link]
}}

Will be transcluded as:

initiated and administered by User icon 2.svgBert Araali (on osm, edits, contrib, heatmap, chngset com.)
Status: State (2/4)  - Started: 27/12/2019
Details: project link

WIth project name displayed

{{Uganda/ProjectTitleSummary
| project_name = My project name
| project_name_display = 1
| project_admin = {{User|Bert Araali}}
| date_start = 27/12/2019
| date_validated = 29/12/2019
| state = 4
| project_overview = [https://wiki.openstreetmap.org/wiki/WikiProject_Uganda/My project link]
}}

Will be transcluded as:

Activity/Project title: My project name
initiated and administered by User icon 2.svgBert Araali (on osm, edits, contrib, heatmap, chngset com.)
Status: State (4/4)  - Started: 27/12/2019 Validated/closed: 29/12/2019
Details: project link

Template to place summary information of a project on to a wiki page. It is set up for projects in Uganda, but can be used globally. The template places a short text description in the page itself, showing essential basic information about a projects name, administrator, dates, state and links to other project wiki pages.

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
project_name_displayproject_name_display

If you want the project name to be displayed in the template enter any value or string for this parameter. In some cases you don't want to display the project name, f.i. to avoid duplicating data in the page, like f.i. using this template after a title which already displays the project name. Displaying without the project name is the standard, so you don't need this parameter if the name is not required to display

Default
empty
Example
1
Stringsuggested
project_nameproject_name

The name of the project. Is required to link the template and it's data uniquely to a project. The next parameter is used to select if you want it displayed in the template.

Default
empty
Unknownrequired
project_adminproject_admin

Name of the administrator(s) of the project. Is a string or even a transclusion, URL of the administrators of the project. A commonly used transclusion is an OSM user with the template {{Template:User}}.

Default
empty
Unknownrequired
statestate

A number representing the state of the project.

Default
empty
Unknownrequired
date_startdate_start

Start date of the project. The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.

Unknownrequired
date_completeddate_completed

Completion date of the project. Only used, required and displayed when the project is completed but waiting for validation (state = 3) or validated and closed (state = 4). The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.

Unknownsuggested
date_validateddate_validated

Validation or closing date of the project. Only used, required and displayed when the project is validated and closed (state = 4). The format is at this time not language related, it is a string displaying the date just as the user assigns it as a string to the parameter.

Unknownsuggested
project_overviewproject_overview

If the project has an overview page or a page with more information you can enter the link or url to this page here. When not used the line will not show in the template.

Default
empty
Unknownsuggested