Document Library Views

Top  Previous  Next

NeatClubs supports a few different ways of publishing documents and newsletters.

A Simple Listing
By Category Views
A Detailed View (for System Administrators)
Category / Sub Category views

 

If you wish to highlight only the documents in a particular user-defined document category, you can call the view_documents script with explicit arguments.

As an example, to show only the documents in "My Category", the URL would be as follows:

http://mysite.com/view_documents,php?user_category=User%20Category&view=simple

Valid arguments for the view_documents.php script are shown in the table below.  The returned documents will still be subject to document permissions. For example, a public visitor may see a different set of returned documents than a member with a login account that entitles them to see a wider set of documents.

Command Line Argument

Allowable Values

Description

view

simple | detailed | bycategory

Changes the view of the document library to a simple listing, a detailed view or a by category view (this will override the defaults in specified for the document library in the system setup)

user_category

any valid document user-defined category

This will restrict the returned list of documents to include only those documents in a matching user-defined category.

type

newsletter | documents

You can restrict the view to show only newsletters or include all document types except system documents and newsletters depending on the arguments provided for type.

Examples of the different views are shown below:

A Simple Listing

A URL invocation such as the one below can be used to provide a simple listing.

http://demo.neatclubs.com/view_documents.php?view=simple&user_category=Uploaded%20File

The default view will be similar to this one except that users would see all documents rather than just the documents in the user category "Uploaded File" as shown

clip0303

If an administrator views a simple listing, they see a similar view except that there are additional "quick link" icons to make it convenient for them to edit / delete or modify document properties.

Note that the administrator also has the option to switch to the more detailed administrator only view of the document library.

clip0304

 

By Category View

For sites with a larger set of documents to manage, a "By Category" view can be more appropriate. In this view each of the user-defined document categories are listed and users can click on the "+" sign to expand the view and show the document contained in a category. The screenshot below see what the administrator sees when the "bycategory" view is invoked.

clip0305

Detailed View (Administrators only)

When system administrators are logged in, they will see the view below. This more sophisticated views makes it easier to assign documents to different user-categories and change other document properties.

Note that in this view administrators can search for documents based on keywords or filter the list to include only documents in only particular user or system defined categories.

Please note that the "Mine" box is checked by default to restrict the list of returned documents.  To view documents created by other web-site users you should uncheck this box.

clip0306

 

Search by Category and Sub Category

Another useful view is to segment categories of information into categories and sub categories. This is used by document the "System Document Categories" with user-defined categories and user-defined subcategories in the document library.

Using this approach a view like the one below can be constructed. All documents are in a System Category called "results". The rows in the table below represent the user-defined categories. The pull-downs in each category represent the sub-categories. Selecting a subcategory and pressing select will return the list of documents in that System Category, User-defined category and Sub-Category. In some cases there will be only a single document and in other cases there may be many documents.

While this is a little complex to setup it is definitely easier that writing software from scratch! - we provide an example here of how Competitive Results can be managed using this approach.

This makes content management very easy since newly added content when assigned to the right categories will automatically appear in this view.

clip0308