View source for MyPortal Development guide

== Introduction  ==

The My Portal page is your own personalized view of what goes on in the Catglobe system that is interesting to you. 

For more information, visit helpfiles at [http://vietnamhelpfiles.catglobe.com/ vietnamhelpfiles.catglobe.com/] under Persionalization/MyPortal. 

== How to make&nbsp;user defined elements<br> ==

A user defined element as its name is the one you can put anything you want. 

[[Image:MyPortal - User-defined.jpg]]&nbsp;<br>

An element&nbsp;contains 2 features: 

*HTML content: input inside Detailed decsription tab's HTML editor. It is&nbsp;required to show the element in MyPortal page&nbsp;(empty content will end up in not displaying anything) 
*Javascript: input inside Detailed description tab's script mode. It&nbsp;is used&nbsp;to manipulate the way the element will act, it can connect to registered web services or&nbsp;change the HTML content dynamically. jQuery is also supported, which makes it even more powerful.

== Script - Supported features<br> ==

=== Events  ===

*''onload'': called after loading the element
*''onadd'': called once after adding the element to MyPortal page (Insert)
*''onminimize'': called when minimizing the element 
*''onmaximize'': called when maximizing the element 
*''onremove'': called&nbsp;when the&nbsp;element is removed from MyPortal page 
*''onmouseover'': called when mouse is over the element 
*''onmouseout'': called when mouse is out of the element

=== Functions ===

*''set_title(titleText)'': change the title of element 
*''get_contentDiv()'': get the element's "div" content, used for manipulating the HTML content
*''getManager().updateElementOrdination()'': automatically re-arrange MyPortal page (used when the HTML content is updated dynamically)

=== Sample code  ===

<source lang="javascript" line="1">
this.onload = function() 
{ 
   // use "this" keyword to access the element itself. 
}
</source>

== Potential problems  ==

It can sometimes be quite problematic when displaying portal elements.Be careful when adding the HTML content, no validation is supported inside the editors. 

=== Tips  ===

*Flash objects might be placed on top of others. To fix that problem, these parameters should be added&nbsp;into the flash:<br>''IE: "&lt;param name='wmode' value='transparent' /&gt;"<br>FF: 'wmode="transparent" '''<br>

== Examples  ==

<u>[[Display a questionnaire's answers in real time]]</u> 

<u>[[Movie player element]]</u>