NewsBoard Extra, Una newsboard di semplice ed immediato utilizzo, pronta per essere inserita nei vostri forum

Introduzione

Questo script permette di inserire nel vostro forum e far visualizzare, dove preferite , una bacheca annunci / newsboard molto particolare. Essa infatti è gestita tramite una discussione del forum in cui è utilizzata, e quindi non è necessario inserire o modificare le news dal pannello amministrativo Codice HTML, basterà infatti aggiungere, rimuovere o modificare un post nel topic designato, per ottenerne l'inserimento o la modifica o al rimozione anche nella newsboard (verranno visualizzate direttamente le ultime due pagine del topic, quindi 30 news, sotto alle news visualizzate sarà presente un link alla discussione, che consentirà di accedervi direttamente e renderà più agevole la consultazione di tutte le news).

Particolare importante, la discussione utilizzata per la gestione delle news va o chiusa, in modo che possano scrivervi soltanto amministratori o moderatori (utilizzando il modulo di risposta rapida) o inserita in una sezione con restrizioni, in modo che possano scrivervi solo gli utenti abilitati (è comunque possibile utilizzarla come "pseudo tagboard" se si lascia la discussione utilizzabile da tutti gli utenti, o da gruppi di utenti abilitati).

Un'ultima cosa sul funzionamento, mentre gli utenti visualizzano soltanto il link che dalla NewsBoard Extra porta direttamente alla discussione (il link Guarda tutte le News... situato sotto alle news visualizzate), gli amministratori hanno a disposizione anche altre opzioni

1) un link che porta direttamente al modulo di inserimento messaggi della discussione (questo link aggiungi una news.)

2) due opzioni visualizzate a sinistra di ogni news, cliccando sulla prima icona gli amministratori potranno accedere direttamente al pannello di modifica del messaggio che contiene la news, cliccando sulla seconda potranno invece visualizzare direttamente quel messaggio.

Installazione

Lo script si compone di tre parti. Per installarlo, inserite in Amministrazione -> Grafica -> Codice HTML nel box Codice HTML che sarà mostrato in FONDO a tutte le pagine una prima parte non modificabile:

e una seconda parte personalizzabile:

Nella parte personalizzabile, al posto di {CODICE} andranno inseriti i parametri per la gestione e la personalizzazione della newsboard.

Inserito questo, va inserito (sempre in Codice HTML) nel punto dove si vuole visualizzare la newsboard. questa parte di codice:

come "contenitore" della newsboard potete utilizzare una tabella con grafica uguale a quella del forum ad una riga e una colonna, come è stato fatto per la newsboard dimostrativa che potete vedere in questa sezione

https://newsboard.forumfree.it/?f=11255019

oppure potete inserirla all'interno di una cella dati di una tabella più grande.

Personalizzazione

prima parte

I parametri utilizzabili nella parte personalizzabile sono:

1) NBidSez, in questo parametro va inserito il numero ID della sezione in cui è presente il topic che fungerà da newsboard, ad esempio NBidSez = "1234";.

2) NBidTopic, parametro simile al precedente, in questo va inserito l'ID del topic che fungerà da newsboard, ad esempio NBidTopic = "1234";.

come trovare i numeri ID di sezione e discussione

www.forumfree.it/?l=0&wiki=ID

questi due parametri sono ovviamente necessari al funzionamento della newsboard, gli altri parametri opzionalmente utilizzabili sono:

3) NBshowNick consente di scegliere se far visualizzare (true) o non visualizzare (false) il nick dell'utente che ha inserito la news. Di default è false, quindi gli utenti visualizzeranno, al posto del nickname dell'utente, un nickname generico personalizzabile, un esempio è NBshowNick = true; (gli amministratori vedono comunque il nick dell'utente che ha postato la news).

4) NBstaffNick, questo parametro personalizza il nickname generico che appare come autore delle news postate, al posto del vero nickname dell'autore (di default è "Staff"). Potete inserire qualsiasi nickname desideriate, un esempioè NBstaffNick = "Nick Staff";

5) NBmaxTextSize, permette di scegliere la lunghezza massima del testo (il numero dei caratteri visibile nella newsboard, per ogni news) prima del link "Continua a leggere" che rimanda al post. Ad esempio NBmaxTextSize = 100;

6) NBtextArea, con quest'ultimo parametro si può far visualizzare, agli amministratori, una textarea per l'invio rapido dei post simile a quella della tagboard (l'utilizzo di questa opzione è sconsigliato, di default è impostata a false). Ad esempio NBtextArea = false; .

7) NBseeAll per modificare la scritta 'Guarda le news precedenti...', ad esempio NBseeAll = 'test'.

8) NBajaxLoader per modificare l'immagine di caricamento, ad esempioNBajaxLoader = 'https://i.imgur.com/vDdID1b.gif;.

  

Queste sono le personalizzazioni di funzionamento possibili tramite i parametri inseribili direttamente nello script, nella seconda parte della guida trovate quelle grafiche ottenibili agendo in colori e stili.

Edited by A c e - 8/1/2015, 10:44

Personalizzazione

seconda parte

Oltre alle personalizzazioni ottenibili tramite i parametri dello script, è anche possibile intervenire sull'aspetto della Newsboard Extra, aggiungendo in colori e stili gli appositi selettori, le personalizzazioni possibili sono numerose, elencheremo qui i selettori principali (e più utili):

A) #topic_newsboard .list li, questo selettore corrisponde alle righe delle news, e permette di personalizzarle modificando, per esempio, colore di sfondo, tipo di font, colore del testo, dimensioni oppure consente di aggiungere bordi (il selettore identifica tutta la riga, e quindi agisce su tutto il contenuto), le varianti più importanti sono

 1a) #topic_newsboard .list li img, che ha effetto su eventuali immagini inserite nella news, potete ridimensionarle (per evitare spaginamenti), esempio #topic_newsboard .list li img {max-height: 15px}, o nasconderle, esempio #topic_newsboard .list li img {display: none} (l'utilizzo di questo selettore è consigliato)

 2a) #topic_newsboard .list li:first-child, questa variante identifica l'ultima news inserita (il primo messaggio visibile in alto) e permette di evidenziarlo, ad esempio si può fare in modo che l'ultima news inserita abbia sempre il testo dello stesso colore (diverso da quello delle altre news)

il selettore #topic_newsboard .list li identifica l'intera riga, per agire solo sul messaggio dovete utilizzare il prossimo selettore

B) .nb_message, questa classe identifica il testo delle news (non agisce, quindi, su data e ora o nicknames), anche questo selettore consente di modificare colore del testo, colore dello sfondo, tipo e dimensione di font, eccetra, se volete agire solo sul testo dell'ultima news postata dovrete quindi utilizzare questa combinazione di selettori #topic_newsboard .list li:first-child .nb_message

C) .nb_when, con .nb_when potete modificare l'aspetto della data e ora in cui le news sono state postate (colore, font, eccetra)

D) .nb_nick, questa classe, invece, consente di agire suil nickname, se volete applicare le modifiche solo al nickname generico (quello inserito tramite lo script) la classe da utilizzare diventa .nb_nick b, se invece fate visualizzare i nickname reali degli autori (gli amministratori li visualizzano comunque) potete personalizzarli con la classe .nb_nick a.

La NewsBoard Extra, così come è generata dallo script, ha una altezza ottimale di 100 pixel, quando le righe delle news superano quell'altezza viene visualizzata una scrollbar, se desiderate che la vostra NewsBoard Extra abbia un'altezza superiore (ad esempio perchè desiderate che news importanti siano comunque visualizzate immediatamente, senza l'utilizzo della scroll, anche se vi sono news più recenti) potete utilizzare, sempre in colori e stili, questo selettore

#newsboard_object {height: XXpx!important; overflow: auto}

al posto di XX inserite il valore di altezza che desiderate, si consiglia di non diminuire l'altezza della newsboard e di non superare l'altezza di 200 pixel.



Edited by Kakashi - 1/5/2014, 14:33