FRANCAIS - INSTALLATION
Nouvelle version v0.6
- Créer un répertoire ’CALx’ dans le répertoire assets/snippets/ de votre installation modx
- Copier-coller le contenu de l’archive dans ce répertoire
- Dans le manager créer un nouveau snippet : CALx
[li]Copier le code suivant dedans :
<?php
$CALxPath = $modx->config['base_path']. 'assets/snippets/CALx/';
include_once($CALxPath.'CALx.class.php');
$objCALx = new CALx();
$objCALx->getFolder=$getFolder;
$objCALx->getTypeProcess=$getTypeProcess;
if(isset($cssStyle)){$objCALx->cssStyle=$cssStyle;}else{$objCALx->cssStyle='defaut';}
if(isset($chunkCSSName)){$objCALx->chunkCSSName=$chunkCSSName;}
if(isset($inactDay)){$objCALx->inactDay=$inactDay;}else{$objCALx->inactDay='6';}
if(isset($dayStart)){$objCALx->dayStart=$dayStart;}else{$objCALx->dayStart='0';}
if(isset($showOtherMonth)){$objCALx->showOtherMonth=$showOtherMonth;}else{$objCALx->showOtherMonth='none';}
if(isset($lang)){$objCALx->lang=$lang;}else{$objCALx->lang='english';}
if(isset($useTV)){
if(!isset($dateStartTVName) || !isset($dateEndTVName)){
$useTV='false';
}
$objCALx->useTV=$useTV;
}else{$objCALx->useTV='false';}
if($useTV=='true'){
$objCALx->dateStartTVName=$dateStartTVName;
$objCALx->dateEndTVName=$dateEndTVName;
}
if(isset($popupSize)){$objCALx->popupSize=$popupSize;}else{$objCALx->popupSize='300';}
if(isset($toolTipPosition)){$objCALx->toolTipPosition=$toolTipPosition;}else{$objCALx->toolTipPosition='CENTER';}
if(isset($popupType)){$objCALx->popupType=$popupType;}else{$objCALx->popupType='2';}
if(isset($idDocYear)){$objCALx->idDocYear=$idDocYear;}
if(isset($idDocMonthEvents)){$objCALx->idDocMonthEvents=$idDocMonthEvents;}
$CALx = $objCALx->Run();
$objCALx='';
return $CALx;
?>
- Pour utiliser les TV : Créer deux TV avec en :
’Type d’entrée : ’ mettre ’Date’
’Widget : ’ mettre ’Date Formatter’
*Ne changez pas le format
’Sélectionner le template où elles seront disponibles
Exemple de TV : Start date
End Date
- Pour utiliser les chunk CSS :
- Crée un nouveau chunk ave le contenu d’un des fichier du répertoire /CALx/style
- Indiquer le nom du chunk au paramètre &chunkCSSName
Appel du snippet
Pour appeler le snippet placer la ligne suivante :
[[CALx? &getFolder=`id` &idDocYear=`ìnt` &idDocMonthEvents=`int`
&dayStart=`int` &inactDay=`int` &lang=`string`
&useTV=`bool` &dateStartTVName=`string`
&dateEndTVName=`string` &popupType=`int` &popupSize=`int`
&toolTipPosition=`string` &showOtherMonth=`string` &chunkCSSName=`string`
&getTypeProcess=`string`]]
Explication des paramètres
&getFolder [int]
Le numéro du répertoire contenant les évènements
&idDocYear [int] (facultatif)
Le numéro du document contenant l’appel de CALx avec &getTypeProcess=`showFullYear`
Crée un lien qui pointe vers ce document en dessous du calendrier.
&idDocMonthEvents [int] (facultatif)
Le numéro du document contenant l’appel de CALx avec &getTypeProcess=`showAllMonthEvent`
Crée un lien qui pointe vers ce document en dessous du calendrier.
&lang [string] (par défaut : english)
Langues disponibles de base : english, french, spanish
Le nom de la langue à utiliser. C’est le préfixe au fichier de langue du
répertoire ’lang’.
Ex : ’french" pour le fichier ’lang/french.lang.php’
&getTypeProcess [createCal | showMultiEvent ]
createCal -> créer le calendrier, créer les lien, colore les cellules
showMultiEvent -> crée la page des liens vers les événements
showFullYear -> crée la liste des calendriers d’une année complète
showAllMonthEvent -> crée une liste de tous les événements du mois
&dayStart [0 | 1 | 2 | 3 | 4 | 5 | 6] (par défaut : 0)
Le jour de départ de la semaine
Valeurs possibles :
0 : lundi
1 : mardi
2 : mercredi
3 : jeudi
4 : vendredi
5 : samedi
6 : dimanche
&inactDay [0 | 1 | 2 | 3 | 4 | 5 | 6] (par défaut : 6)
Le jour d’inactivité de la semaine
Valeurs possibles :
0 : lundi
1 : mardi
2 : mercredi
3 : jeudi
4 : vendredi
5 : samedi
6 : dimanche
&useTV [true | false] (par défaut : false)
Si on souhaite utiliser les TV à la place des dates de publications
mettre ce paramètre à `true`.
Si vous utilisez les TV, les paramètres : dateStartTVName, et dateEndTVName
sont obligatoires.
Si vous omettez ces deux paramètres $useTV sera mis à `false`
&dateStartTVName [string] Obligatoire si &useTV=`true`
Indique le nom de la TV associée à la date de début d’évènement
&dateEndTVName [string] Obligatoire si &useTV=`true`
Indique le nom de la TV associée à la date de fin d’évènement
&popupType [0 | 1 | 2] (par défaut : 2)
Indique le type de popup à utiliser pour les info bulle:
Valeurs possibles :
0 : l’infobulle apparait sur le survol, mais disparait sur un mouvement de souris
Pas de lien cliquable pour le détail
1 : l’inobulle apparait sur un survol, permet de cliquer sur un lien pour le détail
2 : l’infobulle apparait sur un clic, permet de cliquer sur un lien pour le détail
&chunkCSSName [string] (facultatif)
Indique le nom du chunk contenant les classes CSS
&showOtherMonth [previous | both | next | none ] (par défaut : none)
Affiche les jours du mois précédent, suivant, les deux, ou aucun
&popupSize [int] (par défaut : 300)
Taille en pixel de la popup
&toolTipPosition [CENTER | LEFT | RIGHT | ABOVE | BELOW] (par défaut : CENTER)
Emplacement de l’apparition de la popup
Indications
* Qu’un événement soit passé ou à venir, il est affiché dans le calendrier.
Si une journée contient plusieurs événements, un lien dans une info bulle permet d’afficher la liste et un autre lien au détail.
* Le style du calendrier et des info bulles (couleurs etc...) sont modifiables dans le fichier agenda/style/style.css
* un document est créer dans le répertoire des événements pour l’affichage du multi event, il ne faut pas le supprimer.
* ne tient pas compte des sous répertoires, c’est un des ajouts que je vais faire en premier, pour le classement des event c’est qd même plus clair.