Difference between revisions of "MyPortal Development guide"

From Catglobe Wiki
Jump to: navigation, search
m (Fixed link reference)
Line 1: Line 1:
<accesscontrol>Administrators,,Cem,,Maysunshine</accesscontrol>
+
<accesscontrol>Administrators,,Cem,,Maysunshine</accesscontrol>  
[[Category:Miscellaneous]]
+
 
 
== Introduction  ==
 
== Introduction  ==
  
 
The My Portal page is your own personalized view of what goes on in the Catglobe system that is interesting to you.  
 
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.  
+
More information about My Portal is available [[My_portal|here]].  
  
== How to make&nbsp;user defined elements<br> ==
+
== How to make&nbsp;user defined elements<br> ==
  
 
A user defined element as its name is the one you can put anything you want.  
 
A user defined element as its name is the one you can put anything you want.  
  
[[Image:MyPortal - User-defined.jpg]]&nbsp;<br>
+
[[Image:MyPortal - User-defined.jpg]]&nbsp;<br>  
  
 
An element&nbsp;contains 2 features:  
 
An element&nbsp;contains 2 features:  
Line 18: Line 18:
 
*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.
 
*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> ==
+
== Script - Supported features<br> ==
  
 
=== Events  ===
 
=== Events  ===
  
*''onload'': called after loading the element
+
*''onload'': called after loading the element  
*''onadd'': called once after adding the element to MyPortal page (Insert)
+
*''onadd'': called once after adding the element to MyPortal page (Insert)  
 
*''onminimize'': called when minimizing the element  
 
*''onminimize'': called when minimizing the element  
 
*''onmaximize'': called when maximizing the element  
 
*''onmaximize'': called when maximizing the element  
Line 30: Line 30:
 
*''onmouseout'': called when mouse is out of the element
 
*''onmouseout'': called when mouse is out of the element
  
=== Functions ===
+
=== Functions ===
  
 
*''set_title(titleText)'': change the title of element  
 
*''set_title(titleText)'': change the title of element  
*''get_contentDiv()'': get the element's "div" content, used for manipulating the HTML content
+
*''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)
 
*''getManager().updateElementOrdination()'': automatically re-arrange MyPortal page (used when the HTML content is updated dynamically)
  
 
=== Sample code  ===
 
=== Sample code  ===
  
<source lang="javascript" line="1">
+
<source lang="javascript">
 
this.onload = function()  
 
this.onload = function()  
 
{  
 
{  
 
   // use "this" keyword to access the element itself.  
 
   // use "this" keyword to access the element itself.  
 
}
 
}
</source>
+
</source>  
  
 
== Potential problems  ==
 
== Potential problems  ==
Line 57: Line 57:
 
<u>[[Display a questionnaire's answers in real time]]</u>  
 
<u>[[Display a questionnaire's answers in real time]]</u>  
  
<u>[[Movie player element]]</u>
+
<u>[[Movie player element]]</u>  
 +
 
 +
[[Category:Miscellaneous]]

Revision as of 06:24, 28 December 2011

<accesscontrol>Administrators,,Cem,,Maysunshine</accesscontrol>

Introduction

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

More information about My Portal is available here.

How to make user defined elements

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

MyPortal - User-defined.jpg 

An element contains 2 features:

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

Script - Supported features

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 when the 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

this.onload = function() 
{ 
   // use "this" keyword to access the element itself. 
}

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 into the flash:
    IE: "<param name='wmode' value='transparent' />"
    FF: 'wmode="transparent" '

Examples

Display a questionnaire's answers in real time

Movie player element