Différences

Ci-dessous, les différences entre deux révisions de la page.

--- administration:interface:blocs [Dec. 14, 2024 11:41 AM UTC ] – jpb
+++ administration:interface:blocs [Dec. 14, 2024 12:44 PM UTC ] (Version actuelle) – jpb
@@ Ligne 1: / Ligne 1: @@
 {{:administration:logo_npds.png? |}}
 ====== Blocs ======
-Administration - Editer/Créer bloc
+{{ :administration:block.png?|Icône d'interface}}
+==== Administration - Editer/Créer bloc ====
 NPDS, permet l'affichage d'un bloc (ou de plusieurs) sur les pages.
 NPDS (avec un thème approprié) permet d'afficher ces blocs sur quasiment toutes les pages.
-Un Bloc peut-être réservé aux administrateurs, aux membres, à N groupes de membres, réservé aux Anonymes ou être visible par Tous.
+**Un Bloc peut-être réservé aux administrateurs, aux membres, à N groupes de membres, réservé aux Anonymes ou être visible par Tous.**
+=== Modifier un bloc ===
-Modifier un bloc
 Changez les informations nécessaires dans le bloc et sélectionnez l'action souhaitée, pour finir cliquez sur le bouton OK.
 Vous ne pouvez modifier qu'un seul bloc à la fois.
-Supprimer un bloc
+=== Supprimer un bloc ===
 Sélectionnez le bloc et choisissez l'action Effacer un bloc , pour finir cliquez sur le bouton OK.
 Vous ne pouvez supprimer qu'un seul bloc à la fois.
-Créer un bloc (de gauche ou de droite)
+=== Créer un bloc (de gauche ou de droite) ===
 Saisissez le titre du bloc, son index (ce qui va permettre un affichage trié ainsi que son contenu et cliquez sur le bouton Créer un bloc ....
 Par défaut le bloc nouvellement créé est actif.
-Bloc et SuperCache
+=== Bloc et SuperCache ===
-les blocs sont "SuperCachables" et peuvent-être activés ou désactivés sans toucher aux fichiers du thémes.
+  *les blocs sont "SuperCachables" et peuvent-être activés ou désactivés sans toucher aux fichiers du thémes.
 Un bloc avec un temps de cache de 0 (zéro) ne sera pas caché.
-disposent aussi d'une aide en ligne qui peut-être utilisée via le module 'aide-contextuelle' ou dans le cadre d'un développement PHP (laisser cette zone vide sinon).
+  *disposent aussi d'une aide en ligne qui peut-être utilisée via le module 'aide-contextuelle' ou dans le cadre d'un développement PHP (laisser cette zone vide sinon).
-NPDS dispose d'un système de blocs étendu capable d'afficher ou d'éxécuter beaucoup de chose :
+=== NPDS dispose d'un système de blocs étendu capable d'afficher ou d'éxécuter beaucoup de chose : ===
-HTML (pour un bloc supportant l'HTML, sélectionner l'option HTML lors de sa création)
-Javascript
+  *HTML (pour un bloc supportant l'HTML, sélectionner l'option HTML lors de sa création)
-Code PHP et/ou SSI (Serveur Side Include)
+  *Javascript
-Fonction PHP et/ou de NPDS
+  *Code PHP et/ou SSI (Serveur Side Include)
+  *Fonction PHP et/ou de NPDS
 La seule possibilité d'inclure du code est de respecter la syntaxe suivante :
-Pour du code PHP et/ou SSI :
+  *Pour du code PHP et/ou SSI :
-include#votre_repertoire/votre_fichier.php (sans ', sans ").
+    *include#votre_repertoire/votre_fichier.php (sans ', sans ").
-Ce fichier doit être du php et le retour doit obligatoirement se faire dans $content.
+    *Ce fichier doit être du php et le retour doit obligatoirement se faire dans $content.
-Pour des fonctions PHP et/ou des fonctions de NPDS :
+  *Pour des fonctions PHP et/ou des fonctions de NPDS :
-function#votre_fonction => function#Xblock (sans ', sans ", sans () et sans ;).
+    *function#votre_fonction => function#Xblock (sans ', sans ", sans () et sans ;).
-Si votre fonction dispose de paramètres :
+    *Si votre fonction dispose de paramètres :
-function#votre_fonction => function#XNews (sans ', sans ", sans () et sans ;).
+      *function#votre_fonction => function#XNews (sans ', sans ", sans () et sans ;).
-params#votre_param => params#5,10,false (sans ', sans " mais séparés par des virgules).
+      *params#votre_param => params#5,10,false (sans ', sans " mais séparés par des virgules).par exemple :
-par exemple :
+         *function#category
-function#category
+         *function#oldNews
-function#oldNews
+         *params#$storynum
-params#$storynum
+         *function#RecentForumPosts
+         *params#Forums Infos,15,0,false,10,false,-:
-function#RecentForumPosts
+     *Vous pouvez aussi mettre les 2 phases :
-params#Forums Infos,15,0,false,10,false,-:
+        *include#votre_repertoire/votre_fichier.php (sans ', sans ").
-Vous pouvez aussi mettre les 2 phases :
+        *function#votre_fonction => function#XNews (sans ', sans ", sans () et sans ;).
-include#votre_repertoire/votre_fichier.php (sans ', sans ").
+        *params#votre_param => params#5,10,false (sans ', sans " mais séparés par des virgules).
-function#votre_fonction => function#XNews (sans ', sans ", sans () et sans ;).
-params#votre_param => params#5,10,false (sans ', sans " mais séparés par des virgules).
 Ce qui vous permet de charger un code et de l'éxécuter !
-Bloc CSS
+=== Bloc CSS ===
 class-title#nom d'une classe dans votre fichier CSS.
 class-content#nom d'une classe dans votre fichier CSS.
@@ Ligne 59: / Ligne 64: @@
 Theme-Dynamic dispose de deux nouveaux meta-mots : B_class_title et B_class_content qui peuvent être utilisés dans le code de bloc.html
 Les thèmes PHP disposent de deux nouvelles variables : $B_class_title et $B_class_content qui peuvent être 'importées' dans la fonction themesidebox (via un global ...)
-Bloc CSS spécifique
+=== Bloc CSS spécifique ===
 Pour avoir la css specifique, il faut :
-cocher la case dans l'administration
+  *cocher la case dans l'administration
-noter l'id du bloc
+  *noter l'id du bloc
-declarer les id et class dans le fichier style.css ou bien ajouter une css via le gestionnaire (pages.php de votre theme)
+  *declarer les id et class dans le fichier style.css ou bien ajouter une css via le gestionnaire (pages.php de votre theme)
 Exemple css sur un bloc en particulier, ici le bloc gauche ID 2 :
+<code css>
 #LB_2 .LB_title {
 color: #FF0000;
@@ Ligne 108: / Ligne 114: @@
 text-decoration: none;
 }
+</code>
+=== Bloc URI ===
+**uri#uris_séparées_par_un_espace** pour n'afficher le bloc que sur les URI citées.
-Bloc URI
-uri#uris_séparées_par_un_espace pour n'afficher le bloc que sur les URI citées.
 Le temps de rétention doit-être égal à zéro dans ce cas.
 Exemple : uri#index.php user.php forum.php static.php?op=statik.txt&npds=1
 Le tag uri# permet l'utilisation du joker * : par exemple : viewforum.php?forum=* ou viewtopic.php?topic=*&forum=10
 Cette syntaxe est la seule supportée !
-Bloc Caché
+=== Bloc Caché ===
 hidden#... pour ne pas afficher le thème des blocs mais charger le contenu.
 Cela permet d'utiliser le système de bloc pour 'charger' des javascripts, des fichiers PHP, des fichiers CSS...