La nouvelle release de AllEvents intègre maintenant la surcharge des feuilles de style du module.

Ci-contre illustré (cliquez pour agrandir), vous constaterez que la feuille de style surchargée doit être placée dans le dossier /override/mod_allevents de votre site.  Dossier à créer le cas échéant.  Ensuite, il faut strictement respecter l'arborescence du module.  

Dans l'exemple ci-contre, j'ai surchargé le fichier mod_allevents/assets/css/background/paper/style.css.   Le fichier originel se trouve dans le dossier /modules de votre site.   Il faut donc "juste" recréer la même arborescence.   

Les fichiers de langues sont dorénavant surchargeables.

Si vous souhaitez apporter une modification dans les fichiers de langues de AllEvents (que ce soit frontend ou backend; que ce soit le composant ou le module); voici comment procéder  :

1. Au besoin, créer le dossier language/fr-FR dans le dossier /components/com_allevents/override de votre site.   "fr-FR" étant le code langue de votre site; cela peut-être tout autre code comme p.e. en-GB pour l'anglais international.

2. Créez un fichier nommé fr-FR.com_allevents.ini dans le dossier /components/com_allevents/override/language/fr-FR.   Je vous recommande de créer un fichier et non pas de copier le fichier d'origine afin de ne redéfinir que strictement les textes que vous souhaitez modifier.  

3. Editez le fichier et insérez une ligne qui est construite de cette manière : CODE="TEXTE".

4. Sauvez le fichier.

Retournez dans AllEvents et rafraîchissez la page.  Si vous avez redéfini le bon code, votre modification sera immédiatement visible.

Un exemple :

Pour arriver à ce résultat, il a suffit de mettre les deux lignes suivantes dans le fichier de langue surchargé :

TODAY_EVENT="C'est aujourd'hui que cela se passe !"
NEXT_EVENT="Vite, vite, inscrivez-vous !!!"

Lorsqu'on a écrit une surcharge, il existe un petit truc qui permet de désactiver temporairement le support des surcharges : il suffit d"ajouter &override=0 à la fin de l'URL.

Cela permet entre autre chose :

• d'afficher la page comme AllEvents l'a prévu nativement.   Peut-être avez-vous écrit  votre surcharge il y a plusieurs mois et que depuis lors AllEvents a continué à évoluer : est-ce que les évolutions ont modifié la manière dont la page s'affiche ?  En désactivant la surcharge, vous le verrez.
• l'affichage de la page génère des erreurs et/ou une page blanche : est-ce un problème lié à AllEvents ou auriez-vous commis une erreur de programmation en écrivant la surcharge ?   Peut-être AllEvents, d'une version à une autre, a modifié la manière dont les informations sont transmises aux fichiers surchargés et que votre code nécessite une mise-à-jour.
• ...

Désactivez la surcharge est donc un des moyens que AllEvents met à votre disposition pour traquer les erreurs.

Vous pouvez aussi, bien évidemment, désactivez le plugin AllEvents - Override afin de désactivez globalement la prise en charge de la surcharge.

AllEvents vous propose différentes mises en page pour l'affichage des tooltips; ces petites bulles d'informations qui apparaissent au survol du titre d'un évènement ou, depuis le calendrier mensuel, sur le numéro du jour où il y a un ou plusieurs évènements.

Parmis les layouts proposés, il y a par exemple celui-ci à gauche : le titre de l'évènement mis en évidence puis les informations complémentaires (dates, agenda, activité, public cible, section, catégories et localisation).

Les layouts disponibles pour les tooltips sont présents dans le dossier /components/com_allevents/includes/tooltips de votre site.   A chaque layout proposé, vous allez trouver un dossier correspondant.   Ainsi, dans la version 1.1 Alpha 5e de AllEvents, les deux styles proposés sont "default" et "title_bullets_text".

La structure des dossiers est identique : un fichier nommé default.php, un fichier nommé tooltips.css et le traditionnel index.html de Joomla.

La surcharge est simple :

1. Dans le dossier /components/com_allevents/override, créez un dossier qui porte le nom du layout que vous souhaitez modifier.   Par exemple, en supposant que vous souhaitez partir du layout title_bullets_text; vous devrez donc créer le dossier /components/com_allevents/override/tooltips/title_bullets_text.
2. Copiez le fichier original /components/com_allevents/includes/tooltips/title_bullets_text dans le dossier que vous avez créé (càd dans le dossier //components/com_allevents/override/tooltips/title_bullets_text).
3. Avec votre éditeur préféré, ouvrez le fichier nouvellement créé (càd dans le dossier //components/com_allevents/override/tooltips/title_bullets_text/default.php) et apportez-y toutes les modifications nécessaires pour que l'affichage respecte vos souhaits.

Remarque : si vous désirez également modifier la feuille de style; il faudra recopier le fichier tooltips.css du dossier original pour le placer dans le dossier /override afin de la surcharger.

Pour rappel : la surcharge telle que décrite ci-dessus vous permet de conserver vos modifications d'une version à une autre de AllEvents.   A l'instar de Joomla : si vous modifiez les fichiers source de Joomla, vous perdrez vos modifications dès lors que vous mettrez Joomla à jour.   En faisant de la surcharge, ce ne sera pas le cas.

Il m'a souvent été demandé s'il était possible de personnaliser l'écran des filtres : ne pas le faire apparaître comme "ceci" mais plutôt comme "cela".

Exactement comme pour la personnalisation de l'écran d'édition d'un évènements, il est dorénavant possible de personnaliser les filtres.   Pour ce faire, copier simplement le fichier /com_allevents/include/backend_filters.php ou frontend_filters.php vers le dossier /images/allevents/include de votre site et modifier le fichier nouvellement créé à cet endroit.

AllEvents prendra alors votre fichier personnalisé en lieu et place de son fichier d'origine.