Coppermine Photo Gallery v1.5.x: Documentation and Manual

Editing style.css

The file style.css exists in every theme. It contains the Cascading Style Sheet (aka "CSS") for the theme. It's beyond the scope of this document to explain the aspects of CSS for absolute beginners. The idea behind CSS is to have a separation between content (the textual output mainly) and the way the content is represented - the looks. With this being said, the style sheet controls the colors and nearly all design aspects of the output of your gallery. That's why it's worth looking at it: with only some minor changes in the style you can change the overall design of your entire gallery.

Tools

You will need some tools to edit the style sheet, but don't be afraid - nearly all of them are available for free. We have created a list of tools sorted by type that you're welcome to review: Tools recommended by the devs.

You will need a plain-text editor (notepad.exe will do, but it's recommended to use one of the more powerfull editors from the above mentioned tools page. You should not use a graphical WYSIWYG-editor though unless you know you are aware of the limitations of such editors.

List of classes in style.css

Name	Description	Needed?	Type
textinput	.	mandatory	class
listbox	.	mandatory	class
button	.	mandatory	class
radio	.	mandatory	class
checkbox	.	mandatory	class
bblink	.	mandatory	class
maintable	.	mandatory	class
tableh1	.	mandatory	class
tableh2	.	mandatory	class
tableb	.	mandatory	class
tableb_alternate	.	mandatory	class
tablef	.	mandatory	class
catrow	.	mandatory	class
catrow_noalb	.	mandatory	class
album_stat	.	mandatory	class
thumb_filename	.	mandatory	class
thumb_title	.	mandatory	class
thumb_caption	.	mandatory	class
thumb_num_comments	.	mandatory	class
user_thumb_infobox	.	mandatory	class
sortorder_cell	.	mandatory	class
sortorder_options	.	mandatory	class
navmenu	.	mandatory	class
admin_menu	.	mandatory	class
admin_float	.	mandatory	class
admin_menu_wrapper	.	mandatory	class
admin_menu_anim	.	mandatory	object
icon	.	mandatory	class
comment_date	.	mandatory	class
image	.	mandatory	class
middlethumb	.	mandatory	class
imageborder	.	mandatory	class
display_media	.	mandatory	class
thumbnails	.	mandatory	class
footer	.	mandatory	class
statlink	.	mandatory	class
alblink	.	mandatory	class
catlink	.	mandatory	class
topmenu	.	mandatory	class
img_caption_table	.	mandatory	class
debug_text	.	mandatory	class
clickable_option	.	mandatory	class
listbox_lang	.	mandatory	class
pic_title	.	mandatory	class
pic_caption	.	mandatory	class
cpg_main_block	.	mandatory	object
important	.	mandatory	class
cpgChooseLanguageWrapper	.	mandatory	object
cpgChooseThemeWrapper	.	mandatory	object
filmstrip_background	.	mandatory	class
bookmarkIt	.	mandatory	object
.	.	mandatory	class
.	.	mandatory	class
.	.	mandatory	class
.	.	mandatory	class
.	.	mandatory	class
.	.	mandatory	class
.	.	mandatory	class

Additional stylesheet

In addition to your individual theme's stylesheet, coppermine contains reference to an overal style sheet file that contains CSS definitions that are theme-independant. Those overall styles reside in css/coppermine.css and should not be edited unless you really know your way around. Instead, it is recommended to override in your custom stylesheet the definitions made in that overall file.