One of the first things that many sites want to customize is way that uploads listings and upload pages appear on the site. The typical scenario for the first 4 versions of ccHost goes something like this:
In ccHost 5 we tried to make it a less frustrating task with better results. The upload pages and upload listings are actually just query API templates. Therefore, before you get any further, we strongly recommend that do the query template walk through. This should take you about 20 minutes, but it will be well worth it and make the job of making your custom listings go much smoother.
The 'upload page' is the template that ccHost will use when someone has requested to see the details of upload using the files command. For example: http://ccmixter.org/files/victor/1134. This section explains how to create your own version of that and hook it up into the system.
Starting you own version from scratch may be more work up front, but you will have a lot more control over the output of your own site this way. If you are familiar with HTML/CSS it will be much better and easier than you may think. Just sayin.
To start your own customized Upload Page, follow the instructions in the custom query template walk through to create a new template based on the 'details' template in the Hello World example.
Even if you plan on hacking through this, we still highly recommend spending 20 minutes with the custom query template walk through to understand the architecture of how ccHost is displaying records.
The absolute worst thing you can do is hack directly on one of the files under ccskins. That will never pay off. You have been warned.
Make sure you have the following to the top of the page:
%% [meta] type = page desc = _('My custom upload page') dataview = upload_page [/meta] %%
You need to inform the ccHost configuration that you intend to use this page as the template when a user browses to a upload using the files command.
Browse to <your_installation_root>/files/<user_name>/<file_id> to make sure it's your template that is set to that command.
HINT: Any files link will do, like in the Sidebar Extra 'Latest Uploads'.
Using the %inspect(#R)% macro syntax you can see what variables are available for display