=============================================================================== ADVIS LIST VIEWER WEB PART Version 3.0.0.0, 13.06.2007 =============================================================================== (c) 2007 ADVIS AG, Switzerland, http://www.advis.ch =============================================================================== Comments and feedback are always welcome. Please use our forums at http://sharepoint.advis.ch or - in case you don't want to post your message publicly - email us to webparts@advis.ch. =============================================================================== IMPORTANT =============================================================================== || BY INSTALLING AND USING THE SOFTWARE, YOU ARE CONFIRMING YOUR ACCEPTANCE || || OF THE SOFTWARE AND AGREEING TO THE TERMS OF THE FOLLOWING LICENSE || || AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS LICENSE AGREEMENT, || || THEN DO NOT INSTALL THE SOFTWARE. || =============================================================================== LICENSE AGREEMENT =============================================================================== THIS SOFTWARE (LIST VIEWER WEB PART) CAN BE FREELY COPIED AND USED ON AS MANY SITES AND SERVERS AS YOU WANT. THE SOFTWARE (LIST VIEWER WEB PART) IS PROVIDED 'AS-IS', WITHOUT ANY EXPRESS OR IMPLIED WARRANTY. IN NO EVENT WILL THE AUTHORS (ADVIS AG) BE HELD LIABLE FOR ANY DAMAGES ARISING FROM THE USE OF THIS SOFTWARE. THE GRANTED PERMISSION IS SUBJECT TO THE FOLLOWING RESTRICTIONS: 1. THE ORIGIN OF THIS SOFTWARE MUST NOT BE MISREPRESENTED; YOU MUST NOT CLAIM THAT YOU WROTE THE ORIGINAL SOFTWARE. 2. THE SOFTWARE MAY NOT BE ALTERED IN ANY FORM. 3. THE SOFTWARE MAY NOT BE DISSASSEMBLED, INHERITED, DECOMPILED, OR OTHERWISE BROKEN DOWN TO DETERMINE SOURCE CODE ORIGIN AND ALTER SOURCE CODE LOGIC. OVERVIEW =============================================================================== ADVIS List Viewer is an easy to use web part, that shows all the libraries and list of the current SharePoint site or portal area. The list can be fully customized: - Show or hide the list/library descriptions - Show or hide the number of items in the lists/libraries - Show or hide the list/library icons - Show or hide the list/library group header (e.g. "Document Libraries") - Specify your own group labels (e.g. with localized labels) - Apply your own custom style sheets to each element WHAT's NEW =============================================================================== V3.0.0.0 - Designed for Windows SharePoint Services 3.0 (WSS 3.0) and Microsoft Office SharePoint Server 2007 (MOSS 2007). V1.1.0.0 - Two new web part properties added: - Hide Number of Items if Empty - CSS Class for Empty Lists - Changed some common behaviours according to the ADVIS standard - Minor bug fixes - Reworked this readme file V1.0.0.0 Initial Release INSTALLATION =============================================================================== 1) Copy ListViewer_V3.0.0.0.cab to a directory on your SharePoint server. 2) Run stsadm.exe to register the web part the way you like. e.g. STSADM.exe -o addwppack -filename ListViewer_V3.0.0.0.cab -force -globalinstall 3) Restart IIS (e.g. by running iisreset.exe) USAGE / WEB PART PROPERTIES =============================================================================== Place the List Viewer web part on a site or area page. Set the following web part properties according to your preferences: List Viewer General Settings Property Group ------------------------------------------- Show List Group Headers Property name: ShowGroupHeaders Description: Show or hide the list/library group headers (e.g. "Document Libraries") Values: Default value: true Show Icons Property name: ShowIcons Description: Show or hide the list/library icons Values: Default: true Show List/Library Descriptions Property name: ShowDescriptions Description: Show or hide the list/library descriptions Values: Default value: false Show Number of Items Property name: ShowNumberOfitems Description: Show or hide the number of items in a list/library? Values: Default value: true Hide Number of Items if Empty Property name: HideNumberOfItemsIfEmpty Description: Set this property to true if you want to hide the number of items for empty lists and libraries. This setting has no effect if ShowNumberOfItems = false. Values: Default value: false List Viewer Labels Property Group --------------------------------- Label for Document Libraries Property name: DocumentsLabel Description: Label to be displayed for "Document Libraries" Values: Default value: "Document Libraries" Label for Picture Libraries Property name: PicturesLabel Description: Label to be displayed for "Picture Libraries" Values: [string] Default value: "Picture Libraries" Label for Lists Property name: ListsLabel Description: Label to be displayed for "Lists" Values: [string] Default value: "Lists" Label for Discussions Property name: DiscussionsLabel Description: Label to be displayed for "Discussions" Values: [string] Default value: "Discussions" Label for Surveys Property name: SurveysLabel Description: Label to be displayed for "Surveys" Values: [string] Default value: "Surveys" Label for Issues Property name: IssuesLabel Description: Label to be displayed for "Issues" Values: [string] Default value: "Issues" List Viewer Styles Property Group --------------------------------- Use this properties to specify custom styles for the different elements of ListViewer. To use these style properties, you must either create a .css file containing your own css classes, reference it from the page you wish and set the ListViewer class properties to point to your classes. Or you edit ListViewers default css file which is located at C:\Program Files\Common Files\Microsoft Shared\web server extensions\_ wpresources\ADVIS.WebParts.ListViewer\x.x.x.x__2fb4ce642a9762e6\ListViewer.css (wrapped for readability) CSS Class for List Type Headers Property name: ClassListheaders Description: CSS class for list type headers. Use ms-navheader for site default, leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-Listheaders") CSS Class for Lists Property name: ClassListItems Description: CSS class for document libraries and lists. Use ms-unselectednav for site default, leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-Listitems") CSS Class for Title Text Property name: ClassTitles Description: CSS class for special title font settings. Use only if you wish to set different fonts for the titles and descriptions. Leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-Titles") CSS Class for Description Text Property name: ClassDescriptions Description: CSS class for special description font settings. Use only if you wish to set different fonts for the titles and descriptions. Leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-Descriptions") CSS Class for Number of Items Property name: ClassNumberOfItems Description: CSS class for special font settings of the number of items in lists and libraries. Use if you wish to set different fonts for the number of items. Leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-NumberOfItems") CSS Class for Empty Lists Property name: ClassEmptyLists Description: CSS class for the titles of empty lists and libraries, implemented in span tags. Use if you wish to set different fonts for empty. Leave blank for ListViewer default. Values: [string] (valid name of a css class) Default value: "" (empty; ListViewer uses the class "ListViewer-EmptyLists")