Wiki ⇒ Dragonfly public view ⇒ Modules ⇒ Coppermine ⇒ The configuration page ⇒ CPG Dragonfly™ CMS
6.2.5. 3: The configuration page
The following settings are where you can "customize" coppermine for your needs, this is also where "new" features are enabled. For those seeking to hack or customize coppermine or are accessing these settings though phpmyadmin or other browser based mysql administration the config name is next to each title
This is the name of your gallery. It will appear at the top of your home page(edit it's display in template.html), and in the nice titles. Do not use html tags in this field
This is a short description of your gallery. It will appear at the top of your homepage below the name of your gallery.(edit it's display in template.html) You can use the <br> char to manage the display of longer descriptions, edit other display in your theme css
Gallery administrator email
Your e-mail address. All emails sent by the gallery are sent with this email address.
Address to nuke folder
This is the URL where nuke is installed. This is used for links for the e-card "see more pictures link" and the bookmark link. ie http://www.mysite.tld/html/ Don't forget the trailing slash or your ecards links won't work
This is the default language for your gallery. All language files are stored in the lang directory on your server.
Use this line to select the theme of your gallery. Themes are stored in sub-directories of the themes directory. Only themes designed for this version will work. The best way to edit themes is to make a copy of the default theme folder, name as you like (inside the theme folder), edit the css and template files as necessary. Once you have uploaded your files your theme name will be displayed here
Page Specific Titles instead of >Coppermine
Use this line for page specific titles in the title bar of the browser. These are the same as the breadcrumbs that appear on the page.
Show Right Blocks
Use this to show the right blocks while in coppermine, you may want to change the value of Number of columns for the album list to 1 to make it all fit.
Album list view
Width of the main table (pixels or %)
This is the width of tables used on your main page or when you are viewing thumbnails of an album. You can enter a width in pixels or specify it in percents. The default value is 100%. This is called in the cpg function starttable(); if a percent is not specified (important for theme designers)
Number of levels of categories to display
The default value is 2. With this value the script will display the current categories plus one level of sub-categories.
Number of albums to display
This is the number of albums to display on a page. If the current category contains more albums, the album list will spread over multiple pages.
Number of columns for the album list
Number of columns for the album list. The default value is 2. If your nuke them is not very wide or your're using coppermine as your home page, you might change this value to 1
Size of thumbnails in pixels
This is the size of the thumbnails
that are displayed for each album. 50 means that the thumbnail will fit
inside a square of 50x50 pixels.
The content of the main page
This option allows you to change the content of the main page displayed by the script.
These can be placed in any order and are optional (except catlist and alblist they are needed for navigation)
The ,2 means 2 rows of thumbnails. breadcrumb/catlist/alblist/lastup,2/lastcom,2/topn,2/toprated,2/random,2/anycontent
Show first level album thumbnails in categories
This will show all of your albums under there categories in the home page of coppermine Thumbnail view
Number of columns on thumbnail page
Default value is 4 this means that each row will show 4 thumbnails.
Number of rows on thumbnail page
Default value is 3 this means that each column will show 3 thumbnails.
Maximum number of tabs to display
When the thumbnails spread over multiple pages, tabs are displayed at the bottom of the page. This value define how many tabs will be displayed.
Display picture caption (in addition to title) below the thumbnail
This will show a photos caption below the thumb if there is one.
Image view & Comment settings
Picture information are visible by default
Filter bad words in comments
Remove "bad words" from comments. The "bad words" list is in the language file.
Allow smilies in comments
Allows the use of smilies in comments. These will decoded on displayimage but will appear as chars ( :LOL: ) in thumbnail view and blocks
Disable Flood Protection
Disable consecutive comments on one pic from the same user
Email site admin upon comment submission
Changing this to yes will send email on each comment submission to the site administrator address "gallery_admin_email"
Max length for an image description
Maximum number of characters that an image description may contain.
Max number of characters in a word
This is intended to prevent that someone break the layout of the gallery by posting a long comment without space. With the default value, words with more than 38 characters are censored.
Max number of lines in a comment
Prevent a comment for containing too many new line char.
Maximum length of a comment
Maximum number of characters that a comment may contain.
Show film strip Current Value: Enabled display_film_strip
Show film strip below the image (an additional nav tool)
Number of items in film strip
Number of frames in film strip. Change this to lees if you find the displayimage page too wide for your layout.
Allow viewing of full size pic by anonymous
The default value
Pictures and thumbnails settings
Quality for JPEG files
The quality used for JPEG compression when the script resizes an image. Value can range from 0 (worst) to 100 (best). This value can be set to 75 when using ImageMagick.
Max dimension of a thumbnail
Max dimension of a thumbnail (do not change this after you have pictures}
Max width or height of a thumbnail
With the default value thumbnails will fit inside a box of 100x100 pixels.(do not change this after you have pictures)
Create intermediate pictures
By default, whenever you upload a picture, the script creates a thumbnail of the picture (picture name with a thumb_ prefix) plus an intermediate version (picture name with a normal_ prefix). If you set this option to NO, the intermediate picture is not created.
Max width or height of an intermediate picture
The intermediate pictures are those that appears when you click on a thumbnail. Do not change this after you have pictures. The default value is 400, it means that the intermediate picture will fit inside a square of 400x400 pixels, this works well with a 15 inch monitor and 1024 x 768 screen size with most layouts.
Max size for uploaded pictures (KB)
Any picture with a file size larger than this value will be rejected by the script. You should set this to a value less than you server's php setting for this
Max width or height for uploaded pictures (pixels)
Limit the dimensions of the pictures that are uploaded. Resizing large pictures requires a lot of memory and consumes CPU.
Allow new user registrations Current Value: Not Enabled allow_user_registration
NOT USED IN THIS VERSION
User registration requires email verification
NOT USED IN THIS VERSION
Allow two users to have the same email address
NOT USED IN THIS VERSION
Users can can have private albums
If set to YES then your gallery can contain albums that can be visible only by users that belong to a certain group.
Custom fields for image description (leave blank if unused)
These fields are displayed within the "picture information" area. They will appear only if you give them a name. You use one to four of these.
Pictures and thumbnails advanced settings
Show private album icon to unlogged user
Default behavior of coppermine is to show a private album icon and info for private albums by setting this to yes will not show the picture or info
Characters forbidden in filenames
When the filename of a picture that is uploaded contains one of these characters, it will be replaced with an underscore.
Accepted file extensions for uploaded pictures
Any file uploaded whose extension is
not in this list will be rejected by the script. This is intended to
prevent a user from uploading non-image files.
Method for resizing images
If you are using GD 1.x and the colors of your thumbnails or intermediate image are wrong then switch to GD 2.x.
Path to ImageMagick 'convert' utility (example /usr/bin/X11/)
If you are using ImageMagick convert
utility to resize you picture, you must enter the name of the directory
where the convert program is located there. Don't forget the trailing
Allowed image types (only valid for ImageMagick)
This is the list of image types that the script will accept when using ImageMagick. Image type detection is performed by reading the header of the file and not by looking at its file extension.
Command line options for ImageMagick
Here you can add options that will be appended to the command line when executing ImageMagick. Read the ImageMagick Convert manual to see what is available.
Read EXIF data in JPEG files
With this option turned on, the script will read the EXIF data stored by digicams in JPEG files. This new feature hasn't been fully tested.
Read IPTC data in JPEG files
Read IPTC data in JPEG files. This new feature hasn't been fully tested.
The album directory
This is the base directory for your "Image Store". The path is relative to the main directory of the script.
The directory for user pictures
This is the directory where pictures
uploaded with the web interface are stored. This directory is a
subdirectory of the album directory.
Picinfo display filename
Display the filename in the picinfo section?
Picinfo display album name
Display the album name the image is from in the picinfo section?
Display the fieldsize (50KB) in the picinfo section?
Display the dimensions i.e. (640x480) in the picinfo section?
Display the amount of times the picture has been displayed in the picinfo section?
Display the short URL to the picture in the picinfo section? if you chose to set "Display the short URL to the picture as a bookmark link" to yes that's how this link will be displayed, you do not have to set this value to yes to have the bookmark link to work
Picinfo display URL as bookmark link
Display the short URL to the picture as a bookmark link in the picinfo section?
Picinfo display fav album link
Display the add to favorites album in the picinfo section? This new feature allows user to have a personal favorites album that lasts as long as they have the cookie
Cookies & Charset settings
Name of the cookie used by the script
Default value is "cpgnuke". Use a different cookie name for each install if you have more than one coppermine install!
Path of the cookie used by the script
Default value is "/". Change this value to the path of your nuke install /html/.
This should normally be set to "Default (language file)" or "Unicode (utf-8)". See the discussion in the "language" section of this page.
Enable debug mode
If you have problems turn this on and paste the content in your post to the forum (don't worry in our version this info only shows to admin not the general public)
Created: Sunday, July 03, 2005 (08:39:24) by akamu