Difference between revisions of "CcHost"

From Creative Commons
Jump to: navigation, search
(Requirements)
(update source repo link)
 
(223 intermediate revisions by 46 users not shown)
Line 1: Line 1:
{{incomplete}}
+
[[Category:ccHost]]
'''ccHost''' is an open source ([http://creativecommons.org/licenses/GPL/2.0/ GPL] licensed) project that provides web-based infrastructure to support collaboration, sharing, and storage of multi-media using the Creative Commons licenses and metadata. It is used by [http://ccmixter.org ccMixter] and [[#Usage Examples|other sites]].
+
[[Category:Developer]]
 +
[[Category:Software]]
 +
[[Category:Technology]]
 +
[[Category:ccMixter]]
 +
{{Project}}
 +
{{lowercase}}
  
== Information  ==
+
'''ccHost''' is Creative Commons' open source ([http://creativecommons.org/licenses/GPL/2.0/ GPL] licensed) [http://en.wikipedia.org/wiki/Content_management_system 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 [[#Zeitgeist|here]].
 
 
=== Short Description ===
 
  
"Web-based System Supporting Remixing and Collaboration on Media"
+
= Download =
  
=== Goal ===
+
Sign up for [http://sourceforge.net/export/rss2_projfiles.php?group_id=80503 our RSS release feed] to make sure you don't miss important bug fixes and feature updates.
  
The goal of this project is to spread media content that is licensed under
+
=== Current Stable Release ===
Creative Commons throughout the web in much the same way that weblogs spread
+
Latest stable build of [https://sourceforge.net/projects/cctools/files/ccHost/ ccHost 5.1] is available in ZIP archive format.
CC licensed text. ccHost is web-based infrastructure that may be used to host
 
and allow for commenting, remixing, and distribution globally. The more
 
installations of ccHost and its variations, the more content there will be
 
available for enjoyment and artistic re-use in a sane and legal setting. ccHost
 
is what is used for the infamous Creative Commons CC Mixter project which
 
supports legal media sharing and remixing. For more information, contact Jon
 
Phillips at jon@creativecommons.org.
 
  
=== [[ccHost FAQ|Frequently Asked Questions]] (FAQ) ===
+
=== Source Repository ===
  
=== Releases and Downloads ===
+
https://github.com/cc-archive/cchost
  
'''Current Version is 1.0.3'''
+
For much more developer info, see [[Cchost/Developers]].
  
==== ccHost files on Source Forge ====
+
= Documentation =
  
* http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675
+
[[cchost/Documentation|ccHost 5 Documentation]]
  
==== [[CcHost Press Releases|Press Releases]] ====
+
=Communication=
  
=== CVS ===
 
  
* [http://sourceforge.net/cvs/?group_id=80503 HOWTO use this project's CVS] - use module 'cchost1'
+
=== People ===
* [http://cvs.sourceforge.net/viewcvs.py/cctools/cchost1/ Browsable Anonymous CVS]
+
* [[User:fourstones|Victor Stone]]
 
+
* [[User:Jon Phillips|Jon Phillips]]
==== HOWTO Tag a Release ====
+
=== Contacting  ===
 
+
The mailing list is the best way to get our attention. That and other methods are listed below:
* inside the module you are tagging
 
* run: cvs tag CCHOST_1_0_2_RELEASE
 
 
 
=== Communication ===
 
 
 
* Chat: #cc on irc.freenode.net
 
* Wiki: This page (http://wiki.creativecommons.org/wiki/CcHost)
 
 
* Mailing List: https://lists.sourceforge.net/mailman/listinfo/cctools-cchost
 
* Mailing List: https://lists.sourceforge.net/mailman/listinfo/cctools-cchost
 
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]
 
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]
 +
* Chat: #cc on irc.freenode.net
 +
* Wiki: This page (http://wiki.creativecommons.org/CcHost)
 +
* [[Cchost/Developers#Bugs_and_Feature_Requests|Bugs and feature requests]]
  
=== Bugs and Feature Requests ===
+
= Zeitgeist =
 
+
=== Goal ===
''Make sure to use the 'ccHost' category when filing bugs. Also, please use a real email so that we can followup on any bugs posted. Be descriptive when posting and commenting on bugs (every bit counts).''
+
The goal of this project is to spread media content that is licensed under Creative Commons throughout the web in much the same way that weblogs spread CC licensed text.  
 
+
=== Short Description ===
* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
+
"Web-based System Supporting Remixing and Collaboration on Media"
* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
+
=== Slightly Longer Description ===  
 
+
'''ccHost''' is an open source ([http://creativecommons.org/licenses/GPL/2.0/ GPL] licensed) project that provides web-based infrastructure to support collaboration, sharing, and storage of multi-media using the Creative Commons licenses and metadata. It is the codebase used by [http://ccmixter.org ccMixter] and [[#Usage Examples|other sites]].
=== Support ===
 
 
 
==== Browsers ====
 
 
 
* Tested on: Firefox 1.0+ Mac/PC/Linux, IE 6+ PC, Safari Mac
 
* Javascript, XHTML 1.0+, CSS 2
 
 
 
== Usage Examples ==
 
 
 
*[http://ccmixter.org ccMixter] - Primary usage of ccHost is the Creative Commons remix site, ccMixter.
 
*[http://www.opensourcecinema.com/cchost Open Source Cinema]
 
*[http://www.matrix-rayne.com Matrix Rayne Online]
 
*[http://remix.machinehasnoagenda.com/ remix.linux]
 
*[http://www.ccmixter.co.za/ ccmixter South Africa]
 
*[http://fourstones.net fourstones.net] - Victor's personal website
 
* '''Please add your installation here.'''
 
  
== Installation ==
+
Besides its focus on sharing content, ccHost differentiates itself from other multi-media hosting programs by emphasizing the '''reuse''' (a.k.a. remixing) of content between artists[http://courtreportingagency.com ,] not only between artists on any given installation of ccHost, but between all installations across the web and any web site that implements the Creative Commons [http://ccmixter.org/media/viewfile/pool_api_doc.xml Sample Pool API], including non-ccHost sites such as the [http://freesound.iua.upf.edu/ freesound project].
  
''This needs to be added to and revised.''
+
=== Usage Examples ===
  
=== Requirements ===
+
* [http://ccmixter.org ccMixter] - Primary usage of ccHost is the Creative Commons remix site, ccMixter.
 +
* [http://fourstones.net fourstones.net] Victor's personal website
 +
* [http://www.enciclopediacecilia.org/remix/ Remix Cecilia] at the Enciclopedia Cecilia project (Spanish).
 +
* [http://audio.ibeat.org/ iBeat] Moderated Sample Archive
  
* PHP 4, MySQL 4, Cookies enabled in one's browser
+
----
* Install the GetID3 (1.7.3) library from here: http://www.getid3.org/#download before you install ccHost. (It's a simple download-unpack operation)
 
* If you would like integrated user comments and review threads you must install phpBB2 from http://www.phpbb.com/downloads.php. Ratings, Editorial Picks and Contest Polls are built into the core ccHost, user reviews and comments are NOT and relies on phpBB2 forum software to achieve this.
 
* '''Platforms''': This system has been tested on Apache 1 and 2 Windows and Linux. If you've got it working on IIS or OSX let us know. We haven't tried.
 
* Here is my block of code in the apache virtual host for setting the rewrite rules to get pretty urls:
 
  
<pre>
+
= Appendix A: Compatibility =
<VirtualHost *:80>
 
ServerName ccmixter.localhost
 
ServerPath /ccmixter
 
#DocumentRoot /var/www/localhost/htdocs/cchost
 
DocumentRoot /home/rejon/Documents/freelance/creativecommons/src/ccmixter
 
  
<Directory "/home/rejon/Documents/freelance/creativecommons/src/ccmixter">
+
=== Browsers ===
RewriteEngine On
 
RewriteBase /
 
RewriteCond %{REQUEST_FILENAME} !-d
 
RewriteCond %{REQUEST_FILENAME} !-f
 
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
 
</Directory>
 
  
</pre>
+
Recently tested on: Firefox 2/3 Mac/PC/Linux, IE 7 PC, Safari Mac (IE8 requires "compatibility" mode - see [[Cchost/guide/Troubleshooting#IE8_Layout_Issues|here]] for workaround)
  
==== MySQL commands for Setting up DB ====
+
Cookies must be enabled.
  
* install root mysql user:
+
Most skins (the ones people will want to use) require Javascript enabled.
** mysqladmin -u root password 'PASSWORD_HERE'
 
* once logged into mysql:
 
** create database cchost;
 
* to create a new user once inside mysql with access to a table cchost:
 
** grant all on cchost.* to jsmith@localhost identified by 'Secret15';
 
  
==== phpBB2 Installation ====
+
=== Servers ===
  
* [http://www.phpbb.com/downloads.php Download Version 2.0.17]
+
Primary development is done on Ubuntu 8.04 (hardy heron) using Apache, mySQL, and PHP. The actual dev setup is described in detail [[Cchost/Developers/Victor's_Dev_Setup|here]].
* [http://www.phpbb.com/support/documents.php?mode=install Installation Instructions]
 
  
 +
==== Linux ====
 +
ccHost on Apache (2.0.49 up to at least apache-2.0.55-r1) on Linux,
  
==== Notes ====
+
One should be able to easily install mySQL, PHP, and Apache (if they are not already available) through their distributions packaging system. See the dev setup above.
  
* Installing the CCHost software involved download the source files from [http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675 sourceforge], and running a simple installation script.  Permissions will need to be set on several folders, namely cclib/phptal/phptal_cache.
+
==== Windows IIS Server ====
* The text for the front page can be changed by editing ccfiles/home.xml.  The other menu functions etc are generally modified using the admin functions of the site.
 
  
== [[Development]] ==
+
{{Infobox|ccHost has not been seen running or tested on Windows for a long time - several versions ago.}}
  
=== [[ccHost Roadmap|Roadmap]] ===
+
Windows users with their installation disks may install optionally the Windows IIS Web Server. This option has been tested. However, there might still be issues with it, and if so, [http://sourceforge.net/tracker2/?func=browse&group_id=80503&atid=559966 please file a bug].
  
=== [[ccHost Release Procedure|Release Procedure]] ===
+
Even if you using Apache on Windows you may need to have IIS installed if you plan to use mail contact functions.
=== [[ccHost Community Building|Community Building]] ===
 
=== [[ccHost Testing|Testing and Debugging]] ===
 
=== [[ccHost Sample Pools|Sample Pools]] ===
 
  
== People ==
+
==== Windows Apache ====
 +
There are many good tutorials for setting up a Windows/Apache/MySQL/PHP site ([http://google.com/search?q=installing+WAMP Google search]) and all three subsystems now come with Windows installers making the job of installing relatively straightforward.
  
* [[User:Victor Stone|Victor Stone]]
+
====== XAMPP ======
* [[User:Jon Phillips|Jon Phillips]]
+
Windows installations without Apache, mySQL and PHP already installed should consider using [http://www.apachefriends.org/en/xampp.html XAMPP] for Windows, which provides an easy install of Apache web server, MySQL database server, and PHP and perl programming languages. This is an easy way to get up and running, with the underlying technology necessary to use ccHost.
  
 +
Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.
  
== [[ccHost History|History]] ==
+
==== Mac OS X ====
  
 +
''NOTE: This setup is similar to Linux.''
  
== Research ==
+
Verified:
  
* Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/
+
* OS X 10.4.6
 +
* default OS X MySQL build, 4.0.26
 +
* GetID3 1.7.7
 +
* default Apache/PHP
  
[[Category:CcHost]]
+
[http://wiki.creativecommons.org/Creative_commons_non_profit_organization About Creative Commons]
[[Category:Developer]]
 

Latest revision as of 03:17, 30 September 2014


ccHost is Creative Commons' open source (GPL licensed) 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.

Download

Sign up for our RSS release feed to make sure you don't miss important bug fixes and feature updates.

Current Stable Release

Latest stable build of ccHost 5.1 is available in ZIP archive format.

Source Repository

https://github.com/cc-archive/cchost

For much more developer info, see Cchost/Developers.

Documentation

ccHost 5 Documentation

Communication

People

Contacting

The mailing list is the best way to get our attention. That and other methods are listed below:

Zeitgeist

Goal

The goal of this project is to spread media content that is licensed under Creative Commons throughout the web in much the same way that weblogs spread CC licensed text.

Short Description

"Web-based System Supporting Remixing and Collaboration on Media"

Slightly Longer Description

ccHost is an open source (GPL licensed) project that provides web-based infrastructure to support collaboration, sharing, and storage of multi-media using the Creative Commons licenses and metadata. It is the codebase used by ccMixter and other sites.

Besides its focus on sharing content, ccHost differentiates itself from other multi-media hosting programs by emphasizing the reuse (a.k.a. remixing) of content between artists, not only between artists on any given installation of ccHost, but between all installations across the web and any web site that implements the Creative Commons Sample Pool API, including non-ccHost sites such as the freesound project.

Usage Examples

  • ccMixter - Primary usage of ccHost is the Creative Commons remix site, ccMixter.
  • fourstones.net Victor's personal website
  • Remix Cecilia at the Enciclopedia Cecilia project (Spanish).
  • iBeat Moderated Sample Archive

Appendix A: Compatibility

Browsers

Recently tested on: Firefox 2/3 Mac/PC/Linux, IE 7 PC, Safari Mac (IE8 requires "compatibility" mode - see here for workaround)

Cookies must be enabled.

Most skins (the ones people will want to use) require Javascript enabled.

Servers

Primary development is done on Ubuntu 8.04 (hardy heron) using Apache, mySQL, and PHP. The actual dev setup is described in detail here.

Linux

ccHost on Apache (2.0.49 up to at least apache-2.0.55-r1) on Linux,

One should be able to easily install mySQL, PHP, and Apache (if they are not already available) through their distributions packaging system. See the dev setup above.

Windows IIS Server

ccHost has not been seen running or tested on Windows for a long time - several versions ago.

Windows users with their installation disks may install optionally the Windows IIS Web Server. This option has been tested. However, there might still be issues with it, and if so, please file a bug.

Even if you using Apache on Windows you may need to have IIS installed if you plan to use mail contact functions.

Windows Apache

There are many good tutorials for setting up a Windows/Apache/MySQL/PHP site (Google search) and all three subsystems now come with Windows installers making the job of installing relatively straightforward.

XAMPP

Windows installations without Apache, mySQL and PHP already installed should consider using XAMPP for Windows, which provides an easy install of Apache web server, MySQL database server, and PHP and perl programming languages. This is an easy way to get up and running, with the underlying technology necessary to use ccHost.

Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.

Mac OS X

NOTE: This setup is similar to Linux.

Verified:

  • OS X 10.4.6
  • default OS X MySQL build, 4.0.26
  • GetID3 1.7.7
  • default Apache/PHP

About Creative Commons