WP Table Image

A plugin for showing images in WordPress

by Tito Malaspina · github.com/tmalaspina/wptableimage

★ 0stars

0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/tmalaspina/wptableimage/archive/refs/heads/main.zip

Readme github.com/tmalaspina/wptableimage ↗

WP Table Image — Plugin WordPress

Inserisce una griglia di immagini all'interno di articoli e pagine WordPress tramite una semplice shortcode. Al click su un'immagine si apre un lightbox che la mostra alla massima dimensione possibile lasciando un margine del 20% dal bordo dello schermo.

Installazione

Copia la cartella wpTableImage/ in wp-content/plugins/
In alternativa, crea un archivio ZIP della cartella e caricalo da Plugin → Aggiungi nuovo → Carica plugin
Attiva il plugin dalla pagina Plugin → Plugin installati

La struttura dei file deve essere:

wpTableImage/
├── wpTableImage.php
└── assets/
    ├── wpTableImage.css
    └── wpTableImage.js

Utilizzo

Inserisci la shortcode nel contenuto di un articolo o di una pagina:

[wpTableImage urls="https://esempio.com/foto1.jpg
                   https://esempio.com/foto2.jpg
                   https://esempio.com/foto3.jpg"]

Gli URL possono essere scritti uno per riga, separati da spazi o da virgole.

Parametri

Parametro	Default	Descrizione
`urls`	—	Lista degli URL delle immagini (obbligatorio)
`cols`	`3`	Numero di colonne della griglia
`gap`	`10`	Spazio in pixel tra le immagini
`rounded`	`true`	Angoli arrotondati: `true` o `false`
`caption`	`false`	Mostra il nome del file come didascalia al passaggio del mouse: `true` o `false`
`img_width`	`100%`	Larghezza di ogni immagine: qualsiasi valore CSS valido (`200px`, `50%`, `auto`, `10rem`, ecc.)
`img_height`	`auto`	Altezza di ogni immagine: qualsiasi valore CSS valido (`150px`, `auto`, ecc.)
`use_table`	`false`	Usa il tag `<table>` invece di `<div>` con CSS Grid: `true` o `false`

I valori accettati per img_width e img_height sono: auto oppure un numero seguito da px, %, em, rem, vw o vh. Valori non validi vengono ignorati e sostituiti dal default.

Esempi

Griglia base a 3 colonne:

[wpTableImage cols="3" urls="https://esempio.com/a.jpg
                             https://esempio.com/b.jpg
                             https://esempio.com/c.jpg"]

4 colonne con spaziatura maggiore e didascalia:

[wpTableImage cols="4" gap="16" caption="true" urls="https://esempio.com/a.jpg
                                                     https://esempio.com/b.jpg"]

Larghezza fissa, altezza proporzionale:

[wpTableImage cols="3" img_width="200px" img_height="auto" urls="..."]

Altezza fissa, larghezza proporzionale:

[wpTableImage cols="4" img_width="auto" img_height="150px" urls="..."]

Rendering con tag <table>:

[wpTableImage use_table="true" cols="3" urls="..."]

Senza angoli arrotondati:

[wpTableImage rounded="false" urls="..."]

Comportamento responsive

Indipendentemente dai parametri impostati, la griglia si adatta automaticamente alle schermate piccole:

sotto 600px di larghezza → 2 colonne
sotto 400px di larghezza → 1 colonna

Al click su qualsiasi immagine si apre un lightbox a schermo intero. L'immagine viene mostrata alla dimensione massima possibile mantenendo le proporzioni originali, con un margine del 20% dal bordo dello schermo. Il lightbox si chiude cliccando fuori dall'immagine oppure premendo il tasto Esc.

Requisiti

WordPress 5.0 o superiore
PHP 7.4 o superiore

Licenza

GPL2 — vedi file LICENSE per i dettagli.