Réglages avancés des blocs des articles
Publié le: Jeudi 13 mars 2008
lectures : 4586
Copyrights © par pragmaMx France
Les articles sont certainement le module le plus utilisé dans votre système, ceux-ci peuvent être affichés sur l'accueil de votre site de deux façons:
- Soit vous affichez directement le module à l'accueil (Panneau administration - Modules - Module "news" en page de démarrage)
- Soit vous affichez le module par l'intermédiaire de blocs qui récoltent les informations de vos articles
C'est cette deuxième solution qui nous intéresse car pragmaMx dispose de plusieurs blocs pour les articles, ceux-ci disposent également d'options "cachées" (modifications de variables) dans le code php et c'est ce que nous allons détailler ici.
Rappel: En php les variables se présentent sous cette forme: $nom_de_la_variable = valeur ;
PragmaMx est fourni d'origine avec différents blocs permettant d'afficher vos articles, ces blocs se trouvent dans le répertoire /blocks/ de votre système, à savoir:
- block-News.php
- block-News_short.php
- block-News_short-more-columns.php
- block-Old_Articles.php
Vous pouvez ainsi activer un ou plusieurs de ces blocs pour les faire apparaitre en page d'accueil de votre site, pour cela, rendez-vous dans le panneau administration - Blocs - Ajouter un fichier bloc - Dans la liste défilante vous choisissez le bloc à ajouter.
Ces blocs sont fournis avec un réglage standard que vous pouvez néanmoins modifier grâce à des options de réglages avancées que vous changez directement dans le code php du/des blocs. En effet, ouvrez avec votre éditeur de texte le bloc que vous voulez modifier, vous remarquerez ainsi au début du code des options de configuration avec des commentaires ( Sous forme de texte précédé de // ) sur le code permettant de savoir exactement qui fait quoi.
Ces commentaires étant en allemand, voici en détails et traduit en français les différentes options de réglages.
Note: Effectuez vos changements directement sur le fichier original, les morceaux de code indiqués ci-dessous n'ont que simple valeur de renseignement et de traduction des commentaires.
block-News
Ce bloc permet d'afficher vos articles avec multiples possibilitées (nombre de colonnes, boutons de liens, etc....) définis ci-dessous.
/**
* -----------------------------------------------------------------------------
* Réglages avancés pour le bloc
*/
// Afficher la première partie du texte,
// - 0 pour non, ou
// - Afficher un nombre défini (ici 100) de caractères de la première partie du texte
// Toutes les balises HTML-Tags sont supprimées sauf le passage à la ligne qui n'est pas inclu dans le comptage
$showintro = 100;
// Afficher l'image dans le texte avec $showintro
// true = oui
// false = non
$showpics = true;
// Afficher la liste des boutons
// 1 = oui
// 0 = non
$showbuttons = 1;
// Afficher la date
// 1 = oui
// 0 = non
$showdate = 1;
// Afficher la catégorie avec le titre de l'article
// 1 = oui
// 0 = non
$showcattitle = 0;
// Nombre de colonnes du bloc (attention à la mise en page)
$showcolumns = 2;
// Nombre d'articles à afficher
// - Indiquez un nombre quelconque, ou
// - la variable globale $GLOBALS['storyhome'] qui correspond au nombre d'articles à afficher que vous avez défini dans le panneau administration
$storynum = $GLOBALS['storyhome'];
// Afficher les liens vers la recherche etc...
// 1 = oui
// 0 = non
$showextendedlinks = 0;
// Activer le cache du bloc
// true = oui
// false = non
$mxblockcache = true;
/**
* Fin des réglages avancés pour le bloc
* -----------------------------------------------------------------------------
*/
block-News_short
Ce bloc est une version simplifiée permettant d'afficher le titre des articles et le début du texte.
/**
* -----------------------------------------------------------------------------
* Réglages avancés pour le bloc
*/
/* News-Nom du module */
$module_name = 'News';
// Activer le cache du bloc
// true = oui
// false = non
$mxblockcache = true;
// Nombre d'articles à afficher
// - Indiquez un nombre quelconque, ou
// - la variable globale $GLOBALS['storyhome'] qui correspond au nombre d'articles à afficher que vous avez défini dans le panneau administration
$storynum = $GLOBALS['storyhome'];
// Afficher la première partie du texte,
// - Afficher un nombre défini (ici 120) de caractères de la première partie du texte
$textlen = 120;
// Afficher l'image dans le texte avec $showintro
// true = oui
// false = non
$showpics = true;
block-News_short-more-columns
Ce bloc identique à celui présenté ci-dessus permet en outre de définir un nombre colonnes.
/**
* -----------------------------------------------------------------------------
* Réglages avancés pour le bloc
*/
/* News-Nom du module */
$module_name = 'News';
// Activer le cache du bloc
// true = oui
// false = non
$mxblockcache = true;
// Nombre de colonnes du bloc (attention à la mise en page)
$showcolumns = 2;
// Nombre d'articles à afficher
// - Indiquez un nombre quelconque, ou
// - la variable globale $GLOBALS['storyhome'] qui correspond au nombre d'articles à afficher que vous avez défini dans le panneau administration
$storynum = $GLOBALS['storyhome'];
// Afficher la première partie du texte,
// - Afficher un nombre défini (ici 120) de caractères de la première partie du texte
$textlen = 120;
// Afficher l'image dans le texte avec $showintro
// true = oui
// false = non
$showpics = true;
block-Old_Articles
Ce bloc permet d'afficher les articles archivés.
// Afficher en défilement
// 1 = oui
// 0 = non
$scrolling = 0;
// Hauteur de la balise marquee
$hoehe = 100;
// Activer le cache du bloc
// true = oui
// false = non
$mxblockcache = true;
// Nom du bloc - Supprimez cette variable si vous préférez indiquer un autre nom défini dans l'administration des blocs
$blockfiletitle = _PASTARTICLES;
Une fois vos modifications effectuées sur le/les bloc(s) que vous avez choisi, il vous suffit ensuite de simplement écraser votre fichier bloc dans le répertoire /blocks/ de votre système par celui que vous venez de modifier.
Astuce: La meilleur façon de trouver l'affichage dont vous avez besoin est évidemment d'effectuer plusieurs essais avec les différents bloc et de choisir la configuration qui vous intéresse.
[ Retour ]