Gestisci le immagini dei prodotti

ps_manage_product_images

ProSolo TellMyShop Pro
Scrittura · anteprima + approvazione
Salva: subito
Contenuti e SEO e Catalogo · scrive subito
Visibile subito dopo l’installazione

Aggiunge foto dei prodotti da link web, sceglie la foto principale e imposta l’ordine delle foto.

TellMyShop Free: No. Questo strumento è solo in TellMyShop Pro. TellMyShop Free ha solo report pronti che leggono il tuo negozio.

Chiedi alla chat

«Aggiungi queste due foto alla lampada Nova e rendi la prima la foto principale: https://example.com/nova-1.jpg https://example.com/nova-2.jpg»

Anteprima di esempio

Prodotto 245 Lampada da giardino Nova, nera: aggiungi 2 immagini da example.com. L’immagine 1 diventa la copertina. Testo alternativo in tutte le lingue: "Lampada da giardino Nova, nera". Il prodotto non ha ancora immagini.

Dettagli tecnici

action=list mostra le immagini del prodotto (ID, posizione, copertina, testo alternativo, URL). action=add aggiunge fino a 10 immagini da link https pubblici (JPEG, PNG, GIF o WebP, massimo 10 MB ciascuna); legend è il testo alternativo (predefinito: nome del prodotto), cover=true rende la prima nuova immagine la copertina. action=set_cover imposta la copertina (image_id). action=reorder mette image_ids all’inizio nell’ordine indicato, le altre seguono. action=delete rimuove le immagini (image_ids); questo NON SI PUÒ ANNULLARE e richiede confirm_delete=true. Testi alternativi delle immagini esistenti: ps_update_image_legends.

Parametri

Nome	Tipo	Obbligatorio	Descrizione
action	enum: list \| add \| set_cover \| reorder \| delete	sì	list \| add \| set_cover \| reorder \| delete.
product	string	sì	Il prodotto come lo indica una persona: "id:123", "ref:ABC-1", "ean:5901234123457", un URL di prodotto del negozio, un ID semplice (1–7 cifre), un EAN (8/12/13 cifre) o un riferimento. Massimo 300 caratteri.
shop_id	integer	no	ID del negozio in un’installazione multinegozio. Predefinito: il negozio dell’indirizzo del connettore. Gli ID sono elencati da ps_get_shop_info.
lang	string	no	Codice ISO della lingua, ad esempio pl o en. Predefinita: la lingua predefinita del negozio.
image_urls	array of string	quando	add: URL delle immagini. Massimo 10 elementi.
legend	string	no	add: testo alternativo delle nuove immagini, in tutte le lingue. Massimo 128 caratteri.
cover	boolean	no	add: rendi la prima nuova immagine la copertina. Predefinito false.
image_id	integer	quando	set_cover: l’immagine.
image_ids	array of integer	quando	reorder / delete: le immagini. Massimo 100 elementi.
confirm_delete	boolean	quando	delete: conferma che l’utente sa che l’eliminazione non si può annullare. Predefinito false.
confirm	boolean	no	false (predefinito) restituisce un’anteprima e non salva nulla. true esegue, solo dopo che l’utente ha approvato l’anteprima, insieme a change_token.
change_token	string	quando	Token dell’anteprima. Obbligatorio con confirm=true. Valido 30 minuti, monouso, legato agli argomenti e allo stato dei dati dell’anteprima.

Limiti

Un prodotto per chiamata. add: fino a 10 immagini, link https pubblici, JPEG/PNG/GIF/WebP, massimo 10 MB e 40 megapixel ciascuna. delete non si può annullare (confirm_delete=true); add, set_cover e reorder si possono annullare con ps_revert_change.

Cosa vedi prima che venga salvato qualcosa

La chat chiama prima lo strumento senza confermare. Il modulo restituisce un’anteprima (valori attuali e nuovi) e un token monouso valido 30 minuti. La chat ti mostra l’anteprima e salva la modifica solo dopo il tuo sì.

Strumenti correlati

Crea o duplica un prodotto ps_create_product
Aggiorna il testo alternativo delle immagini ps_update_image_legends
Leggi un prodotto ps_get_product
Annulla una modifica ps_revert_change

Casi d’uso con questo strumento

Ultimo aggiornamento: 2026-10-11