XLAgenda
Un agenda en PHP pour votre site Web
Accueil | Présentation | Configuration nécessaire | Installation | Historique | FAQ | Forum | Utilisateurs | Démonstration
> Questions générales et juridiques
> Problèmes techniques et bugs
> Personnalisation de l'agenda
Rien. XLAgenda est complètement gratuit. Vous pouvez toutefois faire un don via PayPal si vous le souhaitez.
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.
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 /xlagenda325/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 (Unix, 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, un message d'erreur apparaît : "Erreur: impossible de communiquer avec la base de données. Vérifiez les donnés 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.
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".
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, vous devez impérativement modifier les fichiers header.php et non pas 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().
Lorsque vous voulez vous connecter à l'admin, vous obtenez plusieurs lignes d'erreur, dont le message "Failed to write session data (files). Please verify that the current setting of session.save_path is correct".
Ce message est lié au fait que vous n'avez pas créé à la racine de votre site un répertoire (dossier) vide appelé "sessions".
Ce répertoire est nécessaire sous Free et Online car il est utilisé pour stocker les fichiers de sessions.
L'affichage de ces lignes d'erreur génère en outre une erreur de type "Headers already sent" qui disparaîtra dès que vous aurez créé le répertoire "sessions".
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.
Il s'agit d'un problème connu, qui sera corrigé dans la prochaine version.
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, 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.
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 "Powered by XLAgenda" et le lien vers le site de l'auteur, en bas de chaque page de l'agenda.
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. A l'intérieur de ces fichiers, il est indiqué où insérer le code HTML. N'insérez pas de code HTML ailleurs ou dans d'autres fichiers ! 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 ce script.
Non. C'est à chaque utilisateur de modifier le script selon ses désirs et ses besoins. Il est inutile de demander à l'auteur de le faire pour vous, la réponse sera de toute manière négative.
Le script a été documenté 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.
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 "xlagenda325" par le nouveau nom.
En outre, pour que cela fonctionne, vous devrez la plupart du temps changer l'extension de votre page en .php
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, nom 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, nom 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, nom ASC";
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.
Dans 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 webmaster@monsite.fr.
Oui, 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.
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.
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.
Avec la version 3.3, 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 users SET email = 'votre email' WHERE user = 'votre nom d'utilisateur'.
Si vous utilisez une version antérieure à la version 3.3, 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.
La prochaine version sortira au mois de février ou mars 2008. Les principales évolutions prévues sont les suivantes :
• Gestion des heures
• Téléchargement des informations sur un événement au format vCal
• Possibilité pour chaque utilisateur d'activer ou de désactiver la réception des notifications par email
N'hésitez pas à suggérer des évolutions à l'aide du formulaire de contact.