Creative Commons - User contributions [en]

Talk:CcHost

2006-06-27T21:53:55Z

Jeremy Butler: Reorganization

I tried to upgrade from 1.0.3 to 2.0.1 and the update script just returns ccHost Installation not complete. So, I tried doing a 2.0 then a 2.0.1, and i got the same error. I don't have much in my database yet, so I suppose I can start from 0, but that isn't cool. . .

If I wrote over something I shouldn't have (I straight copied with Overwrite existing files turned on), the instructions need to be more specific. I don't mean to complain, just to put in some constructive crit.. =) I'd hate to have someone who has lots of stuff in their database lose everything because of a botched upgrade...

[[User:Brenton Simpson | -Brenton]] April 13, 2006, 12:39AM

'''UPDATE:''' Maybe I was just being a dumbass and didn't rename ccadmin. I ended up backing up cc_tbl_user with flashmyadmin, reinstalling, and reimporting the user table. The error for this really should be more descriptive, or at least the update instructions should include a reminder regarding the ccadmin trigger. There's quite a difference between f%cking up your install in an upgrade and triggering a security warning. Speaking of which, how do I get certified by Sourceforge to help maintain this project?

== Reorganization ==

Since this wiki is linked to from the footer of the default installation, I'd recommend reorganizing the main page so that it's less oriented toward developers. Perhaps all the developer info could be moved to a separate page? --[[User:Jeremy Butler|Jeremy Butler]] 21:53, 27 June 2006 (UTC)

CcHost

2006-06-27T21:51:29Z

Jeremy Butler: clean-up, reorganization

{{incomplete}}
'''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]].

== Information ==

=== Short Description ===

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

=== 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. 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) ===

=== Releases and Downloads ===

'''Current Version is 2.0.1'''

==== ccHost files on Source Forge ====

* http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675

==== [[CcHost Press Releases|Press Releases]] ====

==== Experimental Thrice-Daily Builds ====

Currently, cchost packages are being made three-times a day and are available here: http://mirrors.creativecommons.org/cchost/packages/

''Download, install and use these packages at your own risk.''

Only 30 days worth of builds are saved currently.

=== SVN (Source Code Repository) ===

* [http://sourceforge.net/svn/?group_id=80503 HOWTO use this project's Subversion (SVN)] - use module 'cchost'
* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Anonymous SVN]
* [http://wiki.creativecommons.org/Source_Repository_Information Help with cctools SVN setup]

==== HOWTO Tag a Release ====

Really, each major release needs to be tagged, but this 2.0.1 is the first SVN release, and we did it pots CVS -> SVN migration. In the future, this is the proper way to tag and branch.

<pre>
svn copy https://svn.sourceforge.net/svnroot/cctools/cchost/trunk \
https://svn.sourceforge.net/svnroot/cctools/cchost/tags/2_0_1 \
-m "Tagging 2.0.1 bugfix release"
</pre>

[http://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html Here is more about SVN merging/branching].

=== Packaging ===

==== Sign Package ====

You should do this for all packages (RPM, tar.gz, zip, tar.bz2, etc)
<pre>
gpg --detach-sign --armor cchost-VERSION.tar.gz
</pre>

==== Verify Package ====
<pre>
gpg --verify cchost-VERSION.tar.gz.asc
</pre>

=== 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
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]

=== Bugs, Patches and Feature Requests ===

''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).''

* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
* [[HOWTO Patch|Submit Patches]]

=== 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
*[http://www.openclipart.org/cchost/ Open Clip Art Library ccHost in testing]
*[http://www.esolpc.com/teacherhost/ TeacherHost] - for Instructors to share instructional materials.
* '''Please add your installation here.'''

== Installation ==

=== General Requirements ===
* PHP 4 (PHP 5 works if you sync to latest code.)
* MySQL 4 (MySQL 5 works if you sync to latest code; MySQL 3 is not supported.)
* GetID3
**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.)
* Cookies enabled in one's browser.
* '''Platforms''': This system has been tested on Apache 1 and 2 Windows and Linux. It also works with IIS on Windows. If you receive an error about DOCUMENT_ROOT, ignore it. IIS doesn't use DOCUMENT_ROOT, and ccHost doesn't seem to mind. If you have tested ccHost on System X or any other platform, please register as a ccDeveloper and update this page! Thanks. =)
** Apache 2.0.49 up to at least apache-2.0.55-r1 works with cchost 2.0.1
* '''Optional''': Here is the block of code in the Apache virtual host for setting the rewrite rules to get pretty urls:

<pre>
<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">
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
</Directory>
</VirtualHost>
</pre>

=== Web Hosting Services ===
Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface from which to setup a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the cchost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the requirements below and with your hosting service.

=== Windows ===

==== XAMPP ====
It is recommended to download [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 the easiest way to get up and running, as this system replicates the standard Open Source (and Linux) setup of a time-tested server, [http://www.apache.org/ Apache], along with the required MySQL database and PHP programming language, all 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.

==== Windows IIS Server ====

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.

=== Linux ===

Primary development is done on up-to-date Linux development systems using apache, mysql, and php. One should be able to easily install mysql, php, and apache (if they are not already available) through their distributions packaging system.

===Step-by-step instructions ===
====Simple or hosted environment====
If you are using a shared server or other hosted site (like Dreamcast, etc.) then your hosting service probably provided you with a web interface for creating a database, doing file uploads and setting permissions for files and directories.
#Create a new database for ccHost BEFORE running this installation.
#Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.
#Browse to http://where_you_installed/ccadmin and follow all the instructions from then on.

====Advanced environment====
If you have basic knowledge of using FTP and you are comfortable at a UNIX/Linux command line you can use these steps to install:

#Unzip the ccHost ZIP or tar.bz2 archive on your local system and copy the files (retaining the directory structure) to your web-server directory. Change the group and permissions of the files so they may be written by the web server (e.g., in the following lines, the web-server account is "apache").
#*For example:
#*#cp -a cchost-1.0.3 /var/www/localhost/htdocs/cchost
#*#chgrp -R apache /var/www/localhost/htdocs/cchost
#*#chmod g+w /var/www/localhost/htdocs/cchost/
#*#chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/
#Install the GetID3 (1.7.3) library from here: http://www.getid3.org/#download . Unpack the package, and then copy the GetID3 directory to the location it will be accessed. For example:
##tar xzf getid3.tar.gz
##cp -a getid3/getid3 /var/www/localhost/htdocs/cchost/
#Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin"). For example:
##mysql -p -u root
##mysql> CREATE DATABASE cchost;
##mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE ON cchost.* TO 'cchostadmin'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';
##*Make sure to change 'YOUR_PASSWORD_HERE' (and maybe 'cchostadmin') to something unique to your site.
##*Many systems provide phpMyAdmin to take care of these tasks.
##Create directory /var/log/cchost or other location to store log files. Must be writable by the web-server account (e.g., "apache"). For example:
###mkdir /var/log/cchost
###chown apache:apache /var/log/cchost
##Browse to <nowiki>http://where_you_installed_cchost/ccadmin</nowiki>
##*Everything else you need to know will be on the screen from that point on, including suggested php.ini and .htaccess settings, access permissions requirements, etc.

Take Note: On the last screen of the installation process you'll be prompted to read about specific issues regarding file permissions. '''DO NOT SKIP THIS STEP!'''
===Upgrade existing ccHost installations===
#Log in as administrator
#Copy this installation over your current installation.
#Browse to: <nowiki>http://where_you_installed/?update=1</nowiki>

Note to 1.x ccHost installations: phpBB2 is no longer used for reviews. There is a script for importing existing phpBB2 format reviews into the new native reviewing system. Contact fourstones@users.sourceforge.net for details.

=== Notes ===

* Installing the CCHost software involves downloading 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.
* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.

== Development ==

=== Documentation ===

* [http://mirrors.creativecommons.org/cchost/docs/ PHPDOC Documentation of PHP Code]
* '''Victor's Developers Guide''' Coming Soon!

=== Discussion ===

* [[ccHost Localization]] - steps for i18n internationalization/localization

=== [[ccHost Roadmap|Roadmap]] ===
=== [[ccHost Release Procedure|Release Procedure]] ===
=== [[ccHost Community Building|Community Building]] ===
=== [[ccHost Testing|Testing and Debugging]] ===
=== [[ccHost Sample Pools|Sample Pools]] ===

== People ==

* [[User:Victor Stone|Victor Stone]]
* [[User:Jon Phillips|Jon Phillips]]

== [[ccHost History|History]] ==

== Research ==

* Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/

[[Category:CcHost]]
[[Category:Developer]]
[[Category:opensource]]
[[Category:Technology]]

CcHost

2006-06-27T21:43:26Z

Jeremy Butler: /* Installation Steps */ replaced with more detailed explanation from install.txt

{{incomplete}}
'''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]].

== Information ==

=== Short Description ===

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

=== 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. 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) ===

=== Releases and Downloads ===

'''Current Version is 2.0.1'''

==== ccHost files on Source Forge ====

* http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675

==== [[CcHost Press Releases|Press Releases]] ====

==== Experimental Thrice-Daily Builds ====

Currently, cchost packages are being made three-times a day and are available here: http://mirrors.creativecommons.org/cchost/packages/

''Download, install and use these packages at your own risk.''

Only 30 days worth of builds are saved currently.

=== SVN (Source Code Repository) ===

* [http://sourceforge.net/svn/?group_id=80503 HOWTO use this project's Subversion (SVN)] - use module 'cchost'
* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Anonymous SVN]
* [http://wiki.creativecommons.org/Source_Repository_Information Help with cctools SVN setup]

==== HOWTO Tag a Release ====

Really, each major release needs to be tagged, but this 2.0.1 is the first SVN release, and we did it pots CVS -> SVN migration. In the future, this is the proper way to tag and branch.

<pre>
svn copy https://svn.sourceforge.net/svnroot/cctools/cchost/trunk \
https://svn.sourceforge.net/svnroot/cctools/cchost/tags/2_0_1 \
-m "Tagging 2.0.1 bugfix release"
</pre>

[http://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html Here is more about SVN merging/branching].

=== Packaging ===

==== Sign Package ====

You should do this for all packages (RPM, tar.gz, zip, tar.bz2, etc)
<pre>
gpg --detach-sign --armor cchost-VERSION.tar.gz
</pre>

==== Verify Package ====
<pre>
gpg --verify cchost-VERSION.tar.gz.asc
</pre>

=== 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
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]

=== Bugs, Patches and Feature Requests ===

''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).''

* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
* [[HOWTO Patch|Submit Patches]]

=== 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
*[http://www.openclipart.org/cchost/ Open Clip Art Library ccHost in testing]
*[http://www.esolpc.com/teacherhost/ TeacherHost] - for Instructors to share instructional materials.
* '''Please add your installation here.'''

== Installation ==

=== General Requirements ===

=== Common Wed Hosting Services ===

Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface from which to setup a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the cchost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the requirements below and with your hosting service.

=== Windows ===

==== XAMPP ====
It is recommended to download [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 the easiest way to get up and running, as this system replicates the standard Open Source (and Linux) setup of a time-tested server, [http://www.apache.org/ Apache], along with the required MySQL database and PHP programming language, all 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.

==== Windows IIS Server ====

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.

=== Linux ===

Primary development is done on up-to-date Linux development systems using apache, mysql, and php. One should be able to easily install mysql, php, and apache (if they are not already available) through their distributions packaging system.

== Step-by-step instructions ==
====Simple or hosted Environment====
If you are using a shared server or other hosted site (like Dreamcast, etc.) then your hosting service probably provided you with a web interface for creating a database, doing file uploads and setting permissions for files and directories.
#Create a new database for ccHost BEFORE running this installation.
#Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.
#Browse to http://where_you_installed/ccadmin and follow all the instructions from then on.

====Advanced====
If you have basic knowledge of using FTP and you are comfortable at a UNIX/Linux command line you can use these steps to install:

#Unzip the ccHost ZIP or tar.bz2 archive on your local system and copy the files (retaining the directory structure) to your web-server directory. Change the group and permissions of the files so they may be written by the web server (e.g., in the following lines, the web-server account is "apache").
#*For example:
#*#cp -a cchost-1.0.3 /var/www/localhost/htdocs/cchost
#*#chgrp -R apache /var/www/localhost/htdocs/cchost
#*#chmod g+w /var/www/localhost/htdocs/cchost/
#*#chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/
#Install the GetID3 (1.7.3) library from here: http://www.getid3.org/#download . Unpack the package, and then copy the GetID3 directory to the location it will be accessed. For example:
##tar xzf getid3.tar.gz
##cp -a getid3/getid3 /var/www/localhost/htdocs/cchost/
#Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin"). For example:
##mysql -p -u root
##mysql> CREATE DATABASE cchost;
##mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE ON cchost.* TO 'cchostadmin'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';
##*Make sure to change 'YOUR_PASSWORD_HERE' (and maybe 'cchostadmin') to something unique to your site.
##*Many systems provide phpMyAdmin to take care of these tasks.
##Create directory /var/log/cchost or other location to store log files. Must be writable by the web-server account (e.g., "apache"). For example:
###mkdir /var/log/cchost
###chown apache:apache /var/log/cchost
##Browse to <nowiki>http://where_you_installed_cchost/ccadmin</nowiki>
##*Everything else you need to know will be on the screen from that point on, including suggested php.ini and .htaccess settings, access permissions requirements, etc.

Take Note: On the last screen of the installation process you'll be prompted to read about specific issues regarding file permissions. '''DO NOT SKIP THIS STEP!'''
===Upgrade existing ccHost installations===
#Log in as administrator
#Copy this installation over your current installation.
#Browse to: <nowiki>http://where_you_installed/?update=1</nowiki>

Note to 1.x ccHost installations: phpBB2 is no longer used for reviews. There is a script for importing existing phpBB2 format reviews into the new native reviewing system. Contact fourstones@users.sourceforge.net for details.

=== Requirements ===

* PHP 4 (PHP 5 works if you sync to latest code)
* MySQL 4 (MySQL 5 works if you sync to latest code)
* GetID3
**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.)
* Cookies enabled in one's browser.
* '''Platforms''': This system has been tested on Apache 1 and 2 Windows and Linux. It also works with IIS on Windows. If you receive an error about DOCUMENT_ROOT, ignore it. IIS doesn't use DOCUMENT_ROOT, and ccHost doesn't seem to mind. If you have tested ccHost on System X or any other platform, please register as a ccDeveloper and update this page! Thanks. =)
** Apache 2.0.49 up to at least apache-2.0.55-r1 works with cchost 2.0.1
* '''Optional''': Here is the block of code in the Apache virtual host for setting the rewrite rules to get pretty urls:

<pre>
<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">
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
</Directory>
</VirtualHost>
</pre>

==== MySQL commands for Setting up DB ====

* install root mysql user:
** 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';

==== Notes ====

* Installing the CCHost software involves downloading 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.
* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.

== Development ==

=== Documentation ===

* [http://mirrors.creativecommons.org/cchost/docs/ PHPDOC Documentation of PHP Code]
* '''Victor's Developers Guide''' Coming Soon!

=== Discussion ===

* [[ccHost Localization]] - steps for i18n internationalization/localization

=== [[ccHost Roadmap|Roadmap]] ===
=== [[ccHost Release Procedure|Release Procedure]] ===
=== [[ccHost Community Building|Community Building]] ===
=== [[ccHost Testing|Testing and Debugging]] ===
=== [[ccHost Sample Pools|Sample Pools]] ===

== People ==

* [[User:Victor Stone|Victor Stone]]
* [[User:Jon Phillips|Jon Phillips]]

== [[ccHost History|History]] ==

== Research ==

* Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/

[[Category:CcHost]]
[[Category:Developer]]
[[Category:opensource]]
[[Category:Technology]]

CcHost

2006-06-27T21:08:43Z

Jeremy Butler: /* XAMPP */ capitalization

{{incomplete}}
'''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]].

== Information ==

=== Short Description ===

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

=== 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. 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) ===

=== Releases and Downloads ===

'''Current Version is 2.0.1'''

==== ccHost files on Source Forge ====

* http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675

==== [[CcHost Press Releases|Press Releases]] ====

==== Experimental Thrice-Daily Builds ====

Currently, cchost packages are being made three-times a day and are available here: http://mirrors.creativecommons.org/cchost/packages/

''Download, install and use these packages at your own risk.''

Only 30 days worth of builds are saved currently.

=== SVN (Source Code Repository) ===

* [http://sourceforge.net/svn/?group_id=80503 HOWTO use this project's Subversion (SVN)] - use module 'cchost'
* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Anonymous SVN]
* [http://wiki.creativecommons.org/Source_Repository_Information Help with cctools SVN setup]

==== HOWTO Tag a Release ====

Really, each major release needs to be tagged, but this 2.0.1 is the first SVN release, and we did it pots CVS -> SVN migration. In the future, this is the proper way to tag and branch.

<pre>
svn copy https://svn.sourceforge.net/svnroot/cctools/cchost/trunk \
https://svn.sourceforge.net/svnroot/cctools/cchost/tags/2_0_1 \
-m "Tagging 2.0.1 bugfix release"
</pre>

[http://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html Here is more about SVN merging/branching].

=== Packaging ===

==== Sign Package ====

You should do this for all packages (RPM, tar.gz, zip, tar.bz2, etc)
<pre>
gpg --detach-sign --armor cchost-VERSION.tar.gz
</pre>

==== Verify Package ====
<pre>
gpg --verify cchost-VERSION.tar.gz.asc
</pre>

=== 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
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]

=== Bugs, Patches and Feature Requests ===

''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).''

* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
* [[HOWTO Patch|Submit Patches]]

=== 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
*[http://www.openclipart.org/cchost/ Open Clip Art Library ccHost in testing]
*[http://www.esolpc.com/teacherhost/ TeacherHost] - for Instructors to share instructional materials.
* '''Please add your installation here.'''

== Installation ==

=== General Requirements ===

=== Common Wed Hosting Services ===

Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface from which to setup a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the cchost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the requirements below and with your hosting service.

=== Windows ===

==== XAMPP ====
It is recommended to download [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 the easiest way to get up and running, as this system replicates the standard Open Source (and Linux) setup of a time-tested server, [http://www.apache.org/ Apache], along with the required MySQL database and PHP programming language, all 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.

==== Windows IIS Server ====

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.

=== Linux ===

Primary development is done on up-to-date Linux development systems using apache, mysql, and php. One should be able to easily install mysql, php, and apache (if they are not already available) through their distributions packaging system.

=== Installation Steps ===

The exact steps required to install ccHost depends on your web hosting environment.

* Set up a MySQL database on your server
**For a shared host environment (such as http://dreamhost.com) before you can install ccHost you need use your hoster's control panel to create a MySQL database. Note the name you give it, it's server location, the MySQL username and password.
**If you have root access to mysql (this is rare) you can use the command line mysql to create the database, the user and password.
* Uncompress the ccHost package on your local machine (this might be a .zip, .tar.gz, .tar.bz2, or rpm)
* Copy the files to your web server
** Typically people do this using an ftp tool
** You must retain the exact directory structure when you do this
** Many hosting providers also have a file upload interface, but this usually takes very long to upload all files and folders.
* Point your browser at <nowiki>http://where_you_installed_cchost/ccadmin</nowiki>

Everything else you need to know will be on the screen from that point on, including any extra downloads (getid3), suggested php.ini and .htaccess settings, access permissions requirements, etc.

=== Requirements ===

* PHP 4 (PHP 5 works if you sync to latest code)
* MySQL 4 (MySQL 5 works if you sync to latest code)
* GetID3
**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.)
* Cookies enabled in one's browser.
* '''Platforms''': This system has been tested on Apache 1 and 2 Windows and Linux. It also works with IIS on Windows. If you receive an error about DOCUMENT_ROOT, ignore it. IIS doesn't use DOCUMENT_ROOT, and ccHost doesn't seem to mind. If you have tested ccHost on System X or any other platform, please register as a ccDeveloper and update this page! Thanks. =)
** Apache 2.0.49 up to at least apache-2.0.55-r1 works with cchost 2.0.1
* '''Optional''': Here is the block of code in the Apache virtual host for setting the rewrite rules to get pretty urls:

<pre>
<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">
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
</Directory>
</VirtualHost>
</pre>

==== MySQL commands for Setting up DB ====

* install root mysql user:
** 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';

==== Notes ====

* Installing the CCHost software involves downloading 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.
* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.

== Development ==

=== Documentation ===

* [http://mirrors.creativecommons.org/cchost/docs/ PHPDOC Documentation of PHP Code]
* '''Victor's Developers Guide''' Coming Soon!

=== Discussion ===

* [[ccHost Localization]] - steps for i18n internationalization/localization

=== [[ccHost Roadmap|Roadmap]] ===
=== [[ccHost Release Procedure|Release Procedure]] ===
=== [[ccHost Community Building|Community Building]] ===
=== [[ccHost Testing|Testing and Debugging]] ===
=== [[ccHost Sample Pools|Sample Pools]] ===

== People ==

* [[User:Victor Stone|Victor Stone]]
* [[User:Jon Phillips|Jon Phillips]]

== [[ccHost History|History]] ==

== Research ==

* Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/

[[Category:CcHost]]
[[Category:Developer]]
[[Category:opensource]]
[[Category:Technology]]

User:Jeremy Butler

2006-06-27T21:05:01Z

Jeremy Butler:

I'm interested in developing ccHost to use as a virtual slide room for film/TV screen shots.

CcHost

2006-03-27T21:26:06Z

Jeremy Butler: /* Requirements */ formatting

CcHost

2006-03-27T12:43:06Z

Jeremy Butler: /* Notes */ grammar