documentation - Ma page Web

Phortail, le mini CMS
qui vous ouvre de grandes portes !
V2.0.5
Avant de lire ce document, sachez définir avec exactitude vos besoins et vos buts. Plusieurs liens
vous sont donnés à la dernière page afin de vous aider dans votre choix. Bonne lecture !
SOMMAIRE
Ce guide est là avant tout pour vous offrir une première approche complètement guidée à partir d'un
cas d'école. Vous pouvez également suivre les exemples renseignés dans les articles du site installés
par défaut.
1)
Le Webmaster en tant qu'Utilisateur ............................................................................. 2
I. Présentation .................................................................................................................. 2
II.
Mise En Place............................................................................................................ 2
III.
Configuration............................................................................................................ 3
2) Le Webmaster Avancé ..................................................................................................... 5
3) Bibliographie..................................................................................................................... 7
4) Remerciements ................................................................................................................. 7
5) Annexe 1 ............................................................................................................................ 8
1) Le Webmaster en tant qu'Utilisateur
I. Présentation
Phortail est un CMS, terme anglais signifiant "Content Management System". Vous
trouverez beaucoup de sites expliquant en détails sa signification. Pour faire court, c'est un
outil permettant de gérer du contenu : il convient donc parfaitement pour un site Internet
pour un Webmaster qui s'occuperait principalement de gérer le contenu de son site.
Phortail est réalisé en PHP, un langage informatique qui est lu, compris et affiché par des
machines adéquats (appelées serveurs). Il vous faudra donc un hébergeur ayant un serveur
pouvant interpréter le PHP (V 4.1.0 minimum). Un hébergeur comme
permet de
franchir cette étape. Aucune base de données n'est nécessaire pour cette version.
Ensuite, on va avoir besoin d'un logiciel qui nous permet de transférer le CMS depuis notre
ordinateur sur l'hébergeur. Le transfert s'effectue par FTP, terme anglais signifiant "File
Transfert Protocol". Suivant votre système (Windows, Mac, Linux), recherchez le programme
qui vous convient (LeechFTP : http://www.leechftp.eu/, FileZilla : http://www.filezilla.fr/, etc
par exemple pour Windows). N'oubliez pas de lire sa documentation si vous ne savez pas
vous en servir.
N'oubliez pas non plus de vérifier si vous avez déjà un logiciel de type "archiveur" : il
servira pour dézipper l'archive à télécharger.
Une fois qu'on a ces deux ou trois éléments, on va télécharger Phortail. Hop, hop, hop, on se
rend ici : http://phortail.free.fr/downloads.php
On choisit "phortail_v2.0.5.zip" et "skins_phortail_v2.zip".
II. Mise En Place
1ère étape : on dézippe l'archive phortail_v2.0.5.zip en un dossier "phortail" (qui contient
12 dossiers et 27 fichiers).
2ème étape : on utilise le logiciel pour un transfert par FTP. Pour l'exemple de l'hébergeur
Free, il vous faudra vous connecter sur l'hôte ftpperso.free.fr, Port 21, avec vos noms
d'utilisateur et mot de passe (liés à votre compte messagerie de mails). Une fois la liaison
établie, on déplace le dossier phortail à la racine du site.
3ème étape : On se connecte à l'adresse fournie par l'hébergeur. Cela donnera pour l'exemple:
http://monsite.free.fr/phortail/ (changez monsite par le nom de votre compte de messagerie
Free). Cliquez sur "Admin" (en haut à droite) et utilisez le compte initial "pseudo" et le mot
de passe "pass".
III. Configuration
Une fois connecté, une fenêtre vous indique que le mot de passe est celui par défaut. Le
premier geste à effectuer est de le modifier :
On se rend dans "mot de Passe", on entre le mot de passe actuel puis un nouveau mot de
passe que l'on confirme. Si c'est pris correctement ne compte, on a le message suivant : "Le
mot de passe a été modifié avec succès".
On revient en cliquant sur "Retour admin". Deuxième opération à effectuer, changer le
nom du compte : on clique sur "Configuration Générale". Renseignez les diverses cases
suivant ce qui est indiqué, en faisant attention à l' "Identifiant de session d'administration ".
Pour l'exemple et pouvoir expliquer ici, je prends le compte "admin" avec le mot de
passe "azerty". Bien sûr, ce mot de passe est fortement déconseillé : pour rappel, un bon mot
de passe doit au moins respecter ces règles :
- ne pas exister dans un dictionnaire (ni être un prénom)
- être de longueur minimale de 6
- avoir au moins une minuscule et une majuscule
- contenir au moins un caractère spécial : @, &, (etc)
On va se rendre dans "Configuration du Site". Pour activer le Tag-Board (module
permettant de laisser un court message en direct en vue d'un dialogue), on va cliquer sur
"Droit 2" et choisir "tag".
On change pour "Droit 7" de "info" (Infos site) à "info_formulaire" : ainsi, au lieu
d'avoir le mail visible dans le module d'infos du site, on va renvoyer l'utilisateur sur un
formulaire à remplir. Essayez d'autres opérations si vous le souhaitez pour vous entraîner à
modifier l'aspect de votre site (surtout pour le graphisme et les couleurs).
La partie "BARRE de NAVIGATION" est la partie gérant le bandeau de liens de
navigation du site. Par exemple, pour le "Lien 8", je vais passer la valeur "Forum" à une
valeur vide (première valeur de la listbox) afin de ne plus avoir d'accès direct au Forum
En bas de page, on voit "SÉCURITÉ" : je vous recommande de changer les quatre
dernières valeurs (les "Anti-spam") à "Avec".
Une fois les modifications effectuées, on clique sur "Enregistrer la configuration". Le
rendu visuel est alors immédiat.
On se rend ensuite sur l'option "Pied de Page". Par exemple, je supprime les lignes
concernant l'affichage de la flèche de retour vers le haut et les icônes de validateur W3C
(consortium publiant des recommandations sur des normes à appliquer à la création sur le
Web). Ainsi j'ai deux lignes vides, suivies de : [siteurl=http://phortail.free.fr]Site sous le
CMS Phortail [phortailversion][/siteurl]
En ce qui concerne les fichiers mis à disposition pour le téléchargement, les images,
bannières et photos, il faut noter que l'on transfère ces fichiers par l'option "Envoyer sur le
serveur".
Pour finir, on va faire le ménage dans les articles : dans "Admin" puis "Articles", il
suffit de supprimer les articles déjà présents. On choisit le nombre de groupe d'articles (les
boîtes disponibles) dans "Configuration du Site" jusqu'à un maximum de 20. Les pages
centrales sont disponibles jusqu'à un maximum de 10. Les modules visibles sont autorisés
au nombre total (à droite et à gauche) de 20.
On peut changer ces nombres, mais il faudra alors passer par la partie de "Webmaster
Avancé" (ci-après) pour modifier ces paramètres dans les fichiers.
2) Le Webmaster Avancé
I. Les paramètres utilisés
Pour changer les paramètres, on se rend :
Nombre max. de groupes d'articles
include\config2.php, variable $cfgNGroupesArticlesMax
Nombre max. de pages centrales
include\config2.php, variable $cfgNPagesCentralesMax
Nombre max. de modules
include\config2.php, variable $cfgNModulesMax
Nombre max. de sondages
include\config2.php, variable $cfgNReponsesSondageMax
II. La modification sur le Tag-Board
Pour changer le message, on se rend :
Message par défaut sur le Tag-Board
admin \include\tag.inc, ligne du file_put_contents
Il suffit de remplacer la ligne par :
file_put_contents("data/tag.txt", "");
Ensuite, on se connecte dans la partie "Admin" puis on va dans "Tag-Board" et on supprime
les messages.
III. L'anti-spam sur le formulaire de contact
Pour affecter un Anti-spam au formulaire, on se rend :
Anti-spam sur le formulaire de contact
mail_form.php
On remplacera le contenu de ce fichier par celui indiqué dans l'Annexe 1.
IV. Le bas de page "Page Générée"
Pour retirer cette inscription du bas de page, on se rend :
Inscription "Page Générée"
include\bpage.inc, ligne "Page gé" et celle d'après
On remplacera la ligne "Page générée en" et celle d'après par :
//echo '<p style="text-align: center">Page g&eacute;n&eacute;r&eacute;e en ';
//echo number_format($totaltime, 3, ',', '').' secondes';
Explications à traiter :
=> Galerie Image
=> Intégration Forum PhpBB + gestion droits accès [téléchargements, images, tag,
etc]
3) Bibliographie
Le site de référence :
http://phortail.free.fr/index.php
Le site pour établir son cahier des charges :
http://www.hiseo.fr/organisation/choisir-son-cms-2/
4) Remerciements
- Pascal GENTILE (Créateur)
- Pascal MARET (Contributeur)
- Michel DEMANTKÉ (Contributeur)
- Les utilisateurs
5) Annexe 1
Code du mail_form.php :
<?php
/******************************************************************************
Formulaire d'envoi de mail au webmaster
******************************************************************************/
require_once("include/config.php");
include_once("include/fonctions.php");
// $wmlfrmAntiSpam = ($cfgAntiSpam[4] == 1 and file_exists("extensions/cryptographp/cryptographp.php"));
$wmlfrmAntiSpam = true; // Avec ou sans anti-spam (true/false)
if ($wmlfrmAntiSpam) {
demarrer_session("PhortailAntiSpam"); // Nom du cookie de session
}
// Initialisation des variables
$wmlfrmNomExp = empty($_POST['nom']) ? '' : decode_gpc($_POST['nom']);
$wmlfrmAdrEmailExp = empty($_POST['email']) ? '' : decode_gpc($_POST['email']);
$wmlfrmMessageExp = empty($_POST['message']) ? '' : decode_gpc($_POST['message']);
$wmlfrmEnvoyer = empty($_POST['envoyer']) ? '' : decode_gpc($_POST['envoyer']);
$wmlfrmForm = "";
$wmlfrmErreur = 0;
$wmlfrmNomExp = trim($wmlfrmNomExp);
$wmlfrmAdrEmailExp = trim($wmlfrmAdrEmailExp);
$wmlfrmMessageExp = trim($wmlfrmMessageExp);
if ($wmlfrmEnvoyer == 1) {
// Vérification du nom et du message
if ($wmlfrmNomExp and $wmlfrmMessageExp) {
// Vérification de l'adresse email (si non vide)
if (empty($wmlfrmAdrEmailExp) or
preg_match('/^[\w-]+(\.[\w-]+)*@([\w-]+\.)+[a-zA-Z]{2,6}$/', $wmlfrmAdrEmailExp)) {
// Vérification du code anti-spam
if (!$wmlfrmAntiSpam or
( isset($_SESSION['cryptcode']) and isset($_POST['code']) and
$_SESSION['cryptcode'] == md5(strtoupper($_POST['code'])) and !isset($_SESSION['cryptreload']) ) ) {
// Envoi du mail (au format texte brut)
$email = trim($cfgAdministrateur[1]);
$subject = "Message au webmaster";
$headers = 'MIME-Version: 1.0'."\r\n";
$headers .= 'Content-type: text/plain; charset='.PHORTAIL_CHARSET."\r\n";
$headers .= 'Content-Transfer-Encoding: 8bit'."\r\n";
$message = "Message envoyé par : ".$wmlfrmNomExp."\n";
if (!empty($wmlfrmAdrEmailExp)) $message .= "Adresse email : ".$wmlfrmAdrEmailExp."\n";
$message .= "\n".$wmlfrmMessageExp;
$message = wordwrap($message, 70);
// Envoi du mail avec la fonction mail()
if (mail($email, $subject, $message, $headers)) $wmlfrmForm = 1; // OK
else $wmlfrmErreur = 4;
// Erreur
}
else {
$wmlfrmErreur = 3;
$_SESSION['cryptreload'] = true;
}
}
else $wmlfrmErreur = 2;
}
else $wmlfrmErreur = 1;
}
//=============================================================================
//
Affichage de la page
//=============================================================================
include("include/hpage.inc");
htable("Envoyer un message au webmaster", "100%");
if (empty($wmlfrmForm)) { // Formulaire d'envoi de message
$messagesErreur = array(
1 => "Le nom ou le message est manquant",
2 => "L'adresse email n'est pas valide",
3 => "Le mot recopié est incorrect",
4 => "Le message n'a pas pu être envoyé",
);
$argList = "";
if (defined("SID") and SID != "") $argList = "?".SID;
echo '
<form action="'.conv_url("mail_form.php".$argList."#message").'" method="post" acceptcharset="'.PHORTAIL_CHARSET.'">
<div class="center">
<input type="hidden" name="envoyer" value="1" />
';
if ($wmlfrmErreur == 1 or $wmlfrmErreur == 2 or $wmlfrmErreur == 4) {
// Affichage du message d'erreur
echo '
<p>
<a id="message"></a>
<br />
<b>ERREUR&nbsp;: '.$messagesErreur[$wmlfrmErreur].'.</b>
<br /><br />
</p>
';
}
echo '
<table cellspacing="0" cellpadding="0" border="0">
<tr><td style="height: 10px"></td></tr>
<tr><td style="text-align: center"><p>Votre nom ou pseudo&nbsp;:</p></td></tr>
<tr><td style="text-align: center"><p><input type="text" name="nom" size="30" maxlength="40"
value="'.conv_html($wmlfrmNomExp).'" /></p></td></tr>
<tr><td style="text-align: center"><p>Votre adresse email<br />
(si vous souhaitez recevoir une r&eacute;ponse &eacute;ventuelle)&nbsp;:</p></td></tr>
<tr><td style="text-align: center"><p><input type="text" name="email" size="40" maxlength="50"
value="'.conv_html($wmlfrmAdrEmailExp).'" /></p></td></tr>
<tr><td style="text-align: center"><p>Votre message&nbsp;:</p></td></tr>
<tr><td style="text-align: center"><p><textarea cols="60" rows="10" name="message">
'.conv_html($wmlfrmMessageExp).'</textarea></p></td></tr>
</table>
';
if ($wmlfrmAntiSpam) {
echo "<p>\n";
if ($wmlfrmErreur == 3) {
echo '
<a id="message"></a>
<br />
<b>ERREUR&nbsp;: '.$messagesErreur[$wmlfrmErreur].'.</b>
<br /><br />
';
}
echo '
<b>Recopiez le mot&nbsp;</b>
<img src="'.conv_url("extensions/cryptographp/cryptographp.php?".SID).'" alt="" style="vertical-align: middle" />
<b>ici</b>&nbsp;:&nbsp;<input type="text" name="code" size="6" />
<br /><br />
</p>
';
}
echo '
<table cellspacing="0" cellpadding="0" border="0">
<tr><td style="text-align: center"><p><input type="submit" value="Envoyer" /></p></td></tr>
</table>
</div>
</form>
';
}
elseif ($wmlfrmForm == 1) { // Message de confirmation d'envoi réussi
echo '
<p style="text-align: center">&nbsp;<br />
<b>'.conv_html("Le message a été envoyé avec succès").'</b>
<br />&nbsp;</p>
';
}
btable();
include("include/bpage.inc");
?>