Ringraziamenti

Come premessa vorrei ringraziare tutte quelle persone e siti che con i loro tutorial mi hanno permesso di passare con meno fatica alla programmazione PHP e CSS. Senza di loro avrei speso molto più tempo ad apprendere i rudimenti di PHP ed a sviluppare questo CMS.

PicoFlat (c) CMS

PicoFlat CMS è un Contents Management System basato su flat file. Non fa uso cioè di database ma di soli file di testo. E' stato progettato per un mio uso personale, ma penso di fare cosa gradita a chi ha bisogno di un CMS minimale per pubblicare i propri progetti, rilasciandolo sotto licenza GNU GPL.
Questo CMS è dotato solo di struttura grafica atta a visualizzare pagine html e news (tipo blog) che servono per tenere aggornati i visitatori sulle ultime novità pubblicate.
Non ha forum, né gallery, né pagine di amministrazione online. In questo modo se il vostro sito viene crackato da malandrini che passano il tempo cercando di crackare i siti altrui, avrete comunque i dati intatti perchè ospitati suun altro spazio web. In più avendo la possibilità di visualizzare pagine remote, è possibile separare la struttura del sito dai contenuti che possono venire ospitati in un altro spazio web con solo accesso ftp.
Il layout del sito è su due colonne e la colonna dei menù è a destra così da essere più facilmente usabile anche con risoluzioni inferiori a 1024x768. Durante il cambio pagina infatti la visualizzazione viene riposizionata a sinistra. In questo modo il contenuto sarà sempre visibile senza far uso costante dello scorrimento orizzontale.

La grafica del sito è abbastanza spartana, ma se qualcuno vuole contribuire con un layout più "arrotondato", è il benvenuto.

Lo schema del CMS è il seguente:

/directory_principale
    |
    |_banner.php
    |_button_col.php
    |_config.php
    |_COPYING
    |_footer.php
    |_func_menu.php
    |_general_func.php
    |_header.php
    |_help.html
    |_index.php
    |_logfile.log
    |_login.php
    |_style1.css
    |
    |-/contents
    |    |_logo.png
    |    |_motd.php
    |    |_userlink.txt
    |
    |-/images
    |
    `-/news

Tutti i file del CMS sono direttamente sotto la directory principale, mentre le pagine dei contenuti possono essere allocate o dentro la directory /contents o in un altro spazio Web.

Contenuti locali autoindicizzati:
Sono allocati nella directory /contents e sono semplici file HTML (.htm, .html) o di testo (.txt). Non bisogna inserire in questi files i tag 'head' e 'body' ma possono essere usati tutti gli altri tag. Per avere uniformità tra le pagine come altezza dei caratteri, si consiglia di non assegnare i tag relativi, a meno che non sia un titolo pagina. I link alle figure devono essere relativi e inclusivi della cartella in cui risiedono.

Es.: < img src="contents/image.jpg"> 

I link al menù laterale vengono assegnati automaticamente dal CMS e corrispondono al nome del file. Si consiglia perciò di non usare nomi troppo lunghi.

Contenuti remoti :
Valgono le stesse regole seguite per le pagine locali ma con due restrizioni:

1) I link alle figure devono essere "assoluti", ad esempio:


< a href = "http://www.sito.it/directory/.../image.png">Figura_1

2) Non possono essere fatti link ad altre pagine del sito remoto. Ogni pagina dovrà essere quindi un progetto completo. Questo perchè dal sito remoto non è possibile tornare a quello locale in maniera corretta e trasparente.

File dei Link Remoti e pagine locali indicizzate manualmente:
Per attivare il link alle pagine remote del sito, è necessario scrivere sul file userlink.txt la lista dei link che dovranno apparire nel menù utente posto sotto il menù principale. Il file è collocato nella directory /contents e la sintassi di ogni riga è semplice. Anche i contenuti locali possono essere indicizzati manualmente in questo file. La sintassi è la seguente:

http://www.miosito.com/dir/subdir/file.htm
http://miosito.dominio.org/dir/file.php
contents/file.html
contents/altra_dir/file.php

Header:
E' l'intestazione che vedete in alto. Può essere grafica o testuale. Se nella directory principale inserite un file grafico da voi creato e nominato logo.png allora apparirà il banner grafico. In caso contrario apparirà il logo testuale così come inserito nel file config.php

File di configurazione:
E' il file config.php dove vanno inseriti pochi dati come il nome del sito, il nome del webmaster, l'indirizzo email, l'indrizzo "locale" del sito e quello del sito "remoto" se usato.
Se si vuole attivare il menù utente per i link remoti, bisogna assegnare la variabile usermenu, ad esempio:

$usermenu = "PROGETTI" ;

Pagina principale:
Nella pagina principale è presente un riquadro centrale in cui c'è in genere la descrizione del vostro sito. Per modificarlo occorre cambiare il testo nel file motd.php.

INSTALLAZIONE

L'installazione del PicoFlat CMS è molto semplice.

1. Dezippare il file picocms.tgz sul proprio PC mettendolo in una cartella dedicata.
   
2. Andare nella cartella /contents ed eliminare tutti i files, le cartelle e le figure tranne il file news.html e userlink.txt
   
3. Inserire in questa cartella i propri files.
   
4. Ritornare nella cartella superiore e per mezzo di un editor di testo semplice (notepad, vi, pico, ecc.) il file config.php
   
5. Cancellare o editare il file help.html con il proprio help-file.
   
6. Fare l'upload dei file e delle directory sullo spazio web così come sono lasciando inalterato l'ordine delle cartelle e dei files.
   

PicoImpaginatore

Il PicoImpaginatore è un formattatore di figure e testo che utilizza dei comandi molto semplici e immediati da inserire all'interno del testo da pubblicare. In pratica il documento da inserire è formato dal file di testo puro e da una serie di file figure da disporre all'interno del testo. In base a delle parole chiave inserite all'interno del file di testo, il PicoImpaginatore inserirà al loro posto le istruzioni HTML per visualizzare figure richiamate e genererà un file html o php che verrà poi visualizzato nel sito. Lo stesso ovviamente può essere fatto usando direttamente il linguaggio HTML, ma non tutti hanno la voglia o la possibilità di farlo.

Ecco un semplice esempio (con le istruzioni evidenziate in verde):

!titolo Pagina di prova
!testo Questo è un testo da inserire nella pagina web. Sotto apparirà la figura sottotitolata "Figura1" e che in realtà è il file figura1.jpg
!figura figura1.jpg
!testo Questo altro testo sarà posizionato sotto la figura. Le figure sono tutte centrate nella pagina.

Commenti:

• Il comando !titolo significa che quel testo sarà in un carattere grande e di colore azzurro.
• Il comando !figura indica che quello che segue è il nome del file della figura da inserire. Sotto la figura verrà inserito un testo con il nome del file.
• Il comando !testo significa che quello che segue è testo puro e non deve essere interpretato come comandi.

FINE