Foire aux questions (FAQ)
> Questions générales et juridiques
> Problèmes techniques et bugs
> Personnalisation de l'agenda
Questions générales et juridiques
Combien coûte XLAgenda ?
Rien. XLAgenda est complètement gratuit. Vous pouvez toutefois faire un don via PayPal si vous le souhaitez.
Suis-je autorisé à modifier le code de XLAgenda ?
Oui. XLAgenda est sous le régime de la GNU General Public License. En vertu de cette licence, vous pouvez librement modifier le code. Vous n'êtes pas obligé de distribuer ou de publier vos modifications, mais si vous le faites, vous devez placer celles-ci également sous le régime de la GPL.
Pour en savoir plus sur les droits et obligations résultant de la GPL, consultez la FAQ sur le site de GNU.
Est-il possible de contribuer à XLAgenda ?
Bien sûr ! Le projet est disponible sur Github. Vous pouvez proposer des améliorations.
Problèmes techniques et bugs
J'ai une erreur du type "Wrong parameter count for session_set_cookie_params()"
Sur la page d'accueil de l'agenda, l'erreur "Wrong parameter count for session_set_cookie_params()" s'affiche.
Ce problème se produit dans les versions antérieures à la version 5.4 et est lié au fait que vous utilisez une version de PHP antérieure à la version 5.2. Pour y remédier, dans include/functions.php, remplacer cette ligne :
session_set_cookie_params(0, $chemin, '', false, true);
par celle ci :
session_set_cookie_params(0, $chemin, '', false);
A noter : l'affichage de cette erreur génère également des erreurs de type "Headers already sent".
Au moment de l'installation, un message d'erreur "Parse error" s'affiche
Lors de l'installation, après l'écran de validation de la licence, vous obtenez une page blanche et un message d'erreur : "Parse error: syntax error, unexpected T_INCLUDE in /xlagenda44/install/index.php on line 1".
Cette erreur est liée à l'incompatibilité des caractères de fin de ligne entre les différents systèmes (Linux, Windows, MacOS). Pour y remédier, supprimez les fichiers PHP de votre serveur et uploadez les à nouveau en utilisant le mode ASCII.
Si vous ne savez pas comment uploader en ASCII, consultez la documentation de votre client FTP.
Au moment de l'installation, l'agenda me dit de vérifier les données du fichier data.php
Au moment de l'installation, un message d'erreur apparaît : "Erreur: impossible de communiquer avec la base de données. Vérifiez les données du fichier data.php."
Ce message signifie que l'installeur n'a pas réussi à se connecter à votre base de données car les informations figurant dans le fichier data.php sont inexactes ou que le fichier data.php est corrompu.
Si vous pensez avoir bien configuré le fichier data.php, vérifiez qu'il est bien de cette forme :
//INDIQUER ICI LES DONNEES DE CONNEXION A VOTRE BASE DE DONNEES FOURNIES PAR VOTRE HEBERGEUR
$dbserver="nom_serveur"; //ADRESSE DU SERVEUR SQL
$dbdb="nom_base"; //NOM DE LA BASE DE DONNEES A UTILISER
$dbuser="nom_utilisateur"; //NOM D'UTILISATEUR DE LA LA BASE DE DONNEES A UTILISER
$dbpass="mot_de_passe"; //MOT DE PASSE DE LA BASE DE DONNEES A UTILISER
En particulier, les données doivent être placées entre deux guillemets et les lignes se terminer par un point virgule.
Vérifiez bien vos données de connexion auprès de votre hébergeur : lui seul peut vous indiquer comment bien configurer ce fichier.
Si vous utilisez EasyPHP, consultez la FAQ du site EasyPHP pour savoir comment configurer le fichier data.php.
Lorsque je clique sur un lien dans l'agenda, j'obtiens une erreur 404 (not found)
Vous obtenez une erreur 404 (page non trouvée) lorsque vous cliquez sur un jour, sur "mois suivant" ou sur "mois précédent".
Cela signifie que vous n'avez pas modifié, ou que vous avez mal modifié le fichier data.php.
A la ligne $path_agenda= vous devez indiquer le chemin à partir de la racine de votre site vers le répertoire de l'agenda.
Par exemple, si l'agenda est à l'adresse "http://www.monsite.fr/agenda" il faudra indiquer "agenda".
J'ai des messages d'erreur du type "Headers already sent"
Des messages d'erreurs du type "Headers already sent" s'affichent lorsque vous utilisez l'agenda ou que vous vous connectez à l'admin.
Cela signifie que du texte est envoyé avant l'exécution des fonctions session_start() (dans l'admin) ou setcookie() (dans l'agenda).
Pour ajouter du code HTML en haut des pages, nous vous recommandons de modifier les fichiers header.php plutôt que d'ajouter votre code en haut des autres fichiers.
Par ailleurs, lorsque vous modifiez les fichiers header.php, veillez à ne pas insérer de code HTML avant les lignes exécutant les fonctions session_start() et setcookie().
Je viens de mettre à jour XLAgenda. Depuis, je ne peux plus me connecter à l'admin.
Pour toute mise à jour de XLAgenda, vous devez lancer le script de mise à jour automatique. Si vous ne le faites pas, l'application ne fonctionnera pas correctement.
J'essaie de mettre à jour XLAgenda, mais j'ai un message m'indiquant que mon mot de passe est incorrect
A partir de la version 4.1, les noms par défaut des tables ont changé.
Par exemple, la table dans laquelle sont stockés les noms d'utilisateur s'appelle désormais par défaut "xlagenda_users" et non plus "users".
Si vous effectuez une mise à jour depuis une version antérieure à la version 4.1, cette table s'appelle probablement "users" dans votre base de données.
Pensez à modifier le fichier data.php ou à renommer les tables avant de lancer la mise à jour.
Lorsque je me connecte à l'admin, j'ai un message indiquant que ma session a expiré dès que j'essaie d'aller sur une page
Ce problème se produit dans la version 4.2 lorsque le fichier data.php n'a pas été correctement renseigné.
A la ligne $path_agenda= vous devez indiquer le chemin à partir de la racine de votre site vers le répertoire de l'agenda.
Par exemple, si l'agenda est à l'adresse "http://www.monsite.fr/agenda" il faudra indiquer "agenda".
J'ai modifié un nom d'utilisateur. Depuis, cet utilisateur ne peut plus se connecter.
Ce problème se produit dans les versions antérieures à la version 4.1.
En cas de changement d'un nom d'utilisateur, le mot de passe de cet utilisateur ne fonctionne plus et il ne peut plus l'utiliser pour se connecter. La solution est de changer le mot de passe après avoir changé le nom d'utilisateur. Avec la version 3.3, l'utilisateur peut également demander un nouveau mot de passe en utilisant le lien "Mot de passe oublié" sur la page d'accueil de l'agenda.
Sur la page de demande de compte, un message d'erreur s'affiche à la place du code de sécurité
Sur la page de demande de compte, au lieu de l'image affichant le code de sécurité, vous obtenez le message suivant :
"Warning: imagepng() [function.imagepng]: Unable to open 'img/code.png' for writing: Permission denied".
Ce message provient du fait que le répertoire "img" placé à la racine de votre agenda est protégé en écriture. XLAgenda a besoin d'accéder à ce répertoire pour générer l'image sur laquelle s'affiche le code de sécurité. Utilisez votre client FTP pour modifier les droits de ce répertoire en effectuant un CHMOD 777. Si vous ne savez pas comment faire cette opération, consultez la documentation de votre client FTP.
Personnalisation de l'agenda
Suis-je autorisé à modifier XLAgenda pour ajouter des fonctions ou l'adapter à mon site ?
Bien sûr. Vous êtes libre d'apporter toutes les modifications que vous voulez au code ou à l'apparence de l'agenda.
La seule chose qui vous est demandée est de conserver la mention "Propulsé par XLAgenda" et le lien vers le site de l'auteur, en bas de chaque page de l'agenda.
Comment personnaliser l'agenda pour mieux l'intégrer à mon site ?
Vous pouvez ajouter du code HTML avant et après le code de l'agenda, sur l'ensemble des pages de celui-ci. Cela vous permet de l'insérer dans votre page web.
Les deux fichiers à modifier sont header.php et footer.php, dans le répertoire "include". A l'intérieur de ces fichiers, il est indiqué où insérer le code HTML. Nous vous recommandons de ne pas insérer de code HTML ailleurs ou dans d'autres fichiers car cela risquerait de générer des erreurs.
Vous pouvez également modifier la feuille de style style.css.
Dans tous les cas, aucune connaissance en PHP n'est nécessaire pour personnaliser l'application.
Comment modifier les textes ou afficher XLAgenda dans une autre langue ?
XLAgenda est localisable et vous pouvez donc facilement modifier les textes ou afficher l'application dans une autre langue.
Tous les textes utilisés sont stockés dans deux fichiers : "lang/fr/common.php" et "lang/fr/admin.php" (pour l'interface d'administration).
Pour afficher XLAgenda dans une autre langue que le Français, voici la procédure à suivre :
- Créez un nouveau répertoire dans le répertoire "lang" (par exemple "en" pour l'Anglais) et placez dedans les fichiers "common.php" et "admin.php" traduits ;
- Dans le fichier "data.php", indiquez le nom du nouveau répertoire dans la variable "language" ;
- Vous devez également traduire les textes utilisés par l'éditeur HTML tinymce en plaçant un nouveau fichier .js dans le répertoire "include/tiny_mce/langs"
Est-il possible de télécharger une traduction de XLAgenda dans une autre langue que le Français ?
Pas encore ! Mais si vous traduisez XLAgenda, n'hésitez pas à nous envoyer vos fichiers common.php et admin.php. Nous les mettrons à disposition de la communauté.
J'aurais besoin d'une fonction supplémentaire. L'auteur peut-il l'ajouter pour moi ?
Non, c'est à chaque utilisateur de modifier l'application selon ses désirs et ses besoins. Merci d'avance de ne pas contacter l'auteur pour des demandes de ce type.
L'application a été documentée de manière à pouvoir être facilement modifiable et il existe un grand nombre de sites francophones consacrés au couple PHP / MySQL. Ajouter une fonctionnalité est donc à la portée de tout le monde.
Comment insérer le calendrier sur une page de mon site ?
Vous pouvez insérer sur une page de votre site, par exemple la page d'accueil, le calendrier qui apparaît en haut à gauche de XLAgenda. De cette manière, vos visiteurs peuvent facilement savoir quand se tiennent les prochains événements et cliquer sur une journée pour afficher les événements correspondants.
Vous devez pour cela télécharger ce fichier et l'insérer dans le code de votre page, à l'endroit où vous souhaitez afficher le calendrier.
Si vous avez modifié le nom par défaut du répertoire de l'agenda, n'oubliez pas de remplacer dans le code "xlagenda44" par le nouveau nom.
En outre, pour que cela fonctionne, vous devrez la plupart du temps changer l'extension de votre page en .php
Comment afficher tous les événements et non uniquement ceux du mois ?
Pour afficher tous les événements, il faut modifier la requête vers la base de données.
Dans le fichier index.php cherchez la ligne :
$query="SELECT * FROM $table_agenda WHERE (date_debut <= '$date2' AND date_fin >= '$date1' AND actif = '1') ORDER BY date_debut ASC, heure_debut ASC";
- Si vous voulez n'afficher que les événements à venir, remplacez la par la ligne :
$query="SELECT * FROM $table_agenda WHERE date_fin >= '$year-$month-$day' AND actif = '1' ORDER BY date_debut ASC, heure_debut ASC"; - Si vous voulez afficher tous les événements, même passés, remplacez la par la ligne :
$query="SELECT * FROM $table_agenda WHERE actif = '1' ORDER BY date_debut ASC, heure_debut ASC";
Comment configurer la vue par défaut ?
Avec XLAgenda, les événements peuvent s'afficher sur l'écran principal sous forme réduite ou détaillée. Vous pouvez choisir le mode par défaut en modifiant le fichier data.php.
A la fin du fichier data.php, éditez la variable $defaut en indiquant 1 pour la vue réduite et 0 pour la vue détaillée.
Comment personnaliser l'adresse depuis laquelle sont expédiées les notifications par email ?
Depuis la version 3.3, vous pouvez personnaliser l'adresse d'expédition des notifications par email en renseignant le paramètre $email_exp du fichier data.php.
Si vous le ne faites pas, une adresse par défaut, générée avec votre nom de domaine, sera utilisée. Ainsi, si votre site a pour URL www.monsite.fr l'adresse d'expédition sera [email protected].
Utilisation de l'agenda
Peut-on insérer une image dans la description d'un événement ?
Vous utilisez XLAgenda 3.x
Vous pouvez insérer une image dans un événement en utilisant la balise HTML <img>.
Toutefois, vous devez auparavant autoriser l'utilisation de cette balise en l'ajoutant à la liste des balises HTML autorisées, dans le fichier data.php.
Vous utilisez XLAgenda 4.x
Vous pouvez insérer une image à l'aide de l'éditeur HTML à condition d'avoir auparavant changé l'éditeur, en passant de la version "simple" à la version "advanced".
Dans les fichiers "ajouter.php" et "modifier.php" du répertoire "admin", vous devez modifier le code JavaScript appelant l'éditeur HTML en utilisant le code suivant :
<script type="text/javascript">
tinyMCE.init({
mode : "textareas",
theme : "advanced",
language : language,
theme_advanced_toolbar_location : "top",
theme_advanced_toolbar_align : "left",
theme_advanced_statusbar_location : "bottom",
file_browser_callback : "tinyBrowser"
});
</script>
Ensuite, dans le fichier "functions.php", du répertoire "include", vous devez modifier la fonction cleanHtml() pour ajouter la balise <img> et les autres balises que vous souhaitez autoriser.
function cleanHtml($texte)
{
global $editeur_html;
if ($editeur_html)
{
$texte=strip_tags($texte,"<p>,<span>,<ul>,<ol>,<strong>,<em>,<li>,<img>");
$expression="font-family[^>]*\;";
$texte=ereg_replace($expression,"",$texte);
$expression="font-size[^>]*\;";
$texte=ereg_replace($expression,"",$texte);
}
else
{
$texte=strip_tags($texte);
}
return $texte;
}
Consultez la documentation de tinymce pour en savoir plus sur la personnalisation de l'éditeur HTML.
J'ai introduit cinq mauvais mots de passe. Mon compte ou mon adresse IP sont bloqués. Comment faire ?
Si vous introduisez cinq fois un mauvais mot de passe ou un mauvais nom d'utilisateur, le compte utilisé et votre adresse IP seront bloqués. Vous avez alors trois solutions :
- Vous pouvez vous connecter à partir d'un autre compte ou d'une autre adresse IP puis effacer les logs via le menu "Gérer les logs de connexion"
- Vous pouvez vider la table "logs" de votre base de données en utilisant PHPMyAdmin ou une application similaire, ou bien en exécutant la requête SQL "DELETE FROM logs"
- Vous pouvez attendre le lendemain matin : le blocage ne vaut que jusqu'au lendemain 0h00.
J'ai oublié mon mot de passe. Comment faire pour le récupérer ?
Les mots de passe étant codés dans la base de données, il est impossible de les récupérer. Il existe toutefois deux solutions pour pouvoir à nouveau utiliser votre agenda.
Vous utilisez XLAgenda 3.3 ou XLAgenda 4.x
Vous pouvez demander un nouveau mot de passe : il suffit de cliquer sur le lien "Mot de passe oublié", sur la page d'accueil de l'admin et d'indiquer votre adresse e-mail afin de recevoir un nouveau mot de passe. Si vous n'avez pas indiqué d'adresse email au moment de la configuration de votre compte, il faut au préalable insérer une adresse email en utilisant PHPMyadmin ou en effectuant une requête SQL du type :
"UPDATE xlagenda_users SET email = 'votre email' WHERE user = 'votre nom d'utilisateur'.
Vous utilisez une autre version
La seule solution est de générer un nouveau compte. Pour cela, récupérez le script d'installation de votre version, uploadez le sur votre serveur FTP et lancez le. Il vous sera demandé de choisir un nouveau nom d'utilisateur et un nouveau mot de passe. Vous pourrez ainsi retrouver l'accès à l'admin sans effacer les événements de l'agenda. Attention : par mesure de sécurité, ne laissez jamais le script d'installation sur votre serveur.
Prochaines versions
Quand sortira la prochaine version ? Proposera t-elle la fonction x ou y ?
Il n'y a pas de date de fixée pour le moment. La date de sortie et le contenu de la prochaine version seront déterminés en fonction des retours des utilisateurs. N'hésitez pas à suggérer des évolutions à l'aide du formulaire de contact.