Différences

Ci-dessous, les différences entre deux révisions de la page.

--- dev:documentation [2012/01/06 12:44] – darknoon
+++ fr:developpers:documentation [Date inconnue] (Version actuelle) – supprimée - modification externe (Date inconnue) 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
-====== Documentation développeurs ======
-===== OGSpy =====
-[[dev:ogspy:documentation|Documentation Développeur OGSpy]]
-[[dev:ogspy:documentation_mod|Documentation Création Mod OGSpy]]
-===== Xtense pour Firefox =====
-[[dev:Xtense:documentation|Documentation Développeur Xtense Firefox]]
-===== Xtense GreseMonkey =====
-[[dev:Xtense:documentation|Documentation Développeur Xtense Grease Monkey]]
-==== Le cache d'OGSpy ====
-FIXME
-===== Développements des Mods =====
-==== Tuto de création d'un mod pour OGSpy ====
-Vous allez ici apprendre a créer de nouveaux mods en php pour OGSpy tout en respectant sa sécurité, se variables et ces protocoles
-===Les variables OGSpy===
-Sur notre plateforme, tout a été fait pour que le module en ai le moins a faire (et oui, on est tous des glandeurs alors autant en profiter a fond =p)
-Pas besoin de lancer de connexions a la base de données dans vos mods, c'est déjà fait...
-je vous donne la liste des classes que vous pouvez utiliser a la place des fonctions usuelles:
-<PHP>
-mysql_query( => $db->sql_query( //permet d'insérer quelque chose dans la base de donnée
-mysql_insert_id( => $db->sql_insertid //permet de récupérer l'id du dernier élément inséré
-mysql_fetch_assoc( => $db->sql_fetch_assoc( //permet de récupérer un tableau de valeur avec le nom des champs
-mysql_fetch_array( => sql_fetch_row( //permet de récupérer un tableau ordonnée dans l'ordre de la demande
-mysql_num_rows( => $db->sql_numrows( //permet de conter le nombre de ligne retourné par la dernière demande
-mysql_affected_rows( => $db->sql_affectedrows( //permet de copter le nombre de lignes affectés par la dernière demande
-</PHP>
-pour une raison de sécurité, tout les post et les get on été remplacé, ce qui est beaucoup plus simple a lire et a programmer
-<PHP>
-$_POST['exemple'] => $pub_exemple
-$_GET['exemple'] => $pub_exemple
-</PHP>
-en ce qui concerne les tables d'OGSpy de base, vous avez le droit d'insérer des éléments dedans, ou de supprimer celles que vous avez mises mais vous avez en aucun cas, le droit de les supprimer ou de les altérer, par contre vous avez le droit de créer vos propres tables
-n'oubliez pas lors de la création de vos tables que le préfixe existe et peux changer... c'est pour cela que j vous conseille de définir vos table en haut de la page comme ceci:
-<PHP>
-define("TABLE_EXEMPLE", $table_prefix."exemple");
-</PHP>
-et voici la liste des tables ogspy:
-<PHP>
-define("TABLE_CONFIG", $table_prefix."config");
-define("TABLE_GROUP", $table_prefix."group");
-define("TABLE_RANK_PLAYER_FLEET", $table_prefix."rank_player_fleet");
-define("TABLE_RANK_PLAYER_POINTS", $table_prefix."rank_player_points");
-define("TABLE_RANK_PLAYER_RESEARCH", $table_prefix."rank_player_research");
-define("TABLE_RANK_ALLY_FLEET", $table_prefix."rank_ally_fleet");
-define("TABLE_RANK_ALLY_POINTS", $table_prefix."rank_ally_points");
-define("TABLE_RANK_ALLY_RESEARCH", $table_prefix."rank_ally_research");
-define("TABLE_SESSIONS", $table_prefix."sessions");
-define("TABLE_SPY", $table_prefix."spy");
-define("TABLE_STATISTIC", $table_prefix."statistics");
-define("TABLE_UNIVERSE", $table_prefix."universe");
-define("TABLE_UNIVERSE_TEMPORARY", $table_prefix."universe_temporary");
-define("TABLE_USER", $table_prefix."user");
-define("TABLE_USER_BUILDING", $table_prefix."user_building");
-define("TABLE_USER_DEFENCE", $table_prefix."user_defence");
-define("TABLE_USER_FLEET", $table_prefix."user_fleet");
-define("TABLE_USER_FAVORITE", $table_prefix."user_favorite");
-define("TABLE_USER_GROUP", $table_prefix."user_group");
-define("TABLE_USER_SPY", $table_prefix."user_spy");
-define("TABLE_USER_TECHNOLOGY", $table_prefix."user_technology");
-define("TABLE_USER_PLANET", $table_prefix."user_planet");
-define("TABLE_MOD", $table_prefix."mod");
-define("TABLE_MOD_CAT", $table_prefix."mod_cat");
-define("TABLE_MOD_RESTRICT", $table_prefix."mod_restrict");
-define("TABLE_PARSEDSPY", $table_prefix."parsedspy");
-define("TABLE_PARSEDRC", $table_prefix."parsedRC");
-define("TABLE_PARSEDRCROUND", $table_prefix."parsedRCRound");
-define("TABLE_ROUND_ATTACK", $table_prefix."round_attack");
-define("TABLE_ROUND_DEFENSE", $table_prefix."round_defense");
-define("TABLE_MP", $table_prefix."mp");
-</PHP>
-dans TABLE_CONFIG se trouve toutes les configurations d'ogspy (allez directment dans phpmyadmin pour voir ce qui peux vous intéresser), alors si vous souhaitez en lire une, utilisez simplement ça:
-<PHP>
-$server_config['lavariable']
-</PHP>
-=== Utilisation du cache ===
-Depuis la version 3.0.8, un systeme de mise en cache a ete implementé.
-Cette mise en cache concerne les tables suivantes :
-<PHP>
-define("TABLE_CONFIG", $table_prefix."config");
-define("TABLE_MOD", $table_prefix."mod");
-define("TABLE_MOD_CAT", $table_prefix."mod_cat");
-define("TABLE_MOD_RESTRICT", $table_prefix."mod_restrict");
-</PHP>
-Si votre module affecte les données de ses différentes tables, il est fortement conseillé de régénérer les fichiers caches par les fonctions suivantes :
-<PHP>
-generate_all_cache(); // régénère tous les caches
-generate_mod_cache(); // ne régénère que le cache mod
-generate_config_cache();// ne régénère que le cache config
-</PHP>
-=== Les fichiers d'installation ===
-Les fichiers install.php, uninstall.php, update.php et version.txt sont nécessaires a l'insertion du mods dans ogspy
-'''install.php''' :
-<file php install.php>
-<?php
-if (!defined('IN_SPYOGAME')) die("Hacking Attempt!");
-//Fichier install
-$is_ok = false;
-$mod_folder = "nom   du dossier   du mod";
-$is_ok = install_mod ($mod_folder);
-//et si tu as pris la fonction boléenne faut que je rajoute sae
-if ($is_ok == true)
-{
-             // Si besoin de creer des tables, à faire ici
-}
-else
-{
-   echo  "<script>alert('Désolé, un problème a eu lieu pendant l'installation, corrigez les problèmes survenue et réessayez.');</script>";
-}
-?>
-</file>
-'''update.php''' :
-<file php update.php>
-<?php
-if (!defined('IN_SPYOGAME')) die("Hacking Attemp!");
-//Fichier update
-$mod_folder = "nom du dossier";
-$mod_name = "nom du mod";
-update_mod($mod_folder, $mod_name);
-?>
-</file>
-ce fichier permet de mettre a jour votre version de mod et votre bdd quand vous changez de version du mod
-'''uninstall.php''' :
-<file php uninstall.php>
-<?php
-if (!defined('IN_SPYOGAME')) die("Hacking Attemp!");
-global $db, $table_prefix;
-$mod_uninstall_name = "nom du mode";
-$mod_uninstall_table = $table_prefix.  "table1";
-uninstall_mod ($mod_uninstall_name, $mod_uninstall_table);
-?>
-</file>
-celui-ci permet de supprimer votre mod d'ogspy et sa bdd si vous en avez mis une (ne pas oublier de le mettre)
-'''version.txt''' :
-<file text version.txt>
-ère ligne = nom du mod
-ème ligne = version du mod
-ème ligne = title, menu, action, root, link, active,admin
-</file>
-et enfin, dans ce fichier, on met le nom du mod et sa version.