內容簡介
Primo List 是一款獨立且無依賴的外掛，專為顯示精選項目列表而設計。每個項目可包含標誌/圖片、標題、副標題、內容、可選連結及一個或多個類別，並可透過 [primo_list] 短碼在任何地方呈現。
【主要功能】
• 自訂項目類型，包含標誌、標題、副標題等
• 支援多類別分配及自訂顏色
• 可手動拖放排序項目
• 提供三種佈局選擇：卡片網格、標誌牆及列表
• 內建燈箱功能，顯示完整圖片
• 每個項目可設定連結文字
外掛標籤
開發者團隊
原文外掛簡介
Primo List is a self-contained, dependency-free plugin for displaying curated
lists of items. Each item has a logo/image, heading, subtitle, body, optional
link and one or more categories. Render any list anywhere with the
[primo_list] shortcode.
Sponsor walls, partner logos, staff directories, product features: one
portable tool. No Custom Post Type UI, no ACF, no Bootstrap, no external
libraries, no tracking, no external HTTP calls.
Features
Custom post type Item with logo (featured image), heading (title),
subtitle, body and link.
Flat Category taxonomy, multi-assignable, with a per-category weight
(prominence/sort) and optional accent colour.
[primo_list] shortcode with category, id, layout, columns,
columns_mobile, headings, orderby, limit, lightbox, fit and
ratio attributes.
Manual ordering by drag and drop: an Order column on the Items list lets you
drag items into place, saved as you go. Use orderby="menu_order" to have that
hand-set order override category weights entirely; otherwise it breaks ties
under the default weight ranking.
Uniform tiles for mixed-proportion images. Tiles default to square
(ratio="1:1"); set ratio to any W:H, or ratio="auto" to size tiles to
each image. Choose fit="cover" (crop to fill, for art and photos) or fit="contain"
(letterbox the whole image with padding around it, for logos, never cropped).
The lightbox always shows the full, uncropped image.
Per-item crop focus (top / center / bottom / corners) so a cover crop
keeps the important part of each image (e.g. a subject’s head).
Front-end edit pencil on each item for logged-in editors; jump straight to
an item’s editor while curating a gallery (never shown to visitors).
Filter items by category on the admin Items list (a dropdown above the table).
Filtering also shows the ready-to-copy shortcode for that exact category, so you
can paste it straight into a page.
Three layouts: a responsive card grid, a compact logo wall, and a
list (image beside text, one row per item, e.g. a books/catalogue page).
Responsive columns you control. columns sets the desktop count; grids
step down to two per row on a tablet and one on a phone. Set
columns_mobile=”2″ (or more) to keep several across on a phone; useful for
a logo wall, where one giant logo per row wastes the screen.
Per-item initials shown in place of a missing image. An item with no image
and no initials shows nothing at all and the tile closes up around it.
Per-item link text so the button reads “Purchase”, “Read more”, etc.
(defaults to “Visit”).
Built-in lightbox (on by default): click an image to view the full-size
version in an overlay, with prev/next and keyboard navigation. Pure vanilla
JavaScript, no jQuery or third-party library; degrades to opening the image
when JavaScript is off. Disable per list with lightbox="no".
Weight-based ranking that ignores the category you filtered on, so tiers
sort correctly (gold before bronze).
Optional, off-by-default single item pages.
Logos render contained: wide or tall logos are never cropped.
Documentation, worked examples and other plugins:
primowp.com.
