Méthode de développement

NOALYSS est développé en MVC et utilise beaucoup l'objet.

Nous avons détaillé la méthode de développement, elle se trouve aussi dans le manuel, à télécharger sur http://download.noalyss.eu

Vous pouvez aussi la lire en ligne

Tout le code est hébergé sur savannah.org

https://savannah.nongnu.org/projects/noalyss-plugins

et

https://savannah.nongnu.org/projects/noalyss

Afin d'obtenir le trunk, pour suivre le développement, prenez-le depuis le repository git sur htts://savannah.nongnu.org

git clone git://git.savannah.nongnu.org/noalyss.git

git clone git://git.savannah.nongnu.org/noalyss-plugins.git

Configurez maintenant votre environnement :

Vérifier si une tâche ou l'autre correspond à ce que vous voulez faire. Dans tous les cas, pensez à venir sur la Mailing list pour en discuter L'agenda se trouve ici.

En général, on utilise des tâches ou bugs pour le suivi.

PhpStorm , eclipse ou netbeans sont fortement conseillés.

Netbeans vient avec tout ce dont vous avez besoin pour le PHP, pour Eclipse, il faudra ajouter les plugins git, PDT

Téléchargement de Netbeans

Tutoriel pour Eclipse avec PHP

PhpStorm

CodeLite

Atom

Possibilité de débugguer le code http://netbeans.org/kb/docs/php/debugging.html
développement facilité (html, html5, auto-completion, recherche, parcourir facilement le code,…) http://netbeans.org/kb/trails/php.html

git
pgadmin3 https://www.pgadmin.org/
xdebug
firebug
easy xdebug
doxygen http://www.stack.nl/~dimitri/doxygen/
dbeaver https://dbeaver.io/

1. Nommage Les fonctions sont en minuscule, verbe + action séparé par un souligné Les classes commencent toujours une lettre capitale

2. Documentation Dans la mesure du possible, documentez votre code en respectant les tags Doxygen. La documentation du code source est accessible en ligne ou dans le fichier de noalyss télécharger dans le répertoire doc

Plus d'information : Code avec Doxygen

3. Traduction Tous les textes (en français) doivent être entourés de _(): exemple

  $msg="Valide";
   echo "Bonjour";

deviennent

  $msg=_("Valide");
  echo _('Bonjour');

Cela permet aux scripts dans dev/ de retrouver les chaînes à traduire GETTEXT

Afin de soumettre un patch , vous devez d'abord “cloner” la base de données (voir plus haut) ,

Ensuite vous créer votre propre branch soit à partir de UNSTABLE ou STABLE : UNSTABLE si c'est un développement pour la prochaine version, soit STABLE si c'est une correction de bug à mettre de la version STABLE.

Example :

git switch stable # ou unstable
git checkout -b mon_dev1

Puis après avoir modifié et testé , vous devez faire

git format-patch unstable..mon_dev1

Automatiquement des fichiers contenant les patch vont être générés, vous devez les envoyer et ils seront intégrés : compressez et envoyez le fichier obtenu sur la ML contrib.

Si vous souhaitez plus d'information sur les patches https://ariejan.net/2009/10/26/how-to-create-and-apply-a-patch-with-git/

Si vous souhaitez seulement être au courant de l'évolution, vous pouvez soit