- Section publique
La page d'accueil (index.php) montre au visiteur une barre de navigation avec trois liens:
liste (list.php)
chercher (search.php)
proposer (ecrire.php) <
En dessous de cette barre les x dernières News sont affichées en détail:
Date, titre et auteur, suivi des icônes/liens vers le site et l'email de l'auteur si il les a indiqués dans le formulaire ecrire.php. Le site s'ouvre dans une nouvelle fenêtre, et l'email renvoie vers un formulaire de contact mailto.php, l'adresse email restant ainsi invisible. On trouve ensuite le texte de la News, puis jusqu'à trois liens suivis de leur description. Ensuite le visiteur a la possibilité de lire les commentaires (lire.php) s'il y en a, ou d'en écrire un (comment.php).
Liste affiche donc les xx dernières News, classées par date, avec leur sujet et leur auteur. Un clic sur l'une d'elles envoie à la page lire.
Chercher propose une recherche dans toutes les News avec de un à trois mots-clefs, l'opérateur ET ou OU, et la possibilité de rechercher dans les auteurs, les titres ou les textes. L'affichage se présente comme la page liste.
Proposer est le formulaire de proposition de News. Pas de restriction, tout visiteur peut proposer une News, mais elle devra être validée par vous avant d'être publiée. Les champs obligatoires sont: Nom, Titre et Texte. Email est facultatif, mais doit être valide si renseigné. Il est possible d'insérer jusqu'à trois liens et leur description en fin de texte, et quatre smilies sont automatiquement gérés: :) :( :grr: et ?!? sont remplacés par
et 
. Les balise
HTML ne sont pas reconnues, évitant les mauvaises plaisanteries.
Vous recevez un email vous informant de la proposition d'une News et vous
invitant à aller la valider.Privilège administrateur: en tapant admin dans le champ nom et en validant, vous êtes redirigé sur le formulaire réservé(voir plus bas).
Lire le ou les commentaires affiche la News concernée et en dessous tous les commentaires ajoutés par les lecteurs. Les commentaires se présentent comme la News, le titre en moins.
Même privilège pour l'administrateur que ci-dessus.
Ecrire permet donc de commenter une News. Comme pour proposer, tout visiteur peut poster un commentaire, mais vous devez le valider pour qu'il soit publié. Les caractéristiques du formulaire de commentaire sont les mêmes que celles des News, et vous êtes également prévenu par mail.
- Section administration
Une fois passée la page de login, plusieurs choix:
Paramètres de présentation (design.php). Vous choisissez ici l'apparence de mc News (seulement pour la partie publique) en fonction des fichiers qui sont dans le dossier skin. Vous n'en trouverez que deux pour le moment, à vous d'en faire un assorti à votre site. Et surtout pensez à me les envoyer, je les mettrai à disposition de tous.
Paramètres techniques (tech.php). Il faut ici choisir la langue, de la même manière que pour les couleurs, les fichiers étant dans le dossier lang. Même demande de ma part, faites passer! Vous devez également renseigner les autres champs. Le nom c'est celui que vous voulez voir apparaître dans "auteur" sur vos News, l'email c'est pour les avis de post et l'URL du site pour le lien qui vous permet de quitter l'admin après déconnexion. Le nombre de News sur page d'accueil correspond au nombre de News "déployées" que vous voulez voir apparaître (généralement de 5 à 10, mais le choix est libre, attention à la vitesse d'affichage à cause du nombre de requêtes), le nombre de News en page liste peut être beaucoup plus grand, d'autant qu'il détermine aussi le nombre de réponses possibles en recherche.
News à valider vous en montre la liste. Cliquer sur une vous envoie vers la page valider modifier supprimer (valid.php)
Commentaires à valider pour: ici sont listées les News déjà validées mais qui ont reçu un nouveau commentaire. Les liens vous envoient à la même page que ci-dessus.
News validées est la liste de toutes les News pour lesquelles il n'y a rien de nouveau. Utilisez-la pour supprimer les plus anciennes, de façon à éviter l'engorgement de la base de données. Toujours la même page.
Publier une News, en haut à droite, vous ouvre un formulaire pré-rempli avec votre nom et vote email (fixés dans les paramètres techniques). Dans ce formulaire vous pouvez utiliser le HTML, pour écrire en couleurs, en gras, voire insérer des images ou des liens dans le texte. Tout est possible, même les erreurs! Donc soyez prudent. D'autre part les News Administrateur sont validées d'office.
Valider Modifier Supprimer affiche une News et ses eventuels commentaires. Cliquer sur valider la valide, sur modifier ouvre un formulaire vous permettant de tout modifier, et d'ajouter du HTML éventuellement. Une News que vous modifiez doit ensuite être validée, le mot validé est alors rouge. Même procédures pour les commentaires. Supprimer une News supprime également tous ses commentaires, supprimer un commentaire ne supprime que lui. Vous pouvez aussi à partir de cette page écrire un commentaire, et en tant qu'administrateur il jouit des privilèges déjà vus plus haut.
Editez le fichier config.inc.php et renseignez les variables.
$admin_login et $admin_pass seront vos login et mot de passe
d'accès à l'administration de mcNews.
Envoyez ensuite le répertoiremcNews complet sur votre serveur
Web.
Connectez-vous et naviguez jusqu'à http://www.votresite/.../mcNews/admin/install.php,
... et suivez simplement les instructions. Renseignez bien le formulaire
Paramètres techniques.
Un peu de modestie ;)
(oui,
je sais, pour beaucoup c'est la moindre des choses)
1.3:
Protection de l'Admin par sessios, et quelques trous de sécurité éliminés.
Update depuis version 1.2: envoyer tous les fichiers du dossier admin sur votre serveur.
1.2:
Affichage de la page Liste sur plusieurs pages.
1.1a:
Correction d'un bug dans install.php
1.1:
Option de validation automatique des News et/ou des commentaires. Amélioration
de l'affichage (tri sur la date ET le numéro de la News).
1.0:
Première version.
mcNews est distribué dans l'espoir qu'il sera utile, mais SANS AUCUNE GARANTIE de quelque sorte que ce soit. Se reporter à la GNU General Public License pour plus de détails.
Vous devez
avoir reçu une copie de la GNU General Public License
jointe à ce programme, sinon vous pouvez écrire à
la Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.