NEWS
----

$Id: NEWS,v 1.16.2.10 2002/09/14 12:13:51 ruffy Exp $

French version below - Version franaise plus bas
-------------------------------------------------------------------------------

What's new in daCode ?
----------------------

daCode is a web application that allows you to easily create websites, like
Slashdot or LinuxFR. daCode uses php (3 or 4). A MySQL or PostgreSQL database
is needed. daCode is very customisable, and you can use themes.
The main advantage of daCode is its cache, which uses very few cpu power.
daCode is distributed under the GPL licence (for more info about GPL, see
LICENSE file).

The main changes of version 1.4.0 since version 1.2.0 are:

New Features
------------
* You can now use NIS (instead or MySQL, PostgreSQL or LDAP) for the
  authentication of the users. You have to configure this in the config file.
* A "N" picture is now displayed in front of each comment which hasn't been yet
  read by an user since his last visit, so that users can easily know which
  comments are brand new.
* Each registered user can now choose the boxes he wants to see on the main
  page, and their vertical position. Of course, cache is used.
* New moderation system, which allows everyone to score the comments regarding
  to his "karma" (based on experience points, "XP"). This system is fully
  explained on the following web page, in french:
  http://perso.linuxfr.org/penso/moderation-linuxfr.txt .
  It uses cache without problem.
  Karma is shown on user page and in userbox. Karma levels can be defined in
  the config file.
  This comes with a new page that shows a list of users sorted by their XP.
  Also, old moderation system can be used instead of the new.
* daCode now generates a stardard (RDF/RSS) backend file each time news are
  moderated. This file is called "backend.rss" and is generated in the root
  directory of the website. You can change his name in the config file.
* New messages index page: You can now see all the messages you received and
  all the ones you sent in the index page of the messages/ directory. You can
  also now delete your yet read personal messages.
* New class called "Comments", which allows you to theoretically comment
  everything.
* New Mozilla/Netscape 6 Sidebar.
* Error 404 handling.
* We now can send a mail to the author of an article directly through the
  moderation page.
* New debug functions.
* You can restrict accounts creation to admins only.
* Admins can now physically delete news from the database directly through the
  moderation's interface.
* Moderators can be warned by email when news are submitted.
* You can now see the last 10 comments for any user.
* You can now send private messages directly through the board.
* phpWiki URIs are now handled in the board.
* Session management: users can now manage multiple sessions.
* We now use PHPDoc to document the source.

Themes
------
* New theme "Nexen", by Guillaume Magery. This theme comes from
  http://dev.nexen.net/news/.
* New theme "BeOS6", by Littleboy, inspired by the "Origin" skin from BeOS 5.1.

New administration script
-------------------------
* Perl script daily.pl has to be run every night. It cleans what needs to be
  cleaned (SQL, sessions, etc) and modifies vote number for users (for the new
  moderation system).

Contrib
-------
* New contrib/ directory, which contains third-party projects related
  to daCode.
* Added TribuneClient v1.2 by Arnaud Willem <woof@woof.lu>
* Added TrollBrowser by Anthony Piron <apiron@brutele.be>
* Added webcalendar.php4 by Julien Larigaldie <julien@larigaldie.com>

Main modifications
------------------
* New daCode logo, by Ayo73 <URI:http://www.73lab.com/> !
* XHTML 1.0 Transitional instead of HTML 4.0 support.
  Some docs about XHTML 1.0 can be found on the w3c website:
  http://www.w3.org/TR/2000/REC-xhtml1-20000126/
* Documentation has been completed and reorganized, so that it's easier to
  find the informations needed.
* The "New messages" box is now always displayed when you have new messages,
  and it displays _only_ really new messages (ie. not read yet).
  Note that you can know delete messages too.
* The newssection.tmpl, short.php3, short-rss.php3, templates.html,
  templates-1.html, templates-2.html files has been deleted. They weren't
  useful anymore.
* You can know define a common logo and a common comment for the logo for all
  your themes. See that in the config file.
* PostgreSQL support improved: The Timestamp problems should now be resolved.
* Users can now add their ICQ UIN, GnuPG key or their photo to their infos.
  ICQ presence is shown through a mirabilis indicator.
* All pages now have a link to the top of the page at their bottom.
* "fake email" isn't used anymore. We now print the email in another way. It
  should prevent spiders to fetch email address.
* By popular request, we now print links to previous & next news above AND
  below each news, in comment view.
* A lot of new backend functions, for a lot of french- and english-speaking
  websites.
* Removed useless functions (cmp() and datefr()).
* The last connected box no more displays users more than once.
* Reduced all PNG files size.
* We now display the long name for each topic, instead of the short one.
* Removed a lot of warnings.
* The board can now be parsed by external programs through an XML remote file,
  called remote.xml by default. Your login can also be automatically
  posted in front of each of your messages in the board.
* We now use relative links instead of absolute ones. It allows an easy
  mirroring for sites using daCode.
* You can now define a bottom level for posting comments.
  This can be used only with the new moderation system.
* Webcam, Tips and Messages modules have been partially rewritten.
* Added some online documentation for both users and admins.
* And as always, more translations, bugfixes, and of course new bugs ;)

                   ---------------------------------------

The main changes between version 1.2.0 and 1.0.x are:

New Features
------------
* You can now warn someone of a news by sending him an email through the site.
  You can also add a comment to the sent mail.
* Webmasters that can not use the mail() function because of their host can now
  send mails through daCode. You'll need to ask a login and a password. See
  that in the config file.
* New tips module: Users can now post tips about what they want. A new sidebox
  helps displaying the tips on all pages.
* New calendar module: users can now browse the news by day and month. So it's
  now easier to read old news.
* Webmasters can use LDAP instead of MySQL or PostgreSQL to manage users.
  Users data are copied into the LDAP directory used.
* New sidebox showing the last 10 authenticated users connected.
* Authenticated users can now change their real email address.

Themes
------
* OpenMind, by Fabien Penso, is inspired by the PHP-Nuke 4 design.
* KDE 2, by Franck Qulain, looks like ... KDE 2 :)
* All graphic themes have been modified, so that they can be seen by Internet
  Explorer (left sideboxes had different widths ...)
* All graphic themes have now all the images they need.

New administration scripts
--------------------------
* Perl script dacodeconfig makes daCode installation easier (if you can run
  Perl scripts, of course). Use "perldoc scripts/dacodeconfig" for a
  description of the script. Note that it can changes .php3 files into .php.
* Perl script sqlcheck.pl tracks down tainted variables in SQL queries and
  taints in database requests.
* Perl script dacode2usenet.pl allows you to post on a nntp server all the news
  and their comment from your site. Please note that there is no documentation
  available at this time for this script.

Main modifications
------------------
* For compatibility reasons, daCode now uses <?php ?> tags instead of <? ?>.
* The FAQ now contains more Q&A, in both english and french.
* All the text displayed by daCode should be translated in english and french.
* The backend file generated can be customized through the config file.
* Admin interface enhanced: Admins can manage the section of the site, the
  webmaster can add new fields for the users infos, and problems related to
  multiple moderators working on the same news should now be avoided.
* daCode's cache enhanced: date & time of generation are now used; polls and
  board are now cached. And, better, cache doesn't need php safe_mode anymore.
* Addind modules to daCode is now easier: all files in src/phplib/local/ are
  used, when the local/ directory exists.
* Security problems related to users & to SQL queries are now avoided.
* A lot of bugfixes, everywhere and for everything.


Full list of changes is in the ChangeLog file.


-------------------------------------------------------------------------------


Quelles sont les nouveauts de daCode ?
---------------------------------------

daCode est une application web permettant de crer facilement des sites
principalement axs sur les dpches, sur le modle de SlashDot ou de LinuxFR.
daCode utilise php (version 3 ou 4) et ncessite une base de donnes MySQL ou
PostgreSQL. daCode est trs configurable, et permet l'utilisation de
diffrents habillages. Le principal avantage de daCode est sa gestion du
cache, qui permet de ne pas surcharger le CPU du serveur. daCode est
distribu sous licence GPL aux utilisateurs (pour plus d'infos sur la GPL,
lisez le fichier LICENSE).

Les principales nouveauts de la version 1.4.0 depuis la version 1.2.0 sont :

Nouvelles fonctionnalits
-------------------------
* En plus de LDAP, il est dsormais possible d'utiliser NIS pour la gestion des
  utilisateurs. Il faut configurer cela dans le fichier config.php3
* Une image "N" est affich devant chaque commentaire qui n'a pas encore t
  lu. Cela permet  un utilisateur de savoir immdiatement quels sont les
  nouveaux commentaires depuis son dernier passage sur le site.
* Chaque utilisateur enregistr peut dsormais choisir les botes qu'il dsire
  voir apparatre sur le site, ainsi que leur position verticale, et ce pour
  chaque habillage. Le cache est toujours utilis.
* Nouveau systme de modration, qui permet  tout le monde de noter les
  commentaires en fonction de son "karma" (des points d'exprience).
  Le systme est expliqu en entier sur la page web suivante, en franais :
  http://perso.linuxfr.org/penso/moderation-linuxfr.txt.
  Ce systme se sert sans problme du cache.
  Le Karma est affich sur la page d'infos et dans la boite latrale de
  l'utilisateur. Les niveaux de Karma peuvent tre dfinis dans le fichier de
  configuration.
  Une classement des utilisateurs par XP a galement t mis en place.
  L'ancien systme de modration peut toujours tre utilis  la place du
  nouveau.
* daCode gnre dsormais un fichier de backend standard (RDF/RSS)  chaque
  dpche modre. Ce fichier se nomme par dfaut "backend.rss" et est plac 
  la racine du site. Son nom peut tre modifi dans le fichier de config.
* Nouvelle page indexant vos messages : vous pouvez dsormais voire sur une
  mme page (situe  la racine du rpertoire messages/) tous les messages que
  vous avez reus et envoys. Il est galement dsormais possible de supprimer
  vos messages.
* Apparition d'une nouvelle classe, nomme "Comments", qui vous permet en
  thorie de tout commenter.
* Barre latrale pour Mozilla/Netscape 6.
* Gestion des erreurs 404.
* Il est dsormais possible d'envoyer un courriel  l'auteur d'une dpches
  directement par le biais de l'interface de modration des dpches.
* Nouvelles fonctions de dbogage.
* Vous pouvez restreindre la cration de comptes aux administrateurs seulement.
* Les administrateurs peuvent dsormais supprimer physiquement une dpche de
  la base de donnes par le biais de l'interface de modration.
* Les modrateurs peuvent tre avertis par courriel de l'arrive d'une dpche.
* On peut dsormais voir les dix derniers commentaires d'un utilisateur donn.
* Vous pouvez dsormais envoyer des messages privs directement depuis la
  tribune libre.
* Les URIs de type phpWiki sont dsormais supportes dans la tribune libre.
* Gestion des sessions : les utilisateurs peuvent dsormais grer plusieurs
  sessions.
* Utilisation de PHPDoc pour la documentation dans le code source.

Habillages
----------
* Nouvel habillage Nexen, par Guillaume Magery. Cet habillage est inspir de
  celui visible sur http://dev.nexen.net/news/.
* Nouvel habillage BeOS6, par Littleboy, inspir par l'habillage "Origin" de
  BeOS 5.1.

Nouveau script d'administration
-------------------------------
* Le script daily.pl, crit en perl, doit tre lanc toutes les nuits. Il
  nettoie ce qui en a besoin (la table SQL, les sessions) et modifie le nombre
  des votes pour les utilisateurs, lorsqu'on utilise le nouveau systme de
  modration.

Contrib
-------
* Nouveau rpertoire contrib/, qui contient des projets bass sur daCode et
  cres par d'autres personnes.
* Ajout de TribuneClient v1.2, cr par Arnaud Willem <woof@woof.lu>
* Ajout de TrollBrowser, cr par Anthony Piron <apiron@brutele.be>
* Ajout de webcalendar.php4, cr par Julien Larigaldie <julien@larigaldie.com>

Principales modifications
-------------------------
* Nouveau logo daCode, par Ayo73 <URI:http://www.73lab.com/> !
* Support du XHTML 1.0 Transitional en lieu et place du HTML 4.0.
  On peut trouver de la documentation sur le XHTML 1.0 sur le site du w3c :
  http://www.w3.org/TR/2000/REC-xhtml1-20000126/
* La documentation a t complte et rorganise de faon  ce qu'il soit
  plus facile de trouver ce dont on a besoin.
* La boite avertissant de l'arrive de nouveaux messages s'affiche tout le
  temps  partir du moment o on a un message. Il est galement dsormais
  possible de supprimer des messages.
* Les fichier newssection.tmpl, short.php3, short-rss.php3, templates.html,
  templates-1.html, templates-2.html ont t supprims, car ils n'taient plus
  utiles.
* Il est dsormais possible de dfinir un logo commun pour tous les thmes.
  De plus, le commentaire de ce logo est dsormais lui aussi commun  tous les
  thmes
* Le support de PostgreSQL a t amlior : les problmes de Timestamp
  devraient tre rgls.
* Les utilisateurs identifis peuvent dsormais rajouter leur photo, leur UIN
  ICQ ou leur cl GnuPG dans leurs prfrences. Un indicateur de prsence ICQ
  montre si l'utilisateur est en ligne ou non.
* Toutes les pages possdent dsormais en bas de la page un lien vers le haut.
* Le "fake email" n'est plus utilis. On affiche dsormais les adresses dans
  une forme difficile  utiliser pour les robots rcolteurs d'adresses, ce qui
  devrait viter qu'ils en rcoltent.
* A la demande gnrale, des liens vers les dpches prcdentes et suivantes
  sont dsormais affichs non seulement au-dessus mais aussi en dessous de
  chaque dpche, sur les pages de commentaires.
* Beaucoups de nouvelles fonctions de backends, qui concernent des sites aussi
  bien en franais qu'en anglais.
* Les fonctons cmp() et datefr(), devenues inutiles, ont t supprimes.
* La bote des derniers utilisateurs connects n'affiche plus de doublons
  (voire plus) dans les utilisateurs.
* Toutes les images au format PNG ont t rduites.
* C'est dsormais le nom long des habillages, et non plus le nom court (utilis
  pour les images) qui est affich dans la bote des habillages.
* De nombreux avertissements ("warnings") de PHP ont t supprims.
* La tribune libre peut dsormais tre analyse par des programmes externes
  par le biais d'un fichier XML, appel "remote.xml" par dfaut.
  Votre login peut galement tre affich automatiquement devant chacun de vos
  messages dans la tribune libre.
* Utilisation de liens relatifs en lieu et place des liens absolus.
  Cela permet entre autre de mirrorer facilement les sites sous daCode.
* Vous pouvez dsormais dfinir un niveau minimal pour poster des commentaires.
  Cela ne fonctionne qu'avec le nouveau systme de modration.
* De la documentation en ligne a t ajoute autant pour les utilisateurs que
  pour les admins, de faon  simplifier l'utilisation de daCode.
* Les modules Webcam, Tips et Messages ont t en partie rcrits.
* Et toujours plus de traductions, corrections de bogues, et de nouveaux
  bogues ;)

                   ---------------------------------------

Les principales nouveauts de la version 1.2.0 par rapport aux versions 1.0.x
sont :

Nouvelles fonctionnalits
-------------------------
* Il est dsormais possible d'avertir quelqu'un par courriel de la parution
  d'une nouvelle sur le site. Il est galement possible d'ajouter un commentaire
  au courriel envoy.
* Les personnes ne disposant pas de la fonction mail() active sur leur
  hbergeur peuvent dsormais envoyer des courriels, grce  une fonction de
  remplacement rserve  daCode, qui ncessite de demander un nom
  d'utilisateur et un mot de passe uniques.
* Nouveau module d'astuces : on peut dsormais poster des astuces sur des
  domaines divers. Une bote supplmentaire permet l'affichage d'une astuce sur
  n'importe quelle page.
* Nouveau module de calendrier : le calendrier permet la navigation parmis les
  dpches du site web selon leur jour de parution. Cette nouvelle
  fonctionnalit permet d'accder plus rapidement et surtout plus facilement 
  des dpches un peu anciennes.
* Il est dsormais possible d'utiliser LDAP, au lieu de MySQL ou de
  PostgreSQL, pour la gestion des utilisateurs sur le site. Les donnes des
  utilisateurs sont recopies dans l'annuaire LDAP utilis.
* Nouvelle bote affichant les 10 derniers utilisateurs connects : cette bote
  permet de voir qui est venu rcemment sur le site. Les noms d'utilisateurs
  sont des liens qui mnent vers leur fiche perso.
* Il est dsormais enfin possible de changer sa vraie adresse lectronique dans
  sa fiche perso. On ne pouvait auparavant changer que sa fausse adresse.

Habillages
----------
* OpenMind, cr par Fabien Penso, est un habillage qui s'inspire du design des
  sites utilisant PHP-Nuke.
* KDE 2, cr par Franck Qulain, est un habillage s'inspirant de l'interface
  graphique du gestionnaire de fentre pour Unix KDE 2.
* Tous les habillages ont t modifis, de faon  les rendre totalement
  compatibles avec Internet Explorer (les botes de la colonne de gauche taient
  prcdemment de largeur diffrente, suite  des erreurs dans les attributs de
  largeur des colonnes).
* Tous les thmes contiennent dsormais la totalit des images ncessaires 
  leur bon fonctionnement.

Nouveaux scripts d'administration
---------------------------------
* Le script dacodeconfig, cr en perl, permet de simplifier la configuration
  de daCode avant l'installation. Il prend notamment en charge le passage de
  l'extension .php3  l'extension .php ou .php4.
* Le script sqlcheck.pl, galement cr en perl, permet aux dveloppeurs de
  vrifier la validit d'un point de vue de scurit des scripts php stocks
  dans src/phplib/.
* Le script dacode2usenet.pl, lui aussi cr en perl (mais pour l'instant non
  document), permet de poster sur un server nntp (newsgroups) l'intgralit
  des dpches et de leurs commentaires publis sur le site web gr par
  daCode.

Principales modifications
-------------------------
* Pour des raisons de compatibilit, daCode utilise dsormais des balises php de
  type <?php ?> et non plus <? ?>.
* La FAQ d'aide pour daCode contient dsormais plus de rponses pour plus de
  questions. Elle est galement dsormais bilingue (anglais et franais), pour
  des raisons videntes de facilit d'accs.
* La totalit des textes affichs par daCode ( l'exception de ceux internes
  aux habillages) est dsormais traduite en anglais et en franais.
* Le fichier de backend des dpches gnr par daCode est dsormais
  configurable par le biais du fichier config.php3. Il fallait auparavant
  modifier directement dans le code le titre et la description de la page.
* Interface d'admin amliore : il est notamment dsormais possible de grer
  les sections du site depuis la bote d'admin ; le webmestre peut galement
  ajouter ou changer des champs dans ce qui est propos aux fiches persos des
  utilisateurs ; les problmes ds au fait que plusieurs modrateurs travaillent
  sur la mme dpche en mme temps sont galement dsormais vits.
* Le systme de cache a t amlior : le jour et l'heure o la page a t
  gnre sont dsormais stocks et les sondages, ainsi que la tribune libre,
  utilisent galement le cache. Le cache peut galement fonctionner quand PHP
  est install en safe_mode.
* L'ajout de modules  daCode est facilit : tous les fichiers placs dans
  src/phplib/local/ sont lus et interprts, quand le rpertoire local/ existe.
* Nombreuses corrections de bogues divers,  tous les niveaux et dans la plupart
  des fichiers de daCode.
* Correction de quelques problmes de scurit, principalement au niveau des
  requtes SQL et des utilisateurs.


La liste complte des changements et ajouts se trouve dans le fichier
ChangeLog.
