C-News : Documentation

Présentation générale

C-News est un script réalisé en langages de programmations XHTML/CSS pour la présentation, PHP pour la partie pratique et Javascript pour le dynamisme. Il a pour but de permettre aux webmaster n’ayant aucune ou des faibles connaissances dans ses langages de programmation de pouvoir proposer facilement à leurs visiteurs du contenu d’actualité dynamiquement et en toute facilité. Pour cela, il propose des fonctions diverses :

Installation

L’installation de C-News est conçue pour être très simple. Aucune connaissance en langage de programmation ne vous est requise. Par contre, votre serveur d’hébergement doit présenter quelques caractéristiques indispensables :

  1. Commencez tout d’abord par télécharger C-News depuis notre page de téléchargement.
  2. Décompressez le dossier c-news présent dans l’archive sur votre disque dur.
  3. A l’aide de votre logiciel FTP (ex : SmartFTP), connectez-vous à votre FTP puis uploadez le dossier c-news. Si vous le souhaitez, vous pouvez renommer ce répertoire mais uniquement celui-ci.
  4. A l’aide de votre logiciel FTP, mettez les droits en écriture sur les dossiers templates et data ainsi que sur tous leur fichiers et sous-dossiers.
  5. Avec votre navigateur web, rendez-vous à l’adresse http://www.votre-site.com/c-news/install.php et suivez les instructions. L’installation sera automatique.
  6. Connectez-vous à votre compte et configurez le script (voir Configuration).

Configuration

Options générales

La page de configurations générales vous est déjà proposée lors de l’installation mais reste éditable par la partie de gestion de C-News. Voici en détails à quoi correspondent les différents champs :

Nom du site : Il s’agit tout simplement du nom de votre site web ou seront publiées les news.
Adresse du site : Adresse absolue du site commençant par http://.
Adresse du script : Adresse absolue de C-News commençant par http://.
Format de date : Il s’agit du format qui sera utilisé pour toutes dates. Voir tableau ci-dessous :
Rédiger un résumé des news : Un champ supplémentaire de résumé des news apparaîtra dans le formulaire d’ajout.
Renseigner la source des news : Proposer aux visiteurs un lien vers le site source de votre news.
Utiliser les smilies : Smilies dans l’ajout de news et de commentaires.
Etre tenu informé des commentaires par e-mail : L’auteur sera tenu au courant par e-mail de l’ajout de commentaires sur ses news.
Formulaire de commentaires : Dimensions du formulaire de commentaires

Templates

Les templates vont vous permettre de personnaliser l’affichage de vos news en éditant leur code html. Vous accédez à la gestion des templates de C-News par le menu « Configurations ».

Une classe de templates « Défaut » existe déjà et vous pouvez tout à fait la modifier ou en créer une autre. Vous pouvez aussi utiliser en même temps deux classes pour deux pages différentes de votre site par exemple.

Chaque classe de templates est composée de formats que vous pouvez modifier :

Liste des news : C’est le format qui est recommandé pour la présentation des news en liste sur une page d’accueil par exemple. Le code html entré sera reproduit pour chaque news.
News complète : Affichage de la news complète.
Commentaires : Affichage des commentaires de la news. Le code html entré sera reproduit pour chaque commentaire.
Formulaire de commentaires : Il s’agit de l’organisation du formulaire que les visiteurs rempliront afin de poster un commentaire.
Pages : Affichage d’une pagination.

Comme proposé sur la page d’édition des templates, vous ajoutez les marqueurs de contenu (date, titre, contenu, …) de la forme suivante : {marqueur}

Attention : Chaque format possède ses propres marqueurs et ils sont précisés au dessus du formulaire des formats.

Intégration à votre site

Attention : Les codes d’insertion sont en langage PHP, vos pages doivent donc porter l’extension *.php.

Pour facilité l’intégration des news sur votre site web, C-News comporte une page génératrice de code d’insertion. Pour y accéder, suivez le lien « Intégration » du menu de C-News et choisissez le format pour lequel vous souhaitez créer un code d’insertion.

Selon les formats, vous rencontrerez les champs suivants :

Classe de templates : sélectionnez la classe pour laquelle vous voulez créer le code.
Adresse de la page d'intégration par rapport à la racine du script : Il s’agit d’une adresse relative par rapport à la racine du script finissant par un /.
Nombre de news : Nombre de news que vous souhaitez afficher.
Adresse de la page des news complètes par rapport à la page d'intégration : Il s’agit d’une adresse relative de la page d’intégration par rapport à la page ou se situe les news complètes.
Ordre des news :

Attention :

Les codes PHP qui vous sont alors fournis doivent être copier-coller à l’endroit désiré dans votre page web. Bien entendu, plusieurs formats peuvent être intégrés sur une seule page et même plusieurs classes de templates.

Si vous souhaitez n'afficher que les news de certaines catégories (avec le format "Liste des news"), il vous suffit de complète la ligne suivante (avec les ID des catégories voulues) :

$categories = '1,3,6'

Encore des problèmes ?

Si vous avez lu attentivement cette documentation et que vous avez encore des problèmes ou des suggestions à faire, je vous invite à passer par notre forum et j’y répondrais au plus vite.

Site officiel de support : C-News.fr