Cchost/admin/config customize - Revision history

Fourstones: /* Creating font schemes */

2008-11-17T16:48:09Z

‎Creating font schemes

Fourstones: /* Colors */

2008-11-17T16:46:55Z

‎Colors

Fourstones: /* Strings in menus, page header/footer, navigation tabs */

2008-11-13T11:19:28Z

‎Strings in menus, page header/footer, navigation tabs

Fourstones at 10:42, 12 November 2008

2008-11-12T10:42:35Z

Fourstones: New page: Category:ccHost Category:ccMixter Category:Developer Category:Software Category:Technology {{lowercase}} This page describes some of the customizations that can be don...

2008-11-03T16:34:33Z

New page: Category:ccHost Category:ccMixter Category:Developer Category:Software Category:Technology {{lowercase}} This page describes some of the customizations that can be don...

New page

[[Category:ccHost]]
[[Category:ccMixter]]
[[Category:Developer]]
[[Category:Software]]
[[Category:Technology]]

{{lowercase}}
This page describes some of the customizations that can be done in your ccHost installation by creating some custom configuration files. For all these operations you will need a plain text editor and write permissions to your <local_files> area of the installation.

=Strings=
This section covers how to do 'straight' string substitution for forms, headings or prompts. That means a simple replace of text: every time you see 'foo' you want to replace it 'bar.' If you want to do more elaborate, [[cchost/developer/Hooking_Pages|dynamic substitutions]] that will require some real PHP programming.

Place the following file into '''<local_files>/skins/strings/my_string_set.php'''

<nowiki><?</nowiki>
/*
[meta]
type = string_profile
desc = _('My Custom String Set')
[/meta]
*/

include('ccskins/shared/strings/all_media.php');

/* Your custom strings go below here */

/* Your custom strings go above here */
<nowiki>?></nowiki>

The strings in the system are all mapped to a key that starts with the '''str_''' prefix. If you search through the strings in ''ccskins/shared/strings/all_media.php'' and find the string you want to replace, simply copy that line to your string set file and replace the text to the right of the equal sign ('''=''').

Let's say you want you want to replace every occurrence of the word '''artist''' with the word '''teacher'''. You would search for all instances of the word '''artist''' in ''ccskins/shared/strings/all_media.php'' to find these:

$GLOBALS['str_artist'] = _('Artist');
$GLOBALS['str_artists'] = _('Artists');
$GLOBALS['str_contact_artist'] = _('contact this artist');
$GLOBALS['str_feat_list_any_collob'] = _('List any colloborating artists);
$GLOBALS['str_filter_artist'] = _('Artist');
$GLOBALS['str_hidi_author'] = _('Artist');
$GLOBALS['str_remix_artist'] = _('Artist');
$GLOBALS['str_pool_filter'] = _('Sample pool artists');
$GLOBALS['str_stats_artist'] = _('Aritst');

You would copy all of those and put those into your string set file and then edit occurrences of '''artist''' on the ''right'' side of the equal sign and replace those. So your file would end up looking like:

<nowiki><?</nowiki>
/*
[meta]
type = string_profile
desc = _('My Custom String Set')
[/meta]
*/

include('ccskins/shared/strings/all_media.php');

/* Your custom strings go below here */

$GLOBALS['str_artist'] = _('Teacher');
$GLOBALS['str_artists'] = _('Teachers');
$GLOBALS['str_contact_artist'] = _('contact this teacher');
$GLOBALS['str_feat_list_any_collob'] = _('List any colloborating teachers');
$GLOBALS['str_filter_artist'] = _('Teacher');
$GLOBALS['str_hidi_author'] = _('Teacher');
$GLOBALS['str_remix_artist'] = _('Teacher');
$GLOBALS['str_pool_filter'] = _('Sample pool teachers');
$GLOBALS['str_stats_artist'] = _('Teacher');

/* Your custom strings go above here */
<nowiki>?></nowiki>

Again, note that the '''artist''' on the left side of the equal sign still say '''artist''' - this is correct.

As a final step, in your ccHost installation browser to <your_installation_root>/admin/skins/settings and under '''String Profile''' select ''My Custom String Set''.

=Colors=
You can create a custom color set by following these instructions.

#Copy ''ccskins/shared/colors/color_mono.php'' to '''<local_files>/skins/colors/my_colors.php'''
#Open your copy in a text editor and replace the text near the top in the 'desc' field (''Monochrome'') with 'My Color Scheme'
#Edit all the six digit hash numbers (e.g. #FF00EE) and replace them with the colors that you prefer to see and save the file
#In your browser, browse to '''<your_installation_root>/admin/colors''' and select 'My Color Scheme'

You should see the differences the next time you refresh your browser. (You may have to clear your browser's cache to get the full effect.)

=Sidebar extras=
You can create your own "sidebar extras" with a few lines of HTML code. They can even be dynamic with a little query API knowledge.

Your ccHost 5 installation has already put an example of one of these into '''<local_files>/skins/extras/extras_links.tpl'''. To create more of your own extras and enable them follow these instructions:

#Copy '''<local_files>/skins/extras/extras_links.tpl''' to another file in that same directory like '''my_other_extra.tpl'''
#Change the text in the '''desc''' at the top to something like: _('My other extra')
#Replace the contents of the unordered list ('''<nowiki><ul></nowiki>''' tag) with your custom content
#Browse to '''<your_installation_root>/admin/extras''' and drag the box that says 'My other extra' to the sidebar extras area

For some examples of what's possible check out the files in '''ccskins/shared/extras'''.

@@ Line 149: / Line 149: @@
 in '''<local_files>/skins/colors/font_pc100.php'''
-You should see the differences the next time you refresh your browser. (You may have to clear your browser's cache to get the full effect.)
+You should see the differences after you select these in '''admin/colors''' and the next time you refresh your browser. (You may have to clear your browser's cache to get the full effect.)
 =Sidebar extras=

@@ Line 15: / Line 15: @@
 Strings that come from the ''configuration'' are editable directly through the ''Manage Site'' menu. These include:
-*Page header and footer: click on ''Edit Banners and Footers'' then ''Edit Template Tags'' (or browse to '''admin/templatetags''')
+*Page header and footer: click on ''Manage Site'', then ''Edit Banners and Footers'' then ''Edit Template Tags'' (or browse to '''admin/templatetags''')
-*Menus: click on ''Menu'' ('''admin/menu''') to edit individual items or ''Menu Groups'' ('''admin/menugroups''') to edit the name of a group of items.
+*Menus: click on ''Manage Site'', then ''Menu'' ('''admin/menu''') to edit individual items or ''Menu Groups'' ('''admin/menugroups''') to edit the name of a group of items.
-*Navigation tabs: click on ''[[Cchost/customize/Navigation_Tabs|Navigator Tab Sets]]''
+*Navigation tabs: click on ''Manage Site'', then ''[[Cchost/customize/Navigation_Tabs|Navigator Tab Sets]]''
 ==String in forms, page titles and prompts==

@@ Line 105: / Line 105: @@
 #Edit all the six digit hash numbers (e.g. #FF00EE) and replace them with the colors that you prefer to see and save the file
 #In your browser, browse to '''<your_installation_root>/admin/colors''' and select 'My Color Scheme'
 You should see the differences the next time you refresh your browser. (You may have to clear your browser's cache to get the full effect.)

@@ Line 4: / Line 4: @@
 [[Category:Software]]
 [[Category:Technology]]
+{{cchost_head}}
 {{lowercase}}
-This page describes some of the customizations that can be done in your ccHost installation by creating some custom configuration files. For all these operations you will need a plain text editor and write permissions to your <local_files> area of the installation.
+This page describes some of the customizations that can be done in your ccHost installation that involve pre-defines options sets. There are also sections that describe how to create your own versions of these that will requite a plain text editor and write permissions to your <local_files> area of the installation.
 =Strings=
-This section covers how to do 'straight' string substitution for forms, headings or prompts. That means a simple replace of text: every time you see 'foo' you want to replace it 'bar.' If you want to do more elaborate, [[cchost/developer/Hooking_Pages|dynamic substitutions]] that will require some real PHP programming.
+==About Strings==
 Place the following file into '''<local_files>/skins/strings/my_string_set.php'''
@@ Line 74: / Line 93: @@
 =Colors=
 You can create a custom color set by following these instructions.
@@ Line 84: / Line 109: @@
 =Sidebar extras=
-You can create your own "sidebar extras" with a few lines of HTML code. They can even be dynamic with a little query API knowledge.
+==Organzing Your Sidebar Extras==
 Your ccHost 5 installation has already put an example of one of these into '''<local_files>/skins/extras/extras_links.tpl'''. To create more of your own extras and enable them follow these instructions:
@@ Line 94: / Line 133: @@
 For some examples of what's possible check out the files in '''ccskins/shared/extras'''.