Difference between revisions of "CcHost5Documentation"

From Creative Commons
Jump to: navigation, search
Line 3: Line 3:
 
=Introduction=
 
=Introduction=
  
==Understanding ccHost URLs==
+
Welcome to the ccHost version 5 Documentation.  Here you will find a general overview of ccHost, a FAQ, and detailed descriptions of the various settings available to the administrator. 
 +
 
 +
'''ccHost''' is Creative Commons' open source ([http://creativecommons.org/licenses/GPL/2.0/ GPL] licensed) media content management system project that powers [http://ccmixter.org ccMixter] and is the winner of the [http://creativecommons.org/weblog/entry/6026 Linux Journal LinuxWorldExpo Product Excellence Award] for '''Best Open Source Solution.''' Read more about ccHost [[CcHost#Zeitgeist|here]].
 +
 
 +
=FAQ/Cookbook=
 +
 
 +
==How do I change the banner (logo)?==
 +
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "Banner Logo" link, click on the "Browse" button and select your preferred image.  Hit Submit and enjoy!
 +
 
 +
==How do I restrict file types users can upload?==
 +
Log in as an administrator and navigate to "Global Settings."  Each filetype which is desired to be blocked should be set to "(D)isabled."  The "(S)ignature" and "(V)erify" options allow uploads with either a simple check of signature or full file verification using getID3, respectively.
 +
 
 +
==How do I restrict licenses?==
 +
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "License" link.  On that page you can select which supported licenses the users are able to assign to their work.  When you are satisfied click on "Submit."
 +
 
 +
For information on the Creative Commons Licenses see: http://creativecommons.org/licenses/
 +
 
 +
==How do I add administrators?==
 +
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "Settings" link.  On that page you can add more registered usernames to the list of Admins.  Simply separate them by a comma and space, eg: admin, fourstones, rejon, greg
 +
 
 +
=Administrative Settings=
 +
 
 +
There are two Administrative Settings sections: ''Manage Site'' and ''Global Settings.''
 +
 
 +
To view the '''Manage Site''' documentation see [[ccHost5Documentation/ManageSite]]
 +
 
 +
To view the '''Global Settings''' documentation see [[ccHost5Documentation/GlobalSettings]]
 +
 
 +
=Understanding ccHost URLs=
  
 
Understanding how URLs work in ccHost is a very important concept that you should understand before doing anything else.
 
Understanding how URLs work in ccHost is a very important concept that you should understand before doing anything else.
  
=== URL Parts ===
+
== URL Parts ==
  
 
ccHost URLs are composed of four main parts:
 
ccHost URLs are composed of four main parts:
Line 32: Line 60:
  
 
  http://example.com?ccm=/media/people/rejon
 
  http://example.com?ccm=/media/people/rejon
 
=FAQ/Cookbook=
 
 
==How do I change the banner (logo)?==
 
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "Banner Logo" link, click on the "Browse" button and select your preferred image.  Hit Submit and enjoy!
 
 
==How do I restrict file types users can upload?==
 
Log in as an administrator and navigate to "Global Settings."  Each filetype which is desired to be blocked should be set to "(D)isabled."  The "(S)ignature" and "(V)erify" options allow uploads with either a simple check of signature or full file verification using getID3, respectively.
 
 
==How do I restrict licenses?==
 
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "License" link.  On that page you can select which supported licenses the users are able to assign to their work.  When you are satisfied click on "Submit."
 
 
For information on the Creative Commons Licenses see: http://creativecommons.org/licenses/
 
 
==How do I add administrators?==
 
Log in as an administrator and go to the "Manage Site" section.  If running multiple sites make sure you select the site you want to edit from the dropdown menu on top.  Click on the "Settings" link.  On that page you can add more registered usernames to the list of Admins.  Simply separate them by a comma and space, eg: admin, fourstones, rejon, greg
 
 
=Administrative Settings=
 
 
There are two Administrative Settings sections: ''Manage Site'' and ''Global Settings.''
 
 
To view the '''Manage Site''' documentation see [[ccHost5Documentation/ManageSite]]
 
 
To view the '''Global Settings''' documentation see [[ccHost5Documentation/GlobalSettings]]
 

Revision as of 18:44, 28 July 2008

Introduction

Welcome to the ccHost version 5 Documentation. Here you will find a general overview of ccHost, a FAQ, and detailed descriptions of the various settings available to the administrator.

ccHost is Creative Commons' open source (GPL licensed) media content management system project that powers ccMixter and is the winner of the Linux Journal LinuxWorldExpo Product Excellence Award for Best Open Source Solution. Read more about ccHost here.

FAQ/Cookbook

How do I change the banner (logo)?

Log in as an administrator and go to the "Manage Site" section. If running multiple sites make sure you select the site you want to edit from the dropdown menu on top. Click on the "Banner Logo" link, click on the "Browse" button and select your preferred image. Hit Submit and enjoy!

How do I restrict file types users can upload?

Log in as an administrator and navigate to "Global Settings." Each filetype which is desired to be blocked should be set to "(D)isabled." The "(S)ignature" and "(V)erify" options allow uploads with either a simple check of signature or full file verification using getID3, respectively.

How do I restrict licenses?

Log in as an administrator and go to the "Manage Site" section. If running multiple sites make sure you select the site you want to edit from the dropdown menu on top. Click on the "License" link. On that page you can select which supported licenses the users are able to assign to their work. When you are satisfied click on "Submit."

For information on the Creative Commons Licenses see: http://creativecommons.org/licenses/

How do I add administrators?

Log in as an administrator and go to the "Manage Site" section. If running multiple sites make sure you select the site you want to edit from the dropdown menu on top. Click on the "Settings" link. On that page you can add more registered usernames to the list of Admins. Simply separate them by a comma and space, eg: admin, fourstones, rejon, greg

Administrative Settings

There are two Administrative Settings sections: Manage Site and Global Settings.

To view the Manage Site documentation see ccHost5Documentation/ManageSite

To view the Global Settings documentation see ccHost5Documentation/GlobalSettings

Understanding ccHost URLs

Understanding how URLs work in ccHost is a very important concept that you should understand before doing anything else.

URL Parts

ccHost URLs are composed of four main parts:

1. Root URL of installation

2. Virtual Root

  • Don't worry if you don't know what a 'ccHost virtual root' is, we'll get to it here but for now assume it's the word media.

3. Command

  • This part of the URL maps to an internal command in ccHost. This can be anything from a request for a submit form, a feed, a record listing, etc. Examples are people which shows a listing of the latest registered users who have uploaded or files which lists the latest uploads.

4. Parameters

  • Many if not most commands accept and even require parameters. For example, adding a specific user's name to the people command will display the user's main page, e.g. people/rejon

You should refer to the ccHost Command Reference for a listing of all available commands.

If you have enabled 'pretty URLs' in your installation then all the elements are strung together into one URL:

http://example.com/media/people/rejon

If not, then everything starting from the virtual root is prepended the following way:

http://example.com?ccm=/media/people/rejon