View source for jOpenSim HowTo LoginscreenAttachModule

== Required Joomla configuration ==
The Joomla plugin "Content - Load Modules" must be enabled:
[[File:Loadmodules.png|none|Content - Load Modules]]
Ensure, it has '''NOT''' "No wrapping (raw output)" enabled:
[[File:Loadmodules config.png|none|Content - Load Modules Configuration]]
... otherwise the titles of the modules will not show

== Required jOpenSim configuration ==
To be able to use the customizable login screen, you need to enable its layout in the tab "Login Screen" of the "Global Configuration":
[[File:loginscreen layout customized.png|none|Customized Layout]]
== Creating new login screen position ==
Once, this layout is preset, you will find a new menu item in jOpenSim's sidebar:
[[File:login screen custom view.png|none|Custom Login Screen View]]
Here you click on "Add new Position". A new form will appear:
[[File:login screen custom addnew.png|none|Login Screen new position]]
The position name needs to be unique. jOpenSim will suggest a name, but at the end it is totally up to you. Do not mix these positions up with your template positions.

In this turtorial, we assume that we create a position called "jopensim_loginscreen_1" at the position top 20px, left 20px. Once, saved, you will see this position without any attached module:
[[File:login screen custom newposition.png|none|New position without module]]
The status of it will be invisible and disabled as long as there is not at least one module attached to it.
== Attach module to position ==
To attach a module, click on "Set a module for this position". This will bring you to your Joomla's module manager (com_modules). There, create a new or edit an existing module you want to appear at this login screen position.

Now comes the "tricky part" :) The module manager (yet) has no idea of the new position. To enable it, you need to manually type this position on top right into the position field '''and type ENTER''':
[[File:module custom position jopensim loginscreen 1.png|none|Creating custom position in module manager]]
When you save the module and return to jOpenSim's Login Screen, you will see this module attached to this position (in this case jOpenSim Grid Status):
[[File:login screen custom attachedposition.png|none|Position with attached module]]
Now all you need to do is to change status to "visible" and the module will appear in your login screen :)
== Some notes ==
Sure you can even enter template position names, so all your modules in e.g. template position "right" will appear in the login screen (on a position top-right...)

Know that the modules do not look exactly same like on the website, since the login screen will not load the template of the website. Otherwise you would even see the menu, header, footer, etc. in the login screen.

There is a known issue if you attach mod_login to the login screen and users click on "Remember Me" causing several error lines. This issue is on the todo list.