Portlets and gadgets are organized in different categories. Each category contains one or several portlets or gadgets. You can also mix portlets and gadgets into one category. By default all gadgets are placed in the _Gadgets_ category.


h1. Display Gadgets
You can change the number of columns available in the Dashboard Portlet.

# **
Click on _Site Editor_ : _Edit Page_
# **
Click on _Edit Portlet_ button \(which is displayed a pencil icon when you mouse\-over the portlet in edit mode\). It will show a dialog to change the number of columns to display gadgets.
!Column.png|title=!
# **
Change the number of columns and click the _Save_ button to accept the changes.

h1. Add a new Category
You easily add a new category by following these guides:

# **
In the _Group_ menu, select _Administration_ \-> _Application Registry_.
# **
Click the _Add Category_ button on the action bar:
!AddCategory1.png|title=!
The _Category Setting_ tab: includes common information about a category.
* Category name
{quote}The name of the category. This field is required and its length must be between 3 and 30 characters. Only alpha, digit, dash and underscore characters are allowed.
{quote}
* Display name
{quote}The display name of the category and its length must be between 3 and 30 characters.
{quote}
* Description
{quote}A brief description of the category. Any length from 0 to 255 characters is allowed.
{quote}
The _Permission Setting_ tab provides access to the Permission manager.
The permission criteria are used whenever a user creates or modifies a page. In that case the user can only see and use portlets in those categories on which he or she has access to \(as defined by groups and memberships\).
!Permission2.png|title=!

h1. Edit a Category
# **
Click the Edit icon located next to the title bar.
# **
Update the category information.
# **
Click the _Save_ button to apply changes.

h1. Delete a Category
# **
Click the Trash can icon located next to the title bar.
# **
Accept the deletion by clicking _OK_

h1. Add Portlets/Gadgets to a Category
# **
Click the "Plus" icon located next to the category name to which you want to add portlets/gadgets.
!AddPortlet2.png|title=!
* Display name
{quote}The display name of a portlet/gadget.
{quote}
* Application Type
{quote}Either Portlet or Gadget.
{quote}
# **
Enter the display name and select a type
# **
Select a portlet/gadget by checking the radio button.
# **
Click the _Save_ button to add the selected portlet/gadget to the category.

h1. Set Access Permission on Portlets
# **
In the _Group_ menu, select _Administration_ and then _Application Registry_.
!PortletPermission.png|title=!
# **
Select a category in the Category pane that includes the portlet you want to set permissions on. All portlets of that category will be listed underneath.
# **
To set permission for a portlet:
#* Click the _Add Permission_ button to add access permissions to more groups.
!AddPermission.png|title=!
#* Or check _Make it public_ to allow everyone to access.
Whenever the user creates or modifies a page, he or she can only see and use gadgets/portlets that fulfill two conditions: the portlet is in a _category_ which the user has access permission too and the user has access permission on the _portlet_

h1. View/Edit portlet/gadget information
In the _Group_ menu, select _Administration_ then _Application Registry_.

!Org1.png|title=!
* _Left pane_
{quote}All portlets and gadgets grouped by categories
{quote}
* _Right pane_
{quote}shows detail information about a portlet: Name, Display name, Description and Portlet preferences.
{quote}
To see the details of any portlet select it from the list on the left.

To edit a portlet, click the edit button to the right of the portlet's name:

!EditApplication.png|title=!
!EditApplicationInformation.png|title=!

h1. Add a Gadget
In the _Group_ menu, select _Administration_ then _Application Registry_. Click on the _Gadget_ icon.

!Gadgetnew.png|title=!
You may add a remote gadget using its URL or create a brand\-new one:

h6. Add a remote Gadget
# **
Click on _Add a remote gadget_:
!AddGadgetnew.png|title=!
# **
Enter the url of the remote gadget in the _URL_ field.
!AddGadgetnewUrl.png|title=!
# **
Click _Add_. The new remote gadget will be appear in gadget list on left pane of the Dashboard portlet.
h6. Create a new Gadget
# **
Click on _Create a new gadget_:
!CreateGadget1.png|title=!
# **
Populate the {{Source}} field with the xml code of the new gadget.
You can edit or refresh a gadget using the icons in the top right of the _Gadget Details_ pane.

You can delete a local gadget using the trashcan icon to the right of the appropriate gadget in the gadget list.

!ActionGadget.png|title=!

h1. Add a new Gadget to the Dashboard Portlet
See [sect-User_Guide-Dashboard_Portlet-Add_Gadgets] for instructions on how to add new gadgets to the dashboard.


h1. Manage Gadgets

h2. Edit a Gadget
Click the _Edit Gadget_ icon located in the header of the _Gadget Details_ page to display the following window:

!Source.png|title=!