Documentation - DownFile 1.4

DownFile 1.4
Installation
Configuration nécessaire :
Pour faire fonctionner le script, vous devez avoir accès sur votre serveur à :
- PHP4
- Une base MySQL
- Suffisamment d’espace disque pour uploader le script.
- La fonction PHP mail() pour l’envoi des rapports d’erreur
Etapes de première installation :
1. Décompressez tous les fichiers
2. Editez le fichier sql.php comme tel :
$host : serveur mysql
$user : nom d’utilisateur mysql
$pass : mot de passe mysql
$db : nom de la base de données mysql
$download_tbl : nom de la table des fichiers
$download_cat_tbl : nom de la table des catégories
$path : url de stockage des fichiers en téléchargement
$couleur1 : première couleur du tableau
$couleur2 : deuxième couleur du tableau
$email : adresse e-mail de réception des rapports d’erreur
3. Envoyez tous les fichiers sur le serveur par FTP, en respectant l’arborescence.
4. Par PHPMyAdmin (ou en ligne de commande), créez les tables avec le fichier
tables.sql.
5. Voilà, c’est prêt !
Etapes de mise à jour :
1. Décompressez tous les fichiers et uploadez-les (sauf sql.php) sur votre serveur
FTP dans le répertoire d’installation de votre script.
2. Editez le fichier sql.php présent sur votre serveur FTP. Recherchez la ligne
commençant par $download_tbl. Faites un retour à la ligne, et rajoutez la ligne
suivante :
$download_cat_tbl = "downfile_cat"; //nom de la table des catégories
3. Par PHPMyAdmin (ou en ligne de commande), exécutez le fichier
mise_a_jour.sql.
4. Voilà, c’est prêt ! Vous devrez ensuite aller dans l’administration pour créer les
catégories.
Utilisation
Ce script de compose de deux parties : la partie publique et la partie admin. La partie
publique comprend le script d’affichage des fichiers en téléchargement, le script
d’incrémentation du compteur de téléchargement, et le script d’envoi de rapport d’erreur. La
partie admin comprend la liste des fichiers en téléchargement, avec le compteur de
téléchargement, avec la possibilité d’ajouter des fichiers, d’en supprimer et de modifier les
informations sur les fichiers déjà présents.
Partie publique :
Insérez dans votre site un lien vers le fichier download.php pour permettre à vos
visiteurs de visualiser la liste des fichiers en téléchargement. Il est possible de trier selon
différents critères en cliquant sur les liens en haut.
Apparaissent pour chaque fichier le nom, la description, la date d’ajout, le compteur de
téléchargements, et, si l’information existe, le site de l’auteur et une copie d’écran. Il y a
également pour chaque fichier un lien permettant d’informer le webmaster d’un problème
(nécessite la fonction mail() de PHP). La version 1.4 ajoute une gestion des catégories. Si
vous faites un lien vers le fichier download.php, une colonne Catégorie apparaît avant la date.
Vous pouvez aussi faire un lien vers download.php?cat=1 afin de masquer la colonne
Catégorie et de n’afficher que les fichiers de cette catégorie. Cette nouvelle fonction vous
permet de séparer les fichiers par catégorie sans avoir à installer le script dans plusieurs
répertoires et à le modifier (par exemple, sur le site www.aideinfo.com, il est possible avec le
même script (donc, la même table) d’avoir une rubrique Freewares, une rubrique Boîte à
outils, une rubrique Antivirus et une rubrique Fichiers système).
Vous pouvez adapter le script à votre design en modifiant les fichiers header.php et
footer.php. ATTENTION, le copyright DOIT-être laissé tel quel (c’est une question de
respect du travail de l’auteur, i.e. moi). Les autres fichiers ne doivent pas être modifiés, ils
sont nécessaires au bon fonctionnement du script.
Partie admin :
Elle permet de gérer les fichiers.
La page d’accueil présente la liste des fichiers en téléchargement, leur date d’ajout, et le
compteur de clics. Un lien à droite permet de supprimer/editer chaque fichier.
Note : lors de la modification d’un fichier, la date n’est volontairement pas mise à jour, et le
compteur de téléchargement reste tel quel.
Note 2 : le script ne comporte aucune fonction d’upload, il est donc nécessaire d’uploader
manuellement le fichier que vous mettez en téléchargement.
Un lien en haut vous permet d’accéder au formulaire d’ajout de fichiers. Dans le
formulaire, tous les champs sont « obligatoires » hormis le site de l’auteur et la copie d’écran.
Il n’y a aucune vérification pour la copie d’écran. Vous pouvez ainsi utiliser le format que
vous voulez.
Vous pouvez également gérer les catégories (ajout, suppression, édition). La fonction de
suppression est sécurisée et empêche toute suppression d’une catégorie encore utilisée.
Avertissements :
La partie admin n’est pas sécurisée (l’ajout d’une sécurisation par défaut pourrait entraîner,
selon le logiciel serveur utilisé et sa configuration, des erreurs internes). Il est donc important
de la sécurisé. Si votre serveur utilise Apache (le plus courant), vous pouvez utiliser un
.htaccess. Vous trouverez un tutoriel sur le site http://www.aideinfo.com/. , rubrique
webmastering. Si vous ne savez pas quel logiciel (Apache, IIS, Zeus, ...) votre serveur utilise
ou les moyens de sécurisation que vous pouvez utiliser, contactez votre hébergeur.
Pour plus de sécurité, vous pouvez également renommer le dossier /admin/, sans effectuer
aucune autre modification.
Pour tout support ou suggestion d’évolution, vous pouvez vous rendre sur mon forum :
http://www.ericfichot.fr.eu.org/.