Archivist
Last updated Apr 22nd, 2021 | Page history | Improve this page | Report an issue
What is Archivist?¶
Archivist is an archive navigation Extra for MODX Revolution. It allows for wordpress-style navigation of Resources, as well as month/year/day archive listing and automatic FURL generation.
If you are looking to create a blog, check out Articles. It includes Archivist in an easy to use form.
Requirements¶
- MODX Revolution 2.0.0-RC-2 or later
- PHP5 or later
- Extension requirements may call for FURL use and ".html" be changed to "/" : Content -> Content Types -> HTML (.html) -> /
History¶
Archivist was written by Shaun McCormick as a wordpress-style archiving component, and first released on June 3rd, 2010.
Download¶
It can be downloaded from within the MODX Revolution manager via Package Management, or from the MODX Extras Repository, here: https://modx.com/extras/package/archivist
Development and Bug Reporting¶
Archivist is stored and developed in GitHub, and can be found here:http://github.com/splittingred/Archivist
Bugs can be filed here: https://github.com/modxcms/Archivist/issues
Usage¶
Archivist has 2 snippets - one to display the month/year/day listing ("Archivist"), and the other to display archive results ("getArchives").
- Archivist - Displays archive navigation links.
- getArchives - Displays results of archives.
Examples¶
Display archives for your site, with a Month listing for Resources with parents 54 and 55, and then on a Resource ID of 123, display the Resources for that month.
The call for the Month listing:
[[!Archivist? &parents=`54,55` &target=`123`]]
And then on your archives page:
[[!getArchives?
&parents=`54,55`
&toPlaceholder=`archives`
]]
<h2>[[!+arc_month_name]] [[!+arc_year]] Archives</h2>
[[!+archives]]