Cchost/concepts/Commands

From Creative Commons
Revision as of 11:38, 12 November 2008 by Fourstones (talk | contribs) (New page: Category:ccHost Category:ccMixter Category:Developer Category:Software Category:Technology {{cchost_head}} {{lowercase}} =ccHost is About Commands= Get used to the idea...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


Docs Home Install Upgrade Troubleshoot Customize Admins Devs Content Query Templates Commands Skins

ccHost is About Commands

Get used to the idea that ccHost is a command based system. Commands are appended to the base URL after the virtual root.

http://ccmixter.org/media/people

 HINT:  Substitute your installation base URL for 'ccmixter.org' in these examples.

Pretty URLs

If you are using non-pretty-URLs then that command would like like:

http://ccmixter.org?ccm=/media/people

For purposes of brevity in this documentation we tend to assume 'pretty-URLs' (the same URL without the ?ccm=) are enabled in your system.

Stripping the Virtual Root

As of ccHost 5.0 you can leave off the default virtual root (media).

If the virtual root is media and the command is people that will display the latest users (with uploads). If the virtual root is left off, 'media' is assumed. So the same command can be stated:

http://ccmixter.org/people

Command in This Documentation

In this documentation there are many places where you are told to browse to some location and given a partial path, for example, admin/paths.

This is the command (and parameters if applicable) that you append to your installation root.

 http://your_installation_root?ccm=/admin/paths   Pretty URLs turned OFF

or

 http://your_installation_root/admin/paths  For pretty URLs turned ON

If the location in the documentation includes a '?' like:

 api/query?tags=remix

then you need to convert that to an ampersand '&' if you have pretty URLs turned OFF because your URL already has a '?':

 http://your_installation_root?ccm=/api/query&tags=remix   Pretty URLs turned OFF

Arguments

Most command have parameters that are appended to the URL. For example people/antonov

command is still 'people', parameter is 'antonov' which displays anotov's user profile

Command Reference

As of version 5.0.1 you can browse to commands to see a list of all documented command.

To see undocumented commands (that is: a total dump of the URL map) browse to commands/0