Pagina aggiornata il: 14/01/2005 01:19

News Semi Pro v. 1.2

Per server con sistemi linux e unix

Puoi contattarmi presso shishii@tiscalinet.it
Il mio sito è www.shishii.com

ChangeLog

La versione 1.1 da la possibilità di usare due pannelli di gestione separati: uno per l'amministratore, ed uno per gli utenti.

La 1.2 da la possibilità di decidere la formattazione dei paragrafi.

I files e directory che troverai nel file compresso sono:

variabili.pl
news.pl
vis_news.pl
file_news.pl
vis_parole.pl
titoli.txt
contatore.txt
parole.txt
new.gif
ad_com_news.shtml----\___
pub_com_news.html---/ )
com_news.shtml-------------) Alternativi
news.shtml
ins_log.html
pages Directory
old_pages Directory
readme.html (questo file)

In generale

Questi scripts servono per inserire dinamicamente delle news in un sito web allocato su server UNIX-LINUX.

La struttura per grandi linee è la seguente:

Puoi scegliere se usare due pannelli di controllo separati (ad_com_news.shtml e pub_com_news.html) per l'amministratore e gli utenti od uno unico (com_news.shtml). In entrambe i casi tramite essi si inseriscono delle news contraddistinte da un titolo. Il titolo andrà a formare il link dinamico che comparirà nella pagina che presenta l'indice delle news che verrà formato dai titoli in ordine decrescente di inserimento. Quindi puoi inserire i titoli delle news in qualunque pagina preferisci, anche la home page. Il testo invece andrà a riempire una pagina html creata dallo script e su cui si giungerà tramite il link suddetto. Il pannello di controllo dell'amministratore consente di cancellare le news e il relativo link.

A differenza del precedente mio script "News_facili" questo è orientato a consentire ai visitatori la creazione di news in condizioni di relativa sicurezza.

Infatti il visitatore può solamente inserire news, mentre l'amministratore, identificato tramite password (non cryptata) può cancellare delle news, inserire in un elenco le parole vietate, cancellare dall'elenco le parole vietate. Si può scegliere per il corpo del testo se sostituire le parole vietate con una stringa di tua scelta oppure impedire la pubblicazione della news. Invece nel caso del titolo l'uso di una parola vietata impedisce sempre la pubblicazione della News.

Inoltre l'amministratore viene avvisato tramite mail in caso dei seguenti eventi:

Inserimento di una nuova news.
Tentativo di cancellazione di una news.
Tentativo di inserimento di una parola vietata.
Tentativo di cancellazione di una parola vietata.

In questi tre ultimi casi solo se non viene inserita la password o è scorretta. E' prevista anche la possibilità di usare un file di log per monitorare l'uso del pannello di controllo. Ogni inserimento nel log contiene anche l'identificazione dell'IP dell'operatore.

vi sono molte opzioni possibili:

puoi decidere se usare o meno il meccanismo del file locking per preservare i tuoi file.
puoi decidere se ricevere o meno le mail di avviso
puoi decidere se usare o meno il file di log
puoi decidere se fare svuotare automaticamente il file di log e la dimensione massima.
puoi decidere se sottoporre le nuove news ad un esame per evitare l'inserimento di parole vietate
puoi decidere se l'eventuale inserimento di parole vietate comporti la loro sostituzione con un testo scelto da te o il blocco dell'invio della news con messaggio d'errore.
puoi regolare l'ora tenendo conto del fuso orario del server su cui risiede il tuo sito
puoi decidere il numero massimo di news da visualizzare
le news che superano il numero massimo possono:
- essere lasciate nella directory pages
- essere cancellate definitivamente
- essere archiviate nella directory old_pages
in ogni caso il link delle news scadute viene cancellato automaticamente
puoi inserire automaticamente una piccola immagine accanto alle news particolarmente recenti
puoi decidere per quante ore una news va considerata particolarmente recente
puoi decidere se fare comparire la data ed ora di inserimento accanto al titolo della news e sotto il titolo della pagina relativa
puoi decidere se la data accanto al titolo deve essere scritta con un font di dimensione minore
puoi decidere il colore di sfondo e il background
puoi decidere quale formattazione usare per i paragrafi
puoi decidere il tipo e la dimensione dei font
puoi regolare i margini del testo delle pagine che contengono le news
puoi regolare colore, spessore, larghezza della linea orizzontale posta sotto il titolo
puoi scrivere il messaggio di "alt" che si evidenzia quando il mouse va sulla piccola immagine accanto al titolo
puoi decidere se usare uno stile css per i titoli linkati, in modo che non siano sottolineati ma che cambino colore al passaggio del mouse. Puoi decidere quali colori usare

Gli elenchi a tendina di pagine esistenti tra cui scegliere quelle da cancellare sono fatti con uno script che verifica le relative directory e genera il codice html necessario direttamente sul pannello, per cui tali dati sono sempre aggiornati automaticamente.

Sulla pagina html sono presenti JavaScript che consentono l'anteprima di pagine esistenti.

Settaggio

FILES pl

Tutti i files.pl devono essere settati e manipolati solo con editor specifici o con editor di testo puri tipo "blocco note" di windows. Devono essere inviati al server tramite client FTP, assicurandosi che la trasmissione avvenga in modalità ASCII. Si deve attribuire a tutti chmod 755, tranne che a variabili.pl al quale deve essere attribuito chmod 644.

FILES html

Si tratta del pannello di controllo, e della pagina di prova che serve a verificare il funzionamento degli script, prima dell'inserimento sulle pagine pubbliche. Le caratteristiche specifiche verranno illustrate di seguito. Le sezioni su cui devi intervenire sono segnalate nel corpo del codice tramite i tag di commento /*....*/ oppure . Non deve essere variato il chmod attribuito dal sistema. Inoltre vi è il file di log la cui estensione è html e il cui chmod deve essere 666

FILE txt

Si tratta dei files di database.
Inizialmente sono vuoti, e così devono essere caricati sul server. Deve essere attribuito chmod 666.

Configurare ed istallare lo script

variabili.pl

DESCRIZIONE

Questo è il file che contiene tutte le variabili utilizzate dagli scripts.

CONFIGURAZIONE

$titoli_path = '/usr/home/...../titoli.txt';

path completo del file di database titoli.txt

$pag_url = 'http://www.tuosito.com/pages';

URL della directory che contiene le pagine delle news.

$pag_dir = '/usr/home/...../pages';

path della directory che contiene le pagine delle news.

$old_pag_dir =  '/usr/home/...../old_pages';

path della directory che contiene le pagine archiviate delle news.

$img_url = 'http://www.tuosito.com/new.gif';

URL dell'immagine che viene usata per evidenziare le news recenti.

$news_url = 'http://www.tuosito.com/news.shtml';

URL della pagina che contiene i titoli delle news

$path_parole = '/usr/home/...../parole.txt';

Path del file di database che contiene l'elenco delle parole vietate.

$flock = '1';

Per evitare che i files di database vengano corrotti da un accesso multiplo utile imporre un file locking allo stesso quando viene scritto. Per cui lascia la variabile $flock settata ad 1. Se il tuo server non supporta il file locking setta la variabile a 0.

$mail = '1';

se vuoi ricevere una mail di avviso ad ogni inserimento di una nuova news o quando qualcuno tenta di effettuare un'operazione riservata all'amministratore setta la variabile $mail ad 1, altrimenti a 0.

$mailprog = '/usr/sbin/sendmail';

indirizzo del programma di posta sendmail.

$admin_mail = 'xxxxx@tuo_dominio.it';

indirizzo email dell'amministratore.

$log = '1';

Se vuoi usare i files di log setta la variabile $log ad 1, altrimenti 0.

$ins_log = '/usr/home/...../ins_log.html';

indirizzo del file di log di inserimento nuove news e tentativi di cancellazione.

$canclog = '1';

Se vuoi che il file di log venga svuotato automaticamente quando supera una certa dimensione setta la variabile $canclog ad 1 altrimenti a 0. Tieni presente che comunque i dati ti vengono inviati per email prima della cancellazione.

$insert = '10';

Numero di inserimenti massimo nel file di log.

$contatore = '/usr/home/...../contatore1.txt';

Indirizzo del file di database che tiene conto del numero di inserimenti nel file di log.

$password = 'ciccio';

password per l'amministratore, che è l'unico che può cancellare files. Come vedi non è criptata, per cui un forte hacker avrebbe vita facile. Ma è piuttosto improbabile che un buon hacker perda tempo a cancellarti le News!!

$verifica = '1';

se vuoi verificare che il testo non contenga parole vietate setta la variabile ad 1 altrimenti a 0.

$scelta_par = '1';

se hai settato ad 1 la variabile $verifica e vuoi che le parole vietate siano sostituite setta la variabile $scelta_par ad 1, se vuoi che invece venga impedita la pubblicazione della News settala a 2. Tieni presente che la sostituzione delle parole vietate è consentita solo per il corpo del testo. Nel caso del titolo l'uso di una parola vietata impedisce la pubblicazione della News.

censured = '(omissis)';

stringa con cui devono essere sostituite le parole vietate. Questa opzione è attiva solo se hai settato ad 1 la variabile $scelta_par.

$fuso = '0';

regoli l'ora in base al fuso orario del server. Se lo stesso è posto in un luogo che è 6 ore indietro rispetto al paese da cui provengono i visitatori allora devi scrivere 6, se è posto 6 ore avanti allora devi scrivere -6.

$num_max = '5';

indichi il numero massimo di news da visualizzare.

$canc_aut = '1';

Se $canc_aut 0 non cancella le pagine obsolete
Se 1 cancella la pagina dopo averla archiviata
Se 2 cancella la pagina definitivamente senza archiviarla

$image = '1';

se vuoi che compaia una piccola immagine accanto ad un titolo di una news recente setta $image ad 1, altrimenti a 0.

$num_ore = '12';

numero di ore durante le quali deve comparire l'immagine che evidenzia una nuova news se vuoi che compaia, ad esempio, per 2 giorni scrivi 48.

$data_ins = '1';

setta $data_ins ad 1 se vuoi che a fianco del titolo compaia la data ed ora di inserimento, altrimenti 0.

$small = '1';

Se hai scelto di inserire la data, e vuoi che il font della stessa sia più piccolo di quello del titolo setta $small ad 1, se vuoi che abbia la stessa dimensione setta a 0.

$bgcolor = '#80ffff';

colore di sfondo della pagina contenente la nuova news.

$background = 'http://www.tuosito.com/sfondo.gif';

url dell'immagine di sfondo della pagina contenente la nuova news.

$format = '1';

tramite questa variabile puoi adattare la formattazione del testo della news
se la setti ad 1 verranno inseriti i tag per ogni paragrafo
se la setti a 2 verranno inseriti i tag per ogni paragrafo
se la setti a 0 verra inserito solo il tag alla fine del paragrafo.

$tab_width = '90';

ampiezza in % della porzione di testo nella pagina della news.

$size_text = '4';

size del font del testo, il titolo sarà automaticamente più grande

$face_text = 'comic sans ms';

font da usare nel test e nel titolo

$col_text = 'black';

colore del testo della news

$hr_width = '80';

larghezza della linea sottostante il titolo

$hr_size = '2';

spessore della linea sottostante il titolo

$hr_color = '#800080';

colore della linea sottostante il titolo

$img_width = '30';

width dell'immagine che deve comparire accanto alle new recenti

$img_height = '18';

height dell'immagine che deve comparire accanto alle new recenti

$img_alt = "Questa notizia è stata inserita da meno di 
$num_ore ore";

setta in questa variabile il contenuto dell'alt dell'immagine inserita

$css = '1';

se vuoi che il titolo venga formattato tramite css setta $css ad 1, altrimenti 0

$col_link_off = "blue";

colore del titolo quando il mouse è lontano

$col_link_on = "gold";

colore del titolo quando il mouse è sopra

1;

Non rimuovere in nessun caso questo numero posto alla fine di questo file, a meno che tu non sia un esperto programmatore in perl e quindi non sappia cosa significa. :)

ISTALLAZIONE

Il file deve essere caricato sul server nella directory cgi-bin (o equivalente) e nella, eventuale, stessa sottodirectory degli altri script.
E' sufficiente che il file sia leggibile a tutti, quindi puoi lasciare il "chmod" standard.

news.pl

DESCRIZIONE

Questo è il file perl principale.
Svolge quattro funzioni:

scrittura del titolo della news, crezione della pagina relativa
cancellazione del titolo e delle pagine
inserimento nel database delle parole vietate
cancellazione dal database delle parole vietate

CONFIGURAZIONE

Devi solo inserire nella prima riga l'indirizzo dell'interprete di PERL sul tuo server. In genere è

#!/usr/local/bin/perl

oppure

#!/usr/bin/perl

ISTALLAZIONE

Il file deve essere caricato sul server nella directory cgi-bin (o equivalente) e nella, eventuale, stessa sottodirectory degli altri script. Il file deve essere eseguito quindi devi settare chmod 755.

vis_news.pl

DESCRIZIONE

Questo file consente la visualizzazione su una tua pagina delle news, in modo dinamico.
Inoltre inserisce o meno la piccola immagine accanto alle news particolarmente recenti.

CONFIGURAZIONE

Devi solo inserire nella prima riga l'indirizzo dell'interprete di PERL sul tuo server. In genere è

#!/usr/local/bin/perl

oppure

#!/usr/bin/perl

ISTALLAZIONE

file_news.pl

DESCRIZIONE

Questo file serve ad inserire dinamicamente sul tuo pannello di controllo l'elenco effettivo ed aggiornato in tempo reale delle pagine presenti nelle due directory "pages" e "old_pages" per consentirti la cancellazione delle stesse e degli eventuali titoli ancora presenti.

CONFIGURAZIONE

Devi solo inserire nella prima riga l'indirizzo dell'interprete di PERL sul tuo server. In genere è

#!/usr/local/bin/perl

oppure

#!/usr/bin/perl

ISTALLAZIONE

vis_parole.pl

DESCRIZIONE

Questo file serve ad inserire dinamicamente sul tuo pannello di controllo l'elenco effettivo ed aggiornato in tempo reale delle parole vietate presenti nel database per consentirti la cancellazione delle stesse.

CONFIGURAZIONE

Devi solo inserire nella prima riga l'indirizzo dell'interprete di PERL sul tuo server. In genere è

#!/usr/local/bin/perl

oppure

#!/usr/bin/perl

ISTALLAZIONE

PANNELLO UNICO

Nel caso tu voglia usare un unico pannello utilizza questo file e scarta i file: ad_com_news.shtml e pub_com_news.html

com_news.shtml

DESCRIZIONE

Questo file genera la pagina che contiene il pannello di controllo e si divide in due sezioni:

Nella Sezione Amministratore si può operare solo immettendo la password, e si divide in tre sottosezioni:

Sottosezione - Cancellazione
Selezionando la scelta "cancella" ti appresti a cancellare una news.
Se hai settato la variabile $canc_aut=0 (non cancellazione delle pagine) tutte le pagine, sia quelle attive che quelle scadute si trovano nella directory "pages" per cui avrai l'elenco dei files contenuti solo in quella directory. Gli elenchi sono generati automaticamente dallo script file_news.pl.
Se hai settato la variabile $canc_aut=1 (archiviazione delle pagine) le pagine scadute si trovano nella directory "old_pages" per cui ti verranno presentati due elenchi.
Se hai settato la variabile $canc_aut=2 (cancellazione delle pagine) le pagine scadute saranno state cancellate per cui avrai l'elenco solo di quelle attive.
In generale comunque se decidi di cancellare una pagina attiva verrà cancellato automaticamente anche il titolo link. Puoi usare questa procedura quando ti accorgi di avere fatto un errore.
Sono disponibili due pulsanti "Prova" che ti consentono di vedere la pagina che ti appresti a cancellare, prima di effettuare l'operazione che è irreversibile.

Sottosezione - Inserimento parole vietate.
Selezionando la scelta "inserisci" potrai aggiornare il tuo database di parole vietate. Questa sezione è attiva solo se hai settato la variabile $verifica ad 1. In tal caso puoi inserire più di una parola vietata alla volta basta che le separi da una virgola senza ulteriori spazi (prima,seconda,terza).
Ad ogni operazione ti verrà data conferma tramite una pagina che ti indicherà le parole che hai inserito e l'elenco totale. Non ti preoccupare di eventuali doppioni perchè verranno scartati automaticamente. L'elenco sarà in ordina alfabetico e non c'è differenza tra maiuscole e minuscole.

Sottosezione - Cancellazione parole vietate.
Effettuata la selezione e dato invio comparirà una pagina dinamica che evidenzierà la parola cancellata e l'elenco generale in ordine alfabetico.

La Sezione Utenti.
E' agibile senza password ed è quindi a disposizione di tutti:

Sottosezione - Scrittura
Selezionando la scelta "scrivi" ti appresti ad inserire nel sito una nuova news. Devi inserire un nome, l'email, titolo e del testo. Sono tutti obbligatori. Il titolo è particolarmente importante perchè deve descrivere la news e va a costituire il link per raggiungere la pagina relativa. Il testo formattato automaticamente costituirà il corpo della pagina della news. Tieni presente che quando andrai a capo verrà costituito un nuovo paragrafo.

CONFIGURAZIONE

In questo file devi settare alcuni path ed url:

Per consentire il funzionamento dei JavaScript che ti consentono di verificare le pagine devi settare nelle due variabili "dir" le path delle directory "pages" e "old_pages".
Ad esempio:

dir="news/pages/";
dir="news/old_pages/";

Poi devi indicare esattamente l'URL dello script news.pl nella funzione action del form

<form action="http://www.tuosito.com/cgi-bin/news/news.pl" 
method="post" name="comando">

Poi devi indicare esattamente il path dello script file_news.pl

<!--#exec cgi="/cgi-bin/news/file_news.pl"-->

Devi indicare esattamente il path dello script vis_parole.pl

<!--#exec cgi="/cgi-bin/news1/vis_perole.pl" -->

Infine ricorda che su alcuni server potrebbe essere necessario rinominare la pagina da com_news.html a com_news.shtml

ISTALLAZIONE

Il file deve essere caricato sul server nella directory principale e non ha bisogno di modifica di chmod.

DOPPIO PANNELLO

Nel caso tu voglia usare un doppio pannello distinto per amministratore ed utenti usa i due file seguenti e scarta il file com_news.shtml

ad_com_news.shtml

DESCRIZIONE

Questo file genera la pagina che contiene il pannello di controllo dell'amministratore e si divide in quattro sottosezioni:

Nelle prime tre sottosezioni si può operare solo immettendo la password:

Sottosezione - Inserimento parole vietate.
Selezionando la scelta "inserisci" potrai aggiornare il tuo database di parole vietate. Questa sezione è attiva solo se hai settato la variabile $verifica ad 1. In tal caso puoi inserire più di una parola vietata alla volta basta che le separi da una virgola senza ulteriori spazi (prima,seconda,terza). Ad ogni operazione ti verrà data conferma tramite una pagina che ti indicherà le parole che hai inserito e l'elenco totale. Non ti preoccupare di eventuali doppioni perchè verranno scartati automaticamente. L'elenco sarà in ordina alfabetico e non c'è differenza tra maiuscole e minuscole.

Sottosezione - Cancellazione parole vietate.
Effettuata la selezione e dato invio comparirà una pagina dinamica che evidenzierà la parola cancellata e l'elenco generale in ordine alfabetico.

La quarta sottosezione è agibile senza password:

Sottosezione - Scrittura
Selezionando la scelta "scrivi" ti appresti ad inserire nel sito una nuova news. Il nome e l'email, vengono inseriti automaticamente tramite i dati che hai inserito nei value dei due campi hidden "nome" ed "email".
Il titolo e il testo sono obbligatori.
Il titolo è particolarmente importante perchè deve descrivere la news e va a costituire il link per raggiungere la pagina relativa.
Il testo formattato automaticamente costituirà il corpo della pagina della news. Tieni presente che quando andrai a capo verrà costituito un nuovo paragrafo.

CONFIGURAZIONE

In questo file devi settare alcuni path ed url:

Per consentire il funzionamento dei JavaScript che ti consentono di verificare le pagine devi settare nelle due variabili "dir" le path delle directory "pages" e "old_pages".
Ad esempio:

dir="news/pages/";
dir="news/old_pages/";

Poi devi indicare esattamente l'URL dello script news.pl nella funzione action del form

<form action="http://www.tuosito.com/cgi-bin/news/news.pl" 
  method="post" name="comando">

Poi devi indicare esattamente il path dello script file_news.pl

<!--#exec cgi="/cgi-bin/news/file_news.pl"-->

Devi indicare esattamente il path dello script vis_parole.pl

<!--#exec cgi="/cgi-bin/news/vis_perole.pl" -->

Devi inserire i dati che preferisci nel value dei seguenti campi:

<input type="hidden" name="nome" value="Amministratore">

qui devi indicare il nome a cui vuoi che vengano attribuite le news inserite dall'amministratore.

<input type="hidden" name="email" value="xxx@yyy.it">

qui devi indicare la sua email.

ISTALLAZIONE

Il file deve essere caricato sul server nella directory principale e non ha bisogno di modifica di chmod.

pub_com_news.html

DESCRIZIONE

Questo è il pannello di inserimento delle news a disposizione dei visitatori.

Nome, email, titolo e testo sono obbligatori.
Il titolo è particolarmente importante perchè deve descrivere la news e va a costituire il link per raggiungere la pagina relativa.
Il testo formattato automaticamente costituirà il corpo della pagina della news. Tieni presente che quando andrai a capo verrà costituito un nuovo paragrafo.

CONFIGURAZIONE

In questo file devi settare un url:

Devi indicare esattamente l'URL dello script news.pl nella funzione action del form

<form action="http://www.tuosito.com/cgi-bin/news/news.pl" 
  method="post">

ISTALLAZIONE

Il file deve essere caricato sul server nella directory principale e non ha bisogno di modifica di chmod.

news.shtml

DESCRIZIONE

Questo è un file di prova. Ti consente di verificare il funzionamento degli script prima di pubblicare i titoli delle news in una pagina importante del sito, in genere, la home page.

Per cui una volta verificato il corretto funzionamento potrai cancellarlo, dopo avere copiato nella pagina su cui dovranno essere i titoli il seguente tag:

<!--#exec cgi="/cgi-bin/news/vis_news.pl"-->

che dovrà essere settato in modo da puntare al file vis_news.pl

CONFIGURAZIONE

Come già detto devi indicare esattamente il percorso per raggiungere il file vis_news.pl nel tag:

<!--#exec cgi="/cgi-bin/news/vis_news.pl"-->

ATTENZIONE!!!
Potrebbe essere necessario rinominare la pagina che ospiterà i titoli da nome.html a nome.shtml. Anche se si trattasse della index non avrai problemi.

ISTALLAZIONE

Il file deve essere caricato sul server nella directory principale e non ha bisogno di modifica di chmod.

titoli.txt

DESCRIZIONE

Si tratta del fondamentale file di database, che deve essere trattato con ogni cura.

CONFIGURAZIONE

Non ha bisogno di alcuna configurazione, anzi ti devi accertare che sia rigorosamente vuoto.

ISTALLAZIONE

Il file deve essere caricato sul server nella directory che preferisci e ha bisogno di chmod 666. Se lo inserisci in una directory diversa da quella principale devi settare i chmod della dir a 777.

contatore.txt

DESCRIZIONE

Si tratta del file di database, che tiene il conto degli inserimenti nel file di log, per evitare che questo superi le dimensioni volute.

CONFIGURAZIONE

Non ha bisogno di alcuna configurazione, anzi ti devi accertare che sia rigorosamente vuoto.

ISTALLAZIONE

Il file deve essere caricato sul server nella directory che preferisci e ha bisogno di chmod 666. Se lo inserisci in una directory diversa da quella principale devi settare i chmod della dir a 777.

parole.txt

DESCRIZIONE

Si tratta del file di database su cui è archiviato l'elenco delle parole vietate.

CONFIGURAZIONE

Non ha bisogno di alcuna configurazione, anzi ti devi accertare che sia rigorosamente vuoto.

ISTALLAZIONE

Il file deve essere caricato sul server nella directory che preferisci e ha bisogno di chmod 666. Se lo inserisci in una directory diversa da quella principale devi settare i chmod della dir a 777.

new.gif

Si tratta di un regalino che faccio agli utilizzatori del mio script. E' la piccola immagine che compare accanto alle news particolarmente recenti. Ovviamente puoi sostituirla con quella che preferisci. Puoi metterla dove vuoi, ricordati però di settare nel file variabili.pl il path esatto nella variabile $img_url.

Directories pages e old_pages

Le ho inserite per evitare che vengano dimenticate.
Il loro uso è necessario perchè molti server non consentono agli scripts di creare pagine nella directory principale, per ragioni di sicurezza, ed inoltre così tutto è più ordinato.
Setta il chmod a 777.

Torna Su

Indice del sito

Torna Su