About this plugin
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
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
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:
com.