Primo List is a self-contained, dependency-free plugin for displaying curated\nlists of items. Each item has a logo\/image, heading, subtitle, body, optional\nlink and one or more categories. Render any list anywhere with the\n [primo_list] shortcode.<\/p>\n\n
Sponsor walls, partner logos, staff directories, product features: one\nportable tool. No Custom Post Type UI, no ACF, no Bootstrap, no external\nlibraries, no tracking, no external HTTP calls.<\/p>\n\n
[primo_list]<\/code> shortcode with category<\/code>, id<\/code>, layout<\/code>, columns<\/code>,\n columns_mobile, headings<\/code>, orderby<\/code>, limit<\/code>, lightbox<\/code>, fit<\/code> and\n ratio attributes.<\/li>\n- Manual ordering by drag and drop<\/strong>: an Order column on the Items list lets you\ndrag items into place, saved as you go. Use
orderby=\"menu_order\"<\/code> to have that\nhand-set order override category weights entirely; otherwise it breaks ties\nunder the default weight ranking.<\/li>\n- Uniform tiles for mixed-proportion images. Tiles default to square<\/strong>\n(
ratio=\"1:1\"<\/code>); set ratio<\/code> to any W:H<\/code>, or ratio=\"auto\"<\/code> to size tiles to\neach image. Choose fit=\"cover\"<\/code> (crop to fill, for art and photos) or fit=\"contain\"<\/code>\n(letterbox the whole image with padding around it, for logos, never cropped).\nThe lightbox always shows the full, uncropped image.<\/li>\n- Per-item crop focus<\/strong> (top \/ center \/ bottom \/ corners) so a
cover<\/code> crop\nkeeps the important part of each image (e.g. a subject's head).<\/li>\n- Front-end edit pencil<\/strong> on each item for logged-in editors; jump straight to\nan item's editor while curating a gallery (never shown to visitors).<\/li>\n
- Filter items by category<\/strong> on the admin Items list (a dropdown above the table).\nFiltering also shows the ready-to-copy shortcode for that exact category, so you\ncan paste it straight into a page.<\/li>\n
- Three layouts: a responsive card grid<\/strong>, a compact logo wall<\/strong>, and a\nlist<\/strong> (image beside text, one row per item, e.g. a books\/catalogue page).<\/li>\n
- Responsive columns you control.<\/strong>
columns<\/code> sets the desktop count; grids\nstep down to two per row on a tablet and one on a phone. Set\n columns_mobile=\"2\" (or more) to keep several across on a phone; useful for\na logo wall, where one giant logo per row wastes the screen.<\/li>\n- Per-item initials<\/strong> shown in place of a missing image. An item with no image\nand no initials shows nothing at all and the tile closes up around it.<\/li>\n
- Per-item link text<\/strong> so the button reads \"Purchase\", \"Read more\", etc.\n(defaults to \"Visit\").<\/li>\n
- Built-in lightbox<\/strong> (on by default): click an image to view the full-size\nversion in an overlay, with prev\/next and keyboard navigation. Pure vanilla\nJavaScript, no jQuery or third-party library; degrades to opening the image\nwhen JavaScript is off. Disable per list with
lightbox=\"no\"<\/code>.<\/li>\n- Weight-based ranking that ignores the category you filtered on, so tiers\nsort correctly (gold before bronze).<\/li>\n
- Optional, off-by-default single item pages<\/strong>.<\/li>\n
- Logos render contained: wide or tall logos are never cropped.<\/li>\n<\/ul>\n\n