Accueil > MaLiBeLe > webtrees 2. > webtrees faits historiques (et scientifiques) : modules personnalisés

webtrees faits historiques (et scientifiques) : modules personnalisés

version 2023

vendredi 8 septembre 2023, par MaLiBeLe DEKRI

Les 6 modules présentés ici (chefs d’état français, généalogie, histoire, inventions, sciences, famines) peuvent être activés indépendamment les uns des autres et donc au choix des administrateurs. Ils représentent en tout près de 300 évènements (au 8 novembre 2023).

Tous les évènements disposent d’un lien vers Wikipédia pour davantage d’informations sur cet évènement. C’est aussi un excellent moyen de vérifier l’information [1] (les sources sont importantes en généalogie).


Tous les modules présentés ici sont installés et activés sur Malibele sur Dekri.

Voici un affichage :

Autour du mariage de Jean Ulmet et Anne Ayma

Dernière version du 29/08/2023 (enregistré dans le fichier webtrees_histoire-derniere_version.txt pour affichage dans webtrees)

Attention, pour consulter le contenu du module au format web, voir Liste des faits historiques et évènements scientifiques (ordre chronologique).

Les modules mlbl_XXX

Évidemment, ce sont des modules "faits historiques" au sens de webtrees. Aucun évènement n’est repris dans un autre module.

  • mlbl_histoire : les évènements "histoire"
    Des évènements concernant l’histoire de France (le choix est éminemment subjectif...)
    => Télécharger :
  • mlbl_chefs_d_etat : les évènements "chefs d’état"
    Les chefs d’état français
    => Télécharger :
  • mlbl_famines : les évènements "famines"
    Les famines en France (à compléter probablement) :
    => Télécharger :
  • mlbl_sciences : les évènements "sciences"
    Des évènements scientifiques importants pour la société (le choix est éminemment subjectif ici aussi...)
    => Télécharger :
  • mlbl_inventions : les évènements "inventions"
    Une liste d’inventions qui ont marqué l’évolution sociale dans le monde (liste évidemment non exhaustive).
    => Télécharger :
  • mlbl_genealogie : les évènements "généalogie"
    Quelques évènements "généalogiques", qui concernent donc la généalogie et avec lesquels les généalogistes doivent souvent composer.
    => Télécharger :
  • mlbl : les six modules ci-dessus => Télécharger :

Pour consulter les contenus, voir Liste des faits historiques et évènements scientifiques par thème.
Pour télécharger un module, cliquer sur le lien (icône après Télécharger).

Comment installer un module mlbl_XXX ?

  1. Télécharger le module souhaité
  2. le dézipper. Sans logiciel dédié au "dézippage", il est conseillé d’installer 7-zip qui est un logiciel libre et gratuit, facile à installer et simple d’emploi. Téléchargement : 7-Zip.
  3. Via FTP, le transférer dans le dossier /modules_v4/ de webtrees
  4. Activer le module :
    1. Ouvrir le panneau de contrôle
    2. cliquer sur Évènements historiques
    3. cocher les collections à conserver et décocher les autres

C’est tout !

Plusieurs modules "faits historiques" peuvent cohabiter. Pour désactiver un module, renommer le dossier en ajoutant ".disable". Par exemple, pour désactiver le module "mlbl_histoire", le renommer "mlbl_histoire.disable".

Pour afficher le contenu des modules "faits historiques" actifs dans les fiches individuelles, cocher la case dédiée.

Construire son propre module histoire

  • Adapter tous les contenus encadrés par *** (*** à supprimer aussi)
  • Il est possible de s’inspirer d’un des modules malibeleXXX ou de le modifier (pas de copyright exigé).
<?php

/** ***Titre perso*** */

declare(strict_types=1);

use Fisharebest\Localization\Translation;
use Fisharebest\Webtrees\I18N;
use Fisharebest\Webtrees\Module\AbstractModule;
use Fisharebest\Webtrees\Module\ModuleCustomInterface;
use Fisharebest\Webtrees\Module\ModuleCustomTrait;
use Fisharebest\Webtrees\Module\ModuleHistoricEventsTrait;
use Fisharebest\Webtrees\Module\ModuleHistoricEventsInterface;
use Illuminate\Support\Collection;

/** Class NomDuModule */
return new class extends AbstractModule implements ModuleCustomInterface, ModuleHistoricEventsInterface
{
	use ModuleCustomTrait;
	use ModuleHistoricEventsTrait;

	public function title(): string
	{return '***Titre du fichier***';}

	public function description(): string
	{return "***Description courte du module***";}

	public function customModuleAuthorName(): string 
	{return '***Nom de l\'auteur***';}

	/** Date = version au format AAAA-MM-JJ de préférence */
	public function customModuleVersion(): string 
	{return 'AAAA-MM-JJ';} 

	/** URL du fichier texte contenant la référence de la dernière version */
	public function customModuleLatestVersionUrl(): string
	{return 'https://domaine.suff/NomDuFichier.txt';} 

	/** URL de l'éventuelle page d'aide et/ou de présentation */
	public function customModuleSupportUrl(): string 
	{return 'https://domaine.suff/page';}


	/**
	 * Ce module doit-il être activé lors de sa première installation ?
	 * @return bool => false (conseillé) ou true
	 */
	public function isEnabledByDefault(): bool
	{return false;}

	/**
	 * Tous les événements fournis par ce module.
	 * @return Collection<int,string>
	 * Des regroupements peuvent être faits.
	 * Contenu d'une ligne : "1 EVEN évènement\n2 TYPE groupe\n2 DATE format j MMM AAAA \n2 NOTE contenu de la note éventuelle", (ne pas omettre l'encadrement par des guillemets droits et la virgule finale
	 * Exemple de ligne : "1 EVEN Sacre de l’Empereur Charlemagne\n2 TYPE Chef d’état\n2 DATE 800\n2 NOTE voir [Charlemagne](https://fr.wikipedia.org/wiki/Charlemagne)",
	 */
	public function historicEventsAll(): Collection
	{
	switch (I18N::languageTag()) {
		/** Langues utilisées */
		case 'fr':
        case 'fr-CA':
		return new Collection([
		/*# Groupement 1 */
			"1 EVEN évènement\n2 TYPE groupe\n2 DATE format j MMM AAAA \n2 NOTE contenu de la note éventuelle",
			/** (ne pas omettre l'encadrement par des guillemets droits et la virgule finale 
			* \n est un séparateur, le nombre qui suit étant le niveau dans le gedcom
                        * Ce n° doit donc être suivi d'une balise gedcom
                        * Ne pas utiliser de guillemets dans les textes !
                       */

		# Groupement 2
			"1 EVEN évènement\n2 TYPE groupe\n2 DATE format j MMM AAAA \n2 NOTE contenu de la note éventuelle",

				]);

			default:
				return new Collection();
		}
	}
};
/** Bonne utilisation */

Voir en ligne : Cette page doit beaucoup à unepage sur https://gustine.eu


[1il peut toujours subsister quelques erreurs... Toutes nos excuses.

Un message, un commentaire ?

modération a priori

Ce forum est modéré a priori : votre contribution n’apparaîtra qu’après avoir été validée par un administrateur du site.

Qui êtes-vous ?
Votre message

Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document