// -------------------------------------------------------------------- //
// 2. INSTALLATION       //
// -------------------------------------------------------------------- //
 Dézippez l'archive ZIP en gardant son arborescence dans un répertoire de votre choix sur votre disque dur.
Voici l'arborescence que vous devriez ainsi avoir :
 
 ----------------------------------------------------------------
 - DISQUE DUR
  - Répertoire de votre choix
   - phpmynews (vous pouvez renommer ce répertoire)
    - css
    - docs
    - images
    - include
    - tables-sql
    - install
 ----------------------------------------------------------------
 
Il faut désormais procéder à la configuration de l'application
 
// -------------------------------------------------------------------- //
// 3. CONFIGURATION       //
// -------------------------------------------------------------------- //
 
-> Ouvrez le fichier 'include/config.inc.php[3]' avec le kedit ou avec le bloc notes puis suivez les instructions ci-dessous pour renseigner chaque variable!
 
-> A noter pour les débutants que toute la partie de l'installation qui est relative à la Base de données peut être configurée automatiquement grâce à des scripts qui se trouvent dans le dossier 'phpmynews/install' qu'il vous faut donc au préalable passer sur le serveur de votre hébergeur. Là, vous remplirez quelques champs de formulaire et les tables seront créées à votre place, l'utilisateur principal (nommé 'root' sera initialisé et les variables concernant la base de données dans le fichier de config seront complétées toutes seules. Youpi!
 
-> Attention : les variables à compléter par les valeurs true ou false ne doivent pas prendre de guillemets, par exemple :
Valable : $variable = true OU $variable = false
Non valable : $variable = 'true' OU $variable = 'false'
 
-> Attention : certaines variables sont entre quotes ( ' ), d'autres entre guillemets ( " ). Ne modifiez pas cette notation, autrement dit, si ce sont des quotes ne les remplacez pas par des guillemets et réciproquement.
 
 
 // - Configuration des données concernant l'accès à la BDD
 
  .: $cfg_hote :.
  ---------------
  C'est l'adresse du serveur SQL de votre hébergeur. Cette adresse fait partie des renseignements que votre hébergeur vous donne lors de votre inscription.
Quelques exemples :
- Free : sql.free.fr
- Nexen : mysql.nexen.net
 
  .: $cfg_base :.
  ---------------
  C'est le nom de la Base de données qui vous est allouée par votre hébergeur. Le plus souvent cette base est unique (vous n'avez pas possibilité d'en créer une autre) et porte le nom de votre login sur ce même hébergeur.
 
  .: $cfg_user :.
  ---------------
  C'est tout simplement votre login (pseudo) sur votre hébergeur
 
  .: $cfg_password :.
  -------------------
  C'est le password (mot de passe) correspondant à votre login sur votre hébergeur
 
  .: $cfg_database :.
  -------------------
  Le type de Base de données (phpMyNews PEUT fonctionner sur plusieurs bases de données mais n'est livré que pour 'mysql' (la plus répandue).
 
 // - Configuration du nom des tables
  Quatre tables doivent exister pour que l'application fonctionne correctement. Vous devez ici donner le nom de ces quatre tables. Ce nom peut rester le nom par défaut mais vous pouvez les renommer. A noter que si vous les renommez, il faudra penser à changer leur nom aussi lors de leur création pour que le nom des tables corresponde toujours au nom que vous avez indiqué lors de la configuration.
 
  .: $cfg_news :.
  ---------------
  Le nom de la table pour enregistrer les news
  Par défaut : phpmn_news
 
  .: $cfg_admins :.
  -----------------
  Le nom de la table où seront enregistrés les différents administrateurs
  Par défaut : phpmn_admins
 
  .: $cfg_comm :.
  ---------------
  Le nom de la table où seront enregistrés les commentaires.
  Par défaut : phpmn_comm
 
  .: $cfg_liens :.
  ----------------
  Le nom de la table où seront enregistrés les liens et les images
  Par défaut : phpmn_liens
 
 // - Configuration de la langue
  phpMyNews peut fonctionner dans toutes les langues du monde pour peut qu'il existe un fichier correspondant à cette langue dans le répertoire 'include/langues/' de la forme langue.inc.php3. Par exemple pour le français : 'francais.inc.php3'
 
  .: $cfg_language :.
  -------------------
  Le nom de ce fichier sans le .inc.php3
  Par défaut : francais
 
 // - Données propres au site
 
  .: $cfg_url :.
  --------------
  L'URL du dossier racine de votre site, sans / à la fin, par exemple :
  Valable : http://www.tf1.fr
  Non valable : http://www.tf1.fr/
  Non valable : http://www.tf1.fr/fichier.html
 
  .: $cfg_nom :.
  --------------
  Le nom de votre site ou son titre, bref, ce que vous voulez
 
  .: $cfg_search_url :.
  ---------------------
  L'URL du fichier dans lequel vous voulez afficher les news, par exemple :
  Valable : http://champlain.nexen.net/index.php3
  Non valable : http://champlain.nexen.net/
  Non valable : http://champlain.nexen.net
 
  .: $cfg_images_url :.
  ---------------------
  Adresse du répertoire 'images/' de phpMyNews (avec le / final), par exemple :
  Valable : http://login.hebergeur.tld/php/app [...] ws/images/
  Non valable : http://login.hebergeur.tld/php/app [...] ews/images
 
  .: $cfg_inc_dir :.
  ------------------
  Adresse du répertoire 'include/' de phpMyNews (avec le / final), par exemple :
  Valable : http://moi.free.fr/phpmynews/include/
  Non valable : http://moi.free.fr/phpmynews/include
 
  .: $cfg_webmaster_email :.
  --------------------------
  Rien de plus simple : votre adresse email!
 
 // - Données techniques & Configuration des options
 
  .: $cfg_ext :.
  --------------
  Extension utilisée pour les fichiers PHP par votre hébergeur
  Possibilités : '.php3' OU '.php'
 
  .: $cfg_active_log :.
  ---------------------
  Si true : l'appli enregistrera tous les accès à la maintenance (partie administration) pour que vous puissiez les vérifier...
  Si false : rien ne sera enregistré
 
  .: $cfg_log_file :.
  -------------------
  Si vous avez mis true à la variable précédente, choisissez ici le nom du fichier dans lequel seront enregistrés les logs.
  Par défaut : phpmynews.log
 
  .: $cfg_cookie :.
  -----------------
  Durée de vie en secondes d'une connection à la partie d'administration. Voir 'securite.txt'.
  Par défaut : 3600 (=1 heure)
 
  .: $cfg_cookie_vis :.
  ---------------------
  Inscrivez un mot de votre choix sans ponctuation ni accent dans cette variable.
  Valable : 'prefixe'
  Non valable : 'préfixe' (accent !)
  Non valable : 'c cool' (espace !)
 
  Par défaut : phpmynews
 
  .: $cfg_php_self_corrector :.
  -----------------------------
  Si phpMyNews semble bugger lors de son utilisation en "doublant" l'URL de votre site lorsque vous voulez cliquer sur le lien pour poster un commentaire, il faut activer cette variable. Je précise dores et déjà aux utilisateurs de Free et Online qu'ils doivent mettre true  à cette variable, les autres mettent false et voient ensuite s'il faut changer la valeur ou pas, c'est très simple!
 
  Par défaut : false
 
 // - Données sur l'envoi des mails
  // Si une fonction permettant l'envoi de mails est active sur votre hébergeur
 
   .: $cfg_mail_function :.
   ------------------------
   C'est le nom de la fonction mail() que votre hébergeur propose. Le plus généralement cette fonction est mail() mais parfois email() ou autre. Mettez dans cette variable le nom de la fonction sans les ().
   Valable : 'mail'
   Non valable : 'mail()'
 
   .: $cfg_lib_mail :.
   -------------------
   Certains hébergeurs obligent les utilisateurs à inclure une librairie pour pouvoir utiliser la fonction de mail qu'ils proposent (c'est le cas de Nexen par exemple). Si c'est le cas de votre hébergeur, mettez le nom de cette librairie ici. SINON, videz cet espace.
   Valable : 'librairie.truc'
   Valable : '' (vide => pas de librairie)
 
  // Si aucune fonction d'envoi de mails est permise par votre hébergeur
 
   .: $cfg_mail_ip_server :.
   -------------------------
   Si vous souhaitez tenter le coup d'envoyer des mails sans avoir de fonction mail sur votre hébergement, mettez ici l'adresse IP d'un serveur SMTP...
   Valable : 123.456.789.000 (ce n'est pas une IP valide!)
 
   .: $cfg_name_server :.
   ----------------------
   ... et mettez ici son nom
   Valable : smtp.machinchose.tld
 
 // - Données concernant la mise sous cache
 -> A ne compléter que si votre hébergeur accepte la fonction ob_start() ce qui n'est pas le cas de Free ni d'Online. Si vous comptez désactiver le module de cache (cf plus loin dans le fichier) alors ne vous prenez pas la tête à configurer cette section!
 -> Qu'est-ce qu'un 'cache'? Lire 'cache.txt'
 
  .: $cfg_duree_cache :.
  ----------------------
  La durée en secondes de la mise sous cache du document principal.
 
  .: $cfg_cache_file :.
  ---------------------
  Le nom du fichier cache.
  Par défaut : phpmynews.php3
 
 // - Configuration du temps
 
  .: $cfg_format_date :.
  ----------------------
  C'est le format sous lequel doit apparaître la date. Quelques exemples sont ci-dessous. Renseignez vous sur les arguments de la fonction date() pour aller au delà de ces exemples.
 
  Table des correspondances :
  |   format | affichage |
  |-----------------------|-----------------------|
  | d.m.Y @ H:i |  jj.mm.yyyy @ hh:mm |
  |-----------------------|-----------------------|
  | d/m/y  | jj/mm/YY |
  ...
 
  Par défaut : d.m.y @ H:i
 
  .: $cfg_decalage :.
  -------------------
  Décalage horraire en secondes. Si votre serveur est à New York et que votre site, français, est visté en majeure partie par des français, rectifiez donc le décalage horraire du serveur. Par exemple, NYC = 6 heures de moins, or 6 heures = 6 * 3600 secondes
D'où $cfg_decalage = 6 * 3600;
 
  Valable : 46874
  Valable : 0
  Valable : 3 * 3600
  Non valable : "3 * 3600"
  Non valable : "0";
  Non valable : "46874"
 
 // - Configuration de l'affichage
  phpMyNews propose deux modes d'affichage des news : le mode standard et le mode thème. Le mode standard est plus simple à configurer : l'affichage est le même que sur le site de phpMyNews mais vous pouvez changer les polices, couleurs, styles, ou mettre des coins ronds à vos news en configurant le fichier 'graphiques/standard.inc.php3'. Le mode thème est quant à lui plus complexe mais il présente l'avantage de permettre un affichage 100% personnalisable puisque c'est vous qui créez les séquences HTML correspondant à l'affichage des news, des commentaires, des formulaires... lisez pour celà le fichier 'theme.txt'.
 
  .: $cfg_mode_affichage :.
  -------------------------
  'standard' => mode standard
  'theme' => mode thème
 
  .: $cfg_nb_news :.
  ------------------
  Il s'agit du nombre de news affichées par page.
  Valable : 4
  Non valable : "4" ou '4'
 
  .: $cfg_cible :.
  ----------------
  C'est le nom de la frame cible dans laquelle doivent être ouvertes les nouvelles pages. La mention '_blank' permet d'ouvrir une nouvelle fenêtre et ainsi de ne pas faire partir les visiteurs de votre site.
 
  .: $cfg_css :.
  --------------
  Chemin d'accès du fichier CSS. Si vous ne savez pas ce que c'est, n'y touchez pas. Sinon vous pouvez mettre ici n'importe quel fichier CSS dont le nom des styles est le même que le fichier initial pour ainsi personnaliser ENCORE plus l'affichage standard.
 
  .: $cfg_print_img :.
  --------------------
  Quand vous en serez à l'activation des modules, vous verrez qu'il est possible de proposer un lien en bas de chaque news pour l'imprimer. Si vous souhaitez que ce lien ne soit non pas écrit "Imprimer" mais que ce soit une petite image, mettez ici l'URL absolue (avec le http://) de cette image
 
  .: $cfg_email_mod :.
  --------------------
  Pareil que ci-dessus mais pour le module qui envoie la news à des amis (vous pouvez par exemple mettre une image d'un courrier)
 
 // - Activation / Désactivation des modules
  phpMyNesws propose "de série" de nombreux modules que vous pouvez activer ou désactiver selon vos besoins ou les restrictions de votre hébergeur. Pour chaque module ci-dessous vous aurez une description, si nécessaire le nom d'un fichier spécifique à ce module que vous devrez configurer et enfin une liste des hébergeurs connus sur lesquels le module ne peut pas fonctionner.
-> Pour activer un module, mettez true sans guillemets ni quotes, pour le désactiver, mettez false.
 
  .: $cfg_securite_mod :.
  -----------------------
  [|] Description : ce module permet, uniquement pour les navigateurs récents, de détecter la fermeture du navigateur lorsque vous êtes connecté à la maintenance et de vous en déconnecter automatiquement, pour éviter toute intrusion par la suite
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_search_mod :.
  ---------------------
  [|] Description : permet d'afficher ou non le formulaire de recherche pour effectuer une recherche dans les news
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_upload_mod :.
  ---------------------
  [|] Description : module qui permet d'uploader les images, c'est-à-dire de copier des images de votre disque dur vers votre serveur FTP sans utiliser de client FTP, juste par un petit formulaire WEB.
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : Free, Online, Nexen (autres : ?)
 
  .: $cfg_export_mod :.
  ---------------------
  [|] Description : module qui permet d'exporter vos news, c'est-à-dire de permettre à d'autres sites d'afficher vos news en petit dans un coin avec un renvoi vers votre site.
  [|] Fichier doc : 'docs/fr/export.txt'
  [|] Fichier à congigurer : 'include/modules/export.inc.php3'
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_restrict_mod :.
  -----------------------
  [|] Description : module qui permet de modérer le contenu des commentaires postés par les utilisateurs. Il permet aussi d'éviter le spam des adresses email de vos visiteurs en remplaçant leur @ par _at_. Possibilité aussi d'établir une liste de mots interdits qui seront alors corrigés.
  [|] Fichier à configurer : 'include/modules/restrict.inc.php3'
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_orth_mod :.
  -------------------
  [|] Description : correcteur orthographique des news. Etablissez une liste de mots erronés et le mot par lequel ils doivent être remplacé. Très utile par exemple pour ceux qui tapent vite et inversent toujours les mêmes lettres. Par exemple, moi au lieu d'écrire 'est', j'écris souvent 'ets'. Pour 'vous', 'vosu'...
  [|] Fichier à configurer : 'include/modules/orth.inc.php3';
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_print_mod :.
  --------------------
  [|] Description : permet d'afficher en bas de chaque news un lien pour l'imprimer. Ce lien ouvre un popup avec la news dedans, pour éviter de devoir imprimer l'intégralité de la page HTML. Pratique et courrant!
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_comments_mod :.
  -----------------------
  [|] Description : vos visiteurs pourront poster des commentaires pour chacune de vos news via un lien "Commenter" en bas de news si vous activez ce module
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_cache_mod :.
  --------------------
  [|] Description : c'est un module de cache assez simple qui offre tout de même d'excellentes performances sur la vitesse de chargement de votre page d'acceuil. Ce module est tout de même très spécifique et je vous conseillel donc vivement la lecture de son fichier doc avant de l'utiliser, même si dans 95% des cas il est utilisable!
  [|] Fichier doc : 'docs/fr/cache.txt'
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : Free et d'une manière générale les hébergeurs qui ne proposent pas la fonction ob_start()
 
   // Pour les deux modules qui suivent : activez soit l'un, soit l'autre, soit aucun, mais pas les deux!
   .: $cfg_mail_mod :.
   -------------------
   [|] Description : permet d'envoyer des mails via une fonction mail quelque soit son nom proposée par votre hébergeur.
   [|] Fichier à configurer : 'include/modules/mail.inc.php3' et quelques variables dans le fichier config.inc.php3
   [|] Hébergeurs non compatibles : Free et ceux qui ne proposent aucune fonction de mail
 
   .: $cfg_mailbyip_mod :.
   -----------------------
   [|] Description : permet d'envoyer des mails si votre hébergeur ne propose aucune fonction mail en se connectant directement à un serveur (peu importe lequel) au lieu de passer par PHP. Je ne suis pas sûr que ce soit légal mais au moins ça fonctionne...
   [|] Fichier à configurer : 'include/modules/mailbyip.php3' et quelques variables dans le fichier config.inc.php3
   [|] Hébergeurs non compatibles : aucun
   [|] Infos : à vous de trouver une IP de serveur SMTP et son adresse à rentrer dans le fichier config.inc.php3
 
  // - Suite des modules "normaux"
 
  .: $cfg_proposer_news :.
  ------------------------
  [|] Description : permet à vos visiteurs de proposer une news qui sera ensuite enregistrée dans votre base de données sans pour autant être accessible aux visiteurs. Si un des deux modules de mail est actif, un mail pour vous signaler cette news vous sera envoyé. Sinon, un message vous l'indiquera en rouge en haut du menu d'administration lors de votre connection à la partie de maintenance.
  [|] Fichier à configurer : aucun
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_archives_mod :.
  -----------------------
  [|] Description : permet d'afficher un lien en dessous des news pour accéder aux archives, c'est-à-dire à une liste de toutes les news enregistrées dans la base classées paar ordre chronologique.
  [|] Fichier à configurer : 'include/modules/archives.inc.php3'
  [|] Hébergeurs non compatibles : aucun
 
  .: $cfg_smileys_mod :.
  ----------------------
  [|] Description : le petit gadget amusant : permet d'insérer des smileys (petites images de bonhommes qui sourit, qui pelure...) dans vos news ou même dans les commentaires. Vous pouvez de plus modifier la liste des smileys à votre guise. Par exemple, si dans la news vous mettez ce sera remplacé par une tête qui sourit...
  [|] Fichier à configurer : 'include/modules/smileys.inc.php3'
  [|] Hébergeurs non compatibles : aucun
 
 
// -------------------------------------------------------------------- //
// 4. INSTALLATION SUR LE SERVEUR     //
// -------------------------------------------------------------------- //
 
 Bravo! Vous avez configuré l'application, 90% du boulot a été fait. Il reste maintenant à passer le dossier qui contient phpMyNews (nommé par défaut 'phpmynews' sur votre serveur via votre client FTP. Veillez à le placer au bon endroit : c'est-à-dire à ne pas contredire les informations que vous avez données dans le fichier de configuration!

// ------------------------------------------------------------ //
 // Insertion des news dans la page web    //
 // ------------------------------------------------------------ //
 Enfin, ouvrez le fichier dans lequel vous souhaitez inclure les news (généralement nommé index.php3 et situé à la racine mais ce fichier peut se trouver où vous le voulez) et éditez son code HTML en ajoutant ce petit morceau de code PHP là où les news doivent apparaître dans la page :
 
<?php
$cfg_include_dir = 'phpmynews/include/'; //Changez cette valeur si nécessaire mais n'oubliez pas le / final !!!!!!!!
include($cfg_include_dir.'index.php3';  //remplacez le .php3 par .php si vous fonctionnez en .php
?>