Software: Apache. PHP/5.5.15 uname -a: Windows NT SVR-DMZ 6.1 build 7600 (Windows Server 2008 R2 Enterprise Edition) i586 SYSTEM Safe-mode: OFF (not secure) C:\AmbienteBogota\aulavirtual\docs\ drwxrwxrwx | |
| Viewing file: Select action/file-type: [ phpMyFAQ 1.6.x Documentation ]2.a. pré requis pour phpMyFAQ 5 2.e. Notes concernant la fonction recherche 7 2.f. Négociation automatique du contenu 7 2.h. Activation du support mod_rewrite 8 2.k. Plugins de recherche pour Firefox et IE7 9 2.l. ID Statique de solution 9 2.m. protection contre le Spam 9 3.a. Mise à jour depuis phpMyFAQ 1.3.x 10 3.b. Mise à jour depuis PhpMyFAQ 1.4.x 10 3.c. Mise à jour depuis PhpMyFAQ 1.5.x 11 3.d. Mise à jour depuis PhpMyFAQ 1.6.x 12 3.e. Modification des gabarits pour PhpMyFAQ 1.6.x 12 4.a. Administration des utilisateurs 14 4.b. Administration des catégories 15 4.c. Administration des enregistrements 15 4.d. Administration des news 17 4.e. Editer des questions ouvertes 17 4.f. Statistiques d’évaluation 17 4.i. Voir le Log Administrateur 18 4.j. Changer les mots de passe 18 4.k. Editer la configuration 18 4.n. Plugin de recherche Firefox 18 5. Personnaliser phpMyFAQ 1.6.x 20 5.a. Le fichier template/index.tpl 20 5.b. Le fichier template/style.css 20 1. IntroductionPHPMyFAQ 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. LicencePhpMyFAQ 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. SupportSi 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. DonationsSi 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. Installation2.a. pré requis pour phpMyFAQPhpMyFAQ 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
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éparationsMerci 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’installationOuvrez 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 étapesVous 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 rechercheLes 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 contenuPour 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 PHPSi 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_rewriteServeur 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 supportSi 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 PDFTous 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 IE7PhpMyFAQ 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 solutionIntroduite 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 SpamPhpMyFAQ 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 à jourLa 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.xLa 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.xLa 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.xLa 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.xLa 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.xLes 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. MigrationPré-requis:
Si vous souhaitez migrer vos données existantes dans votre base de données PhpMyFAQ nous vous recommandons les étapes 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.
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. AdministrationL’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 utilisateursPhpMyFAQ 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égoriesPhpMyFAQ 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 enregistrementsVous 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 newsphpMyFAQ 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 ouvertesPhpMyFAQ 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’évaluationSous 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. CookiesphpMyFAQ 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 sessionsCes 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 AdministrateurLe 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 passeCette 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 configurationIci, 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. SauvegardeIl 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 FAQVous 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 FirefoxVous 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éconnexionCliquez 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.xDans 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.tplL’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.cssToutes 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émentairesVous avez besoin d’un autre gabarit ou plus de fonctions XHTML/CCS ? Alors écrivez nous et nous pourrons en parler. 6. Un dernier pointMerci 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. |
:: Command execute :: | |
--[ c99shell v. 1.0 pre-release build #13 powered by Captain Crunch Security Team | http://ccteam.ru | Generation time: 0.0312 ]-- |