Document Properties

Top  Previous  Next

All types of documents in NeatClubs.COM (including uploaded files, newsletters, web pages etc.) can have their properties modified.

When viewing the document listing as a system administrator, the edit properties icon is used to change the properties of a document.

clip0309

You can change any of the settings described below and press "Save Document Properties" to have changes take effect

A sample document properties screen is shown below.

clip0573

The meanings of these fields (that are not self-explanatory) are covered below:

Document Property

Explanation

Document name

A short descriptive name for the document. Documents will normally be display sorted alphabetically by the name provided here.

Description / Abstract

A couple of sentences describing what this document is all about. For best results you should try and make this is a little longer than the short description and have it provide additional information.

Contributor

This is the name of the person who created the document

Date created

This is the date on which the document was initially created

Date last modified

This setting includes the date that this document was last saved to the database.

System Category

Select valid document categories here. System Categories are defined site-wide under Categories & Definitions in the System Setup.

Select User Category

The user category can be any value. If you want to associate this document with an existing user-defined category, select the existing category from this list to populate the field below.

User Category

You can enter a user category here. If you type a new user category name it will be added to the list of available user categories automatically.

Select sub-category

Most documents will not have subcategories, but if you have valid sub-categories already established, you can select a sub-category here.

Optional sub-category

Use this field to enter a new document sub-category if not available on the list above. The value provided in this field is interpreted to be the subcategory.

An example of how sub-categories might be used to show competitive results is provided here.

Optional re-direct URL

If using subcategories, sometimes we would like to add a sub-category which is really just a re-direct to a specific URL. If a URL is entered here, in the subcategory view rather than show the document content a link will be provided to the provided URL (the URL provided here is assume to be valid) - in most cases this field will be blank.

Visible to members of type

Indicates what member categories are able to see this document when logged in. Member types are setup system wide under Categories & Definitions.

 

clip0656

The meanings of these fields (that are not self-explanatory) are covered below:

Document Property

Explanation

Enable Fast, Ajax Style Document Loading

Often, side panel and top-panel menu items link to NeatClubs documents. Documents that contain simple HTML are candidates for ultra-fast Ajax style page loads whereas more complex documents that embed Flash or Javascript are not . Setting this document property to "Yes" for fast Ajax loads means that for embedded content (implying files with no attachments) you accept that the contents of the page are simple and are cool with Ajax techniques being used to inject content into the web-page thus resulting in an approximate "10 times" performance improvement. This is very much worth doing, so generally "Yes" is the right answer unless you suspect the contents of your document are complex. If you have concern that you are embedding advanced content in the page however,  or if you experience problems, "No" is the safer answer. We have assumed "No" making this a particularly important setting for review.

Include in listings

If enabled, documents will appear by default in the simple listings subject to file permissions.

Searchable in Google

If enabled, the web-site will proactively include this page in the Google searchable sitemap

Featured document

If Featured Documents are enabled, enabling this checkbox will result in this document being included as a Featured Document on the side panel.

Print page icon

If enabled, a convenient "Print" icon will be displayed on each content page and selected system generated pages  to create a print friendly view of the page

Scroll bars

This controls what happens when content on the page is too wide to fit in the center column width specified in the Preferences / Appearance settings. Normally content will be "clipped". If scroll bars are enabled, users will be able to scroll through the center panel to see wide content.

Suppress Left Column

If set to yes, when the document is displayed the left column will be suppressed. It will be up to the document designer to make sure that there are navigation links since the side panel menu will not be shown.

Suppress Right Column

If set to yes, when the document is displayed the right column will be suppressed for this document only.

Suppress Page Specific CSS

If enabled, site-wide CSS (cascading style sheet content) configured in the Advanced CSS customization will be suppressed for this page only. This is useful if you have unique content on a page that is not appropriate to show with the regular site-wide CSS style.

Over-ride background color

A hexadecimal number (e.g. "#ff0000") or written color ("Red") can be included to provide a background color for this document that differs from the rest of the site. Please exercise caution when doing this - it is easy to create terrible looking pages using this feature!

Height after which to scroll

This setting is valid only if scroll bars are enabled. This controls the vertical height in pixels to allow for the document display before scroll bars are enabled in the vertical direction. This is useful if you don't want a long content to artificially elongate your site in the vertical direction.

clip0629

The meanings of these fields (that are not self-explanatory) are covered below:

Document Property

Explanation

Newsletter Header graphic

This option is valid only for documents in the System Category "Newsletters". By specifying an alternate Header Graphic (from the System Category "E-Mail Header Graphics"), you can over-ride the system wide default and have your Newsletters go out with a customized header specific to the Newsletter.

Website Header Graphic

When this document is viewed, you can replace the site's normal web-site header graphic with a different header selected here. If this option is select the option below should not be selected.

Website Header Document

For more sophisticated requirements, it is useful to be able to insert HTML content in the page where the web-header would normally appear. This option allows you to select a document containing HTML that will appear in the header area over-riding the defaults for this document only.

Header height for this page

You can customize the header height for this page if different than the system-wide default. If a value of zero is entered the system default configured under "Appearance" will be assumed. It is up to the site designer to make sure that the header graphic or header document specific to this page fits in the allocated vertical space.

Side panel document

Use this option to have pictures in a user-defined photo category appear in the side panel whenever this document is viewed.

Side panel Gallery on view

Use this option to have pictures in a user-defined photo category appear in the side panel whenever this document is viewed.

clip0630

 

Document Property

Explanation

No Attached File / Attached File

Using this setting you can either remove an attachment from a document or update the file to link to a different attachment or version of the same attachment. This is often easier than deleting and re-creating the document in the document library.

File to Attach

Use the browse key to select the document on your local file system to upload

Type of Attachment

When you upload a new file, use this option to tell NeatClubs what kind of document this is (this helps NeatClubs display the correct graphic symbol when the document is viewed)

It is important that this value be selected - otherwise the new attachment will be ignored.