From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(initial wixtd manual)
 
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
==The WiXTD Wiki page==
+
__NOTOC__
 +
{{Quicklinks}}
 +
{{thirdparty}}
  
−
===About===
+
== WiXTD ==
 +
=== What is Wixtd? ===
 +
Wixtd is... <insert short introduction and description >
 +
----
 +
[[Image:Wixtd_mapping.jpeg|350px|thumb|left|WiXTD's TMS-tiling features can show both hypergrid and region information, using AJAX calls for data retrieval]]
 +
=== Links ===
 +
[http://wixtd.os-networks.net Running Development Version]
  
−
WiXTD is a webportal that is meant to make control over a grid a little easier for administrators, users and moderators, but it's main purpose is to function as a social community tool that sticks between the web and the virtual world. Before it can fullfill all that, it's important to have a clean codebase to start from. Therefor it's written in PHP5, tries to be as object oriented as possible, and uses the Smarty template engine to seperate markup from code. The upcoming 0.1 release must be functional enough to install and write new modules, developed by users. That's why there are no releases yet. The underlying structure is still not cohesive and consistent enough to make module development even possible.
+
=== Installation ===
 +
There is a preliminary install script for wixtd now, which does an environment check, writes the database, and gives additional information how to get WiXTD running. The sql contains also modrex specific tables, which are for testing. These are not used normally, but can be switched on from the settings menu. Please install wixtd in a seperate database, apart from opensim. Follow these steps to get it running:
  
−
===Concepts===
+
* Make sure you have PHP5, CURL, XMLRPC and imagick with JP2-support(requires jasper, and imagemagick with jp2-support)
 +
* Copy wixtd from svn in the Apache's documentroot
 +
svn checkout
 +
* Run the installation script, by pointing your browser to:
 +
http://foobar.org/install/install.php
 +
* Follow the instructions in the script
 +
* Log in and customize your wixtd
  
−
WiXTD is modular, meaning functionality is grouped within structures called modules. There are modules for profiles, region management, simulator management, messaging, etc. Each module has the same basic layout; it extends the module class and inherits a core-object. Using the core-object, each module has access to the whole system. Besides modules, which are fully part of the webinterface, there are also parts that are called 'micros'. A micro is a small part of functionality, that can be used without using the whole web-interface. It has access to all components, but it doesn't render the user interface. For instance, there is the splash-screen that a user will see when it retrieves the grid-info with the hippoviewer. In the OpenSim-config, a grid-administrator would then specify the micro for the splashscreen like:
+
=== Manual ===
 +
 
 +
==== Micro's ====
 +
Micro's are mini-components that have a small set of functionality, which can be accessed apart from the webportal. The current micro's are:
 +
Splash screen in the viewer. Setup in Gridinfo
 
  http://mygrid.org/index.php?mcr=splash
 
  http://mygrid.org/index.php?mcr=splash
−
  or to generate tms-tiles for the webmap...
+
  CLI script that generates maptiles from the region/simulator tables
−
  http://mygrid.org/index.php?mcr=tiler
+
  php /my/webdir/index.php tiler
−
  or to handle currency traffic...
+
  Currency handler. Will be used for karma
 
  http://mygrid.org/index.php?mcr=currency.php
 
  http://mygrid.org/index.php?mcr=currency.php
−
  and automated regionloading...
+
  Automated regionloading. Used by the webloader
 
  http://mygrid.org/index.php?mcr=sim2xml
 
  http://mygrid.org/index.php?mcr=sim2xml
−
  convert a mysql blob to an image...
+
  Automated HyperGrid linkloader
−
  http://mygrid.org/index.php?mcr=getAsset&uuid=
+
http://mygrid.org/index.php?mcr=sim2xml&ctr=hgl
 +
Shows an asset-blob as an image.  
 +
  http://mygrid.org/index.php?mcr=getAsset&uuid=643656-2343e344-434e32-3235ea
 +
Used by an AJAX-call of region-data for Openlayers. Can be used for dynamic KML-layer generation as well
 +
http://mygrid.org/index.php?mcr=map&lon=32&lat=64
 +
Anyway, you got the point. These are not at all times part of the webinterface, but can be used by OpenSimulator or an external API as well. Most data is returned as XML, but it's not yet consistent. This will be cleaned during the 0.1 phase as well...
  
−
Anyway, you got the point. These are not at all times part of the webinterface, but can be used by OpenSimulator as well.
+
=== Template ===
−
 
+
If you want to change the template, it's best to copy the /tpl/osn folder to a custom /tpl/mynewtemplate folder. Change the theme in Settings accordingly. The mainstyling is in /tpl/mynewtemplate/style.css . Custom html layout is both in the template folder(general stuff for index layout), and in the /com/com.mycomponent/views directories. WiXTD uses the smarty engine for template parsing.
−
===Installation===
+
<cleanpage title=hide cats=hide />
−
I'll keep this one short. If you are a regular user, not willing to invest some time understanding the source, you probably don't want to try wixtd atm. There will be an easy-to-use installer when the software is more stable, but until then installation is only for people with some patience and free time. Follow these steps to get it running:
+
−
* Make sure you have PHP5, CURL, XMLRPC and imagick with JP2-support(requires jasper, and imagemagick with jp2-support)
+
−
* Copy the source in Apache's documentroot
+
−
svn checkout http://forge.opensimulator.org/svn/wixtd/trunk .
+
−
* Import the tables from install/wixtd.sql into your opensim database
+
−
* Make an admin admin opensim user with the opensim user service
+
−
* Modify the wixtd_user UUID, so it's the same as the opensim user UUID (with phpmyadmin)
+
−
* Modify the wixtd_settings table, so it reflects your own setup
+
−
* Copy ./inc/config.php.tmp to ./inc/config.php
+
−
* Fill in your mysql-settings
+
−
''You should have a working webinterface by now...''
+
−
* Try logging in with 'admin admin' and password 'admin'
+
−
* Customize your wixtd installation from the acp-menu's
+

Revision as of 14:15, 21 February 2019

Languages Languages: 

En.png English

Imbox notice.png

*** THIS ARTICLE IS ABOUT THIRD PARTY SOFTWARE ***
Although OpenSimulator encourages the development of third party software for OpenSimulator, no support can be provided on this. For help with this software, contact the developer of this software directly.
Please do not contact the OpenSimulator team with questions about this software.


WiXTD

What is Wixtd?

Wixtd is... <insert short introduction and description >

WiXTD's TMS-tiling features can show both hypergrid and region information, using AJAX calls for data retrieval

Links

Running Development Version

Installation

There is a preliminary install script for wixtd now, which does an environment check, writes the database, and gives additional information how to get WiXTD running. The sql contains also modrex specific tables, which are for testing. These are not used normally, but can be switched on from the settings menu. Please install wixtd in a seperate database, apart from opensim. Follow these steps to get it running:

  • Make sure you have PHP5, CURL, XMLRPC and imagick with JP2-support(requires jasper, and imagemagick with jp2-support)
  • Copy wixtd from svn in the Apache's documentroot 
svn checkout
  • Run the installation script, by pointing your browser to: 
http://foobar.org/install/install.php
  • Follow the instructions in the script
  • Log in and customize your wixtd

Manual

Micro's

Micro's are mini-components that have a small set of functionality, which can be accessed apart from the webportal. The current micro's are: 

Splash screen in the viewer. Setup in Gridinfo
http://mygrid.org/index.php?mcr=splash
CLI script that generates maptiles from the region/simulator tables
php /my/webdir/index.php tiler
Currency handler. Will be used for karma
http://mygrid.org/index.php?mcr=currency.php
Automated regionloading. Used by the webloader
http://mygrid.org/index.php?mcr=sim2xml
Automated HyperGrid linkloader
http://mygrid.org/index.php?mcr=sim2xml&ctr=hgl
Shows an asset-blob as an image. 
http://mygrid.org/index.php?mcr=getAsset&uuid=643656-2343e344-434e32-3235ea
Used by an AJAX-call of region-data for Openlayers. Can be used for dynamic KML-layer generation as well
http://mygrid.org/index.php?mcr=map&lon=32&lat=64

Anyway, you got the point. These are not at all times part of the webinterface, but can be used by OpenSimulator or an external API as well. Most data is returned as XML, but it's not yet consistent. This will be cleaned during the 0.1 phase as well...

Template

If you want to change the template, it's best to copy the /tpl/osn folder to a custom /tpl/mynewtemplate folder. Change the theme in Settings accordingly. The mainstyling is in /tpl/mynewtemplate/style.css . Custom html layout is both in the template folder(general stuff for index layout), and in the /com/com.mycomponent/views directories. WiXTD uses the smarty engine for template parsing. UNIQc473a1c375fcdd5-cleanpage-00000000-QINU

Retrieved from "http://opensimulator.org/index.php?title=Wixtd&oldid=47324"
Personal tools
General
About This Wiki