h1. Available preferences {anchor:id=CONTref.Portlets.Explorer.AvailablePreferences}

|| *Preference* || *Type* || *Default value* || *Description* ||
| *repository* | {{String}} | {{repository}} | The repository name which will be used in an instance of Site Explorer |
| *workspace* | {{String}} | N/A | Not in use. The workspace name was included in the Drive(!) |
| *path* | {{String}} | N/A | The path of node. This preference will be used when the usecase chosen is Parameterize |
| *drive* | {{String}} | N/A | Not in use. Replaced by driveName preference(!) |
| *views* | {{String}} | N/A | Not in use. The views will be displayed basing on the Drive which user has the access permission(!) |
| *allowCreateFolders* | {{String}} | N/A | Allow to create a folder by type. When you do not specify the value, then the default value will be nt:unstructured, nt:folder |
| *categoryMandatoryWhenFileUpload* | {{Boolean}} | false | Force an user to add a category when uploading or creating a document |
| *uploadFileSizeLimitMB* | {{Float}} | 150 | The maximum of file size when upload to the system (MB) |
| *usecase* | {{String}} | {{selection}} | The behavior to access Site Explorer. By default, the "selection" option is configured. Besides "selection", there are 4 other ways to configure the file explorer: *Jailed*,*Personal*,*Social*,*Parameterize* |
| *driveName* | {{String}} | {{Private}} | The name of a drive that an user wants to access |
| *trashHomeNodePath* | {{String}} | {{/Trash}} | The location to store the deleted nodes |
| *trashRepository* | {{String}} | {{repository}} | The name of the repository where stores the deleted nodes |
| *trashWorkspace* | {{String}} | {{collaboration}} | The name of the workspace where stores the deleted nodes |
| *editInNewWindow* | {{Boolean}} | {{false}} | Allow to edit document with or without a window popup.|
| *showTopBar* | {{Boolean}} | {{true}} | Allow to show the Top bar or not. |
| *showActionBar* | {{Boolean}} | {{true}} | Allow to show the Action bar or not.|
| *showSideBar* | {{Boolean}} | {{true}} | Allow to show the Side bar or not.|
| *showFilterBar* | {{Boolean}} | {{true}} | Allow to show the Filter bar or not. |

h1. Example of configuration {anchor:id=CONTref.Portlets.Explorer.ExampleConfiguration}
{code:language=xml|indent=2}
<portlet-preferences>
  <preference>
    <name>repository</name>
    <value>repository</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>workspace</name>
    <value></value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>path</name>
    <value></value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>drive</name>
    <value></value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>views</name>
    <value></value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>allowCreateFolders</name>
    <value></value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>categoryMandatoryWhenFileUpload</name>
    <value>false</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>uploadFileSizeLimitMB</name>
    <value>150</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>usecase</name>
    <value>selection</value>
    <read-only>false</read-only>
    </preference>
  <preference>
    <name>driveName</name>
    <value>Private</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>trashHomeNodePath</name>
    <value>/Trash</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>trashRepository</name>
    <value>repository</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>trashWorkspace</name>
    <value>collaboration</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>editInNewWindow</name>
    <value>false</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>showTopBar</name>
    <value>true</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>showActionBar</name>
    <value>true</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>showSideBar</name>
    <value>true</value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>showFilterBar</name>
    <value>true</value>
    <read-only>false</read-only>
  </preference>

</portlet-preferences>
{code}
