/*########################### SAIBAL DOWNLOAD AREA V.2.0 #######################
                                                                                
Creato da saibal [http://www.lorenzone.it / saibal@lorenzone.it]                
nel Novembre del 2002.                                                          
                                                                                
Questo script  dedicato a tutti coloro che hanno il pisellino piccolo.         
FORZA!!! Anche voi troverete la donna dei vostri sogni... basta avere pazienza! 
                                                                                
  Baci ai pupi                                                                  
  Saibal alias Lorenzo                                                          
###############################################################################*/

----================================ ATTENZIONE!!!! ================================----

SE VOLETE ESEGUIRE UN UPGRADE DALLA VERSIONE 1.0 O DALLA VERSIONE 2.0 LEGGETE LA SEZIONE "UPDATE" (ma dai???)

----================================================================================----


-----------------
Premessa
-----------------
Sicuramente un bel passo avanti rispetto alla versione 1.0. Non solo  cambiato il modo di scrivere codice (speriamo in meglio) ma sono state anche aggiunte delle nuove funzioni. Da notare anche che lo script utilizza i template per la grafica e non pi il codice html "immerso" nel codice php.
Riassumo brevemente le caratteristiche salienti del Saibal Download 2.0:

1) Mostrare il numero di download effettuati per ogni scheda

2) Mostrare il numero di votazioni in percentuale per ogni scheda

3) Bloccaggio di multivotazioni tramite cookie e log del numero IP con un tempo di cancellazione stabilito da voi

4) Possibilit di organizzare l'uscita delle schede tramite data. Potrete ad esempio inserire una scheda oggi e farla uscire tra un mese

5) Upload dei file direttamente dall'area di amministrazione

6) Gestione completa delle categorie e delle schede dall'area di amministrazione

7) Utilizzo del VB CODE per inserire i tag come <b> ... </b> oppure <i> ... </i>

8) Ottimizzazione del tag TITLE per favorire i motori di ricerca nell'indicizzazione

9) Tabelle accessorio per mostrare gli script pi scaricati, i pi votati, pi visti e gli ultimi inseriti

10) Possibilit di inserire un logo per ogni scheda

11) Due tipi di layout per le categorie: orizzontale o verticale

12) Statistiche per i file pi scaricati, pi votati e pi visti

13) Upload dei loghi direttamente nel database

14) Inserimento di sottocategorie

#######################################################
#######################################################


-----------------
Installazione
-----------------
- Aprite il file "config.inc.php" che trovate dentro la cartella _admin.

- Impostate i parametri presenti nella sezione IMPOSTAZIONE NECESSARIE (accesso al database, tabelle etc)

- Se ne avete la possibilit create un database specifico per lo script

- Impostate i parametri presenti nella sezione IMPOSTAZIONI PRIMARIE (path per i template, orario del server etc)

- Fate un rutto per scaricare la tensione da installazione

- Caricate tutti i file in una cartella sul vostro server

- Consiglio di chiamare la cartella "download" e di metterla nella root principale del sito (http://www.sito.it/download)

- Date CHMOD 777 alla cartella "include"

- Date CHMOD 777 alla cartella "files" e alla cartella "temporary" (si trova dentro "files")

- A questo punto digitate questo url sul vostro browser: http://www.sito.it/download/_admin/install.php

- Bevetevi un chinotto facendo un brindisi alla cugina del tortellino (la gnocca)

- Seguite i passi dell'installazione

- Se tutto  andato bene gioite. Se invece qualcosa  andato male, spegnete il pc e datevi all'ippica

- Cancellate o rinominate il file "install.php" presente nella cartella "_admin"

- L'amministrazione  raggiungibile all'indirizzo http://www.sito.it/download/_admin/index.php

- I dati di accesso dell'amministratore sono "admin" e "admin". ricordate di cambiarli una volta loggati

- Prima di iniziare ad inserire le schede, personalizzate le impostazioni nella sezione "SETTINGS"

- Alcune frasi standard possono essere personalizzate dal file "config.inc.php" (date un'occhiata alla parte finale)

- Se vi va mandatemi 50 euri per ringraziarmi :D

#######################################################
#######################################################


-----------------
Update dalla versione 1.0
-----------------
- Prima di tutto effettuate un backup del vostro database

- Fatto questo cancellate tutti i precedenti file della versione 1.0

- Modificate il file "CONFIG.PHP" in base alle vostre esigenze (soprattutto la parte relativa all'update - riga 37)

- Uploadate il tutto sul vostro server

- Eseguite la pagina "UPDATE.PHP" presente a questo indirizzo: http://www.sito.it/cartella_script/_admin/update.php

- Se tutto  andato bene... ringraziate il cielo

- Entrate nell'amministrazione (http://www.sito.it/cartella_script/_admin/index.php) con i dati "admin" - "admin"

- Personalizzate i dati principali nella sezione "SETTINGS"

#######################################################
#######################################################


-----------------
Update dalla versione 2.0
-----------------
- Prima di tutto effettuate un backup del vostro database

- Eseguite la pagina "UPDATE_2.1.PHP" a questo indirizzo: http://www.sito.it/cartella_script/_admin/update_2.1.php

- Se tutto  andato bene... cercate di trombarvi la vicina

#######################################################
#######################################################


-----------------
PERSONALIZZAZIONE E TEMPLATE
-----------------
Questo script utilizza i template. Ci vuol dire che la maggior parte delle modifiche andranno fatte nella sezione "SETTINGS" (colori, layout etc) mentre altre, se volete, dovranno essere fatte a mano sui singoli template.
Tutti i template si trovano nella cartella "public_template".
Gli unici template da modificare necessariamente sono: header.php e footer.php. Questi due template costituiscono la "cornice" attorno alle schede e andranno personalizzati con la grafica del vostro sito.
Il mio consiglio  di creare un file unico con il vostro codice e poi "dividerlo" in due... cos  pi facile. La prima parte andr in "header.php" mentre la seconda andr in "footer.php".


********* HEADER.PHP *********

 la parte iniziale del vostro codice. quella che "sta sopra" le schede. In questa parte NON VA messo il codice che comprende questi tag:
--------------------------------------------------------------
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
<head>
	<title>titolo</title>
<META NAME="DESCRIPTION" content="xxxx">
<META NAME="KEYWORDS" content="xxxxx">
--------------------------------------------------------------
Questi tag, infatti, vengono messi in modo personalizzato dallo script a seconda della pagina. se aprite il template "header.php" capirete.

Per aggiungere dei javascript o dei meta tag personalizzati potete farlo tranquillamente. baster inserirli sopra la riga
--------------------------------------------------------------
<link rel='stylesheet' href='<? echo $url_sito; ?>/stile.css' type='text/css'>
--------------------------------------------------------------
presente nel file "header.php".


Se volete modificare i CSS (magari perch dovete aggiungerne di vostri) baster modificare il file "stile.css" oppure modificare direttamente la stringa puntando ai vostri CSS (dopo averci inserito dentro i miei ovviamente)


********* FOOTER.PHP *********

 la parte finale del vostro codice. quella che "sta sotto" le schede.


********* TEMPLATE.PHP *********

Un template non  altro che una piccola parte di codice html in cui ci sono delle variabili php che vengono interpretate. Ogni singola pagina dello script  composta da tanti template che vengono richiamati di volta in volta.
In via generale non avrete bisogno di modificare i singoli template ma, se  proprio necessario, vi spiego come fare.
Supponiamo di voler modificare la tabella iniziale nella pagina "index.php".
Apriamo la pagina "index.php" e cerchiamo queste righe:

	eval("printtemp(\"".gettemp("$pub_template/NOME_TEMPLATE.php")."\");");

oppure

	readfile("$pub_template/NOME_TEMPLATE.php");

Ogni volta che troverete queste righe vorr dire che viene richiamto un template specifico. 
Nel caso di eval(....) vuol dire che ci sono delle variabili al suo interno che verranno interpretate.
Nel caso di readfile(...) invece vuol dire che il template contiene solo codice HTML.

Dopo aver capito qual  il template da modificare, dovrete andarlo a cercare nella cartella "public_template". Aprite il template con un qualsiasi editor e modificate ci che volete stando attenti a non toccare le variabili php (nel caso ci fossero... ocio a non fare casini che poi date la colpa a me).
Tornando all'esempio: se decido di modificare la tabella iniziale della "index.php" mi interesser questa riga

	eval("printtemp(\"".gettemp("$pub_template/tab_cat_start.php")."\");");

Aprir il template chiamato "tab_cat_start.php" e modificher ci che mi pare :)
All'inizio pu sembrare un po' ostico ma alla fine ci prenderete la mano.

#######################################################
#######################################################


-----------------
FUNZIONI DELL'AMMINISTRAZIONE
-----------------
Elenco brevemente le funzioni di ogni singola sezione dell'amministrazione

*SETTINGS
impostate ogni singola voce del modulo. per ogni voce c' una spiegazione. se non capite qualcosa fate delle prove.

*USERS
sezione per aggiungere, modificare o cancellare un utente. per ogni utente  possibile impostare due livelli. L'amministratore potr accedere ad ogni funzione mentre il redattore non potr usufruire delle funzioni presenti nel men "ADMIN". L'utente bannato, ovviamente, non potr pi accedere pur rimanendo il suo nome nel database (magari volete riabilitarlo in seguito).
L'utente "admin" non pu essere n cancellato n bannato ma solo modificato. Per il campo "user" e "pass" non sono ammessi n spazi n caratteri strani.

*CREA FILE
sezione per creare i file da include nel sito. se volete includere le tabelle dei pi scaricati, pi votati etc etc (dopo averli creati ovviamente) baster mettere queste righe nel file "header.php" o in qualsiasi altro file del sito (purch con estensione php) 

	--------------------------------------------------------------
	<? include("$_SERVER[DOCUMENT_ROOT]/download/include/last_file.saibal"); ?>

	<? include("$_SERVER[DOCUMENT_ROOT]/download/include/download_file.saibal"); ?>

	<? include("$_SERVER[DOCUMENT_ROOT]/download/include/visti_file.saibal"); ?>

	<? include("$_SERVER[DOCUMENT_ROOT]/download/include/votati_file.saibal"); ?>
	--------------------------------------------------------------
Ovviamente cambiate il percorso dopo $_SERVER[DOCUMENT_ROOT] se avete messo lo script in una cartella diversa da "download"

*STATS
Le statistiche per i file pi scaricati, pi votati etc etc

*IP VOTI
Tabella per vedere l'ip di ogni votazione. si svuota automaticamente dopo i TOT giorni impostati nell'area SETTINGS. Il limite nell'area SETTINGS  lo stesso anche per il cookie. 
Quindi se avete impostato 3 giorni, il cookie e l'ip verranno cancellati dopo questo termine. Se l'utente cancella a mano il biscotto c' il confronto con l'ip nel database...sempre che non abbia cambiato connessione. 
Se volete potete svuotare la tabella a mano per permettere nuove votazioni anche se il termine non  scaduto.

*CATEGORIE
Sezione per gestire le categorie presenti. Cliccando sul nome della categoria si accede ai file presenti in essa.

*LOGHI
Sezione per uploadare un logo. Da qui, una volta inserito il nome del logo da uploadare,  possibile controllare che questo non esista gi nel database.
Il link "guarda tutti i loghi" non ve lo spiego perch so che siete intelligenti :D

*UPLOAD FILES
Sezione per uploadare i file sul vostro server. Se avete un file che supera i 500 KB vi consiglio di eseguire l'upload via ftp. C' il rischio che, con una connessione lenta, lo script non ce la faccia ad eseguire l'operazione.
In questa sezione, ovviamente, potete vedere tutti i file presenti e cancellarli.

*CREDITS
Leggeteli dai :)

#######################################################
#######################################################


-----------------
FAQ
-----------------
D: Non riesco ad uploadare un file via script. Perch?
R: Hai dato chmod alla cartella "files" e "temporary"?

D: I template non vengono richiamati. Come mai?
R: Controlla i percorsi dei template nel file config.inc.php

D: Che vuole dire, nella sezione SETTINGS, "File da selezionare per i file statici"?
R:  il numero di file da includere nelle tabelle laterali (i pi votati, i pi scaricati etc)

D: Che vuole dire, nella sezione SETTINGS, "Giorni minimi prima di poter rivotare una scheda"?
R:  la durata, in giorni, sia del cookie che dell'ip nel database

D: Come posso modificare un template che non pu essere modificato con l'amministrazione?
R: Apri la pagina interessata e cerca tutte le righe con eval(...) o con readfile(..). Una volta trovato il template che ti interessa puoi modificarlo

D: Posso aggiungere una sottocategoria ad una sottocategoria?
R: No

D: Perch?
R: Chi si fa i cavoli suoi campa cent'anni

D: Posso aggiungere infinite sottocategorie ad una categoria?
R: S

D: Bravo
R: Grazie

D: Ti devo pagare per questo script?
R: Se c'hai una cugina che merita fammici fare un giro. Altrimenti non mi devi nulla. Se per mi segnali il sito dove hai installo lo script sono contento. saibal@lorenzone.it

D: Posso guadagnare rivendendo lo script?
R: Calcola che se vengo a sapere che hai fatto una cosa del genere ti prendo a pisellate sulle gengive con un condom di ferro

D: Quanto ci hai messo a farlo?
R: Un sacco perch avevo molti impegni

D: Perch non ti trovi una donna e inizi a scopare?
R: Ma vaffanculo :D

#######################################################
#######################################################


-----------------
RINGRAZIAMENTI
-----------------
Ringrazio tutti quanti... specie la mia mamma che mi ha fatto cos funky. Ringrazio anche chi ha creato la TOPA... che Dio la benedoca. Un ciao, ovviamente, va a GM (http://www.myphp.it) che mi ha insegnato l'uso dei template :)

#######################################################
#######################################################


-----------------
Licenza
-----------------
Questo Saibal-scriptino  gratuito sia per siti no-profit che per siti commerciali.  vietato rivendere a terzi il codice originale. Se c'era da guadagnarci sopra ci pensavo da solo no? :\
Quindi potete tenervi i soldi e magari darli in beneficienza... anzi: se lo fate siete proprio bravi.
L'unica cosa che chiedo per rimuovere il copyright  di avvertirmi, per mia curiosit, se lo usate (con il nome del vostro sito ovviamente)... altrimenti, se non vi  cascato prima il pisello, diverrete impotenti adesso.

#######################################################
#######################################################


-----------------
Bug e problemi
-----------------
Se avete problemi di installazione potete anche scrivere sul mio forum (http://www.lorenzone.it/forum); non scrivete per per avere consigli o consulenze su php... essendo una mezza sega non sarei in grado di rispondere (:
Vi consiglio, in questo caso, di venirci a trovare sul forum di Html.it.

****** IMPORTANTE *******
Segnalatemi anche eventuali bug e malfunzionamenti cos potr correggerli
Saibal e Lorenzone.it non rispondono di eventuali danni provocati da questo script


Baci sulle natiche e sul glande a tutti
Saibal alias Lorenzo

