Bij het configureren van w4os op een nieuwe site, hadden we problemen om uit te vinden waarom de zoekfunctie niet werkte met de interne zoekmachine. Het werkte echter perfect met een externe engine die exact dezelfde versies van de bibliotheken gebruikt. En het werkt intern perfect op verschillende openbare grids die ik beheer, evenals de testgrids die zijn gemaakt voor de ontwikkeling van w4os.
Op zulke momenten zeg je tegen jezelf “misschien is valetsen uiteindelijk wel beter voor mij, je hoeft alleen maar beleefd te zijn”. Beleefd? Inderdaad: protocol!
In het OpenSim.ini bestand moet je, om w4os als zoekmachine te gebruiken, de URL specificeren (eindigend op query.php) door de GatekeeperURI (de gateway voor het raster) toe te voegen, met het argument “gk”, om een geformatteerd antwoord mogelijk te maken voor het raster dat de aanvraag doet. Deze informatie wordt niet verzonden door de viewer, dus je moet het toevoegen in de instellingen.
[Search]
Module = OpenSimSearch
SearchURL = "http://example.org/helpers/query.php?gk=http://yougrid.org:8002"
In de meeste gevallen is de GatekeeperURI identiek aan de LoginURI. Maar volgens de OpenSimulator standaarden bevat het een zogenaamd protocol (http://). En de plugin-instellingen hebben dit niet gespecificeerd. En de zoekmachine accepteert geen waarde zonder protocol (yourgrid.org:8002).
Conclusie: er is een nieuwe update voor w4os, nu beschikbaar op magiiic.com of op GitHub, en binnenkort in de WordPress plugins directory.
Het lost het probleem op twee manieren op:
- de instellingenpagina voor helpers vermeldt nu correct de syntaxis van de instellingen die in OpenSim.ini moeten worden gemaakt
- de zoekmachine zelf accepteert nu dat de GatekeeperURI geen protocol heeft.
De correctie is ook doorgevoerd in de zoekmachinebibliotheek, die is opgenomen in w4os, maar ook beschikbaar is als een op zichzelf staande oplossing, Flexible Helpers Scripts.