Topic Cards & Reference Sheets
Topic Cards (Explore Topics)
Location
- GP Element: ID 4091 — ID86 Niche Cards
- Display:
general:front_page - CSS:
.id86-niche-grid(4-column CSS grid)
HTML
<section class="id86-section id86-niche-cards">
<div class="id86-shell">
<div class="id86-section-heading">
<h2>Explore topics</h2>
</div>
<div class="id86-niche-grid">
<a class="id86-niche-card id86-code" href="/category/code/">
<h3>Code</h3>
<p>Languages, tools, and everyday development patterns.</p>
</a>
<!-- ... DevOps, AI, Security ... -->
</div>
</div>
</section>
Responsive Behavior
| Viewport | Columns |
|---|---|
| > 960px | 4 |
| 601–960px | 2 |
| ≤ 600px | 1 |
Card Anatomy
Each card has:
- 4px colored top border matching the category (
--id86-card). - White background with a 1px border.
- Hover:
translateY(-5px)lift with increased shadow. - Min height:
clamp(164px, 18vw, 210px).
Category Colors
| Class | --id86-card |
|---|---|
.id86-code | #2597d5 (sky) |
.id86-devops | #2273bf (blue) |
.id86-ai | #1f64a6 (dark blue) |
.id86-security | #0b2149 (navy) |
Technology Cards (Explore Technologies)
GP Element: ID 4414 — ID86 Tech Cards
Shortcode: [id86_tech_cards limit="18" link="1"]
Hook: generate_after_header, priority 25 — renders between Topic Cards (20) and Latest Reference Sheets (30)
Display: general:front_page
Full index: /technologies/ — page ID 4416
A band of small monospace name tiles directly below the topic cards. The card carries the technology name and nothing else: no description, no post count, no icon, no category label. It is the devhints.io chip (`bash` Bash scripting) promoted to a tile, which keeps the landing page dense without adding a fourth full-height section.
18 cards, three rows of six. Each row is a semantic group even though no row label is printed:
| Row | Theme | Slugs |
|---|---|---|
| 1 | Languages and markup | rust php python sql css javascript |
| 2 | Platform and data | wordpress wp-cli woocommerce mysql postgresql sqlite |
| 3 | Infrastructure and tooling | linux docker nginx cloudflare git bash |
The grouping only holds at 6 columns. At 4 (tablet) and 2 (mobile) the grid reflows and the semantic rows dissolve — the arrangement is a scanning aid, not a data structure.
Why 18
Measured against the 10,614-document corpus:
| Cards | Rows (desktop) | Docs reachable from a visible chip |
|---|---|---|
| 12 | 2 | 68.6% |
| 18 | 3 | 74.5% |
| 24 | 4 | 80.0% |
| 48 | 8 | 88.0% |
18 is the last step with a strong return: +5.9 points of coverage for one extra row. Past 24 the curve flattens, and at 48 the band stops being a shortcut — 8 rows on desktop, 24 rows on mobile, where it is taller than the hero.
HTML
<section class="id86-section id86-tech-cards">
<div class="id86-shell">
<div class="id86-section-heading">
<h2>Explore technologies</h2>
</div>
<nav class="id86-tech-nav" aria-label="Technologies">
<div class="id86-tech-grid">
<a class="id86-tech-card" href="/tag/rust/">
<span class="id86-tech-card__name">rust</span>
</a>
<!-- ... -->
</div>
</nav>
<p class="id86-tech-more">
<a class="id86-tech-more__link" href="/technologies/">
View all 69 technologies <span aria-hidden="true">→</span>
</a>
</p>
</div>
</section>
The grid is wrapped in a <nav> landmark with an aria-label, so a screen reader announces "Technologies, navigation" instead of 18 loose links. The aria-label is settable per instance with nav_label.
Where the list is controlled
The cards are not driven by tag counts or a query loop. They come from an explicit allowlist in the FluentSnippets PHP snippet 5-id86-technology-cards.php:
function id86_tech_tags() {
return apply_filters('id86_tech_tags', [
// Row 1 — languages and markup
'rust', 'php', 'python', 'sql', 'css', 'javascript',
// Row 2 — platform and data
'wordpress', 'wp-cli', 'woocommerce', 'mysql', 'postgresql', 'sqlite',
// Row 3 — infrastructure and tooling
'linux', 'docker', 'nginx', 'cloudflare', 'git', 'bash',
// Everything below here is index-only: /technologies/ continues from this point
'rclone', 'shell', 'openlitespeed', /* … 48 more … */
]);
}
One array serves both the homepage band and the index page. The homepage takes the first 18 via limit="18"; the index takes all of it via limit="0".
Rules:
- Array order is display order, everywhere. The index page is a superset of the homepage band in the same order, so a reader who clicks through sees the same first 18 in place.
- Anything not listed is excluded. No separate exclude list, no automatic inclusion — junk tags (
test,demo,Featured) can never reach either surface. - A listed slug with no published posts is skipped (
hide_empty). - The 18-slot cut happens after that filter, so a homepage slot held by an empty tag is backfilled by the next qualifying slug. You do not need to reshuffle when a technology has no posts yet.
- Slugs are
post_tagslugs — lowercase and hyphenated.
Editing the list
Where: wp-content/fluent-snippet-storage/5-id86-technology-cards.php, lines 39–56 — or in WP admin at FluentSnippets → Snippets → ID86 Technology Cards.
The array holds 69 slugs. Positions 1–18 are the homepage band; 19 and beyond are index-only.
| Goal | Action |
|---|---|
| Swap a homepage tile | Replace the slug in place, then delete the old slug from the index-only block so it is not listed twice |
| Add to the homepage | Cut a slug from the index-only block and paste it into the slot you want |
| Remove a technology | Delete the slug from the array — it leaves both the band and the index |
| Reorder | Move slugs; position 1 renders first, left to right then top to bottom |
| Try before committing | Use include="" on the shortcode rather than editing the array |
Keep six slugs per row if the semantic rows should hold at desktop width — a five- or seven-entry row shifts every subsequent tile by one.
After saving:
-
FluentSnippets rewrites its own
index.php. Do not edit that file. -
Purge both cache layers, or the front end keeps serving the old band:
# on GC-US-M10curl --resolve id86.net:443:127.0.0.1 "https://id86.net/?LSCWP_CTRL=PURGESINGLE"Then the Cloudflare
purge_cachecall forhttps://id86.net/andhttps://id86.net/technologies/. -
Confirm the order that will render:
wp eval 'echo implode(", ", array_slice(id86_tech_tags(), 0, 18));'
A slug must already exist as a post_tag with at least one post; otherwise it is skipped silently rather than erroring. Check first with wp term list post_tag --slug=rclone.
Shortcode attributes
| Attribute | Default | Purpose |
|---|---|---|
limit | 18 | Max cards rendered. 0 renders the whole allowlist |
min | 1 | Minimum post count for a tag to render; 0 allows empty tags |
min_cards | 0 | Return nothing unless at least this many cards qualify — use 6 at launch so a sparse row never ships |
include | — | Comma-separated slugs that replace id86_tech_tags() for this instance |
exclude | — | Comma-separated slugs to drop from the resolved list |
orderby | manual | manual (array order), count, or name |
link | 0 | 1 always appends the index link — "View all N technologies" when the band is truncated by limit, otherwise "Browse all technologies" |
link_url | /technologies/ | Target for that link |
nav_label | Technologies | aria-label on the wrapping <nav> |
Companion shortcode: [id86_tech_count] returns how many allowlisted technologies currently have at least one post.
Responsive Behavior
| Viewport | Columns |
|---|---|
| > 960px | 6 |
| 601–960px | 4 |
| ≤ 600px | 2 |
Two columns are kept at 600px and below rather than one: the tiles are short enough that a single column wastes a full screen of height.
Card Anatomy
- White background,
1px solid #dde7efborder,10pxradius. min-height: 58pxfixed, so the band never shifts layout (CLS = 0). Drops to52pxat 600px and below; both clear the 48px mobile hit-target rule.- Name in monospace,
0.9rem / 600,var(--id86-navy). - Hover:
border-color: var(--id86-sky),translateY(-2px),0 6px 14px rgba(20,50,108,.10). - Focus-visible:
2pxsky outline with2pxoffset. - Long names truncate with an ellipsis instead of wrapping, so every row stays the same height.
Empty State
The shortcode returns an empty string when no listed tag qualifies, and the section disappears entirely. Nothing is printed, so there is no empty heading or half-row.
CSS Location
The card styles live in the FluentSnippets CSS snippet 6-id86-technology-cards-css.php, printed inline in wp_head at priority 10. They are scoped to .id86-tech-* and .id86-section.id86-tech-cards, so no rule leaks onto other pages. The same classes render the /technologies/ grid. See CSS System.
The /technologies/ Index Page
Page: ID 4416 — /technologies/
Title: All Technologies
Same card component, no limit. It mirrors the homepage order and continues past the first 18.
<style id="id86-tech-index-css">…</style>
<div class="id86-tech-index">
<section class="id86-tech-index__hero">
<div class="id86-tech-index__inner">
<p class="id86-kicker">Instant Documentation</p>
<h1>All technologies</h1>
<p class="id86-tech-index__lede">Every technology with at least one published reference.</p>
</div>
</section>
<section class="id86-section id86-tech-index__body">
<div class="id86-shell">
<p class="id86-tech-index__count">[id86_tech_count] technologies available</p>
[id86_tech_cards limit="0" min="1" link="0" nav_label="All technologies"]
</div>
</section>
</div>
- Uses the recommendations-page pattern: one inline scoped
<style>plus a full-bleed hero (margin-left: calc(50% - 50vw)), because page content sits in the theme's narrowentry-contentcolumn. The body section breaks out the same way so the grid can reach 1180px. - The hero supplies the only
<h1>; the theme renders no duplicate page title (verified: 1<h1>). [id86_tech_count]prints the live number of technologies with at least one post, so the page never claims "69 technologies" while only a handful exist.link="0"stops the index linking to itself.- At the full 69 technologies the grid is 12 rows on desktop and 35 on mobile. That is correct for an index page and wrong for the homepage — which is exactly why the homepage truncates at 18.
Latest Reference Sheets
Location
- GP Element: ID 4092 — ID86 Latest Sheets
- Content:
[id86_latest_sheets limit="6"]shortcode - CSS:
.id86-sheet-grid(3-column CSS grid)
Shortcode Output
The id86_latest_sheets_shortcode function renders each homepage reference as a sheet card with topic + content type, no excerpt, updated date, and Read more:
<article class="id86-sheet-card">
<div class="id86-archive-meta">
<span class="id86-archive-category">Code</span>
<span class="id86-archive-type">Quick Reference</span>
</div>
<h3><a href="/code/git-cheat-sheet/">Git Quick Reference</a></h3>
<div class="id86-archive-card__footer">
<span class="id86-archive-updated">Updated Aug 13, 2026</span>
<a class="id86-sheet-link" href="/code/git-cheat-sheet/">Read more →</a>
</div>
</article>
Responsive Behavior
| Viewport | Columns |
|---|---|
| > 960px | 3 |
| 601–960px | 2 |
| ≤ 600px | 1 |
Card Anatomy
- White background, 1px border.
- Topic + content-type badges in the meta row.
- Title link (whole card clickable).
- Footer with updated date and "Read more →" link.
- No excerpt/text preview.
- Natural card sizing (no fixed min-height).