ArchivistGrouper

ArchivistGrouper is a snippet in the Archivist Extra. It lists Resources under one or more parents, grouped by month or year, with nested item links inside each group. Pair the group links with getArchives on a target Resource so filtered archive pages work.

Articles ships Archivist and uses this snippet for nested archive navigation. You can call it on any site that has the Archivist package installed.

Usage¶

Place the snippet where you want the grouped archive list. Point parents at the blog or article containers, and target at the Resource that runs getArchives.

[[!ArchivistGrouper? &parents=`12` &target=`123`]]

Group by year instead of month:

[[!ArchivistGrouper? &parents=`12` &target=`123` &mode=`year`]]

Available Properties¶

Defaults below match the snippet source. Empty Default means the snippet falls back as described.

The snippet also reads a property named monthSeparator, but current source joins groups with a hardcoded newline and never applies that property. Prefer resourceSeparator for item spacing inside a group.

Chunks¶

groupTpl (monthContainer / yearContainer)¶

Default month wrapper:

<li><a href="[[+url]]">[[+month_name]] [[+year]]</a>
<ul>
[[+resources]]
</ul>
</li>

Default year wrapper:

<li><a href="[[+url]]">[[+year]]</a>
<ul>
[[+resources]]
</ul>
</li>

[[+resources]] holds the rendered itemTpl chunks for that group. Group placeholders include url, month_name, month, year, year_two_digit, day, weekday, weekday_abbr, weekday_idx, resources, and idx.

itemTpl (itemBrief)¶

Default item chunk:

<li><a href="[[~[[+id]]]]">[[+pagetitle]]</a></li>

Each item gets the Resource fields plus date helpers (date, month_name, month, year, and related), cls, idx, and altCls when the row is odd-numbered.

See Also¶

• Archivist
• Archivist snippet
• getArchives