1. Introduction
PHPMyFAQ est un système de FAQ multilingue (Question Fréquemment posées) basé
complètement sur une base de données.
Il supporte différents types de base de données pour stocker l’ensemble des
données, PHP 4.1.0 (ou supérieur) est nécessaire pour accéder à ces données.
PHPMyFAQ permet également un système de gestion du contenu multilingue avec
un éditeur WYSIWIG et un gestionnaire d’image, support Multi-Utilisateurs souple
sur base LDAP, un dispositif de révision a la Wiki, un système de news
(nouveautés),
user-tracking, un module de langues, amélioration de la négociation de
automatique du contenu, gestion des gabarit (modèle), support XML étendu,
support PDF, un système de sauvegarde, une carte du site dynamique, un système
intégré contre le spam, et un script d’installation simple a utiliser.
Cette documentation devrait vous aider pour l’installation et
l’administration de PHPMyFAQ.
1.a. Licence
PhpMyFAQ est publié sous licence publique Mozilla Version 1.1 (MPL). Cette
licence vous garantie le libre usage de PhpMyFAQ, un accès au code source et le
droit de modifier et de distribuer PhpMyFAQ.
La seule restriction est appliquée au copyright, qui reste tout le temps a
Thorsten Rinne et a l’équipe PhpMyFAQ. Toutes les versions modifiées de PhpMyFAQ
tomberont aussi sous les termes de la MPL. N’importe quel autre programme, qui
n’accéderais seulement qu’a certaines fonctions de PhpMyFAQ n’est pas affecté
par ces restrictions et peut être distribué sous n’importe quel type de licence.
Un usage ou une distribution commerciale de PhpMyFAQ, par exemple sur CD Rom,
est autorisé tant que les conditions mentionnées ci-dessous sont respectées.
Nous avons décidé d’utiliser le modèle de licence MPL pour PhpMyFAQ parce que
nous estimons que c’est un bon compromis entre la protection de la franchise et
la distribution libre d’une part et un autre logiciel indépendant de son modèle
de licence. Quand nous le comparons à d’autres modèles de licence ce texte est
court et facilement compréhensible même pour des nouveaux venus.
Cette documentation est autorisée sous une licence de création commune.
1.b. Support
Si vous rencontrez des problèmes en utilisant PhpMyFAQ, vérifiez sur notre
forum de support à
http://forum.phpmyfaq.de/
. Il n’ya pas de support gratuit par téléphone ou par email, merci de vous
abstenir de téléphoner ou d’écrire.
L’équipe PhpMyFAQ offre les services payant suivant :
Personnalisation
Support
Si vous êtes intéressé, passez juste voir
notre page de support.
1.c. Copyright
© 2001-2006 par Thorsten Rinne et l’équipe phpMyFAQ sous licence publique
Mozilla.
Tous droits réservés.
1.d. Donations
Si vous trouvez PhpMyFAQ utile et que vous voulez exprimer votre
satisfaction, allez voir la page amazon de Thorsten. Nous acceptons aussi les
dons en ligne par PayPal.
Merci d’utiliser le bouton ci-dessous pour faire un don en ligne :
2. Installation
2.a. pré requis pour phpMyFAQ
PhpMyFAQ communique avec un système de base de données via PHP. Afin de
l’installer vous aurez besoin d’un server web répondant aux exigences
suivantes :
PHP
A partir de la version 4.1.0 (recommandée: PHP 4.4.2 or PHP 5.1.2)
Webserver (Apache 1.3.x/2.0.x or lighttpd or IIS)
Database server
MySQL 3.23.23+, 4.0.x, 4.1.x, 5.0.x, 5.1.x (recommandée: 4.1.x)
MySQL 4.1.x, 5.0.x, 5.1.x avec l’extention MySQLi PHP5 (recommandé:
5.0.x)
PostgreSQL 7.2.x, 7.3.x, 7.4.x, 8.0.x, 8.1.x (recommandée: 8.1.x)
Sybase
Microsoft SQL Server 2000, 2005
IBM DB2 Universal Database 8.2.x, 9.0.x, IBM Cloudscape, et Apache
Derby
SQLite avec PHP5
MaxDB 7.5 ou plus (expérimental)
Correctement réglé : Permissions d’accès, propriétaire, groupe.
Vous pourrez uniquement faire fonctionner PhpMyFAQ quand le paramètre PHP
safe_mode sera positionné sur off, d’autres contraintes affectent les paramètres
open_basedir et disables_functions, qui peuvent être réglés respectivement dans
les fichiers php.ini et http.conf.
Dans le cas où PHP fonctionne comme un module d’Apache, vous devrez pouvoir
faire un chown des fichiers avant l’installation. Les fichiers et les dossiers
doivent appartenir à l’utilisateur d’Apache.
Vous pouvez déterminer sous quelle version votre serveur web fonctionne en
créant un fichier nommé info.php avec le contenu suivant :
<?php phpinfo(); ?>
Chargez ce fichier sur votre espace web et ouvrez-le avec votre navigateur.
Le script d’installation vérifiera la version de PHP qui est installé sur votre
serveur.
Si vous ne répondez pas à ces pré-requis vous ne pouvez pas démarrer le
processus d’installation.
Dans le cas où vous auriez PHP 3.0.x ou PHP 4.0.x ou PHP 6.0.0-dev installé
vous ne pourrez pas utilisez PhpMyFAQ
PhpMyFAQ utilise un éditeur WISIWIG en ligne. Il utilise un dispositif non
standard basé sur le javascript mis en application dans Mozilla Firefox 0.7+
(toutes plateformes), Mozilla 1.3+ (toutes plateformes) et Internet Explorer
5.5+ pour Windows, donc cet éditeur fonctionnera seulement avec ces navigateurs.
Vous devez activer le Javascript. Opera, Safari et Konqueror ne sont pas
supportés pour l’instant mais les versions futures devraient fonctionner.
2.b. Préparations
Merci de dézipper l’archive téléchargée sur votre disque dur.
Vous pouvez modifier l’apparence de PhpMyFAQ en utilisant les patrons
(gabarits). Une description de la façon est fait pout être trouvé ci-dessous.
Copiez tous les fichiers dézippés dans un répertoire de votre serveur web en
utilisant FTP. Un bon choix pourrait être le répertoire faq/.
Important:
Les permissions en écriture dans ce répertoire sont nécessaire au script pour
lui permettre de configurer les fichiers data.php et config.php pendant
l’installation. C’est le cas si vous utilisez PHP comme CGI ou comme mod_php
avec le safe_mode désactivé. Le script d’installation s’arrêtera si votre
serveur web n’est pas configuré comme demandé.
Il pourrait aider a paramétrer le chmod a 777 sur l’ensemble du répertoire de
PhpMyFAQ pour éviter des problèmes pendant l’installation. Si vous exécutez une
installation très restrictive de mod_php vous devriez garder le chmod 777 pour
les dossiers et les annuaires suivants même après l'installation réussie :
Tous les autres répertoires ne devraient pas être autorisés en écriture pour
votre propre sécurité.
2.c. Script d’installation
Ouvrez votre navigateur et entre une adresse de ce type :
http://www.example.com/faq/install/installer.php
Remplacez
www.example.com
avec votre nom de domaine actuel. Quand le site est chargé entrez l’adresse de
votre serveur de base de données (par exemple db.provider.com), votre nom
d’utilisateur de la base de données ainsi que votre mot de passe. La base de
données doit être disponible avant de lancer le script d’installation. Vous
pouvez laisser le champ prefix vide.
Si vous projetez d’utiliser plusieurs FAQ sur une seule base de données vous
devrez utilisez un préfix par base (par exemple sport pour une FAQ de sport ou
météo pour une FAQ de météo, etc). Merci de notre que seul les lettres et un
underscore peuvent être utilisés comme préfix.
Si votre PHP a été compilé avec l’extension LDAP vous pouvez aussi ajouter
vos informations LDAP.
Quand vous utilisez plusieurs FAQs vous devez les installer dans différents
répertoires indépendants (pax exemple : faq1/, faq2/, faq3/ etc…). In addition.
De plus vous pouvez entrer votre langue, par défaut en Anglais. En outre vous
devriez enregistrer votre nom, votre adresse e-mail et – très important – votre
mot de passe. Vous devez entrer votre mot de passe deux fois et il doit faire au
moins 6 caractères. Puis cliquez sur le bouton « install » pour initialiser les
tables dans votre base de données.
2.d. premières étapes
Vous pouvez accéder à l’espace public de votre FAQ en entrant
http://www.example.com/faq/index.php
dans la barre d’adresse de votre navigateur.
Votre FAQ sera vide et sera présentée sous la disposition standard.
Pour configurer PhpMyFAQ aller a l’adresse
http://www.example.com/faq/admin/index.php
Utilisez l’utilisateur admin et le mot de passe que vous avez choisi pour
votre première connexion a la section admin.
Quelques variables ne peuvent pas y être changées, mais peuvent être
modifiées par l’édition du fichier inc/constants.php. Vous pouvez changer :
Le fuseau horaire de votre serveur (par défaut 00:00 heures)
Le délai de déconnexion de la section admin (par défaut 30 minutes)
La valeur de début de l'identificateur de solution (par défaut 1000)
La valeur d’incrémentation de l'identificateur de solution (par défaut 1)
Le nombre d’enregistrement dans le Top10 (par défaut 10)
Le nombre d’anciens enregistrements (par défaut 5)
2.e. Notes concernant la fonction recherche
Les recherches booléennes de texte intégrales fonctionneront seulement avec
MySQL et s’il y a des entrées dans la base (5 ou plus). Le terme que vous
cherchez ne devra pas être dans plus de 50% des entrées, ou il sera
automatiquement exclu des recherches. Ce n’est pas un bug, mais plutôt une
fonction de MySQL. Merci de vous souvenir que vous avez besoin de MySQL 4.1 pour
utiliser la recherche booléenne de texte intégrale pour les langues Arabes,
Chinoises, Hébreux, Coréennes ou Japonaises.
2.f. Négociation automatique du contenu
Pour paramétrer la langue par défaut de votre navigateur vous devez modifier
une valeur qui sera envoyé à votre serveur web. Celle-ci dépend du navigateur
que vous utilisez.
Outils -> Options -> Avancées
-> Choix des langues
Edition -> Préférences ->
Navigator -> Languages
Safari utilise les
préférences systèmes de MacOS X pour déterminer votre langue préférée.
Préférences Système ->
International -> Language
La plupart des versions:
Fichiers -> Préférences ->
Langues
Linux/*BSD versions 5.x and
6.x:
Fichiers -> Préférences ->
Document -> Langues
Windows:
Outils -> Options ->
(General) Langues
MacOS:
Edition -> Préférences -> Web
Browser -> Language/Fontsback to top
2.g. Réglages PHP
Si vous pouvez éditer le fichier php.ini merci de vérifier que la variable
file_upload=On et paramétrée; Autrement les téléchargements de fichiers ne
fonctionneront pas pour les pièces jointes.
2.h. Activation du support mod_rewrite
Serveur Web Apache
Si vous voulez activer l’optimisation du moteur de recherche vous devez
renommer le fichier _.htaccess en .htaccess dans le répertoire de base où votre
faq est située. Puis vous devez activer le support du mod_rewrite dans la page
de configuration de la partie admin.
Serveur Web IIS
Si vous voulez activer l’optimisation du moteur de recherche vous devez
renommer le fichier _httpd.ini en httpd.ini dans le répertoire de base où votre
faq est située. Puis vous devez activer le support du mod_rewrite dans la page
de configuration de la partie admin.
Serveur Web lighttpd
Si vous voulez activer l’optimisation du moteur de recherche vous devez
copier les rôles contenus dans le fichier _lighttpd.conf dans votre
lighttpd.conf. Puis vous devez activer le support du mod_rewrite dans la page de
configuration de la partie admin.
2.i. Enabling LDAP support
Si vous avez entré les bonnes informations LDAP pendant l’installation vous
devez activer le support LDAP dans la page de configuration de la partie admin.
Après cette action PhpMyFAQ lira le nom d’utilisateur complet ainsi que
l’adresse e-mail depuis LDAP et remplira automatiquement ces informations dans
champs d’entrées de la page d’accueil.
2.j. Export en PDF
Tous les tags (X)HTML ne sont pas supportés par l’export en PDF. Nous
supportons actuellement les tags suivant dans les PDFs :
Support pour les textes en gras, italique et soulignés
Support pour les images
Support de base pour les tableaux
Support pour les listes <li>
<pre> sera affiché en utilisant la police Courrier
Support pour <br>, <br /> and <p>
Support pour <hr> and <hr />
Support pour <sup> and <sub>
2.k. Plugins de recherche pour Firefox et IE7
PhpMyFAQ 1.6.x fournit des plugins de recherche pour Mozilla Firefox et
Microsoft Internet Explorer 7. Ces plugins peuvent être créés dans la section
d'admin et chaque utilisateur du site peut les installer. Avec un plugin de
recherche installé vous pouvez effectuer des recherches sur une installation
PhpMyFAQ grâce à la boite de dialogue dans le coin supérieur de Mozilla Firefox
ou de Microsoft Internet Explorer 7. Nous vous recommandons d’utiliser Mozilla
Firefox. Pour d'autres informations sur Mozilla Firefox, merci de visiter la
page d'accueil de la fondation Mozilla.
2.l. ID Statique de solution
Introduite avec la version 1.6.0, PhpMyFAQ met en application un ID de
solution statique qui ne change jamais. Cet ID apparaît a coté de la question
sur la page d’un enregistrement de la FAQ. Vous vous demandez pourquoi vous
auriez besoin d’un tel ID ? Si vous avez un enregistrement avec l’ID 1042, Il
est maintenant possible d’entrer uniquement l’ID 1042 dans la boite de dialogue
de recherche et vous serez automatiquement rediriger vers l’enregistrement 1042
de la FAQ. Par défaut le numéro de l’ID démarre a 1000 mais vous pouvez le
changer dans le fichier inc/constants.php. Vous pouvez aussi changer la valeur
d’incrément de l’ID statique.
2.m. protection contre le Spam
PhpMyFAQ 1.6.0 and supérieur exécute 3 vérifications sur les formulaires
publics.
Vérification des adresses IP/de réseaux
Vérification des mots interdits
Vérification du code captcha (graphique)
Les adresses IP/Réseaux peuvent être ajoutées ou retirées dans le panneau de
configuration de la partie administrative du site. Si vous voulez ajouter des
mots interdits dans PhpMyFAQ, vous devez éditer le fichier inc/blockedwords.txt.
Merci d’ajouter un seul mot par ligne.
3. Mises à jour
La mise à jour de PhpMyFAQ 1.6.x est possible a partir des versions
suivantes :
phpMyFAQ 1.3.x
phpMyFAQ 1.4.x
phpMyFAQ 1.5.x
Si vous faites fonctionner une version plus ancienne de PhpMyFAQ nous vous
recommandons une nouvelle installation vierge.
3.a. Mise à jour depuis phpMyFAQ 1.3.x
La mise à jour depuis la version 1.3.x vers 1.6.x est réellement une mise à
jour importante. Merci de faire une sauvegarde complète avant d’exécuter la mise
à jour. Néanmoins la mise à jour depuis phpMyFAQ 1.3.x vers la version actuelle
est assez simple. Premièrement vous devez supprimer tous les fichiers et
répertoires a l’exception de :
Les fichiers data.php et config.php dans le répertoire inc/
Le répertoire attachments/
Le répertoire data/
Le répertoire images/
Le répertoire pdf/
Le répertoire xml/
Copiez les nouveaux fichiers sur votre site web et ouvrez l’URL suivante avec
votre navigateur :
http://www.example.com/faq/install/update.php
Choisissez la version actuellement installée de PhpMyFAQ et cliquez sur le
bouton du script de mise à jour, votre version sera automatiquement mise à jour.
Il est possible que les images ou documents attachés ne le soient plus. Vous
devez les rattacher avec le nouveau gestionnaire d’image. De plus vous devez
recréer vos catégories.
Ensuite vous devez convertir le BBCode depuis phpMyFAQ 1.3.x vers le code
XHTML parce que phpMyFAQ 1.6.0 ne supporte plus BBCode. Ceci sera fait par un
script de conversion.
Ouvrez l’URL suivante avec votre navigateur :
http://www.example.com/faq/install/bbcode2xhtml.php
Il est possible que cette mise à jour dure quelques secondes étant donné que
toutes les entrées BBCode doivent être converties en XHTML.
Note : Vous ne pouvez pas faire de mise à jour de MySQL vers une autre base
de données.
3.b. Mise à jour depuis PhpMyFAQ 1.4.x
La mise à jour depuis PhpMyFAQ 1.4.x est assez simple. Copiez via FTP tous
les nouveaux fichiers du package phpMyFAQ a l’exception de :
Les fichiers data.php et config.php dans le répertoire inc/
Tous les fichiers du répertoire template/ directory a l’exception du fichier
artikel.tpl.
Ouvrez l’URL suivante avec votre navigateur :
http://www.example.com/faq/install/update.php
Choisissez la version actuellement installée de PhpMyFAQ et cliquez sur le
bouton du script de mise à jour, votre version sera automatiquement mise à jour.
Note : Vous ne pouvez pas faire de mise à jour de MySQL vers une autre base
de données. Vous devez ajouter les liens RSS dans les entêtes XHTML depuis vos
gabarits basés sur la 1.4.x. Vous devez aussi ajouter de nouvelles choses dans
les gabarits, merci de lire les nouveaux gabarits pour l’ensemble des
changements.
3.c. Mise à jour depuis
PhpMyFAQ 1.5.x
La mise à jour depuis PhpMyFAQ 1.5.x est assez simple. Copiez via FTP tous
les nouveaux fichiers du package phpMyFAQ a l’exception de :
Les fichiers data.php et config.php dans le répertoire inc/
Tous les fichiers du répertoire template/ directory a l’exception du fichier
artikel.tpl.
Ouvrez l’URL suivante avec votre navigateur :
http://www.example.com/faq/install/update.php
Choisissez la version actuellement installée de PhpMyFAQ et cliquez sur le
bouton du script de mise à jour, votre version sera automatiquement mise à jour.
Si vous effectuez une mise à jour d’une version antérieure a PhpMyFAQ 1.5.4
vous devez ajouter les lignes suivantes dans le fichier template/search.tpl:
{msgFirefoxPluginTitle}
{msgMSIEPluginTitle}
Si le plugin de recherche Firefox ou IE7 est créé, le
If the Firefox or IE7 search plugin is created, le lien d’installation du
plugin apparaitra automatiquement su la page de recherche.
Vous devez aussi modifier dans le fichier index.tpl le code suivant :
<form action="{writeSendAdress}" method="post">
<label for="suchbegriff">{searchBox}</label>
<input alt="search..." class="inputfield" type="text" name="suchbegriff"
id="suchbegriff" size="18" /><br />
<input type="submit" name="submit" value="Go" class="submit" />
</form>
En :
<form action="{writeSendAdress}" method="get">
<label for="suchbegriff">{searchBox}</label>
<input alt="search..." class="inputfield" type="text" name="search"
id="suchbegriff" size="18" /><br />
<input type="submit" name="submit" value="Go" class="submit" />
<input type="hidden" name="action" value="search" />
</form>
Vous trouverez les changements avec la version 1.6.x dans le fichier
docs/CHANGEDFILES.txt.
3.d. Mise à jour depuis PhpMyFAQ 1.6.x
La mise à jour depuis PhpMyFAQ 1.6.x est assez simple. Copiez via FTP tous
les nouveaux fichiers du package phpMyFAQ a l’exception de :
Les fichiers data.php et config.php dans le répertoire inc/
Tous les fichiers du répertoire template/ directory a l’exception du fichier
artikel.tpl.
Ouvrez l’URL suivante avec votre navigateur :
http://www.example.com/faq/install/update.php
Choisissez la version actuellement installée de PhpMyFAQ et cliquez sur le
bouton du script de mise à jour, votre version sera automatiquement mise à jour.
Si vous effectuez une mise à jour d’une version antérieure a PhpMyFAQ 1.6.1
vous devez ajouter les lignes suivantes dans le fichier template/search.tpl:
{msgMSIEPluginTitle}
Vous devez aussi modifier dans le fichier index.tpl le code suivant :
<form action="{writeSendAdress}" method="post">
<label for="suchbegriff">{searchBox}</label>
<input alt="search..." class="inputfield" type="text" name="suchbegriff"
id="suchbegriff" size="18" /><br />
<input type="submit" name="submit" value="Go" class="submit" />
</form>
En :
<form action="{writeSendAdress}" method="get">
<label for="suchbegriff">{searchBox}</label>
<input alt="search..." class="inputfield" type="text" name="search"
id="suchbegriff" size="18" /><br />
<input type="submit" name="submit" value="Go" class="submit" />
<input type="hidden" name="action" value="search" />
</form>
Vous trouverez les changements avec la version 1.6.x dans le fichier
docs/CHANGEDFILES.txt.
3.e. Modification des gabarits pour PhpMyFAQ 1.6.x
Les gabarits 1.3.x ne sont pas compatibles avec PhpMyFAQ 1.6.x, donc merci de
prendre les gabarits par défaut en XHTML depuis le package. Si vous avez besoin
d’aide pour intégrer PhpMyFAQ dans votre site web libre à vous de nous
contacter.
3.f. Migration
Pré-requis:
Une application capable d’exporter les données en CSV
Une configuration prête de
PhpMyAdmin
pour importer les données en CSV.
Une sauvegarde récente de votre base de données.
Si vous souhaitez migrer vos données existantes dans votre base de données
PhpMyFAQ nous vous recommandons les étapes suivantes :
Notez vos catégories afin de les conserver pour plus tard (ou
imprimez lez avec PhpMyAdmin); Vous trouverez les données dans la table
xx_faqcategories. Si vous n’avez encore aucune catégories c’est le bon
moment pour les créées, cela ne vous demandera que quelques minutes…
Ouvrez votre tableur habituel (par exemple OpenOffice, Excel, etc.)
Créez une nouvelle feuille contenant les données suivantes :
id lang active keywords thema content author email comment datum
Dans le cas où vous n’auriez aucune donnée dans votre base de données
PhpMyFAQ le compteur de votre champ ID commence à 1 autrement regardez dans
votre xx_faqdata actuel pour trouver votre plus grand nombre « id » pour
démarrer à compter.
Le champ « lang » contient votre langue préférée. Dans mon cas vous trouverez
« de » parce que ma langue préférée est l’allemand. Paramétrez « active » à
« yes » (sans les doubles cotes naturellement) autrement les données
n’apparaitrons pas ensuite. Vous pouvez ne pas remplir les « keywords » (mots
clés) pour l’instant mais n’oubliez pas de les remplir car vous en aurez besoin
pour faire des recherches par mots-clés dans votre FAQ. « thema » décrit le
sujet de la FAQ ou en d’autre mots, l’objet. « content » contient la réponse de
la FAQ. « autho » et « email » sont assez explicites. « comment » est juste une
valeur qui peut être « y » ou « n ».
Je préfère « n » pour désactivez les commentaires utilisateurs mais ceci est
a votre convenance. Vous devriez faire attention avec « datum » car cette valeur
dépend fortement de son format. Un exemple ressemblerait a ceci : 20050401090000
qui peut traduit par : 4 chiffres pour l’année (2005), 2 chiffres pour le mois
(04), 2 chiffres pour le jour (01), 2 chiffres pour l’heure ’09), 2 chiffres
pour les minutes (00) et 2 chiffres pour les secondes (00).
Votre table devrait ressembler à ceci :
id lang active keywords thema
content author email comment datum 1 de yes FAQ Is there any better solution
than phpMyFAQ? No! John Doe john@doe.com n 20050401090101
Faire attention que les champs contenant des nombres doivent avoir le format
« number » avec 0 décimale. Autrement PhpMyAdmin pourrait se tromper.
Maintenant vous êtes prêt a exporter en cvs. Faites vous un faveur et évitez
les espaces dans le nom du fichier, UNIXes pourrait avoir du mal a lire le nom
du fichier dans ce cas.
Ouvrir votre URL PhpMyAdmin et ouvrez votre base de données PhpMyFAQ
(même si elle est encore vide). Faites défiler la page vers le bas et
cliquez sur le lien "import text file", choisissez votre fichier et cliquez
sur le bouton "submit".
C’est fait. Si vous avez des soucis c’est le bon moment pour restaurer vos
données depuis la sauvegarde que vous avez fait plus tôt. Puis de l’éditer les
enregistrements importés et ré assigner les enregistrements aux catégories.
4. Administration
L’administration de PhpMyFAQ est complètement basée sur le navigateur. La
partie admin peut être accédée par l’URL :
http://www.example.com/faq/admin/index.php
Si vous avez perdu votre mot de passe, vous pourrez le réinitialiser. Un
nouveau mot de passe aléatoire sera généré et vous sera envoyer par mail. Merci
de le changer après vous être connecté avec le mot de passe généré.
Après avoir entré votre nom d’utilisateur et votre mot de passe vous pouvez
vous connecter au système. Sur la page de démarrage vous pouvez vois le menu
admin sur la gauche, quelques statistique sur les visites, entrées et
commentaires sur la droite. En bas de la page principale de la zone admin vous
verrez un bouton « version information ». Si vous cliquez sur le bouton votre
version de phpMyFAQ vérifiera la dernière version sur notre site
www.phpmyfaq.de. Nous ne notons rien dans ce processus !
Le menu contient les sections suivantes :
Page de démarrage
Administration des utilisateurs
Administration des catégories
Créer l’article
Approuver un article
Editer un article
Editer une nouveauté
Editer les questions ouvertes
Statistiques
Cookies
Voir les sessions
Voir l’Adminlog
Modifier mon mot de passe
Editer configuration
Sauvegarde
Exporter votre FAQ
Firefox search plugin
Déconnexion
4.a. Administration des utilisateurs
PhpMyFAQ Permet une gestion souple des privilèges (ou droits) pour les
différents utilisateurs de la partie admin. Il est possible d’assigner différent
privilèges a des personnes réelles (représentées par le terme utilisateur). Ces
privilèges sont très détaillés et vous permettrais de donner a un utilisateur en
particulier le droit de modifier une entrée mais pas de la supprimer. Il est
très important d’examiner de quel privilège chaque utilisateur aurait réellement
besoin. Vous pouvez supprimer complètement une entrée en éditant tout son
contenu, ce qui équivaut a supprimer cette entrée. Le nombre d’utilisateur n’est
pas limité dans PhpMyFAQ.
Sur l’écran principal de l’administration des utilisateurs vous pourrez voir
un aperçu de tous les profils utilisateurs actifs, pour lesquels une combinaison
de « 1 » et de « 0 » représente les privilèges d’un utilisateur. Un « 1 »
signifie que l’utilisateur a ce privilège, un « 0 » indique qu’un utilisateur ne
peut pas effectuer une certaine action. L’ordre est essentiellement le même que
le listing des « droits » quand vous créer ou éditer un utilisateur.
Sachez que les nouveaux comptes utilisateurs n’ont aucun privilège, vous
devrez les assigner en éditant le profil de l’utilisateur. L’utilisateur Admin
ne peut pas être supprimé, son nom ne peut pas être modifié.
4.b. Administration des catégories
PhpMyFAQ vous permet de créer les différentes catégories et sous catégories
emboitées de votre FAQ. Vous pouvez aussi réorganiser vos catégories dans un
ordre différent. Il est aussi possible d’utiliser des langues différentes par
catégories. Pour des raisons d’accessibilité vous devriez ajouter une courte
description pour chacune des catégories.
4.c. Administration des enregistrements
Vous pouvez créer des entrées directement depuis la partie admin. Les entrées
créées ne sont pas publiées par défaut.
La signification des champs est la suivante :
L’emplacement où cette entrée sera créée dans la hiérarchie de la FAQ dépend
de ces paramètres. Vous pouvez choisir une ou plusieurs catégories où stocker
l’entrée. Si vous voulez ajouter un enregistrement dans la FAQ dans plus qu’une
catégorie vous devez sélectionner avec votre souris et appuyer sur la touche
CTRL.
C’est la question ou l’entête de votre entrée.
Le contenu est la réponse à la question pour un problème. La réponse peut
être éditée avec l’éditeur WISIWIG (What You See Is
What You
Get) inclus lorsque Javascript est activé. Vous pouvez ajouter des images
où vous voulez avec l’éditeur d’image intégré. L’éditeur permet les combinaisons
de touches suivantes :
CTRL-A – sélectionner tout
CTRL-B - Gras
CTRL-I - Italique
CTRL-U - Souligné
CTRL-S - barré
CTRL-L – aligné à gauche
CTRL-E - centré
CTRL-R - aligné à droite
CTRL-J - justifié
CTRL-1 .. CTRL-6 - titres (<h1> .. <h6>)
CTRL-0 (zero) – nettoyer les contenus copier depuis Word
Les mots clé sont utilises pour faire des recherches dans la base de données.
Dans le cas où n’auriez pas inclus un mot spécifique dans l’entrée elle-même,
mais il est étroitement lié au contenu pour lequel vous souhaitez l’inclure,
ainsi les résultats de recherche de l’entrée seront améliorés. Il est également
possible d'employer des mots-clés non connexes de sorte qu'une recherche
incorrectement écrite mène également aux bons résultats.
Il est possible de spécifier un auteur pour vos entrées.
Vous pouvez sélectionner la langue de votre entrée. Par défaut la langue
sélectionnée et sauvegardée dans la configuration sera choisie. Vous pouvez
créer des entrées dans différentes langue comme ceci : Ecrire un article en
Français (ou dans une autre langue) et sauvegardez le. Maintenant choisissez
Editer un article et éditez votre entrée Française. Changez le sujet, le
contenu, les mots clé et modifiez la langue aussi, par exemple en Portugais.
Sauvegardez l’entrée. Maintenant vous pouvez voir deux entrées dans votre liste
quand vous éditez les enregistrements, ayant le même ID, pourtant avec des
langues différentes.
Chaque entrée génère automatiquement un ID de solution. Tous les
enregistrements peuvent être accédés en entrant cet ID dans la boite de
recherche.
Si une entrée est « active » est elle visible dans la partie publique et sera
incluse dans les recherches. Si elle n’est pas « active » elle sera invisible.
Les entrées proposées sont désactivées par défaut afin d’éviter les abus.
Si vous ne voulez pas autoriser les commentaires publics pour cette entrée
vous devez désactiver cette fonction.
Tel un wiki, phpMyFAQ 1.6.x soutient des révisions de chaque entrée. De
nouvelles révisions ne seront pas créées automatiquement mais vous pouvez en
créer une en cliquant sur « oui ».
L’ancienne révision sera stockée dans la base de données et la nouvelle
révision sera affichée dans la partie publique. Vous pouvez aussi revenir à
d’anciennes révisions si vous en sélectionnez une et la sauvegarder comme une
nouvelle.
Date de la dernière modification.
Ce champ est réservé aux commentaires qui peuvent refléter quels changements
ont été apportés à une certaine entrée. Cela aide les différents administrateurs
à garder une trace de ce qui s’est passé sur une entrée au fil du temps. Toute
information entrée ici restera invisible dans la partie publique.
Le log des changements liste tous les précédents changements, y compris
l’auteur et la date du changement.
Toutes les entrées de la base de données qui ne sont pas actives (et donc
invisibles au public) sont listées ici. Les contenus suggérés par les visiteurs
seront aussi placés à cet endroit. Pour approuver ces entrées, cliquer sur
l’entrée pour l’éditer. Modifier la en « actif » pour qu’elle devienne visible.
Vous pouvez aussi supprimer les entrées (cela inclut une demande de confirmation
pour valider votre choix).
Toutes les entrées disponibles sont listées ici. En cliquant dessus, la même
interface qui vous permet de créer des enregistrements va s’ouvrir, cette fois
avec toutes les données appropriées à l’entrée sélectionnée. Vous pouvez éditer
et supprimer tous les enregistrements. Veuillez noter que les anciennes
révisions ne seront pas supprimées.
4.d. Administration des news
phpMyFAQ offre la possibilité de poster des news sur la page de démarrage de
votre FAQ. Dans la zone d’administration, vous pouvez créer de nouveaux items,
éditer les existants ou les supprimer.
4.e. Editer des questions ouvertes
PhpMyFAQ permet aux visiteurs de contribuer à la FAQ en posant des questions.
Chaque visiteur peut voir ces questions ouvertes dans la zone publique, et peut
y donner réponse. Si vous souhaitez vous débarrasser de questions, vous pouvez
aussi utiliser cette section. Vous pouvez aussi reprendre une question, y
répondre vous-même et l’ajouter à la FAQ.
4.f. Statistiques d’évaluation
Sous chaque entrée, les visiteurs ont la possibilité d’évaluer la qualité
d’un article en donnant une note de 1 à 5 (où 1 est le pire, 5 le meilleur).
Dans les statistiques, la moyenne des notes et le nombre de votes deviennent
visibles pour chaque entrée notée. Pour donner une rapide vue d’ensemble, les
entrées avec une moyenne de 2 ou moins sont affichées en rouge, et celles avec
une moyenne de 4 ou plus en vert.
4.g. Cookies
phpMyFAQ peut enregistrer les informations de connexion dans la zone
administrateur du PC en tant que cookie. Même si cette option peut être très
confortable, c’est un trou de sécurité potentiel. N’utiliser ces cookies que si
vous êtes la seule personne à utiliser cet ordinateur.
4.h. Voir les sessions
Ces fonctions vous permettent de garder une trace de vos visiteurs. Un ID est
assigné à chaque visiteur dès qu’il arrive sur la page d’accueil, qui
l’identifie durant toute sa visite. En utilisant ces informations, vous pouvez
reconstituer la manière dont les visiteurs utilisent la FAQ , et ainsi faire les
ajustements nécessaires de vos catégories, contenus et mots-clés. Il existe
aussi une fonction de recherche avec laquelle vous pouvez rechercher une
certaine IP, un nombre minimal d’actions ( ? the number of minimum actions ????)
ou la date d’une visite.
4.i. Voir le Log Administrateur
Le Log Administrateur vous permet de tracer toutes les actions des
utilisateurs dans la zone administrateur de phpMyFAQ. Si vous pensez que vous
avez un intrus dans le système, vous pouvez le trouver avec certitude en
consultant le Log Administrateur.
4.j. Changer les mots de passe
Cette section vous permet de changer votre mot de passe. Il est possible de
désactiver cette fonction pour un utilisateur, ce qui est pratique pour les
comptes de groupes. Pour pouvoir changer un mot de passe, l’option « changer mot
de passe » doit être activée pour l’utilisateur.
4.k. Editer la configuration
Ici, vous pouvez éditer les options générales de phpMyFAQ. Si vous voulez
entrer plusieurs adresses mail dans la configuration, les séparer par une
virgule.
4.l. Sauvegarde
Il est possible d’utiliser la fonction de sauvegarde pour créer une copie de
la base de données dans un simple fichier. Cela rend possible la restauration de
la FAQ en cas de « crash » ou la migration d’un serveur vers un autre. Il est
recommandé de faire régulièrement des sauvegardes de votre FAQ.
Données de sauvegarde
Une sauvegarde de toutes les données inclue toutes les entrées, utilisateurs,
commentaires, etc..
Log de Sauvegarde
Les sessions de visites et le Log Administrateur seront sauvés. Ces
informations ne sont pas nécessaires pour faire fonctionner phpMyFAQ, elles ne
servent que pour établir des statistiques.
4.m. Exporter votre FAQ
Vous pouvez exporter le contenu de votre FAQ dans 4 formats :
Un fichier XML
Un fichier plat XHTML
Un fichier PDF avec une table des matières
Un fichier XML DocBook
4.n. Plugin de recherche Firefox
Vous pouvez entrer le titre et une déscription unique pour votre plugin de
recherche Firefox pour votre version de PhpMyFAQ. Si vous voulez changer le
titre ou la description vous devez juste recréer le plugin.
Si vous voulez votre propre favicon pour la boite de dialogue Firefox vous
devez remplacer le fichier image nommé pmfsearch.png du répertoire image/. Si
vous ne le changez pas c’est le logo de PhpMyFAQ qui sera utilisé.
4.o. Déconnexion
Cliquez sur Déconnexion à la fin de votre session. Il est recommandé de vous
déconnecter avant de fermer votre navigateur pour éviter tout piratage.
5. Personnaliser phpMyFAQ 1.6.x
Dans PhpMyFAQ 1.6.0 le code et la disposition sont presque complètement
séparés. L’apparence est basée sur plusieurs gabarits, que vous pouvez modifier
en fonction de vos besoins. Les fichiers les plus importants de l’apparence de
PhpMyFAQ peuvent être trouvés dans le répertoire template/. Tous les gabarits
originaux sont des XHTML 1.0 transitionnels valident et nous n’utilisons pas les
tableaux pour des raisons de mise en page.
Note : Vous pouvez changer l’apparence de la partie admin en utilisant le
fichier CSS admin.ccs
5.a. Le fichier template/index.tpl
L’apparence par défaut de PhpMyFAQ est sauvegardée dans le fichier index.tpl.
C’est un fichier HTML normal, comprenant quelques variables dans des
parenthèses, servant de réceptacle pour le contenu.
Exemple :
<span class="useronline">{userOnline}</span>
Le parseur de gabarit de la FAQ converti le container {userOnline} par le
nombre actuel de visiteurs en ligne.
Vous pouvez changer le gabarit a votre volonté, mais vous devriez conserver
le gabarit original au cas où quelque chose tournerait mal. Théoriquement vous
pouvez utiliser n’importe quel éditeur pour modifier les gabarits, nous avons
testé avec succès en utilisant Dreamweaver. La modification des fichiers avec
Microsoft Frontpage, Adobe GoLive ou NetObjects Fusion peut endommager le
fichier, puisqu’ils modifient le code source.
5.b. Le fichier template/style.css
Toutes les mise en forme telles que les polices et analogues peuvent être
modifiées dans le fichier CCS style.ccs. Les couleurs sont définies dans le
fichier colors.ccs. Vous trouverez plus d’info sur le site officiel du W3C
5.c. Gabarits supplémentaires
Vous avez besoin d’un autre gabarit ou plus de fonctions XHTML/CCS ?
Alors écrivez nous et nous pourrons en parler.
6. Un dernier point
Merci d’utiliser phpMyFAQ! :-)
Auteur: Thorsten Rinne
Co-auteurs: Stephan Hochhaus, Markus Gläser
Dernière modification : 2006-07-16
© 2001-2006 l’équipe phpMyFAQ
Cette documentation est sous licence Creative Commons License.
|