Bonjour,
En partenariat avec Grom, j'ai procédé durant ces dernières semaines à des modifications du module News 1.63

Avec pour objectif d'y intégrer une gestion d'évènements.

La modification principale est la création de 2 nouveaux blocs qui contiendront des évènements définis par l'auteur d'un article.

Comme des images valent mieux qu'une longue explication, voici quelques éléments concrets.
Tout a été testé sous un environnement xoops 2.0.18.x et 2.3.x

La première modification porte sur le formulaire de saisie d'un article.
Nous y trouvons à présent une nouvelle section permettant de saisir une date de début et de fin pour un évènement lié/correspondant à l'article.



Par exemple, si vous écrivez un article sur une bourse aux livres, vous pourrez indiquer avec ces nouveaux champs les dates de la bourse aux livres.
Pourquoi ? Pour alimenter la base de données, et se servir ensuite des ces informations pour les afficher dans un bloc spécifique.

Vous trouverez en effet 2 nouveaux blocs dans le module news : "évènements à venir", et "évènements du jour"

Ci-dessous, des captures d'écran des options de ces blocs.
Tout d'abord le bloc des évènements du jour.



Concernant l'ordre/regroupement, c'est pour déterminer le type d'affichage souhaité dans le bloc.
Je vous laisse découvrir le contenu du menu déroulant.

Ensuite, l'autre bloc : les évènements à venir.



Il s'agit d'un bloc un peu plus fournit en options.

Ces blocs ont leur propre template personnalisé.
Vous trouverez une description des variables smarty disponibles ici :
http://www.valentinois.net/forums/frx ... c_news_events_smarty.html

Voici à présent un aperçu de ces blocs sur ma page d'accueil.
J'ai créé une dizaine d'articles avec diverses date d'évènements : certains sont dépassés et n'apparaissent donc pas dans le bloc, d'autres sont des évènements sur un seul jour, d'autres sur plusieurs jour.
On retrouve dans ce bloc, la catégorie de l'évènement (avec un lien vers cette catégorie), on trouve également le titre de l'article et un lien vers ce dernier, on trouve le début du scoop (selon le paramétrage dans les options du bloc), et un lien pour accéder à la suite de l'article.
Tout l'aspect visuel est paramétrable dans les templates des blocs.
Voici l'aspect de base des évènements à venir, triés par date croissante.



Je peux demander un regroupement par catégorie, on obtient alors un affichage comme celui-ci.



De la même façon, j'ai un bloc ne concernant que les évènements ayant lieu le jour même (qu'ils durent un jour ou plusieurs jours, on les retrouve dans ce bloc).
l'affichage par défaut, affiche l'image affectée à la catégorie, et le titre de l'article (avec un lien vers l'article). Tout ceci est modifiable dans le template correspondant.



Les modifications à faire sur le module pour obtenir cette fonctionnalité ne sont pas très lourdes.
Elles portent sur 4 fichiers (plus 6 autres pour les fichiers de langue).

4 nouveaux fichiers ont été créés : 2 pour la gestion des blocs (affichage + options), et 2 pour les templates.

Et une petite modification sur la base de données.

Ces opérations ne sont pas irréversibles, et vous pouvez revenir à tout moment à une version classique du module news.

L'archive et la procédure se trouvent dans le message suivant.

Vous pourrez soit utiliser tels quels les fichiers de l'archive pour écraser les fichiers d'origine du module, soit appliquer à la main les modifications, car tout mon code est commenté et facilement identifiable parmi le code d'origine.

L'archive est jointe à ce post.
Voici la procédure de mise en place.

Si vous avez une installation classique du module news, vous avez juste à écraser les fichiers d'origine par ceux de l'archive.

Exécutez ensuite à la main (phpmyadmin par exemple), la requête qui se trouve dans le fichier blueteen-events.sql, ou ajoutez les champs à la main (les détails se trouvent dans le fichier sql).

Mettez à jour le module news.

Vous devriez retrouver les 2 nouveaux blocs.

Vous pouvez à présent aller dans l'administration des blocs, et choisir vos options, puis valider (impératif même si vous ne faites aucun changement d'option la première fois).

Editez un article, ajouter une date d'évènement, et vérifiez que le bloc s'affiche bien !

------------

Par contre, si vous souhaitez connaître le détail des modifications apportées, il vous suffit d'utiliser votre éditeur de texte, et de recherche la chaîne de caractères suivante dans les fichiers de l'archive : blueteen - events

Vous trouverez alors toutes les portions de code ajoutées.

------------

Le fichier /sql/mysql.sql a également été modifié, vous pouvez donc vous en servir pour faire une installation neuve du module news, et prendre ainsi en compte directement la gestion des évènements.

------------

la documentation pour les variables smarty est incluse dans l'archive, vous pouvez donc la consulter hors-ligne.

Les templates contiennent également un mémento des variables disponibles.

------------

Les fichiers de langue anglais et français sont fournis.
Les valeurs ajoutées se trouvent tout à la fin des fichiers.

EDIT : archive mise à jour le 03/02/09 à 16h00
EDIT : archive mise à jour le 27/02/09 à 14h00
Ajouter 38 au compteur de téléchargement.

Attacher un fichier:

---

events-news-163.zip Taille: 73.48 KB; Hits: 356

Salut,
Je saute sur l'occasion pour dire à quel point je suis admiratif du travail effectué et du temps passé sur cette modification par Blueteen. J’ai eu l’immense honneur d’être un testeur des modifications apportées et chaque jour à été pour moi la découverte d’un garçon extraordinaire d’opiniâtreté et de gentillesse. J'ai été véritablement ébahit par son attachement au détail et à la précision des modifications apportées au module sans parler du fait qu’il n’a jamais perdu de vue l’utilisation générale du hack. S’ouvrir un maximum de portes pour avoir une souplesse d’utilisation et une modularité exemplaire, quelque soit la volonté de fonctionnement des futurs utilisateurs.
Pour moi, le premier avantage est que lorsqu’il est installé, il n’oblige en aucune façon son utilisation. On peut à loisir utiliser « news » comme on l’a toujours fait. Il n’offre que des fonctionnalités en plus.
Ce qui me gênait vraiment dans le module de départ, c’est qu’avec les dates de publication, on avait la disparition de l’affichage de l’article du site. Pas vraiment possible d’avoir un article automatisé en le gardant consultable dans les archives. D’autre part, les modules de calendriers sont parfois trop spécialisés pour une utilisation simpliste d’événements diverses.

J’ai donc testé en avant première cette gestion d’événements « Spécial Blueteen » et franchement c’est ENORME ! La foultitude de possibilités d’affichage entre les 2 nouveaux blocs et les variables des templates offre une liberté presque infinie. Le regroupement des articles par catégories par dates + ou dates – , la possibilités d’appliquer ou non les autorisations de lecture des groupes, et dans les templates d’afficher ou non les dates et les heures de début ou de fin, et de choisir les catégories affichées, c’est MONSTRUEUX !
Si on désire se servir des nouveaux blocs pour de la gestion d’événement, ca ne peut qu’être l’idéal, c’est fait pour ! Mais si on veut simplement pouvoir programmer non seulement des dates de publication ET simplement des dates d’affichage d’articles en « Top page », comme les articles des 15 derniers jours, c’est également possible. Il suffit alors de modifier le template a sa guise et de choisir les dates d’événements comme dates d’affichage en top page.

Pour finir, une mention spéciale à la précision de l’explication des modifications du module et des différentes variables utilisables qui ont du lui prendre autant de temps que la modif elle-même .

J’en profite pour lui dire une millième fois merci pour ce formidable travail. Je suis certain que cette modification va rentrer dans les habitudes d’utilisation de ce module indispensable à Xoops, qu’Instant-Zéro l’intégrera à sa future version , s’il y a, et que frxoops.org ne perdra pas une seconde pour que ce topic soit un vrai article en première page du site.

Merci encore, Blueteen.
Grom

PS: Disponible à la démo sur les sites de ma signature !

Je n'arrête pas de le dire... on dirai que personne m'écoute... Le Père Blueten, C'EST UN SUPER PRO !!!

J'installe tous cela ce soir... mille merci pour ce boulot.

Bonne après-midi

Merci merci ! Je vais rougir

Pour info, je viens de remettre l'archive à jour suite à un bug constaté par Grom.

Seul le fichier /blocks/news_events.php a été mis à jour !

C'était une incohérence d'affichage lorsqu'un évènement avait la même date et heure de début que de fin.
C'est réglé à présent.

J'en profite pour apporter cette précision :
Si vous avez un évènement dont vous connaissez seulement l'heure de début, et qui ne dure qu'un seul jour.
On note alors au moment de l'envoi de l'article : 30/01/09 à 08h au 30/01/09 à 08h

Ca permet d'avoir cet évènement affiché dans le bloc des évènements à venir durant toute la journée.

De cette façon, si une personne passe à 14h sur le site, elle verra qu'un évènement est en cours (utile par exemple si vous n'utilisez pas le bloc des évènements du jour).

Si vous avez des cas de figures qui posent souci, ou des questions n'hésitez pas !

Le code des blocs est largement commenté (presque un commentaire par ligne), on peut donc facilement s'y retrouver (enfin je pense

Thank's l'ami pour ce hack

L'archive a été mise à jour.
La documentation des variables aussi.

J'ai ajouté des variables de langues, une variable pour tester si le jour de début est égal au jour de fin, et j'ai mis à jour le template 'news_block_events.html', il doit être plus lisible.

Les nouvelles variables et le nouveau template permettent de gérer ces cas de figures
Citation :

Archive de ce post mise à jour.

Un nouveau bloc (3ème de ce hack) est disponible.
Il permet d'afficher les évènements dont la date est passée.

Cela complète donc le bloc des évènements en cours, et le bloc des évènements à venir.

L'intérêt ?
Afficher par exemple X évènements sportifs passés (l'ancienneté est paramétrable dans les options du bloc) pour la (ou les) catégorie(s) choisie(s), avec par exemple, les résultats en rapport avec ces évènements, joints aux articles.

Vous pouvez également limiter le nombre d'articles affichés.
Comme pour les autres blocs, un regroupement par catégories est possible, et le tri par date également.
Le bloc possède également son propre template.

Je reviens rapidement sur ce hack : Je ne m'en lasse pas.
Un gros défaut à news me pourissait la vie : Comment gérer l'affichage des articles en top page, en les gardant visible dans le site.
Avec cette gestion de blocs, une info peut donc être visible en top page pendant un durée au choix (15 jours, un mois, 6 mois) puis disparaitre de la page principale tout en restant accessible dans le module. Dans le cas d'evenements particuliers, cela peut-être avant un evenement ou après. Et ce avec un seul module. Juste une gestion de blocs avec une surcharge de template hypra simple.
J'ai du mal a saisir le manque d'înteret pour cette fonction.
Moi j'en suis tombé amoureux !

Merci c'est super ça marche, c'est magique.
C'est vraiment un grand plus pour le module news.
Et en plus à la portée des débutants.
Merci encore.