Le système de blocs de PHP-NUKE
======================
Depuis PHP-NUKE 5.1, vous pouvez ajouter de nouveaux blocs simplement
en les copiant dans le répertoire /blocks/.
Vu la nature de ce logiciel et sa complexité aucune garantie
de quelque nature que se soit ne peut être donnée
quant à l'exploitation et/ou la mise en oeuvre de ces informations,
l'utilisation et/ou l'exploitation reste dans tous les cas de figure
de votre responsabilité et ne peut en aucun cas, direct ou indirect
rendre responsable une quelconque personne participant au développement de ce logiciel.
Afin d'améliorer votre niveau de sécurité, nous vous conseillant
de réaliser autant que nécessaire des sauvegardes de vos bases de données ou fichiers.
==========================================
1.- Introduction à l'utilisation des Blocs
==========================================
On commence dans le répertoire "blocks" où vous pouvez ajouter ou supprimer
tous les blocs que vous souhaitez.
Les noms de fichiers sous le répertoire /blocks/ ont deux règles pour fonctionner
correctement:
a) Tous les espaces doivent être remplacer par "_", ainsi si vous disposez
d'un bloc Cote du jour, votre fichier doit être : block-Cote_du_jour.php
Noter le préfixe "block-" et l'extension du fichier ".php",
les deux sont nécessaire pour l'ajout du bloc.
b) Tous les blocs doivent retourner une variable appelée $content,
voir le fichier exemple block-Sample_Block.php inclus.
Tous les fichiers de ce répertoire commençant par "block-" avec l'extension .php
seront inclues dans le formulaire de sélection dans l'interface de l'administration.
Pour ajouter un nouveau bloc, aller dans l'interface d'administration
et sélectionner le nouveau bloc depuis la section Blocs.
Si vous n'avez pas donné de nom à votre bloc, le système en crée un avec le nom
du fichier en remplaçant tous les caractères "_" par des espaces.
Si vous avez créé un bloc et supprimer le fichier, le système indiquera une erreur pour le bloc;
une erreur est aussi signalée si la variable $content est vide.
Ne pas oublier lors de l'ajout d'un nouveau bloc de substituer tous les caractères
blancs par "_" ( soulignement ) dans le nom du fichier.
Respecter la casse : "Cote_ du_jour" est différent de "cote_Du_Jour".
Lire aussi les instructions de l'auteur du bloc.
==============================================
2.- Information pour les développeurs de blocs
==============================================
La mise en place de nouveaux blocs est simples et ne nécessite que quelques
règles:
a) Au début de chaque fichier de bloc ajouter le code ci-dessous:
if (eregi("block-Votre_Bloc.php",$PHP_SELF)) {
Header("Location: index.php");
die();
}
Ceci permet d'éviter l'accès direct au fichier, ainsi les utilisateurs
ne peuvent voir le bloc qu'à travers le site.
b) Vous pouvez mettre ce que vous souhaitez dans un bloc :
accéder à une table, utilisé du code HTML, des formulaires,
du code PHP, Java, Javascript, Perl, Flash, etc.
c) Vous êtes limité en largeur pour votre bloc. cette limite est contrôlée
par le thème du site, noter qu'une image très large dans bloc, peut
rendre votre site horrible :-P
d) Le nom du fichier du bloc ne doit pas contenir de caractères espaces,
remplacer les par le caractère "_" soulignement.
par exemple si vous souhaitez un bloc "Le temps de voir",
le nom de fichier doit être "block-Le_temps_de_voir.php"
e) Quoique vous fassiez dans le bloc, vous devez renseigner
la variable de retour $content.
voir le fichier exemple block-Sample_Block.php inclus.
En espérant que vous apprécierez ces nouvelles fonctionnalités de PHP-NUKE.
=============================================================================
NOTE: Pour rester conforme au standard HTML 4.01
Il est important de substituer tout caractère "&" dans les URLs par"&"
Par exemple :
doit être écrit :
Sans cela, vos pages ne seront pas conforme à l'HTML 4.01.
=============================================================================