====== Widget and Applications Modules ======

<onecolumn>
    * [[#What is an API?]]
    * [[#How do I add a widget to my netvibes page?]]
    * [[#Where do I find widgets that are netvibes base on the API?]]
    * [[#How to configure the PopMail widget?]]
</onecolumn>

===== What is an API =====

Netvibes is providing an API (Application Programming Interface) for all the Developers who want to build their own widget.  netvibes recently introduced the Universal Widget API that lets you write the widget once for netvibes and it will instantly be available on Google IG, OS X Dashboard, and other widget platforms.  If you are a Developer and you want to build your own widget, you will find all the information here: http://dev.netvibes.com

<note>Netvibes cannot be held responsible for the content, functionality, availability or performance of this widget. If you have any concerns, please report them via the Feedback Form on your netvibes page.</note>


===== How do I add a widget to my netvibes page? =====

There are 2 methods of quickly adding widgets:

==== 1- From the Topbar ====

=== Search for widgets ===
Seek out widgets related to or on the subject of interest eg. Tennis.
\\
\\
Add Content > Tennis > click on green icon > browse over widgets and select a widget > Add to my page.

=== Browse categories ===
A list of categories appear on the right.  Here, you can view and add popular widgets under Features Widgets:  Business, Lifestyle, Sports to name a few.

  * Add Content
  * Browse Categories
  * Music
  * Browse over widgets and select a widget
  * Add to my page.

=== Essential Widgets ===
Essential Widgets are useful for day to day management of your life.  To illustrate, there is the Weather widget - prepare yourself for a rainy day.  Hotmail widget - view all unread emails in your Inbox.  Flickr photos widget - colour your page with personal photos and for your eyes only.  Digg widget - social bookmarking and blogging of technology and science articles.
\\
\\
There are at least 40 Essential Widgets to add to your page and access at your convenience.
\\
\\
Add Content > Essential Widgets > webnote > Add to my page
\\
\\
Alternatively, see all results directly on Ecosystem – http://eco.netvibes.com

==== 2- Start Wizard ====
If your account is configured to France, US, China and Germany you can also add widgets and feeds from the ‘Suggest’ option at the top right of your webpage. Remaining countries will have this option in due course.

  * Click on ‘Add content’
  * Click on ‘Content wizard’

Simply select a subject of interest ie. Business, Women & Fashion, Politics etc.
\\
\\
This automatically creates a new Tab named either of the above.
\\
\\
Click on the tab and within it is content you can use as a guideline or add to you webpage.


===== Where do I find widgets that are netvibes base on the API? =====

You can find a lot of widgets for netvibes in our Ecosystem: http://eco.netvibes.com
\\
\\
Some websites which are developing widgets, sometimes add a link into their tools part or they adding a netvibes button on their page.
\\
\\
Who do I contact if there is a problem with a widget?
\\
\\
Netvibes cannot be held responsible for the content, functionality, availability or performance of this widget.  If you have any concerns, please report them via the Feedback Form on your netvibes page http://www.netvibes.com/static.php?show=feedback
\\


===== How to configure the PopMail widget? =====

To utilise this widget, you need POP3 or IMAP configurations.
\\
\\
==== To configure the POP/IMAP widget: ====

  * Go to the edit mode 
  * Enter the following information found when you select Edit at the top right of the widget window. 
  * Title and colour let you customise the PopMail widget (you can add as many widgets as you want).
  * Enter your login and password and select the protocol you wish to use - POP3 or IMAP.
\\
If your POP3 or IMAP requests a secure connection, contact your network administrator or check your mail provider FAQ as we can't do email support. Most services won't need it, some services like Gmail require them. The Port number will be automatically set with the standard values.
\\
\\
If you have a WebMail, you can enter the URL (add http:// ) and each time you'll click on our email, you'll be directed there. As in the Gmail and Yahoo widget, you can select the number (up to 20) mails titles you want to view.
\\

==== To activate: ====

  * Click on 'Add content' link
  * Click on 'Essential widgets' link
  * Click on the 'PopMail' widget
  * Select Add to my Page
  * Go to the top right of the widget and select Edit
  * Type in a Title, your Login/full email address, Password, Protocol [POP3 or IMAP4] and Mail Server
  * The remainder of the fields will automatically default so ensure to [Save] the changes.

==== How to use: ====

  * If any, single click on an item - this should immediately load your webmail. Type in your login & Password, once in, you should have access to all your emails.