Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Newsreader/Tutorials/How to hook your eclipse project newsgroup to salvo"

 
(5 intermediate revisions by the same user not shown)
Line 8: Line 8:
  
 
== 2.Procedure  ==
 
== 2.Procedure  ==
<div>2.1 First add an org.eclipse.ecf.salvo.newsgroupProvider extension to your plug-in.</div><div><br></div><div>[[Image:Salvo-tutorial1-1.png]]</div><div></div><div></div><div></div><div>2.2 Now right click the added extension and add a newsgroup.</div><div></div><div></div><div>[[Image:Salvo-tutorial1-2.png]]</div><div></div><div></div><div>Depending on your requirement you may add multiple newsgroups.<br></div><div></div><div></div><div>2.3 Define the newsgroup name and the description.</div><div></div><div></div><div>[[Image:Salvo-tutorial1-3.png]]</div><div></div><div></div><div>2.4 Create a class which provides newsgroup information.<br></div><div></div><div></div><div>A newsgroup provider must implement the org.eclipse.ecf.salvo.ui.external.provider.INewsgroupProvider interface.<br>To create a new class which implements the INewsgroupProvider interface, click on the “class” link.<br>The following dialog will appear when you click on the “class” link. </div><div></div><div></div><div>[[Image:Salvo-tutorial1-4.png]]<br></div><div></div><div></div><div>Set class name and the package and then click finish.<br> When you click finish, you will see the generated class which implements the INewsgroupProvider interface.<br><br>[[Image:Salvo-tutorial1-5.png]]</div><div></div><div>
+
<div>2.1 First add an org.eclipse.ecf.salvo.newsgroupProvider extension to your plug-in.</div><div><br></div><div>[[Image:Salvo-tutorial1-1.png]]</div><div></div><div></div><div></div><div></div><div><div><br></div>
 +
2.2 Now right click the added extension and add a newsgroup.  
 +
 
 +
<br>
 +
</div><div></div><div></div><div></div><div>[[Image:Salvo-tutorial1-2.png]]</div><div></div><div></div><div></div><div>Depending on your requirement you may add multiple newsgroups.<br></div><div></div><div></div><div><div><br></div>2.3 Define the newsgroup name and the description.</div><div></div><div></div><div></div>
 +
 
 +
<div>[[Image:Salvo-tutorial1-3.png]]</div><div></div><div></div><div></div><div><div><br></div>2.4 Create a class which provides newsgroup information.<br></div><div></div><div></div><div>A newsgroup provider must implement the org.eclipse.ecf.salvo.ui.external.provider.INewsgroupProvider interface.<br>To create a new class which implements the INewsgroupProvider interface, click on the “class” link.<br>The following dialog will appear when you click on the “class” link. </div><div></div><div></div><div></div>
 +
 
 +
<div>[[Image:Salvo-tutorial1-4.png]]<br></div><div></div><div></div><div></div><div>Set class name and the package and then click finish.<br> When you click finish, you will see the generated class which implements the INewsgroupProvider interface.<br><br>[[Image:Salvo-tutorial1-5.png]]</div><div></div><div>
 
<br> 2.5 Define newsgroup information.<br>  
 
<br> 2.5 Define newsgroup information.<br>  
  
Line 17: Line 25:
 
2.6 Define when to enable your newsgroup. <br>  
 
2.6 Define when to enable your newsgroup. <br>  
  
Under the enablement section, using eclipse core expressions you can define the conditions that should satisfy to enable your newsgroup.<br>Following is a sample enablement definition.<br>  
+
Under the enablement section, using eclipse [http://wiki.eclipse.org/Platform_Expression_Framework core expressions] you can define the conditions that should satisfy to enable your newsgroup.<br>Following is a sample enablement definition.<br>  
  
 
<br>  
 
<br>  
</div><div>[[Image:Salvo-tutorial1-6.png]]</div><div></div><div></div><div>Here the newsgroup is enabled when, <br>'''''org.eclipse.ecf.salvo.application.perspective perspective''''' is active or '''''org.eclipse.ecf.salvo.ui.internal.views.messageView''''' part is active or '''''org.eclipse.ecf.salvo.ui.articlepanel''''' editor is active.<br></div><div></div><div>[[Image:Salvo-tutorial1-7.png]]</div><div></div><div></div><div>Following is the plugin.xml configuration for the above extension.</div><div></div><div></div><div>[[Image:Salvo-tutorial1-8.png]]</div><div></div><div></div><div>Now the extension point definition is completed.<br></div><div></div><div></div>  
+
</div><div>[[Image:Salvo-tutorial1-6.png]]</div><div></div><div></div><div>Here the newsgroup is enabled when, <br>'''''org.eclipse.ecf.salvo.application.perspective perspective''''' is active or '''''org.eclipse.ecf.salvo.ui.internal.views.messageView''''' part is active or '''''org.eclipse.ecf.salvo.ui.articlepanel''''' editor is active.<br></div><div></div>
 +
 
 +
<div>[[Image:Salvo-tutorial1-7.png]]</div><div></div><div></div><div><br><br>Following is the plugin.xml configuration for the above extension.</div><div></div><div></div>
 +
 
 +
<div>[[Image:Salvo-tutorial1-8.png]]</div><div></div><div><br></div><div>Now the extension point definition is completed.<br></div><div></div><div></div>  
 +
 
 +
 
 
== 3.Test your extension point  ==
 
== 3.Test your extension point  ==
<div><br>When the user executes the Ask a question wizard, Salvo will automatically suggest your newsgroup to him/her, if the predefined conditions are satisfied at that moment.</div><div></div><div>[[Image:Salvo-tutorial1-9.png]]<br></div><div></div><div></div>
+
<div>When the user executes the Ask a question wizard, Salvo will automatically suggest your newsgroup to him/her, if the predefined conditions are satisfied at that moment.</div><div></div><div><br>[[Image:Salvo-tutorial1-9.png]]<br></div><div></div><div></div>

Latest revision as of 16:04, 18 August 2011

How to hook your eclipse project newsgroup to salvo

1.Introduction

This tutorial explains how you can hook your eclipse project/product newsgroup to salvo.
By hooking your project newsgroup with Salvo, Salvo will able to automatically figure out and suggests newsgroups to your project/product users where they can post their questions.


2.Procedure

2.1 First add an org.eclipse.ecf.salvo.newsgroupProvider extension to your plug-in.

Salvo-tutorial1-1.png

2.2 Now right click the added extension and add a newsgroup.


Salvo-tutorial1-2.png
Depending on your requirement you may add multiple newsgroups.

2.3 Define the newsgroup name and the description.
Salvo-tutorial1-3.png

2.4 Create a class which provides newsgroup information.
A newsgroup provider must implement the org.eclipse.ecf.salvo.ui.external.provider.INewsgroupProvider interface.
To create a new class which implements the INewsgroupProvider interface, click on the “class” link.
The following dialog will appear when you click on the “class” link.
Salvo-tutorial1-4.png
Set class name and the package and then click finish.
When you click finish, you will see the generated class which implements the INewsgroupProvider interface.

Salvo-tutorial1-5.png


2.5 Define newsgroup information.

In here you have to define the information of your newsgroup.
Please see the org.eclipse.ecf.salvo.ui.external.provider.INewsgroupProvider interface for more information.
Now first part of the process is completed.


2.6 Define when to enable your newsgroup.

Under the enablement section, using eclipse core expressions you can define the conditions that should satisfy to enable your newsgroup.
Following is a sample enablement definition.


Salvo-tutorial1-6.png
Here the newsgroup is enabled when,
org.eclipse.ecf.salvo.application.perspective perspective is active or org.eclipse.ecf.salvo.ui.internal.views.messageView part is active or org.eclipse.ecf.salvo.ui.articlepanel editor is active.
Salvo-tutorial1-7.png


Following is the plugin.xml configuration for the above extension.
Salvo-tutorial1-8.png

Now the extension point definition is completed.


3.Test your extension point

When the user executes the Ask a question wizard, Salvo will automatically suggest your newsgroup to him/her, if the predefined conditions are satisfied at that moment.

Salvo-tutorial1-9.png

Back to the top