Primo List

Description

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.