LOMART

Taille police

Cpanel

Documentation

logo bgmax
bgMax est un petit module dont le but est de faciliter la mise en place d'une image de fond pour votre site.

Bien que conçu pour faciliter la personnalisation des templates gérée par le Framework JA T3, il fonctionne avec la plupart des templates.

Il est totalement indépendant du template, il se contente d'ajouter du code pour personnaliser votre page après génération par le template. Cela prend tout son sens dans le cas du Framework JA T3 et de son fichier 'index.php' inhabituel et déroutant.

Mais pourquoi s'appelle-t'il bgMax ?

Tout simplement, car à l'origine, il servait à implanter le javascript bgMax, créé par www.webbricks.org, dont le but est d'agrandir l'image de fond à la taille du navigateur et de réaliser un effet de fondu lors de l'affichage.

Concrètement, sous Joomla, il suffit d'installer le module comme vous le faites d'habitude, puis de le publier en position debug pour qu'il soit appelé en dernier lors de la génération de la page.

Pour découvrir les possibilités du module, le plus simple est d'explorer son panneau de paramétrage.

configuration | image et couleur de fond | taille et position | styler le contenu | affichage sous conditions

Les copies d'écran présentées sont celles de la version pour Joomla! 1.6.

Bien que les 2 versions se ressemblent, je signalerais les différences quand nécessaire.

La première chose à faire est d'activer le module et de le publier en position debug (ou une autre position située en fin de votre template si la position debug n'existe pas).

Sous joomla 1.6, il ne faut pas oublier le "Menu d'Assignement" situé au-dessous pour indiquer les pages sur lequel le module sera actif.

alt

Debug : le premier paramètre permet de demander l'affichage sur le site d'informations pour faciliter le paramétrage du module.

Vous avez le choix entre : Jamais, toujours ou seulement si connecté.

La première partie des paramètres permet de définir l'image de fond. Cette partie diffère selon la version de Joomla!

Image de fond:

J16 Sélection visuelle dans le gestionnaire de média
J15 Zone de texte pour indiquer l'url de l'image qui peut être absolue ou relative
J15 Sélection d'une image dans le dossier 'images/bgmax'.
Ce dossier est créé automatiquement à la première utilisation de bgmax.
Au hasard dans dossier :
J15 / J16

Créer un sous-dossier dans le dossier "images/bgmax" et télécharger vos photos dans ce sous-dossier.
Ensuite, sélectionnez ce sous-dossier dans la configuration du module pour afficher les images de ce dossier.

Pour la couleur utilisée en l'absence d'image, vous pouvez la choisir :

  • en vous aidant du sélecteur de couleurs
  • en laissant le module la définir en fonction de la couleur du bas-gauche de l'image. De cette façon, le fond change automatiquement avec l'image.
Attention, certaines images JPEG génèrent des erreurs.
Dans ce cas, il faut les sauver en PNG puis de nouveau en JPEG.

alt

La deuxième partie va fixer le comportement de l'image dans la fenêtre du navigateur client.

Position : adaptation de l'image à la fenêtre
Avec utilisation du javascript:
MAX : ajuste la largeur à celle de la fenêtre.
Si votre image est plutôt carrée, elle remplira l'intégralité de la fenêtre.
FULL : l'intégralité de l'image sera visible en la réduisant si nécessaire et en ajoutant des marges.


Sans utilisation du javascript (CSS uniquement):
aucun / no-repeat : aucune répétition
repeat-x : répétition horizontale
repeat-y : répétition verticale
repeat : répétition horizontale et verticale

COVER : l'image va s'adapter pour couvrir tout le fond (uniquement pour les navigateurs CSS3)

Les autres paramètres définissent la position et le mode de défilement.

IE6 : la position "fixed" générant une erreur avec IE6, l'image de fond sera toujours en mode "scroll" avec ce navigateur et "fixed" avec tous les autres.

Si besoin, zIndex et Décalage top permettent de compenser des problèmes du navigateur ou du template.

alt

Il reste à régler le côté magie du module : l'apparition en fondu de l'image.

Le délai d'apparition permet de définir le temps de chargement de l'image au-dessous duquel l'effet ne sera pas actif. Pour les pages suivantes, l'image étant en cache, l'effet n'aura pas lieu. A adapter selon la vitesse de votre hébergement.

La durée et le nombre d'images par seconde sont des notions plus simples à régler.

Note: le fondu n'est pas actif si l'image n'est pas redimensionnée.

alt

Avec certains templates, le bloc central ne permet pas de voir l'image de fond; ce qui est dommage pour notre utilisation.

Il suffit donc d'indiquer le nom du sélecteur CSS qui définit le centre de la page. Par exemple, #ja-wrapper pour JA T3. Puis sa largeur en pixels ou en pourcentage, sa position horizontale, la couleur et l'opacité du fond.

alt

Et pour être complet et exhaustif, on peut indiquer le code à ajouter dans la partie HEAD de la page générée.

Ce peut être le style d'un titre pour être en harmonie avec l'image de fond, un second bloc qui joue sur le contenu central, ...

La zone de texte permet d'indiquer un style en ligne qui sera inséré dans la partie HEAD de la page générée (entouré des balises < style ...>< /style>).

Joomla! 1.6 ne permettant pas la saisie de code dans les zones de texte, la notion de fichier à inclure a été ajoutée.

Il s'agit d'un simple fichier texte à ajouter dans le dossier /images/bgmax. Ce fichier peut contenir des directives conditionnelles de style pour les anciens navigateurs (IE6, ...). Une autre utilisation des fichiers inclus est de préparer des styles css prêt à l'emploi. 

Pour les utilisateurs de l'ancienne version pour Joomla! 1.5:

Afin d'être compatible avec la version 1.6, il n'est plus nécessaire d'ajouter les tags de déclaration: < style ...>< /style>. Dans la majeure partie des cas, la transition ne devrait pas poser de problème.

alt

L'affichage conditionnel permet de limiter l'action du module en fonction du contenu affiché

  • artid = id d'un article
  • catid = id d'une catégorie
  • menuid = id d'un item de menu
  • view = mode d'affichage du contenu selon la codification Joomla! **
  • layout = mode de mise en page du contenu selon la codification Joomla! **
  • nom d'un composant sous la forme com_phocadownload
  • id = identifiant selon contexte **

** pour connaître les critères à utiliser, le plus simple est d'afficher la page avec l'option "debug"

debug

#OK# indique qu'il s'agit du module nommé 'BgMax-random' qui est actif sur la page. La 2ème ligne indique le contexte, dans ce cas il s'agit de l'article 19 de la catégorie 24 en vue article affiché par le composant com_content appelé par le menu 154

Pour utiliser le module avec tous les articles de la catégorie 24 sauf pour l'article 19, il suffit d'écrire :

catid=24
-artid=19

le signe moins devant le mot clé inverse la condition. Il suffit qu'une ligne remplisse la condition pour que le module soit activé.

 

period

La dernière partie des paramètres permet de définir la période durant laquelle le module est actif.

Depuis la version 3.2.2, vous pouvez changer de fond en fonction de la saison, avoir un habillage différent le week-end et la semaine, ...

Les zones date de début et fin acceptent maintenant la date sous différentes formes

  •     rien : aucune contrainte
  •     JJ-MM-AAAA: date exacte de début ou de fin
  •     JJ-MM: uniquement le jour et le mois. le module sera actif tous les ans
  •     JJ: actif tous les mois
  •     X: avec 1 pour dimanche à 7 pour le samedi. Le module sera actif les jours dits de la semaine.


Pour les heures, il est possible de les lier à la date. Ce qui permet d'indiquer que l'affichage doit débuter au jour et heure indiqué. Dans le cas contraire, l'affichage aura lieu tous les jours aux heures indiquées durant la période définie par les dates.

Vous pouvez également utiliser les fonctionnalités natives de Joomla! pour limiter la période.

Print Friendly and PDF

Vous voulez changer de fond en fonction de la saison, avoir un habillage différent le week-end et la semaine, ...
La nouvelle version 3.2.2 de bgMax le permet.

Les zones date de début et fin acceptent maintenant la date sous différentes formes

    rien : aucune contrainte
    JJ-MM-AAAA: date exacte de début ou de fin
    JJ-MM: uniquement le jour et le mois. le module sera actif tous les ans
    JJ: actif tous les mois
    X: avec 1 pour dimanche à 7 pour le samedi. Le module sera actif les jours dits de la semaine.

Pour les heures, il est possible de les lier à la date. Ce qui permet d'indiquer que l'affichage doit débuter au jour et heure indiqué. Dans le cas contraire, l'affichage aura lieu tous les jours aux heures indiquées durant la période définie par les dates.
Vous êtes ici : Accueil bgMAX Actualité-documentation Documentation