w4os – Interface Web pour OpenSimulator 2.7.5 – par Speculoos World

Interface WordPress pour OpenSimulator (w4os).


  • Version 2.7.5
  • WordPress Version 5.3.0
  • Testé jusqu’à la version 6.5
  • PHP Version 7.3
  • Tags OpenSimulator, Second Life, metaverse, avatar, interface web, grilles, autonome, hypergrid, 3D
  • Auteur Speculoos World
  • Lien pour les dons https://w4os.org/donate/

Catégorie :

Interface WordPress prête à l’emploi pour OpenSimulator. Fournit l’enregistrement des utilisateurs, le choix du modèle d’avatar par défaut, les informations de connexion, les statistiques et un serveur de ressources web pour les grilles ou les simulateurs autonomes.

Instructions d’installation complètes :(https://gudulelapointe.github.io/w4os/INSTALLATION.html)

Voir les sections Fonctionnalités et Feuille de route pour les fonctionnalités actuelles et à venir.


  • Création d’avatars:
    • Section OpenSimulator dans la page standard du compte WP
    • Onglet Avatar dans le tableau de bord du compte sur les sites WooCommerce
    • Les mots de passe des avatars et des sites web sont synchronisés
    • Instructions de configuration pour les nouveaux avatars
    • Profil public de l’avatar : extrait du profil de l’avatar
    • Modèles d’avatars: tenues par défaut à choisir lors de l’enregistrement
    • Noms réservés: les avatars dont le prénom ou le nom est “Default”, “Test”, “Admin” ou le nom utilisé pour les modèles d’avatar sont interdits au public (ces avatars doivent être créés par les admins depuis la console Robust).
  • Moteur de recherche: fournit la recherche dans le visualiseur
    • lieux
    • terrains à vendre
    • petites annonces
    • événements (intégration de 2do.directory)
  • Codes courts
    • Informations sur la grille: [grid-info] codde court, bloc Gutenberg et module Divi
    • Statut de la grille: [grid-status] code court, bloc Gutenberg et module Divi
    • Statut de la grille: [popular-places] code court, bloc Gutenberg et module Divi
    • Page de profil: [avatar-profile] code court, bloc Gutenberg et module Divi
  • Serveur de ressources web: le lien nécessaire pour afficher les images du monde virtuel sur un site Web.
  • Assistant de devises: intégration avec Podex, Gloebit et le module monétaire de base
  • Transfert par e-mail des messages hors ligne
  • Synchronisation manuelle et cron des utilisateurs grille/WP
  • Authentification avec les informations d’identification de l’avatar (s’il n’y a aucun compte wp correspondant, en créer un)

Version payante

La version gratuite du répertoire de plugins WordPress et la version payante sont techniquement les mêmes. La seule différence est la façon dont vous soutenez le développement de ce plugin : avec la version gratuite, vous participez à l’expérience de la communauté (veuillez noter et commenter), tandis que la version payante nous aide à consacrer des ressources à ce projet.

  • Robust server must be installed before setting up W4OS.
  • To allow users to choose an avatar on registration, you must enable user
    profiles in Robust.HG.ini (update [UserProfilesService], [ServiceList] and
    [UserProfiles] sections)
  • You should have a working assets server (see Dependencies section below)

WordPress configuration

Before installing this plugin, make sure your WordPress installation is complete and permalinks are enabled.

If upgrading from a different distribution (e.a. switching from github to WordPress Plugin Directory), make sure you disable the installed verssion before activating the new one.

  1. Download and activate the latest stable release
  2. Visit OpenSim settings (admin menu > “Opensim” > “Settings”)
  • Enter your grid name and grid URI (like yourgrid.org:8002 without http://)
  • Enter your robust database connection details and submit. If you get a
    database connection error, it might come from a case-sensitivity issue (see
  • insert [gridinfo] and [gridstatus] shortcodes in a page or in a sidebar widget
  1. Set permalinks and profile page
  • Visit Settings > Permalinks, confirm W4OS slugs (profile and assets) and save.
  • Create a page with the same slug as Profile permalink.
    (This will be handled in a more convenient way in the future)

Create avatar models

Avatar models are displayed on new avatar registration and allow new users to start with another appearance than Ruth.

  • Check (or change) their naming convention in Admin > OpenSimulator > Settings > Avatar models
  • From robust console, create a user named accordingly (for example, “Female Default”, Default John”, …).
      R.O.B.U.S.T. # create user Default John
      Password: ************************
      Email []: (leave empty)
      User ID (enter for random) []:  (leave empty)
      Model name []: (leave empty)
      15:27:58 - [USER ACCOUNT SERVICE]: Account Default John xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx created successfully
    • A password is needed as you need connect in-world to configure it.
      Choose a strong password, any hack could affect all new users.
    • FirstName or LastName has to match your W4OS Avatar models settings
    • The rest of the name will be displayed in the form, so make it relevant
    • You can leave “Email” and “User ID” blank
    • Leave “Model Name” blank, you are creating a model, not using an existing model to create a user
  • Connect in-world as this avatar and change outfit. Any worn clothing or attachment will be passed to the new avatars. Be sure to wear only transfer/copy items.
  • Make a snapshot and attach it to this account profile

The model will now appear in new avatar registration form, with its profile picture.

These accounts will be excluded from grid statistics.


  • Web Asset Server: the project requires a web asset server to convert simulator assets (profile pictures, model avatars…) and display them on the website. W4OS provides a web assets service, or you can specify an external web assets service URL instead.
  • PHP 7.4 to 8.1
  • PHP Modules: w4os requires php imagemagick module. Also, while they are not required, WordPress recommends activating PHP curl and xml modules. They are also recommended by W4OS for full functionalties.


See TROUBLESHOOTING.md for more information.

See (https://github.com/GuduleLapointe/w4os/) for complete status and changelog.

Medium term

  • [x] get grid info from http://login.uri:8002/get_grid_info
  • [x] Web Assets server
  • [x] Helpers (search, currency, map…)
  • Improve avatar profile
    • Switch to allow web profile
    • Switch set in-world prefs for public profiles
    • Better basic layout
    • Web edit profile
  • Admin Start / Stop regions
  • Admin Create region
  • Admin Use sim/grid configuration file to fetch settings if on the same host

Long term

  • Admin create users
  • Admin create models (from current appearance)
  • Deactivate (recommended) or delete (experimental) grid user when deleting wp account
  • Choice between Robust console or database connection
  • User’s own regions control (create, start, stop, backup)
  • WooCommerce Subscriptions integration for user-owned Regions or other pay-for services
  • 2do HYPEvents project integration https://2do.pm
  • Gudz Teleport Board project integration (based on user picks)
  • separate OpenSimulator libraries and WordPress specific code, to allow easy integration in other CMS

Do I need to run the website on the same server?

No, if your web server has access to your OpenSimulator database.

Can I use this plugin for my standalone simulator?

Yes, it works too. Use OpenSim database credentials when requested for Robust credentials.

Why can’t I change my avatar name?

This is an OpenSimulator design limitation. Regions rely on cached data to display avatar information, and once fetched, these are never updated. As a result, if an avatar’s name (or grid URI btw) is changed, the change will not be reflected on regions already visited by this avatar (which will still show the old name), but new visited region will display the new one. This could be somewhat handled for a small standalone grid, but never in hypergrid context. There is no process to force a foreign grid to update its cache, and probably never will.

Shouldn’t I copy the helpers/ directory in the root of my webiste ?

No, you don’t need to and you shouldn’t. The /helpers/ is virtual, it is served as any other page of your website. Like there the /about/ URL website doesn’t match a /about/ folder your webste directory.
Even if there is a helpers/ directory in w4os plugin, it has the same name for convenience, but he could have been named anything. It’s content is not accessed directly, it is used by the plugin to generate the answers.
On the opposite, if there was an actual helpers/ folder in your website root, it would interfer with w4os.

  1. Grid info and grid status examples
  2. Avatar registration form in WooCommerce My Account dashboard.
  3. Settings page
  4. Web assets server settings


  • fix fatal error when updating from WP directory (“MetaBoxUpdaterOption” not found)


  • new Avatar Models settings page, including list of available avatars
  • added defaults for plugin-provider or external search engines
  • added troubleshooting guide
  • added instructions for nginx users
  • optimized assets rendering from cache
  • fix profile and avatar models pictures broken
  • fix regression arguments not accepted for query.php
  • fix invalid DATASRV example variable when gridname contains invalid characters
  • fix helpers nginx icompatibility (use REQUEST_URI instead of REDIRECT_URL)
  • fix helpers settings hints missing http:// protocol for gatekeeper
  • fix no result if gatekeeper is passed without http:// protocol
  • fix search and register url settings


  • fix array_unique(): Argument #1 ($array) must be of type array, null given on plugin first activation
  • fix Undefined constant “W4OS_PROFILE_URL” fatal error
  • prepare 3.x transision


  • fix wrong event time in in-world search (UTC shown instead of grid time)


  • restored WooCommerce Account Dashboard avatar section


  • fix w4os_profile_sync() fatal error when profiles are disabled
  • fix fatal error when wp object is passed as user_id


  • minor fixes (profile page title, profile image, profile text display)


  • new search helper
  • new offline messages helper. Messages are stored in OfflineMessageModule V2 format, so one can switch between core and external service (fix #47)
  • new currency helpers
  • new Popular Places block and [popular-places] shortcode
  • new events parser (fetch events from 2do.pm or another HYPEvents server)
  • added password reset link to profile page
  • added prebuilt binaries for opensim 0.9.1 and 0.9.2
  • added currency conversion rate setting
  • separate helpers settings page
  • updated translations
  • fix userprofile table queried even if not present (issue #64) when User Profiles are not enabled on robust
  • fix fatal error Argument #2 ($haystack) must be of type array, bool given (issue #64)
  • fix offline messages not forwarded by mail (opensim db not properly loaded by helpers)
  • fix profile picture aspect ratio (4/3, as in viewer)
  • fix fatal error in helpers for poorly encoded unicode text sources
  • fix fatal errors in helpers when database is not connected
  • fix #57 password not updated on grid when using password recovery in WordPdress
  • fix fatal error and warnings with popular-places shortcode
  • avoid fatal error if php xml-rpc is not installed, show error notice instead
  • helpers migrated from old mysqli db connection method to PDO
  • dropped aurora and OpenSim 0.6 support


  • new web assets server

  • new profile page

  • new config instructions for new grid users

  • new blocks support

  • new grid and wordpress users sync

  • new grid based authentication; if wp user exists, password is reset to grid password; if not, a new wp user is created

  • new admin can create avatars for existing users

  • new grid info settings are fetched from Robust server if set or localhost:8002

  • new check grid info url validity (cron and manual)

  • added option to replace name by avatar name in users list

  • added profile image to gridprofile

  • added assets permalink settings

  • added states in admin pages list for known urls (from grid_info)

  • added lost password and register links on login page

  • added buttons to create missing pages on status dashboard

  • added Born and Last Seen columns to users list

  • added hop:// link to login uri

  • added in-world profile link to profile page

  • added Partner, Wants, Skills and RL to web profile

  • removed Avatar section from WooCommerce account page until fixed

  • removed W4OS Grid Info and W4OS Grid Status widgets (now available as blocks)

  • fix duplicate admin notices

  • fix squished profile picture

  • fix avatar not created, or not created at first attempt

  • fix inventory items not transferred to new avatars

  • fix errors not displayed on avatar creation page

  • fix avatar model not shown if default account never connected

  • fix missing error messages on login page

  • fix user login broken if w4os_login_page is set to profile and OpenSim database is not connected

  • fix a couple of fatal errors

  • fix slow assets, store cached images in upload folder to serve them directly by the web server

  • fix Fatal error Call to undefined function each()

  • show a link to profile page instead of the form in profile shortcode

  • responsive profile display for smartphones

  • show image placeholder if profile picture not set

  • added imagick to the recommended php extensions

  • lighter template for profiles when loaded from the viewer

  • guess new avatar name from user_login if first name and last name not provided

  • replace wp avatar picture with in-world profile picture if set

  • use version provided by .version if present

  • More comprehensive database connection error reporting


  • added login form to gridprofile shortcode when not connected instead of login message
  • added w4os-shortcode classes
  • added screenshots
  • fix fatal error when trying to display WooCommerce Avatar tab form in My Account
  • fix localisation not loading
  • shorter “Avatar” label, removed uuid in gridprofile shortcode


  • Now distributed via WordPress plugins directory
  • Official git repository changed to GitHub
  • renamed plugin as W4OS – OpenSimulator Web Interface
  • fix other WP plugins directory requirements
  • fix localizations not loading
  • fix regression, automatic updates restored. Users with version 2.0 to 2.0.3 will need to reinstall the plugin from source. Sorry.
  • use plugin dir to detect slug instead of hardcoded value
  • renamed [w4os_profile] shortcode as [gridprofile] for consistency. w4os_profile is kept for backwards compatibility


  • fix #2 Database check fails if mysql is case insensitive
  • fix #4 Database connection error triggered if userprofile table is absent
  • fix #10 invalid JSON response when adding [w4os_profile] shortcode element
  • fix wrong letter cases in auth table name
  • fix only show profile form for current user
  • better css loading
  • only check once if w4os db is connected
  • added login page link to message displayed when trying to see profile while not connected
  • more detailed error messages for avatar creation


  • added changelog, banners and icons to view details
  • fix “Yes” and “No” translations
  • fix typo in banners and icons urls, can’t believe I didn’t see this before…
  • fixed conflict with other extensions settings pages
  • changed update server library to frogerme’s WP Plugin Update Server