Difference between revisions of "Cchost/admin/FAQ and Cookbooks"

From Creative Commons
Jump to: navigation, search
(typo)
(How do I change the banner (logo)?)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
[[Category:ccHost]]
 +
[[Category:ccMixter]]
 +
[[Category:Developer]]
 +
[[Category:Software]]
 +
[[Category:Technology]]
 +
{{lowercase}}
 
{{draft}}
 
{{draft}}
 
Go back to [[cchost/admin|ccHost Administrators' Documentation]]
 
Go back to [[cchost/admin|ccHost Administrators' Documentation]]
  
=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 add new file types to the system?=
 +
*Log in as an administrator (if not already)
 +
*Click on ''Global Settings'' then ''Pseudo Verify'' (or browse to '''admin/pverify''')
 +
*Follow the instructions at the top of the screen
 +
*When you finished click on the ''Submit'' button
 +
*Follow the instructions directly below to enable the file type in submit forms.
 +
 
 +
=How do I enable/restrict file types users can upload?=
 +
*Log in as an administrator (if not already)
 +
*Click on ''Mangage Site'' then ''File Formats'' (or browse to '''admin/formats''')
 +
*Check the boxes for the formats you want to allow
 +
*Click on the ''Submit'' button
  
 
=How do I restrict licenses?=
 
=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."
+
*Log in as an administrator (if not already)
 
+
*Click on ''Manage Site'' then ''License'' (or browse to '''admin/license''')
 +
*Check the licenses you want to enable in submit forms
 +
*Click on the ''Submit'' button
 
For information on the Creative Commons Licenses see: http://creativecommons.org/licenses/
 
For information on the Creative Commons Licenses see: http://creativecommons.org/licenses/
  
 
=How do I add administrators?=
 
=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
+
*Log in as an administrator (if not already)
 +
*Click on ''Manage Site'' then ''Settings'' (or browse to '''admin/settings''')
 +
*At the ''Site Administrators'' field, enter a comma separated list of log in names. (If the user name is not in use yet, the next user that registers with that name will become an admin)
 +
*Click on the ''Submit'' button
  
=How do I edit the navigation tabs at the top of the page?=
 
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 "Navigator Tab Sets" link.  Click on the "[Edit tabs]" link for the associated tab set you want to edit.
 
  
To create a new tab click on "Add Tab."  Give it a name (internal only), Display Name (what is displayed), Help Hint ("tooltip" when hovering over with mouse pointer), define its action, and set access level.
 
  
On that page you are also able to remove unwanted tabs and edit what all of the current tabs' functions are.
 
  
=How do I manage page and topic content in ccHost?=
 
 
For the complete howto, see [[CcHost5Documentation/Content_Manager|Content Manager Howto]].
 
  
 
=How do I repair a broken configruation (A.K.A. HELP!!!!)=
 
=How do I repair a broken configruation (A.K.A. HELP!!!!)=
Line 42: Line 55:
 
*Click on the word 'media' to open the configuration settings and see if you can spot the error
 
*Click on the word 'media' to open the configuration settings and see if you can spot the error
 
*After you have fixed (or decided you can't fix) the problem make sure to the put the '//' back into the cchost_lib/cc-config-repair.php file otherwise you will leave a large gaping security hole in your site
 
*After you have fixed (or decided you can't fix) the problem make sure to the put the '//' back into the cchost_lib/cc-config-repair.php file otherwise you will leave a large gaping security hole in your site
 
=How to Configure the Query Browser=
 
 
ccHost 5.0 includes admin configurable query brower. You can see examples
 
of the browser in action at http://ccmixter.org/browse and http://fourstones.net/browse
 
 
This browser is a query builder (see http://your_install_root/query for documentation
 
on ccHost Query API). The browser can configured with option sets (optset) that determine
 
several visual features.
 
 
In order to create an optset:
 
 
1. Click on 'Global Settings' ( admin/site/global )
 
 
2. Click on 'Query Browser'  ( admin/browse )
 
 
3. Here you can edit the default optset and create different optsets for the
 
browser
 
 
    Name - The 'name' is important because it will be used in the browse URL's
 
          'optset' parameter. If no optset parameter is in the URL then the
 
          optset called 'default' is assumed
 
 
    Template - Select the template that will be used to show results
 
 
    Style    - Select the style sheet
 
 
    Def. limit - Enter the initial amount to display in the results area
 
 
    Playlist but. - Check this if you want to have the 'Save to playlist' button
 
                    (this only applies to sites with playlists enabled).
 
 
    Req. tags - These tags will be added to every query made, the user
 
                can NOT edit these.
 
 
    Types - Click on the "Edit types" to bring up a popup that allows you edit what
 
            the user will see in the 'Types' select box and what tags they map to.
 
 
    Filter on: User - Check this to include the 'User' look up field
 
 
    Filter on: License - Check this to include the 'License' look up field
 
 
Click on 'Add Option Set' to create new, custom option sets.
 
 
4. Once you have saved your optsets you can then see the results by specifying
 
them in the 'browse' URL. Examples
 
 
To use the 'default' optset simply browse to: http://your_install_root/browse
 
 
To use a different optset browse to: http://your_install_root/browse?optset=your_optset_name
 
 
5. You can specify 'start-up' values based on the Query API
 
 
    http://your_install_root/browse?tags=hip_hop&limit=15
 
 
    http://your_install_root/browse?user=teru
 
 
The user can then change these values once in the browser.
 
 
This can be very useful for menu items and navigation tabs.
 
 
==Customizing the Query Browser (Developers)==
 
 
To make your own custom styles for the entire query browser:
 
 
      a: Copy ''ccskins/shared/css/qbrowser_narrow.css'' to
 
        ''your_cchost_files/skins/css/my_browser_styles.css''
 
 
      b: Edit the 'desc' line at the top to something meaningful to you
 
 
      c: Edit the import urls to point to ccskins versions of
 
        those files
 
 
      d: Browse to admin/browse and select your stylesheet
 
        in the "Style"
 
 
To make your custom results templates:
 
 
      a: Copy ''ccskins/shared/formats/simple_qbrowser.tpl'' to
 
        ''your_cchost_files/skins/formats/my_browser_results.tpl''
 
 
      b: Edit the 'desc' line at the top to something meaningful
 
        to you
 
 
      c: The current dataview for that template is 'playlist_line'
 
        which has limited information per record. If you like
 
        a more full record of information change the dataview
 
        line to 'default'
 
 
      d: Browse to admin/browse and select your template in the
 
        "template" section
 

Latest revision as of 21:25, 7 November 2008

Go back to ccHost Administrators' Documentation


How do I add new file types to the system?

  • Log in as an administrator (if not already)
  • Click on Global Settings then Pseudo Verify (or browse to admin/pverify)
  • Follow the instructions at the top of the screen
  • When you finished click on the Submit button
  • Follow the instructions directly below to enable the file type in submit forms.

How do I enable/restrict file types users can upload?

  • Log in as an administrator (if not already)
  • Click on Mangage Site then File Formats (or browse to admin/formats)
  • Check the boxes for the formats you want to allow
  • Click on the Submit button

How do I restrict licenses?

  • Log in as an administrator (if not already)
  • Click on Manage Site then License (or browse to admin/license)
  • Check the licenses you want to enable in submit forms
  • Click on the Submit button

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

How do I add administrators?

  • Log in as an administrator (if not already)
  • Click on Manage Site then Settings (or browse to admin/settings)
  • At the Site Administrators field, enter a comma separated list of log in names. (If the user name is not in use yet, the next user that registers with that name will become an admin)
  • Click on the Submit button



How do I repair a broken configruation (A.K.A. HELP!!!!)

If you get into 'trouble' with your system you might be able to salvage your site by browsing to either:

If you are not logged in as an administrator when trying this you will have to:

  • Open the cchost_lib/cc-config-repair.php file in a text editor
  • Remove the two forward slashes '//' before the word 'return' in the line at the top of the file
  • Save this file to disk
  • From your browser, go to 'http://your_server/cchost_lib/cc-config-repair.php'. This should bring up a configuration editor
  • Click on the word 'media' to open the configuration settings and see if you can spot the error
  • After you have fixed (or decided you can't fix) the problem make sure to the put the '//' back into the cchost_lib/cc-config-repair.php file otherwise you will leave a large gaping security hole in your site