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=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.
where=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 to2019-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 to2020-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.