Module:Activities Reports/doc
This is the documentation page for Module:Activities Reports
It is NOT recommended to edit this module directly. Please visit the WAD Portal and submit activity reports via the OOUI forms (by clicking on "Submit activity report" button). If you make a mistake in your report submission, do not edit this Lua module to correct it, just resubmit a new report with the correct data. |
This module will keep track of Activities Reports submitted by Wikimedia Affiliates in relations to the Reports page here: WADP on Meta-Wiki.
Usage
editEach entry looks like this:
{ unique_id = 'q86jm02q9io', group_name = 'Learning & Evaluation User Group', report_type = 'Annual Activities Report', start_date = '01/01/2017', end_date = '12/31/2018', report_link = 'https://meta.wikimedia.org/wiki/Test_Report_2019_2020', report_lang_code = 'de', report_link_en = 'https://meta.wikimedia.org/wiki/Test_Report_2019_2020/en', partnership_info = {'Educational Institutions', 'GLAM Institutions', 'Other'}, dos_stamp = '2019-07-02T18:21:59.837Z', },
Syntax
editFirst, a note on the general syntax: editing these entries is comparable to editing templates on Wikipedia such as infoboxes, but with a few key differences:
- Each "block" is wrapped in curly brackets, with a comma following each entry, as you can see above.
- To add a new entry, add a block like above below the last entry, but before the final
}
on the bottom of the module that closes off the whole thing. - Each value after the equals sign has to be surrounded in single quote marks. Here we use single-quotes instead of double quotes. If, however, you want to use an apostrophe, you will need to escape it with a backslash. For example:
Wikimedia\'s mission is to make knowledge available to everyone.
- partnership_info is a special key that takes as value and array and this in Lua is done with curly braces
{}
and it's comma separated to distinct the values from one another. - Indenting is not strictly necessary but it does look nice.
Parameters
edit- unique_id is used to distinguish each entry even when the other values change. It does not need to follow a specific pattern but it does need to be unique.
- group_name is the name used by the affiliate (User Group, Chapter etc). This should in most cases be a recognized affiliate listed in the Wikimedia Movement Affiliates page on Meta-Wiki.
- report_type, this describes the type of activity report the affiliate in concern is submitting. For example; Annual Activity report, etc.
- start_date is the start date of the reporting.
- end_date is the end date of the reporting.
- report_link is the link to the report submitted (for that current year) by the affiliate in any language.
- report_lang_code is the language code of the 'report_link' submitted above. If it's already in English, no need for this.
- report_link_en is the report attached link in English (must) as this will be used to render the report in the reports table.
- partnership_info is the type of partnership collaboration that a particular affiliate is engaged in as part of their activities.
- dos_stamp stands for date of submission stamp and this is the timestamp that this entry/report was submitted.
Translation
editThe strings of text presented on the Activities Report form are stored in Template:i18n/Reports and can be translated through the Translate interface.
Note that this module stores English versions. To update English text, you should update this module directly.
Even if you are editing this module by hand, there is no need to update Template:i18n/Reports by hand, (however, if you see that Template:i18n/Reports needs to be marked for translation, you are welcome to do so!)