Après mon cours intensif accéléré Smarty, je replonge dans le code Piwigo, histoire de peaufiner ma culture personnelle ...
Pour repérer les fonctions, variables, etc. y a-t-il une documentation développeur consultable par le commun des mortels ? ou faut-il explorer en détail les modules des différents répertoires ?
Hors ligne
La documentation développeur (plugin surtout) est une point à ne pas négliger afin d'attirer le plus de candidats possible et afin de leurs donner les meilleurs moyens de sortir des plugins efficaces.
Pour moi c'est très important pour le développement de Piwigo.
Hors ligne
Pour les évènements, il existe le plugin EventTracer qui les listes.
Mis à part çà, faut lire le source :)
Hors ligne
grum a écrit:
Pour les évènements, il existe le plugin EventTracer qui les listes.
Merci pour le tuyau.
grum a écrit:
Mis à part çà, faut lire le source :)
C'est ce que j'avais commencé à faire ... mais j'espérais néanmoins trouver une "cartographie" quelconque de fonctions, variables, etc qui m'aurait permis d'éviter de chercher 25 aiguilles en même temps dans 35 meules de foin différentes ;)
Hors ligne
au début, je m'étais fait une espèce de cartographie des fonctions et données importantes.
pis j'ai laissé tombé : trop lourd à maintenir ^^;
Hors ligne
grum a écrit:
au début, je m'étais fait une espèce de cartographie des fonctions et données importantes.
pis j'ai laissé tombé : trop lourd à maintenir ^^;
D'autant plus que c'est justement au début qu'on en a besoin ! Après, on est en terrain connu ;)
Hors ligne
Je déplace le sujet dans une autre section du forum car elle concerne pour moi "l'outillage" pour Piwigo :-)
Hors ligne
Gotcha a écrit:
Je déplace le sujet dans une autre section du forum car elle concerne pour moi "l'outillage" pour Piwigo :-)
En fait, j'ai peut-être mal posé ma question ; mais là, j'avais bien la casquette de l'utilisateur/développeur qui cherchait de l'info ;)
Hors ligne
Il n'y a pas très longtemps (moins de 1 an), laurent.duretz avait proposé la mise en place de PHPXref et ça me semble être déjà un bon outil pour comprendre l'organisation du code dans Piwigo (qui include qui)
Hors ligne
Veux-tu dire que cet outil est capable d'analyser du code existant, même s'il ne comporte pas de balises ou commentaires spécifiques ? (pas pris le temps de regarder avant de poster).
Hors ligne
tosca a écrit:
Veux-tu dire que cet outil est capable d'analyser du code existant, même s'il ne comporte pas de balises ou commentaires spécifiques ? (pas pris le temps de regarder avant de poster).
oui, c'est le principe de ce logiciel. Maintenant de là à dire qu'il va te donner toutes les infos dont tu rêves, il y a un pas, que je ne vais pas franchir.
Hors ligne
plg a écrit:
oui, c'est le principe de ce logiciel. Maintenant de là à dire qu'il va te donner toutes les infos dont tu rêves, il y a un pas, que je ne vais pas franchir.
Je vais tâcher de ne pas me laisser emporter par mes fantasmes :D
Merci de la piste en tout cas.
Hors ligne
au même titre que doxygen (que j'utilisais régulièrement pdt mes études, et que je trouve très bien..., je vais tester phpxref pour voir), sans un minimum de tag et de description dans le source, seule la structure du code est récupérable.
Petit message subliminal aux devs, la mise en place de commentaire de base dans le source c'est bien! :)
[PS.] moi même je commente rarement...[/PS]
Hors ligne
datajulien a écrit:
[PS.] moi même je commente rarement...[/PS]
Thème de méditation : "C'est toujours dans le code des autres qu'on souhaite trouver des commentaires."
Hors ligne
Très impressionnant ! Une fois résolus deux micros-problèmes ( "comment fait-on au juste pour lancer un programme en Perl ?" ;) puis répertoire du fichier "output" inexistant), le résultat est produit en moins d'une minute.
Processing Piwigo... Source.............: /home/marie-noelle/Downloads/phpxref-0.7/../Piwigo/piwigo-2.0.6 Target.............: /home/marie-noelle/Downloads/phpxref-0.7/output Scanning Tree......: OK - 1063 files to process Pass One...........: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% Generating Output..: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% Variable references: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% Function references: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% Class references...: 0%..30%..40%..50%..80%..90%..100% Constant references: 0%..10%..20%..30%..40%..50%..60%..70%..80%..90%..100% Table references...: Some values were referenced in require and include statements for which no value could be found in the configuration file so cross-referencing may be incomplete: Unknown constant names (ref count): S (2), SMARTY_CORE_DIR (53), _ (24), UPGRADES_PATH (2), PHPWG_ROOT_PATH (297), LOCALEDIT_PATH (4), SMARTY_DIR (2), PHPWG_PLUGINS_PATH (1) Unknown variable names (ref count): $page (1), $config_file (1), $_compile_file (1), $file_to_include (4), $file_name (1), $user (1), $smarty (1), $root (1), $_plugin_file (1), $method (1), $theme (1), $this (3), $upgrade_file (1), $styles (1), $source_file (1), $my_path (1), $filename (3), $_smarty_compile_path (3), $func (1), $upgrade_id (2) Summary statistics: Files Scanned: 1063 containing 132043 lines 2847 variable names in 6417 definitions and 55324 references. 1233 function/method names in 1013 definitions and 13142 references. 158 constant names in 238 definitions and 2677 references. 52 class names in 53 definitions and 377 references. 0 table names in 0 references.
Provisoirement, j'ai fait l'impasse sur les tables car je n'ai pas installé de BD Piwigo en local, mais j'y reviendrai.
Il ne me reste plus qu'à explorer ...
(PJ : copie écran de consultation)
Dernière modification par tosca (2009-12-17 19:33:47)
Hors ligne