^{Link 1.0}

This plugin allows to dynamically add links with a 3D cell and modules. It is used by means of dynamic edition interface of the site compulsorily (DynamicEditor plugin). Create (or modify) a link towards a whiteboard, an URL, a mailing list is possible, when an object is clicked in the 3d. Naturally, these modules have to be already present to be able to create these links.

Furthermore, a password can be associated to the link : it will be asked to the user when this one will click on the object.

There is no instance to create.
On the other hand, a preparation work in the C3D3 editor is necessary :

1/ Define links it will be possible to dynamically create :

1- In the C3D3 editor, add the "Link" plugin in the "Plugins" tab.
2- In the "Paramètres" window of the Link plugin, define the various configurations which will be used in the dynamic editor as follows : Link_name Flag Param Texte_Name

Hence, you have to conceive which types of links will be on-line managable. Each type will be configured to be able to be chosen during the dynamic edition.
For example, you foresee 3 types of links :
an "URL" type : when clicking on a material, the client browser will open a web page;
a "whiteboard" type : when clicking on a material, the whiteboard interface will open on the client;
a "mailing list" type : when clicking on a material, a client will be able to register to a mailing list.
In these 3 cases, when online editing wished material (and parameters an URL for example) will be chosen.

For this example, Link plugin parameters are  :

Link plugin parameters example

url 1 URL\ link Enter\ URL
whiteboard 0 Whiteboard\ link
mailinglist 0 Mailing\ list\ link

Notes :

- Link_name (URL) : event name to be linked with a module
- Flag (1) :
if Flag=1, allows to indicate an additionnal parameter is needed
if Flag=0, there is no additionnal parameter needed (additionnal texte example :: Enter\ URL, which allows to define a additionnal paramater which is in this case an URL)
- Param (Link\ to\ an\ URL) : Text that a user can select to choose a new module.
- Text_name (Enter\ URL) : Wording corresponding to the additionnal parameter who allows to indicate to the user he has to define a new parameter
In "whiteboard" case, the flag being 0, the link waits no additionnal parameter, thus it does not need "Text_name" wording.

3- SCS links creation :

Links must be created in the Modules interface of the C3D3 editor ; for example, if we consider our previous 3 links (Url, Whiteboard, MailingList), the following links must be created :

C3D3.Link.link.url >> InOut.gotoUrl
C3D3.Link.link.whiteboard >> Whiteboard.show
C3D3.Link.link.mailinglist >> MailingList.show

2/ Dynamically create the links :

1- Once a user connected and the 3D initialized, activate the DynamicEditor interface  by right-clicking on the wished material and choose "Edit effects" menu, and then Link.

2- The Setup the link :

Choose

• link type
  
• alias (name displayed when the mouse passes over the object)
  
• password (optional)
  
• parameter (if needed)
  
• Alias will be the shown name for this link (in the "infos" zone of the C3D3 or in the tiptool if the Bubble plugin is integrated).

Press Apply effect to confirm. To remove it, press Delete effect.

Note : It is possible to create instance of links in static mode in C3D3 editor (Instances rubric), those can be dynamically edited and conversely.

See above.