altocompta/doc/FAQ-fr.sgml

<!doctype linuxdoc system>
<article>
<title> PhpCompta FAQ</title>
<author>
 <name>originally written by Dany De Bontridder
 </name>
</author>
<date>$Revision$</date>
<abstract>
Ce document contient les réponses aux questions les plus fréquemment posées sur
PhpCompta <url url="http://www.alchimerys.be/FR/phpcompta" name="PhpCompta">
site savannah
<url url="http://savannah.nongnu.org/projects/phpcompta/" name="PhpCompta Savannah">
</abstract>

<!-- Table of contents -->
<toc>
<sect> Qu'est-ce que PhpCompta ?
<P>PhpCompta est un logiciel <url url="http://www.gnu.org/licenses/gpl.html" name="GPL">
adapté à la législation
 belge en matière de comptabilité, il vous permet de tenir votre comptabilité de
 manière centralisée.Il a été crée pour supporter diverses comptabilités d'autres
 pays mais par manque de documentation, celle-ci ne sont pas encore implémentées, idem
 pour les traductions. </P>
 <P>Si vous voulez contribuez n'hésitez pas :
 <url url="http://mail.nongnu.org/mailman/listinfo/phpcompta-contrib" name="Mailing List Contribution">
 <newline> Si vous avez besoin d'aide
 <url url="http://mail.nongnu.org/mailman/listinfo/phpcompta-support" name="Mailing List support">.
 </p>
<sect> Quel le nom du soft ??
<p>
<verb>
 - phpcompta,
 - wcompta,
 - webcompta
 </verb>

 </p>
 <p>
En fait c'est phpcompta, bien qu'au départ c'était wcompta, contraction de
 WebCompta mais malheureusement, c'est le nom d'un soft qui existait
 déjà, j'ai été obligé de changer vers phpcompta.
</p>
<p>
Cependant PhpCompta est un nom temporaire, il sera changé le jour où
quelqu'un proposera mieux. Si ce nom doit être changé, c'est par respect envers
l'équipe de Php qui ne souhaite pas que le mot Php soit réutilisé dans d'autres
applications.
</p>
</sect>
<sect>Par où commence t'on et comment ?
<p>

 Étape 1, créer un dossier, qui contiendra la comptabilité d'une
 entreprise (sur 1 an ou plus).
  <itemize>
 <item> Menu Administration -> Dossier, choisir un nom pour le dossier, create
 folder

 <item> Étape 2, on peut créer des utilisateurs mais ce n'est pas obligatoire.

 <item> Étape 3, on revient à l'accueil :)

</itemize>
</p>
<p>
 Si vous avez pris Comptabilité basique, vous devrez créer les journaux,
 les fiches, mettre à jour votre plan comptable... Allez voir dans le
 répertoire doc du tarball
</p>
</sect>
<sect>Ou trouvez les patches
<p>
Sur  <url url="http://www.phpcompta.org/" name="Site phpcompta"> la page d'origine,
 malheureusement, il n'est pas encore possible de télécharger des fichiers sur Savannah
</p>
</sect>
<sect>Comment adapter le fichier php.ini <label id="php-setting">
<p>
<quote>
Avec PHP 4.3.1 :
	Les variables sont passés de page en page dans un tableau _POST[nom_var] alors
	qu'avec les versions précédentes, on y accédait directement avec $nom_var
	voir la variable register_globale = off dans le php.ini
</quote>

php.ini doit contenir pour phpcompta, cependant il n'est pas certain qu'il faille changer 
ces paramètres, vous devez aller sur admin/setup.php pour voir ce qui doit être fait
 <verb>
[PHP]
include_path=".:../include:../../include:addon"
[Session]
session.name              = PHPSESSID
                                    ; name of the session
                                    ; is used as cookie name
session.auto_start        = 1       ; initialize session on request startup
session.cookie_lifetime   = 0       ; lifetime in seconds of cookie
                                    ; or if 0, until browser is restarted
session.cookie_path       = /tmp       ; the path the cookie is valid for
</verb>
lors de l'installation (admin/setup.php), on vérifie que toutes les paramètres d'initialisation sont
corrects.

</sect>
<sect>Quand  réinitialise t-on le mot de passe, que vaut-il ?
<p>phpcompta</p>
<sect>Quel est l'utilisateur et le mot de passe par défaut?
<p>
l'utilisateur et le mot de passe par défaut sont phpcompta/phpcompta,
l'utilisateur demo a aussi phpcompta comme mot de passe.
</p>
</sect>
<sect>J'ai trouvé un tit bug, comment faire un patchs ??<label id="bug">
<p>
Le plus simplement du monde : d'abord récupérez le projet ,
corrigez le problème que vous avez détecté, placez-vous à la
racine du projet et vous tapez :
<verb>
cvs diff -rrelease -u > patch-date-email
</verb>
Pensez à d'abord effacer les fichiers inutiles, les ~, les corefiles...
Vous pouvez envoyer le fichier résultat. Pensez à me dire si c'est un
patch relatif aux cvs ou non. Mais testez-le avant.
remplacer release par la release (allez sur savannah, browse CVS pour connaitre
le nom du tag que vous voulez)
</p>
<p> Pour tester les patch,
<p>
Pour le tester, faites un cvs co dans un autre répertoire que celui où vous
avez développé votre patch, puis essayer votre patch
<verb>
patch -p0 &lt; patch-(numéro de version)-votre-email </verb>si vous êtes dans le
répertoire au-dessus de celui de phpcompta
<verb>patch -p1 &lt; patch-(numéro de version)-votre-email</verb> si vous êtes dans le
répertoire courant de phpcompta
</p>
<p>
Si cela ne marche pas ce n'est pas bon
</p>

</sect>
<sect> Comment faire de la doc
<p>
Sous Mandriva (anciennement mandrake), ajouter les linuxdocs-tools avec la commande
urpmi linuxdoc-tools, pour Ubuntu apt-get install linuxdoc-tools, tetex, tetex-extra
les autres, je ne sais pas :(
</p>
<p>
Une fois, les linuxdoc tools installés il peut être nécessaire
d'installer d'autres outils comme jade, sgml,...
Il faudra en tout cas ajouter les tetex-dvips, textex-xdvi, latex2html

<p>
De toute façon, vous
pouvez imprimer le guide, pour le trouver faites :
<verb> en mode commande : rpm -qil linuxdoc-tools|grep guide</verb>
</p>
<p>Jetez aussi un oeil sur les exemples, vous verrez c'est assez simple
<verb>en mode commande:  rpm -qil linuxdoc-tools|grep example</verb>
</p>
<p>
Ensuite, editez le fichier sgml,
et surtout pensez à utilisez aspell -H --lang=fr_FR check FA-fr.sgml pour
véifier l'orthographe. Pour le visionner, faites linuxdoc -B html FAQ.sgml
soit linuxdoc -B rtf pour avoir un fichier rtf... Puis faites un patch :-) 
<ref id="bug" name="Comment faire un patch">
</p>
<sect>Comment contribuer ?
<p>Sur le site de Savannah, j'ai décidé d'utilisé le Task Manager,
chacun s'organise comme il veut, soit il  m'envoie son travail par email soit il
se joint au projet. Je préfère que l'on travaille par email au début.
</p>
<p>
L'intérêt de ce système est de pouvoir voir le suivi mais aussi d'ajouter des commentaires
sur un sujet
<url url="http://savannah.nongnu.org/task/?group=phpcompta" name="PhpCompta Task Manager">.
</p>
<p>
Cela m'évite de devoir chaque fois changer sur le site de phpcompta
</p>
</sect>

</sect>
<sect> Comment appliquer un patch ?
<p>
<sect1>Quel patch utiliser ?
<p>
Dans certains cas, le dernier patch ne reprend PAS les autres,
il faudra lire la release note du patch
pour savoir ce qu'il faut appliquer avant. En règle générale, il
faut appliquer les patch dans l'ordre : le premier, puis le second...

Sinon, les patchs sont toujours nommés ainsi
<bf>path-(numéro_version)-(numéro_de_path).tgz</bf>

exemple
path-r092-1.tgz, est le premier patch pour la release 0.9.2

</p>
</sect1>
<sect1> Comment appliquer le patch
<p>
Après l'avoir téléchargé, allez dans le répertoire de PhpCompta, c'est-à-dire celui qui contient les sources
<enum>
<item>Décompresser le patch (gzunip patch-...)
<item>puis appliquez le patch -p0 &lt; patch...
</enum>


</p>
</sect1>
</sect>
<sect>Les entêtes de facture
<p> Pourquoi les coordonnées de la société faisant la facture n'apparraissent-ils pas ?

Parce que vous n'avez pas rempli les coordonnées de votre société dans les paramètres ou 
parce que votre modèle n'en contenait pas.

</sect>
<sect> Problèmes fréquents
<sect1> Impossible de se logguer
<p> Il faut contrôler le fichier log d'Apache

</sect1>
<sect1> J'ai le message d'erreur 'cannot find file ....'
<p> Dans votre php.ini, n'oubliez pas de mettre correctement le include_patch voir php-setting
<ref id="php-setting" name="Php">


</sect1>
</sect>
<sect> Je reçois une erreur postgresql à propos d'une table log qui n'existe pas
<p>
C'est normal, les sortie de déboggage sont envoyées dans une base de données, ce
qui facilite la recherche, le tri,...

<p> Vous avez deux possibilités,
  <itemize>
 <item>soit vous changez dans le fichier include/constant.php, define ("DEBUG","true"); par
 define ("DEBUG","false");

 <item> Se connecter en tant que postgres et taper les commandes
 <verb>
 createdb -h localhost -O phpcompta log
 psql -h localhost -U phpcompta -f sql/log/log.sql log
 </verb>
</itemize>
</p>
</sect>
<sect>Après avoir installé la version 1.1.0, les périodes centralisées ne le sont plus
<p> Oui, c'est tout-à-fait normal, la période 1.1.0 introduit plusieurs changements dont par exemple,
les numéros d'opérations et de pièces justificatives.

<p>C'est à cause de cela, qu'il faut re-centraliser.

</sect>
<sect>J'ai toujours des timeouts
<p>Soit vous augmentez le timeout de votre server http soit vous mettez l'option fsync=N dans
le fichier de configuration de PostgreSql ou encore changer dans votre php.ini le paramètre 
max_execution_time soit dans le fichier .htaccess, soit dans le fichier php.ini soit dans la 
définition de votre virtual host dans la configuration d'apache.

</sect>
<sect>Mais où sont les rapports prédéfini
<p>Parce que les rapports peuvent toujours être facilement adaptés,
ils sont inclus dans le produit mais pas installé. Pour les trouver,
allez simplement dans le répertoire contrib/rapport et exécutez les
scripts sql soit grâce à pgAdmin soit en ligne de commande ou soit avec
l'outil PhpPgAdmin.

</sect>
<sect>Developpeur
<p> Les développeurs trouveront toutes la documentation dans doc/developper.
Pour la base de données, j'utilise postgresql_autodoc et pour php, doxygen.

</sect>
</article>