Funzionalità
I codici pubblicati in questa guida vi consentiranno di personalizzare il tag SPOILER, modificandolo e aggiungendovi nuove funzionalità, potrete inserire il tag personalizzato in tutto il forum o solo in sezioni di vostra scelta (sì può scegliere in quali sezioni inserirlo o in alternativa escludere le sezioni dove non inserirlo).
Le modifiche / personalizzazioni ottenibili, grazie a questi script, sono:
- Spoiler apribili singolarmente, in una pagina di discussione dove siano presenti più spoiler, cliccando su uno di essi si aprirà solo lo spoiler cliccato e non tutti quelli presenti.
- Possibilità di inserire spoiler plus, contenenti un avviso che verrà visualizzato da chi cliccherà lo spoiler, prima che si apra e il contenuto venga visualizzato, l'avviso sarà visualizzato in una finestra di conferma a due pulsanti, e l'utente potrà scegliere se cliccare su OK e visualizzare il contenuto o annullare l'apertura.
- Possibilità di scegliere se utilizzare un unico pulsante per inserire gli spoiler (cliccandolo si potrà scegliere se inserire uno spoiler con avviso o uno spoiler normale) oppure aggiungere un pulsante specifico per gli spoiler plus.
Lo script spoiler plus è
parzialmente compatibile con la versione mobile di ForumFree (va aggiunta una apposita dichiarazione di stile in
Mobile/App), utilizzando la versione mobile
non è possibile inserire spoiler plus, per inserirne uno mentre si utilizza un dispositivo mobile basta passare temporaneamente alla versione desktop del forum.
Installazione
Per installare lo script base è sufficiente questo script:
HTML
<script type="text/javascript" src="http://nb.forumfree.it/scripts/ace/spoilerplus.js"></script>
da inserire in Amministrazione → Grafica →
Codice HTML, nel box "Codice HTML che sarà mostrato
in FONDO a tutte le pagine".
Parametri opzionali
nbSpArrSecEs, consente di escludere le sezioni dove
non si vuole inserire lo spoiler plus, esempio:
HTML
<script type="text/javascript">
var nbSpArrSecEs = ["sezioneesclusa1","sezioneesclusa2","sezioneesclusa3"];
</script>
<script type="text/javascript" src="http://nb.forumfree.it/scripts/ace/spoilerplus.js"></script>
al posto di sezionesclusa1 eccetra vanno inseriti i
numeri ID delle sezioni da escludere dallo spoiler plus.
nbSpArrSecAb, consente di abilitare specifiche sezioni
dove inserire lo spoiler plus, esempio:
HTML
<script type="text/javascript">
var nbSpArrSecAb = ["sezioneinclusa1","sezioneinclusa2","sezioneinclusa3"];
</script>
<script type="text/javascript" src="http://nb.forumfree.it/scripts/ace/spoilerplus.js"></script>
al posto di sezioneinclusa1 eccetra vanno inseriti i
numeri ID delle sezioni dove volete utilizzare lo spoiler plus.
Se nessuno dei due parametri è specificato lo spoiler plus verrà inserito in tutto il forum, se desiderate inserirlo solo in specifiche sezioni potete utilizzare uno dei due parametri (se volete inserirlo in poche sezioni converrà utilizzare il secondo, se invece si tratta di molte sezioni sarà più pratico utilizzare il parametro che esclude le sezioni dove non volete lo spoiler plus,
i due parametri non si possono utilizzare contemporaneamente).
nbSpAddButton, qui potete scegliere fra due possibili valori,
true se volete aggiungere un pulsante specifico per gli spoiler plus,
false per utilizzare un unico pulsante, quello SPOILER già presente, a cui verrà aggiunta una opzione per scegliere fra spoiler classico e spoiler plus, esempio
HTML
<script type="text/javascript">
var nbSpAddButton = true;
</script>
<script type="text/javascript" src="http://nb.forumfree.it/scripts/ace/spoilerplus.js"></script>
nel caso omettiate questo parametro lo script funzionerà con l'opzione
false, quindi con un unico pulsante.
Un esempio completo di codice potrà essere:
HTML
<script type="text/javascript">
var nbSpArrSecEs = ["sezioneinclusa1","sezioneinclusa2","sezioneinclusa3"];
var nbSpAddButton = true;
</script>
<script type="text/javascript" src="http://nb.forumfree.it/scripts/ace/spoilerplus.js"></script>
Versione mobile/app
Per la versione mobile, aggiungere questo css in Amministrazione → Funzioni aggiuntive →
Mobile/App, nel primo box della pagina con gli altri css:
CODICE
/* SPOILER PLUS */
.spoiler {position: relative}
.spoiler .spoilermessage:not(:active) {position: absolute; width: 100%; font-size: 0}
.spoiler .spoilermessage:not(:active):after {content: attr(data-msg); font-size: 9pt}
Per quanto riguarda la dichiarazione di stile, serve a rendere gli spoiler plus parzialmente compatibili con la versione mobile di forumfree, nel caso non la inseriate gli spoiler plus saranno visualizzati, nella versione mobile, come spoiler normali, utilizzandola verrà prima visualizzato, all'apertura dello spoiler plus, il messaggio d'avviso, basterò cliccare su questo messaggio per visualizzare l'effettivo contenuto dello spoiler.
