Home/ask/assignments/Documentation

Description

This page makes use of the #cargo_query function to query data from the Assignments Cargo table (populated by the the Assignments/Table page) which is then transcluded unto Home. As part of the database query, the query makes use of the DATEDIFF() function to validate if the specified Release Date (also set on the the Assignments/Table page) is between two dates, the first day of the month or the first day of the next month.

The two future months listed first are ordered by the release date in ascending order. The bottom past month is ordered in descending order.

Syntax

To add a new month or change what month a section covers, simply make a copy of the syntax below and/or update the relevant code segments:

    <div class="month-container">
        <div class="month">
            <p>April</p>
        </div>
        <table class="pcgwikitable sortable template-infotable" style="max-width: 100%; min-width: 100%; margin: 0 auto">
            {{#cargo_query:
            tables=Assignments
            |fields=Game,Status,Release_Date
            |where=_pageName = 'PCGamingWiki:Assignments/Table' AND DATEDIFF(Release_Date, '2019-04-01') >= 0 AND DATEDIFF(Release_Date, '2019-05-01') < 0
            |format=template
            |template=:Home/ask/assignments/row
            |limit=10
            |order by=Release_Date ASC
            |more results text=
            }}
        </table>
    </div>

Update these places

ISO 8601 format, so YYYY-MM-DD

<p>April</p>

• This is the header shown above the table; update to reflect what month the table below it shows.

DATEDIFF(Release_Date, '2019-04-01') >= 0

• This evaluates if the release date of a game is after or equal to the specified date, so change the 2019-04-01 part to the first day of the month that the section should list.
• So to show games released in December 2019, 2019-04-01 would be changed to 2019-12-01, so that games released after or equal to the start of December is included.

AND DATEDIFF(Release_Date, '2019-05-01') < 0

• This evaluates if the release date of a game is before the specified date, so change the 2019-05-01 part to the first day of the next month that the section should list.
• So to show games released in December 2019, 2019-05-01 would be changed to 2020-01-01, so that games released before the start of the next month is included.

order by=Release_Date ASC

• ASC = Ascending order; releases are ordered from the first day of the month to the last day of the month.
• DESC = Descending order; releases are ordered from the last day of the month to the first day of the month.
• Generally recommended to keep past months ordered in descending order, as it keeps the most recent releases on top, while future months are ordered in ascending order.

Notes

where=_pageName = 'PCGamingWiki:Assignments/Table'

• This limits the query to only poll data defined on the PCGamingWiki:Assignments/Table page. If that page ever moved, this needs to be updated.