# Esempi di donazione

## Configurazione e casi d'uso

Ogni esempio di donazione (cost example) si compone di: immagine, titolo, descrizione, importo, e il flag opzionale "quantità limitata".

Buona pratica generale: 3 esempi, massimo 4. Per l'importo predefinito nel campo libero (quello sotto agli esempi), conviene impostare una cifra diversa da quelle proposte negli esempi (es. se gli esempi sono 10/25/50, mettere 15 come predefinito): serve a segnalare al donatore che sono possibili anche importi diversi da quelli suggeriti, "rompendo" visivamente lo schema dei cost example.

### Quantità limitata: caso d'uso ticketing

Il flag "quantità limitata" è pensato principalmente per campagne di tipo biglietto/evento a numero chiuso: si imposta una quantità totale disponibile (es. 100), e ogni volta che qualcuno effettua quella donazione/acquisto, la quantità disponibile scala di uno. Utile ad esempio per gestire un evento con posti limitati, tenendo eventualmente da parte una quota riservata (es. su 100 posti, 20 riservati e 80 messi in vendita, impostando quantità 80). Se non serve, il flag va lasciato disattivato.

## Scopo

Questa sezione descrive come modificare l'ordinamento degli esempi di donazione visualizzati sulla pagina campagna, ad esempio per mostrarli dall'importo più alto al più basso.

## Quando usare

Usa questa procedura quando vuoi che gli esempi di donazione appaiano in un ordine diverso da quello predefinito (crescente). È necessario intervenire nel codice del template; si consiglia di farlo solo se si ha familiarità con il linguaggio di templating Liquid utilizzato da Riseact.

## Procedura

1. Vai nel pannello di amministrazione della campagna e seleziona **Modifica codice**.
2. Apri lo snippet **campaign-cost-examples.html**.
3. Individua la riga che contiene il tag:
   `{% for cost_example in campaign.cost_examples`
4. Per ordinare gli esempi dall'importo **più alto al più basso**, applica un filtro di ordinamento inverso sulla variabile. La sintassi esatta dipende dalla versione del template: verifica la riga e modifica di conseguenza aggiungendo il filtro `| reverse` o l'ordinamento per campo importo in ordine decrescente.
5. Salva le modifiche e verifica il risultato sulla pagina campagna in anteprima.

## Note operative

- La modifica è applicata a livello di template del singolo snippet: interessa tutte le campagne che usano quel template, a meno che non venga creata una copia dedicata per la campagna specifica.
- L'ordinamento predefinito degli esempi di donazione segue l'ordine di inserimento nel pannello di amministrazione. Puoi anche modificare l'ordine direttamente dal pannello trascinando gli esempi, senza intervenire nel codice.
- Se non sei sicuro di come intervenire nel codice, contatta il supporto prima di apportare modifiche in produzione.

## Da verificare

- Confermare la sintassi esatta del filtro Liquid supportata dalla versione attuale del motore di template di Riseact.
- Verificare se esiste un'opzione di ordinamento configurabile da interfaccia grafica nelle versioni future del prodotto.