Aller au contenu
Support de Zwii

2 captures d’écran

À propos de ce fichier

 

Ce module va vous permettre d'insérer un agenda dans une page ZWII.

Il est basé sur Fullcalendar développé par Adam Shaw.

Il est particulièrement destiné à réaliser un agenda collaboratif avec gestion des différentes autorisations.

 

Voir ce module en situation

 

Version actuelle V4.1 testée avec  Zwii 10.4.04

 

 

Nouveau :

  • Nouvelle organisation des données pour préparer la gestion des modules (Zwii 10.5.00) : mise à jour particulière
  • Gestion des catégories
  • vous pouvez émettre un mailing suite à la création, modification, suppression d'un évènement, vous pouvez associer les couleurs des évènements dans l'agenda à une catégorie d'évènements.

 

# Première installation

Décompressez l'archive, installez les dossiers module et site à la racine de votre site

 

installation.png.aed5df113bac277b6fda8a6b3a68123b.png

 

 

Implantation dans le site www/10402/

 

# Mise à jour depuis la version 4.0

  1. Sauvegardez les dossiers site/file/source/agenda et site/file/agenda
  2. Transférez les dossiers module et site à la racine de votre site
  3. Copiez le contenu du dossier site/file/agenda/data dans site/data/agenda/data
  4. Si vous utilisez les catégories d'évènements copiez le fichier site/file/source/agenda/categories.json dans site/data/agenda/categories
  5. Si vous utilisez la fonction mailing copiez le contenu de site/file/source/agenda/adresses dans site/data/agenda/adresses
  6. Vous pouvez supprimer site/file/agenda et site/file/source/agenda/adresses

 

 

 

 # Mise à jour depuis une version 2.11 à 3.3

  1. Sauvegardez les dossiers site/file/source/agenda et module/agenda/data
  2. Transférez les dossiers module et site à la racine de votre site
  3. Copiez le contenu du dossier module/agenda/data dans site/data/agenda/data
  4. Si vous utilisez les catégories d'évènements (depuis 3.1) copiez le fichier site/file/source/agenda/categories.json dans site/data/agenda/categories
  5. Si vous utilisez la fonction mailing (depuis 3.0) copiez le contenu de site/file/source/agenda/adresses dans site/data/agenda/adresses
  6. Vous pouvez supprimer module/agenda/data et site/file/source/agenda/adresses

 

 

# Mise à jour depuis une version  < 2.11

 

En gras c'est à faire même si vous ne voulez pas conserver votre agenda actuel.

1 - sauvegarder l'agenda dans la page de gestion / configuration. le fichier sera dans votre_site/module/agenda/data/nomdevotreagenda_sauve/

2 - transférer le fichier sur votre poste par FTP

3 - supprimer la page Zwii nomdevotreagenda

4 - par FTP supprimer complètement le module agenda actuel puis installer le nouveau

5 - après avoir créé votre page agenda vous disposerez d'un dossier votre_site/site/data/agenda/data/nomdevotreagenda_sauve/ où vous pourrez transférer par FTP le fichier sauvegardé.

6 - En gestion / configuration charger le fichier et retrouver votre bel agenda.

 

Il est parfois nécessaire de vider le cache de votre navigateur ( https://www.viderlecache.fr ).

 

# Utilisation

Créez une nouvelle page, modifiez là en sélectionnant le module agenda et enregistrez la page puis configurez le module associé à la page (roue dentée), validez cette configuration (vous pourrez la modifier plus tard).

 

agenda_0.jpg.ff1a7e725333b06f17503ca594858ce6.jpg

 

 

Vous obtenez un agenda vide avec un affichage par mois et à la date actuelle.

agenda_vide.png.77a7bf706434a47b8c9dce8b8271d847.png

 

Vous disposez des sélections Fullcalendar, vue par mois ou par semaine, avancer ou reculer d'un mois, d'une semaine, afficher le jour actuel.

 

 

 

Pour créer un nouvel évènement, cliquez sur une case de l'agenda, par exemple ici celle du 19/12/2020 :

Par défaut la date est la date cliquée, l'horaire de début est 8h00, celui de fin 18h00

 

 

agenda_creation_1.png.959f3863f846e6563ca87c6220d778dd.png

 

Pour chaque évènement vous pouvez spécifier le groupe qui pourra accéder à sa lecture et celui qui pourra le modifier. Si votre groupe ne permet pas d'accéder à la lecture l'évènement ne sera pas affiché dans l'agenda. Par exemple si l'évènement est réglé avec un accès en lecture à partir du groupe éditeur et que vous êtes connecté en tant que membre vous ne pourrez pas voir cet évènement dans l'agenda.

 

Vous avez depuis la version 3.0 la possibilité d'envoyer des courriels à des adresses contenues dans un fichier destinataire. 3 fichiers destinataires sont automatiquement créés, administrateurs.txt, editeurs_administrateurs.txt ou tous_inscrits.txt. Le choix fait en création est mémorisé, si vous avez choisi d'envoyer un courriel pour cet évènement, une modification ou une suppression provoquera l'émission d'un autre courriel.

 

Vous disposez d'un éditeur Wysiwig (tinymce) pour réaliser la saisie de l'évènement. Dans l'exemple précédent vous êtes visiteur (avec droit de création) ou connecté en tant que membre, vous pouvez seulement mettre le texte en forme.

 

Par contre si vous êtes connecté en tant qu'éditeur ou administrateur les possibilités seront plus étendues avec insertion d'images ou de liens.

 

 

agenda_creation_2.thumb.png.a466f62e20c949ba0b930382d57b3893.png

 

Depuis la version 3.1 de l'agenda vous pouvez associer la couleur de fond et la couleur du texte d'un évènement à une catégorie d'évènements. Voir les explications plus bas.

 

categories_creation.png.3f8dc55d51a90afc7ccf9b0020de6388.png

 

Pour éditer un évènement afin de le lire, modifier ou supprimer cliquer sur un évènement :

 

agenda_edition.png.2dac3fead721aa106270aa2df45f9691.png

 

 

Vous pouvez modifier, par exemple, la date ou les horaires :

 

agenda_edition_2.png.0b7084d6922ac118a4f66bdff9255755.png

 

 

Autre exemple :

agenda_edition_3.thumb.jpg.cfc3b8315cfc8d81e5aa89efe1389802.jpg

 

Sur l'écran précédent on constate que vous pouvez  lire l'évènement mais pas le modifier, vous êtes donc actuellement un visiteur. Seul un membre, un éditeur ou un administrateur peut modifier cet évènement.

 

 

# Gestion de l'agenda

 

 

gestion_haut.png.c88c49adb733249acd6035140b992280.png

 

1 -  Sauvegarder, restaurer un agenda ou supprimer tout

Vous pouvez sauvegarder l'agenda actuel, charger un agenda précédemment sauvegardé ou supprimer tous les évènements de l'agenda.

 

L'agenda à charger pourra avoir été sauvegardé intentionnellement ou de façon automatique, en effet une sauvegarde est créée automatiquement à chaque création, modification ou suppression d'évènement, seules les 10 dernières sauvegardes automatiques sont conservées.

 

Vous pouvez dans une même sélection choisir de sauvegarder l'agenda et en " même temps " de charger un agenda précédemment sauvegardé. Pour la sauvegarde le nom du fichier doit être saisi sans extension, exemples agenda_22022020 ou mon_agenda_perso.

 

2 - Gérer les droits

Vous pouvez limiter la création d'évènement à certains groupes (le réglage par défaut est Editeur).

 

La case à cocher va permettre quand vous êtes en création ou en édition / modification d'un évènement de limiter les choix de groupe pour l'accès en lecture ou en modification (le réglage par défaut est case cochée).

Par exemple, vous êtes connecté comme membre, la case limitation est cochée, vous cliquez sur un évènement de l'agenda :

gestion_2.jpg.f706d0417f11609be51e0aca7e2145af.jpg

 

En tant que membre vous pouvez modifier cet évènement, les seuls choix possibles pour les accès en lecture ou en modification sont votre groupe Membre et le groupe inférieur Visiteur.

Si la case limitation n'avait pas été cochée vous auriez eu les 4 choix possibles Visiteur, Membre, Editeur, Administrateur.

 

3 - Affichage de l'agenda

 

Vous pouvez régler la largeur maximale de l'agenda dans votre page Zwii en pixels ou 100%. C'est uniquement la largeur maximale donc en "grand" écran, l'affichage s'adapte automatiquement à la largeur de la fenêtre de votre navigateur pour garder une bonne visibilité de l'agenda sur des petits écrans.

 

Exemple d'affichage avec les réglages : site large 1170px, module en position libre dans la page Zwii, largeur maximale de l'agenda réglée sur 710 px.

 

agenda_800_texte.thumb.jpg.2059b9894e91fb502c55edef0c2efb46.jpg

 

Pour personnaliser les couleurs de l'agenda vous disposez dans module/agenda/view/index d'un fichier index.css largement commenté.

 

4 - Ajouter des évènements à l'agenda actuel depuis un fichier ics

 

 

gestion_bas.png.bf96c8f47c6edd23264f0e70beed8616.png

 

Si le texte "Votre choix..." apparaît vous pouvez sélectionner un des fichiers au format ics présents dans le dossier "votre_site/site/file/source/agenda/ics" , une fois la page validée les évènements contenus dans ce fichier seront ajoutés à l'agenda actuel.

Pour être reconnus dans le fichier ics ces évènements devront avoir une déclaration commençant par BEGIN : VEVENT,  un 'SUMMARY' non vide et une date de début.

Vous pouvez télécharger depuis votre poste sur le serveur un fichier au format ics en utilisant le gestionnaire de fichiers utilisé par Zwii. Les fichiers ics devront être mis dans le dossier /agenda/ics/ déjà présent.

Cette fonctionnalité n'est accessible que depuis les versions de Zwii 9.2.23 ou 10.0.041 .

 

5 - Gestion des datégories

 

Vous pouvez y accéder en cliquant sur le bouton 'Catégories' sur la page de configuration du module.

 

gestion_haut.png.c88c49adb733249acd6035140b992280.png

 

categories.png.49a08fcffe1f7609569f79ea95095ff0.png

 

Choix des couleurs des évènements : case cochée les couleurs seront choisies par catégorie, sinon vous choisirez la couleur du fond et la couleur du texte dans une liste. Ce choix ne concerne que les évènements créés après ce choix.

 

categories_creation.png.3f8dc55d51a90afc7ccf9b0020de6388.png

 

Création ou modification d'une catégorie : Vous pouvez saisir un nom avec des majuscules ou des espaces.

 

Un tableau affiche les catégories actuelles et permet de les effacer, à l'exception de la catégorie 'Défaut', modifiable mais non effaçable.

 

 

 

# Un résumé des droits

 

  • Droit d'accès à la page Zwii contenant le module agenda : se règle comme pour toute page Zwii sur l'écran d'édition / modification de la page.
     
  • Droit d'accès à la création d'évènement, champ d'application la totalité de l'agenda : se règle en configuration du module (roue dentée ou bouton raccourci Gérer) pour cela vous devez être connecté au moins en tant qu'éditeur.
     
  • Droit d'accès à la lecture d'un évènement, champ d'application l'évènement : se règle à la création ou à l'édition / modification de l'évènement.
     
  • Droit d'accès à la modification ou à la suppression d'un évènement, champ d'application l'évènement : se règle à la création ou à l'édition / modification de l'évènement.
     
  • En page de configuration, la case à cocher "Limitation du choix des groupes liés aux évènements" limite le choix des groupes d'accès en lecture ou en modification à votre groupe et aux groupes inférieurs.

 

 

# C'est possible

Vous pouvez avoir dans un même site Zwii plusieurs pages contenant un agenda différent.

 

 

 

 

 

agenda_920.jpg

agenda_connecte.jpg

 


Quoi de neuf dans la version 4.1 ?   Voir le journal des modifications

Publiée

Version 4.1 majeure

  • Modification des dossiers de données pour préparer la gestion des modules (Zwii 10.5.00),
  • Nouvel outil de configuration : la gestion des catégories,
  • Ajout des constantes pour la future gestion des modules.

 

Version 4.0 majeure

  • Séparation des scripts et des données pour faciliter les mises à jour ultérieures

 

Version 3.3

  • Amélioration du codage

 

Version 3.2

  • Correction d'un bug qui se produisait si plusieurs membres modifiaient un évènement simultanément.

 

Version 3.1

  • Les couleurs d'un évènement dans l'agenda peuvent être associées à une catégorie d'évènements,
  • Amélioration de l'aspect visuel de l'agenda avec réglage des couleurs facilité.

 

Version 3.0

  • Possibilité d'émettre un mailing suite à la création, modification, suppression d'un événement.

 

Version 2.12

  • Demande de confirmation en cas de suppression d'un agenda
  • Modification du bouton suppression en édition d'évènement

 

Version 2.11

  • Correction d'un bug en édition (suppression d'évenement)

 

Version 2.10

  • Compatibilité avec Zwii 10.2.07

 

Version 2.9

  • Correction de certains liens erronés pouvant empêcher la mise en forme du texte des évènements

 

 

Version 2.7 mineure

  • Compatibilité avec Zwii 10.1 en conservant la compatibilité avec Zwii 9.2 et 10.0

 

Version 2.6 mineure

  • Couleur du bouton supprimer dans la page d'édition d'un évènement.

 

Version 2.5 majeure

  • Corrections pour permettre un changement du nom de la page qui héberge le module

 

Version 2.4

  • Modifications liées à la séparation du thème entre site et administration

 

Version 2.3

  • Corrige un bug qui se produisait lors de la lecture de certains fichiers ics

 

Version 2.2

  • Le téléchargement des fichiers ics se fait avec le gestionnaire de fichiers de Zwii

 

Version 2.1

  • Edition des évènements en Wysiwyg (tinymce) avec des autorisations fonction de votre groupe
  • Suppression du fichier .htaccess et quelques corrections

 

 




Retour utilisateur

Vous pouvez donner un avis uniquement après avoir téléchargé le fichier.


herve

Signaler ·

  

Bonjour

 

Au fil de son développement ce module Agenda peut; maintenant,  jouer dans la cour des grands.  👍

 

Ces fonctionnalités répondront à la plupart de nos besoins.

 

il est 

- collaboratif (travail en équipe, calendrier d’association ...)

- informatif avec la possibilité d'envoi de mails à la création d'un évènement, la liste de mail pouvant être celle des membres inscrits ou de toutes autres listes de destinataires.

- souple et adaptable par la possibilité de créer sa propre liste de catégorie d'évènements.

- facile à utiliser.

- les évènements créer sont facilement paramétrables concernant leur accès en consultation et modifications.

- multiple par le fait que plusieurs agendas indépendants peuvent être créer sur la même installation de Zwii.

 

Ce module n'ai pas figé, son créateur @sylvainlelievre est réactif.

 

Bref que du bonheur.

 

Hervé

 

Réponse de l’auteur :

Merci @herve,

 

C'est grâce à des idées comme les tiennes et à tes encouragements que ce module a pu progresser au fil des mois.

Encore merci à Adam Shaw, le concepteur du moteur javascript de cet agenda que j'ai mis à la disposition des Zwiiens !

 

  • Merci 1

Partager cet avis


Lien vers l’avis
×
×
  • Créer...