{"id":5835,"date":"2025-04-05T06:52:15","date_gmt":"2025-04-05T13:52:15","guid":{"rendered":"https:\/\/w4os.org\/news-fr\/2025\/04\/opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats\/"},"modified":"2025-04-05T07:37:40","modified_gmt":"2025-04-05T14:37:40","slug":"opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats","status":"publish","type":"post","link":"https:\/\/w4os.org\/fr\/news-fr\/2025\/04\/opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats\/","title":{"rendered":"OpenSim Helpers se dote d&rsquo;une documentation et d&rsquo;un site d\u00e9di\u00e9"},"content":{"rendered":"\n<p><strong>OpenSim Helpers<\/strong>, la biblioth\u00e8que au c\u0153ur du plugin&nbsp;<strong>w4os<\/strong>, dispose enfin d\u2019instructions d\u2019installation claires \u2014 et de son propre site web :&nbsp;<a class=\"\" href=\"https:\/\/opensimulator-helpers.dev\/\">https:\/\/opensimulator-helpers.dev\/<\/a>. C\u2019\u00e9tait attendu depuis longtemps.<\/p>\n\n\n\n<p>Suite aux retours des utilisateurs, nous avons travaill\u00e9 dur pour rendre l\u2019installation des helpers plus simple. Comme toujours, c\u2019est un travail en cours, mais c\u2019est d\u00e9j\u00e0 une nette am\u00e9lioration.<\/p>\n\n\n\n<p><strong>OpenSim Helpers<\/strong>\u00a0(anciennement\u00a0<em>Flexible Helpers Scripts<\/em>) est une collection de scripts et de biblioth\u00e8ques web utilis\u00e9s en compl\u00e9ment d\u2019une installation OpenSimulator. Ils sont utilis\u00e9s par des grilles ou des simulateurs <em>standalone<\/em> pour fournir des fonctionnalit\u00e9s non incluses dans le noyau d\u2019OpenSimulator et n\u00e9cessitant une impl\u00e9mentation c\u00f4t\u00e9 web : recherche, transactions financi\u00e8res, transfert de messages hors ligne\u2026<\/p>\n\n\n\n<p>Les helpers sont inclus dans le plugin\u00a0<strong>w4os<\/strong>, mais ils sont \u00e9galement disponibles comme biblioth\u00e8que autonome, ce qui permet de les int\u00e9grer \u00e0 n\u2019importe quel site web, avec ou sans CMS. Ils sont g\u00e9n\u00e9ralement install\u00e9s dans un sous-dossier, par exemple\u00a0<em>example.org\/helpers<\/em>.<\/p>\n\n\n\n<p>Les helpers peuvent aussi \u00eatre install\u00e9s s\u00e9par\u00e9ment, en compl\u00e9ment d\u2019une interface web comme&nbsp;<strong>w4os<\/strong>, pour am\u00e9liorer les performances.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Caract\u00e9ristiques actuelles<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Recherche dans le monde<\/strong> &#8211; Recherchez des lieux, des terrains \u00e0 vendre, des petites annonces et des \u00e9v\u00e9nements \u00e0 partir du panneau de recherche classique du viewer.<\/li>\n\n\n\n<li><strong>Monnaie<\/strong> &#8211; Permet des transactions telles que la vente de terres ou d&rsquo;objets, le paiement d&rsquo;avatars. Peut \u00eatre configur\u00e9 avec des services tiers comme Gloebit ou Podex, ou m\u00eame localement (une  monnaie m\u00eame fausse est n\u00e9cessaire pour des fonctions telles que le transfert gratuit de terrains ou la cr\u00e9ation de groupes).<\/li>\n\n\n\n<li><strong>Land tool<\/strong> &#8211; Permet les transactions de terrains (gratuites ou payantes)<\/li>\n\n\n\n<li><strong>Transfert des messages hors ligne<\/strong> &#8211; Transfert par e-mail des messages priv\u00e9s envoy\u00e9s \u00e0 un avatar hors ligne (activation dans les param\u00e8tres du viewer).<\/li>\n\n\n\n<li><strong>Guide de destination<\/strong> &#8211; Prise en charge du guide de destination des viewers v3.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Instructions d&rsquo;installation<\/h2>\n\n\n\n<p><strong>OpenSim Helpers<\/strong> regroupe des scripts, certains nouvellement d\u00e9velopp\u00e9s, d\u2019autres provenant de projets existants. Ils ont \u00e9t\u00e9 unifi\u00e9s pour simplifier la configuration. Mais OpenSimulator \u00e9tant ce qu\u2019il est, l\u2019installation peut rester d\u00e9licate \u2014 surtout sans documentation.<\/p>\n\n\n\n<p>Ce manque est d\u00e9sormais combl\u00e9 : les \u00e9tapes d\u2019installation sont d\u00e9taill\u00e9es dans le fichier <strong>INSTALLATION.md<\/strong>. Cela devrait offrir une aide bienvenue aux nouveaux utilisateurs.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Nouveau site web<\/h2>\n\n\n\n<p>Les projets open source sont g\u00e9n\u00e9ralement h\u00e9berg\u00e9s sur des plateformes comme GitHub \u2014 c\u2019est le cas de\u00a0<a class=\"\" href=\"https:\/\/github.com\/magicoli\/opensim-helpers\">opensim-helpers<\/a>. Mais tous les utilisateurs potentiels ne sont pas familiers avec ces outils. C\u2019est pourquoi nous avons cr\u00e9\u00e9 un site web d\u00e9di\u00e9, simple et centr\u00e9 sur l\u2019essentiel :<\/p>\n\n\n\n<div class=\"wp-block-buttons is-content-justification-center is-layout-flex wp-container-core-buttons-is-layout-16018d1d wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button\"><a class=\"wp-block-button__link has-text-align-center wp-element-button\">https:\/\/opensim-helpers.dev<\/a><\/div>\n<\/div>\n\n\n\n<p class=\"has-text-align-left\">Ce n\u2019est pas un site tape-\u00e0-l\u2019\u0153il. L\u2019objectif est de rester simple et clair \u2014\u00a0sans les fioritures de GitHub\u00a0\u2014 et d\u2019\u00e9viter les contraintes d&rsquo;une maintenance manuelle.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">En passant : l\u2019outil de g\u00e9n\u00e9ration du site<\/h3>\n\n\n\n<p>Comme toutes les informations utiles sont d\u00e9j\u00e0 pr\u00e9sentes dans le d\u00e9p\u00f4t GitHub (sous forme de fichiers Markdown), nous avons d\u00e9velopp\u00e9 un outil d\u00e9di\u00e9 qui synchronise automatiquement le site \u00e0 partir du d\u00e9p\u00f4t. Ainsi, le site reste toujours \u00e0 jour avec la documentation r\u00e9dig\u00e9e \u00e0 la vol\u00e9e par les d\u00e9veloppeurs.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>G\u00e9n\u00e8re un site statique<\/strong> pour des performances optimales et une faible charge serveur (pages mises \u00e0 jour r\u00e9guli\u00e8rement via cron)<\/li>\n\n\n\n<li><strong>Utilise Bootstrap<\/strong> pour une mise en page propre, responsive et l\u00e9g\u00e8re<\/li>\n\n\n\n<li><strong>Pages basiques<\/strong> \u00e0 partir des fichiers\u00a0<code>.md<\/code>\u00a0(ex :\u00a0<code>README.md<\/code>\u00a0comme page d\u2019accueil,\u00a0<code>INSTALLATION.md<\/code>,\u00a0<code>TROUBLESHOOTING.md<\/code>,\u00a0<code>CHANGELOG.md<\/code>, ajout\u00e9s automatiquement au menu)<\/li>\n\n\n\n<li><strong>Page de t\u00e9l\u00e9chargement<\/strong> (derni\u00e8re version stable et instructions pour la version de d\u00e9veloppement)<\/li>\n\n\n\n<li><strong>Page de support<\/strong> (avec une pr\u00e9f\u00e9rence pour l\u2019usage des issues GitHub)<\/li>\n\n\n\n<li><strong>Page de dons<\/strong> (li\u00e9e \u00e0 GitHub Sponsors)<\/li>\n<\/ul>\n\n\n\n<p>Le g\u00e9n\u00e9rateur est lui aussi open source, disponible ici :\u00a0<a class=\"\" href=\"https:\/\/github.com\/magicoli\/php-site-generator\">https:\/\/github.com\/magicoli\/php-site-generator<\/a>.<br>(Il n\u2019a pas son propre site web \u2014\u00a0<em>trop meta<\/em>\u00a0\ud83d\ude05)<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Alternatives<\/h2>\n\n\n\n<p>Comme mentionn\u00e9 plus t\u00f4t, OpenSim Helpers peut \u00eatre utilis\u00e9 comme solution autonome, int\u00e9gr\u00e9 \u00e0 une interface web, ou utilis\u00e9 en parall\u00e8le avec celle-ci.<\/p>\n\n\n\n<p>Le moyen le plus simple est souvent d\u2019installer une interface web compl\u00e8te, qui int\u00e8gre \u00e0 la fois les helpers et les outils n\u00e9cessaires \u00e0 l\u2019inscription, la gestion de compte, etc. Plusieurs projets int\u00e9ressants existent \u2014 avec ou sans CMS \u2014 notamment\u00a0<strong>w4os<\/strong>\u00a0(bien s\u00fbr),\u00a0<strong>OSMW<\/strong>\u00a0et\u00a0<strong>Diva<\/strong>\u00a0: <a class=\"\" href=\"http:\/\/opensimulator.org\/wiki\/Webinterface\">http:\/\/opensimulator.org\/wiki\/Webinterface<\/a>.<\/p>\n\n\n\n<p>Cela dit, dans certains cas, les helpers sont n\u00e9cessaires seuls, pour optimiser les performances ou lorsque l\u2019on ne souhaite pas d\u2019interface compl\u00e8te. La plupart des fonctionnalit\u00e9s offertes par OpenSim Helpers existaient autrefois dans des projets s\u00e9par\u00e9s \u2014 souvent abandonn\u00e9s aujourd\u2019hui. M\u00eame si nous ne les listons pas ici, nous remercions chaleureusement les d\u00e9veloppeurs originaux qui ont permis \u00e0 ce projet d\u2019exister.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Perspectives<\/h2>\n\n\n\n<p>Nous continuerons \u00e0 d\u00e9velopper\u00a0<strong>w4os<\/strong>\u00a0et\u00a0<strong>opensim-helpers<\/strong>\u00a0en parall\u00e8le, afin de garantir la disponibilit\u00e9 et la mise \u00e0 jour \u00e0 la fois d\u2019une interface compl\u00e8te et d\u2019un backend autonome. Certaines fonctionnalit\u00e9s introduites dans\u00a0<strong>w4os<\/strong>\u00a0et\u00a0<strong>2do Directory<\/strong>\u00a0seront migr\u00e9es dans les helpers le moment venu. Nous souhaitons \u00e9galement r\u00e9organiser le projet pour faciliter son int\u00e9gration dans tout type de site.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u00c0 propos de Speculoos World<\/h2>\n\n\n\n<p><strong><a href=\"https:\/\/speculoos.world\/\">Speculoos World<\/a><\/strong>\u00a0est un monde virtuel 3D lanc\u00e9 en 2011, bas\u00e9 sur OpenSimulator. C&rsquo;est le responsable de\u00a0<strong><a href=\"https:\/\/w4os.org\/\">w4os<\/a><\/strong> et\u00a0<strong><a href=\"https:\/\/opensim-helpers.dev\/\">opensim-helpers<\/a><\/strong>, ainsi que plusieurs autres projets li\u00e9s \u00e0 OpenSimulator. D\u2019abord d\u00e9velopp\u00e9s pour les besoins de la grille Speculoos, ces outils ont \u00e9t\u00e9 rendus open source pour en faire b\u00e9n\u00e9ficier l\u2019ensemble de la communaut\u00e9 OpenSimulator.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>OpenSim Helpers, la biblioth\u00e8que au c\u0153ur du plugin&nbsp;w4os, dispose enfin d\u2019instructions d\u2019installation claires \u2014 et de son propre site web :&nbsp;https:\/\/opensimulator-helpers.dev\/. C\u2019\u00e9tait attendu depuis longtemps. Suite aux retours des utilisateurs, nous avons travaill\u00e9 dur pour rendre l\u2019installation des helpers plus simple. Comme toujours, c\u2019est un travail en cours, mais c\u2019est d\u00e9j\u00e0 une nette am\u00e9lioration. OpenSim&hellip; <a class=\"more-link\" href=\"https:\/\/w4os.org\/fr\/news-fr\/2025\/04\/opensim-helpers-se-dote-dune-documentation-et-dun-site-adequats\/\">Poursuivre la lecture <span class=\"screen-reader-text\">OpenSim Helpers se dote d&rsquo;une documentation et d&rsquo;un site d\u00e9di\u00e9<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[20],"tags":[58,41,182,42],"class_list":["post-5835","post","type-post","status-publish","format-standard","hentry","category-news-fr","tag-interface-internet","tag-opensimulator-fr","tag-source-ouverte","tag-w4os-fr","entry"],"_links":{"self":[{"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/posts\/5835","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/comments?post=5835"}],"version-history":[{"count":3,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/posts\/5835\/revisions"}],"predecessor-version":[{"id":5849,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/posts\/5835\/revisions\/5849"}],"wp:attachment":[{"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/media?parent=5835"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/categories?post=5835"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/w4os.org\/fr\/wp-json\/wp\/v2\/tags?post=5835"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}