OpenSim Helpers ottiene una documentazione e un sito appropriati

OpenSim Helpers, la libreria alla base del plugin w4os, ha finalmente delle istruzioni di installazione adeguate e un proprio sito web: https://opensimulator-helpers.dev/. Questo era atteso da tempo.

In seguito al feedback degli utenti, abbiamo lavorato duramente per rendere più semplice l’installazione degli helper standalone. Come al solito, si tratta di un lavoro in corso, ma è già un enorme miglioramento.

OpenSim Helpers (in precedenza Flexible Helpers Scripts) è una raccolta di script e librerie web utilizzati a fianco di un’installazione di OpenSimulator. Vengono utilizzati dalle griglie o dai simulatori autonomi per fornire funzionalità non incluse nel nucleo di OpenSim, che richiedono un’implementazione sul lato web, come la ricerca, le transazioni finanziarie e l’inoltro di messaggi offline.

Gli helper vengono forniti con il plugin w4os ma sono disponibili anche come libreria indipendente, consentendo l’integrazione in qualsiasi sito web, indipendentemente dal fatto che utilizzi un CMS. In questi casi, di solito vengono installati in una sottocartella, come example.org/helpers.

Opzionalmente, gli helper possono essere installati anche in modo indipendente, insieme a un’interfaccia web come w4os, per migliorare le prestazioni.

Caratteristiche attuali

  • Ricerca nel mondo – Cerca luoghi, terreni in vendita, annunci ed eventi dal classico pannello di ricerca del visore.
  • Valuta – Consente di effettuare transazioni come la vendita di terreni o oggetti, il pagamento di avatar. Può essere configurata con servizi di terze parti come Gloebit o Podex, o anche localmente. (Anche la valuta fittizia è necessaria per funzioni come la vendita gratuita di terreni o la creazione di gruppi).
  • Strumento terreno – Abilita le transazioni di parcelle (gratuite o a pagamento)
  • Inoltro di messaggi offline – Inoltra i messaggi di messaggistica istantanea offline agli indirizzi e-mail degli avatar (richiede l’abilitazione nelle impostazioni del visualizzatore).
  • Guida di destinazione – Supporto per la guida di destinazione del visualizzatore v3

Istruzioni per l’installazione

Gli OpenSim Helpers sono costituiti da script, alcuni scritti di recente e altri inizialmente raccolti da vari progetti precedenti. Sono stati unificati per semplificare la configurazione. Tuttavia, essendo OpenSimulator quello che è, la configurazione può essere ancora complicata, soprattutto in assenza di documentazione.

Questa lacuna è stata colmata: i passaggi per l’installazione sono documentati nel file INSTALLATION.md. Dovrebbe offrire una guida utile agli utenti che non conoscono la libreria.

Nuovo sito web

I progetti open source sono tipicamente ospitati su piattaforme come GitHub – e lo stesso vale per opensim-helpers(https://github.com/magicoli/opensim-helpers). Ma non tutti i potenziali utenti hanno familiarità con queste piattaforme. Ecco perché abbiamo creato un sito web semplice e dedicato al progetto, focalizzato sull’essenziale.

Non è un sistema sofisticato. L’obiettivo è quello di mantenerlo pulito e semplice – senza le campane e i fischietti di GitHub – e di evitare il fastidio della manutenzione manuale.

Nota a margine: lo strumento di generazione di siti web

Poiché tutte le informazioni chiave sono già presenti nel repository GitHub (come file Markdown), abbiamo sviluppato uno strumento dedicato per sincronizzare il sito web direttamente dal repo. In questo modo, il sito rimane automaticamente aggiornato con la documentazione creata dagli sviluppatori.

  • Genera un sito web statico per garantire prestazioni e carico minimo del server (le pagine vengono aggiornate regolarmente tramite cron).
  • Utilizza Bootstrap per un layout pulito, reattivo e leggero
  • Crea pagine di base dai file .md (ad esempio, README.md come homepage, altre come INSTALLATION.md, TROUBLESHOOTING.md, CHANGELOG.md aggiunte al menu).
  • Fornisce una pagina di download (l’ultima versione stabile e le istruzioni per l’installazione di dev)
  • Include una pagina di supporto (incoraggiando l’uso dei problemi di GitHub)
  • Offre una pagina per le donazioni (collegata a GitHub Sponsors)

Il generatore stesso è anche open source e disponibile qui: https://github.com/magicoli/php-site-generator.
(Non ha un proprio sito web – quindi meta 😅)

Alternative

Come accennato in precedenza, OpenSimulator Helpers può essere installato come soluzione indipendente, integrato con un’interfaccia web o utilizzato in combinazione con essa.

L’opzione più semplice è spesso quella di installare un’interfaccia web completa, che di solito include gli helper insieme agli strumenti per la registrazione degli utenti, la gestione degli account, ecc. Esistono diversi progetti interessanti – con o senza CMS – in particolare w4os (ovviamente), OSMW e Diva:
http://opensimulator.org/wiki/Webinterface

Detto questo, in alcuni casi ha più senso eseguire gli helper in modo indipendente, per motivi di prestazioni o quando non è necessaria un’interfaccia. Molte delle funzioni ora incluse in OpenSim Helpers erano disponibili in passato in progetti separati, spesso abbandonati. Anche se non le elencheremo tutte, siamo grati agli sviluppatori originali il cui lavoro ha gettato le basi per questa libreria.


Guardare avanti

Continueremo a sviluppare sia w4os che opensim-helpers in parallelo, assicurandoci che sia l’interfaccia web completa che il backend standalone rimangano aggiornati. Alcune funzionalità introdotte in w4os e nel progetto 2do Directory saranno migrate negli helper quando sarà opportuno. Abbiamo anche in programma di riorganizzare il codice per facilitare l’integrazione tra i vari progetti.

Informazioni sul mondo Speculoos

Speculoos World è un mondo virtuale in 3D creato nel 2011 e basato su OpenSimulator. Mantiene sia il w4os e opensim-helpersinsieme a diversi altri progetti legati a OpenSim. Originariamente costruiti per soddisfare le esigenze della griglia di Speculoos, sono stati resi disponibili per essere condivisi con la più ampia comunità di OpenSimulator.

avatar profile picture

Di Magic Oli

Web developer, web designer, infographist and singer.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *