{{tag>script php mysql programmation web}}
== PhxContacts ==
Page wiki dédiée à mon script de carnet d'adresses. Je n'ai pas encore trouvé le temps ni le courage pour continuer le développement ainsi que la doc...
Néanmoins, toutes les contributions sont les bienvenues !
Merci de votre compréhension.
Ce script est idéal pour gérer les adresses de vos contacts ou de vos partenaires. Il vous permet de limiter l'accès aux contacts en donnant des droits d'accès aux membres de votre famille ou de votre organisation. Une interface d'administration agréable vous offre une grande facilité de configuration pour vos données.
**//Ayant développé cette application pour mon besoin personnel, il est possible qu'elle ne convienne pas au votre, en conséquence n'hésitez pas à// mettre la main à la pâte //!//**
===== Caractéristiques =====
[[http://phoetux.org/phxcontacts/phxcontacts.png|{{ http://phoetux.org/phxcontacts/phxcontacts_mini.jpg|Cliquez pour agrandir}}]]
* base de données MySQL
* gestion des contacts
* posibilité de lier une photo au contact :: **//__nouveau__//**
* multiutilisateurs (user et admin)
* gestion des droits d'accès
* 4 niveaux de sécurité :: **//__nouveau__//**
* anti-SPAM, cryptage des adresses emails en hexdecimale
* panneau de configuration
* assistant d'installation
* envois de messages électroniques
* aide en ligne sur le forum
* etc...
===== Configuration requise =====
* Serveur d'application supportant le **PHP** //(testé avec PHP v.4.3.3 et plus)//
* Une base de données **MySQL**
* Compatible Netscape 4+ et IE 4+, recommandé avec [[http://www.mozilla-europe.org/fr/products/firefox/|Mozilla Firefox]]
* **Ne fonctionne pas correctement avec __EasyPHP sous Windows__ !!!**
**[[http://phoetux.org/scripts/?id=3|Télécharger maintenant]]**
^ Version | 0.98 beta ^ Téléchargements | {{http://phoetux.org/phxcontacts/a.php?.png?}} |
^ Format | TAR.GZ ^ Démo | Disponible [[http://phoetux.org/phxcontacts/demo|par ici]]! |
^ Taille | 100 ko ^ Faire un don | Envoyez-moi un chèque! |
Distribué également sur [[http://www.comscripts.com/|{{http://partner.comscripts.com/cscount.php?hits=357&.png?}}]]
----
**Patch 0.97** - [[http://phoetux.org/scripts/?id=4|téléchargez le patch]] (ZIP 9.8 ko)
Mise à jour de votre carnet d'adresses vers la version 0.97 !!!
Si vous êtes déjà utilisateur de PhxContacts et que vous souhaitez mettre à jour votre carnet d'adresses, vous pouvez patcher votre base de données afin de concerver tous vos contacts déjà enregistrés. Téléchargez le patch et décompressez le fichier ZIP puis placez le fichier "**patch.php**" à la racine de PhxContacts et connectez-vous dessus avec votre navigateur et suivez les indications.
**//Par mesure de sécurité, faites une sauvegarde de votre base de données avant de la patcher. Je ne serai pas responsable en cas de perte de données.//**
===== Installation =====
Avant l'installation, n'oubliez pas de lire le fichier **lisezmoi.html** ainsi que la [[http://phoetux.org/phxcontacts/demo/licence.html|licence]] d'utilisation.
- Décompressez le fichier phxcontacts.zip à la racine de votre site. Un répertoire "phxcontacts" est créé contenant les fichiers nécessaires à l'application.
- Faites un [[phxcontacts#chmod777|CHMOD 777]] sur le fichier "**config.inc.php**" qui se trouve dans le dossier config à la racine de PhxContacts (votre-site.com/phxcontacts/config/config.inc.php) et sur le dossier "**photos**" à la racine également.
- Ouvrez un navigateur et connectez-vous sur l'**assistant d'installation** qui se trouve dans le dossier **install** (http://votre-site.com/phxcontacts/install) et suivez les indications à l'écran.
- Pour des mesure de sécurité, une fois la procédure d'installation terminé, **supprimez le dossier install** du répertoire phxcontacts de votre site.
- Modifiez l'interface graphique à l'aide du fichier **styles.css**.
===== Aide en ligne =====
Avant de commencer l'installation : vous devez rendre le fichier config/config.inc.php accessible en écriture par le script. Pour cela, il faut modifier les droits d'accès au fichier. La commande est CHMOD. le code qui suit cette commande, dans ce cas, 777 est les nouveaux droits d'accès donnés au fichier. 777 signifie "lecture, écriture et exécution pour tous les utilisateur".
cd /chemin/vers/votre/site/phxcontacts
chmod 777 config/config.inc.php
chmod 777 -R photos
Voici un exemple de modification des droits avec [[http://filezilla.sourceforge.net/|FileZilla]] sous Windows
{{ http://phoetux.org/phxcontacts/aide/p001.jpg }}
==== Etape 1 ====
{{ http://phoetux.org/phxcontacts/aide/logomysql.jpg}}
Entrez vos paramètres MySQL
* **Adresse ou nom du serveur MYSQL** : est l'adresse que va utiliser le script pour atteindre votre base de données.
* **Nom de la base de données** : est comme son nom l'indique, le nom de votre base de données.
* **Nom d'utilisateur de la base** et **Mot de passe de l'utilisateur** : sont les login et mot de passe qu'utilisera le script pour accéder à votre base de données.
* **Préfixe des tables** : est par défaut "**phx_**". Ce préfixe sera placé devant le nom de chaque une des tables créées et utilisées par le script. //Par exemple : cela permet de regrouper les tables lorsque vous afficherez votre base de données dans [[http://www.phpmyadmin.net/|phpMyAdmin]].// Si vous n'êtes pas sûr, il est conseillé de laisser le nom par défaut.
==== Etape 2 ====
{{ http://phoetux.org/phxcontacts/aide/config.gif}}
Configurez et personnalisez votre carnet d'adresse Cette étape est très importante car vous allez créer votre compte administrateur du carnet d'adresse. Ce compte vous permet d'accéder à la console d'administration pour gérer les utilisateurs, les catégories, le panneau de configuration, etc. Il est important de mettre une adresse email valide et personnelle.
* **Titre du carnet d'adresses** : est le texte qui sera affiché sur l'entête du carnet d'adresse.
* **Adresse email du carnet d'adresses** : est l'adresse principale du carnet d'adresses. Elle sera utilisée lorsque le script devra envoyer des emails. //Vous pouvez mettre votre propre adresse.//
* **URL de votre webmail** : est un simple lien vers votre webmail préféré. Ce champ n'est pas très utile, mais obligatoire. //Par exemple : vous pouvez mettre http://www.gmail.com ou http://webmail.votre-site.com etc.//
* **Racine du site** : est le lien relatif du script sur votre site. //Par exemple : http://www.votre-site.com/dossier_choisi/phxcontacts. // Dès que vous placerez le curseur dans le champ, une fonction JavaScript écrira votre lien en relation au dossier où vous aurez placé le carnet d'adresses.
* **Niveau de restriction** : déterminez le niveau de protection des données du carnet d'adresses (par défaut le niveau est élevé) :
* **Faible** : les membres et les non-membres pourront voir les détails des contacts ainsi que ajouter/modifier/supprimer des contacts. **//Ce mode est __déconseillé__ si vous placez le script en dehors d'un site intranet !//**
* **Moyen** : les membres et les non-membres pourront voir les détails des contacts mais seuls les membres pourront ajouter/modifier/supprimer des contacts.
* **Elevé** : seuls les membres pourront voir les détails des contacts, pourront ajouter/modifier/supprimer des contacts, mais seuls les administrateurs pour gérer la configuration du carnet d'adresses.
* **Parano** : seuls les membres pourront voir les détails des contacts mais seuls les administrateurs pourront ajouter/modifier/supprimer des contacts.
**Ce qu'il faut savoir** : PhxContacts lutte contre le SPAM en utilisant une fonction de cryptage pour l'affichage d'adresses emails sur ses pages. Les adresses sont lisibles par les navigateurs internet mais pas par les robots aspirateurs de sites pour générer des listes. //**Le moyen le plus efficace reste de mettre un niveau élevé** pour bloquer l'accès aux programmes malveillants.//
===== Bugs =====
Si vous rencontrez des erreurs, éditez le fichier **config/var.inc.php** et modifier la valeur de la variable **$debugSQL à "true"**. Cette variable vous permet de voir le détail des différentes actions, comme les requêtes SQL lors du chargement des pages, le transfère de variables dans l'URL (form method = "GET"), etc.