Subversion Repositories svnkaklik

Rev

Details | Last modification | View Log

Rev Author Line No. Line
6 kaklik 1
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html xmlns="http://www.w3.org/1999/xhtml">
3
<head>
4
<title>Coppermine Photo Gallery - Documentation &amp; Manual</title>
5
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
6
<meta name="language"    content="en">
7
<meta name="author"      content="Coppermine dev team">
8
<meta name="copyright"   content="Coppermine dev team">
9
<meta name="description" content="Coppermine Photo Gallery project - Coppermine is an easily set-up, fast, feature-rich photo gallery script with mySQL database, user management, private galleries, automatic thumbnail creation, ecard feature and a template system for easy customization to match the rest of a site.">
10
<meta name="keywords"    content="photo,gallery,galery,image,coppermine,php,mysql,easy,feature,phpnuke,thumbnail,automatic,creation,gd,Image Magick,ecard">
11
<meta name="page-topic"    content="photo,gallery,galery,image,coppermine,php,mysql,easy,feature,phpnuke,thumbnail,automatic,creation,gd,Image Magick,ecard">
12
<meta http-equiv="Content-Style-Type" content="text/css">
13
<meta name="MSSmartTagsPreventParsing" content="true">
14
<meta http-equiv="imagetoolbar" content="no">
15
<!--
16
CVS version info:
17
$Id: index.htm,v 1.23 2005/04/19 03:17:12 gaugau Exp $
18
-->
19
<style type=text/css>
20
 
21
body {
22
        font-size: 12px; background: #F7F7F7; margin: 2%; color: black; font-family: verdana, arial, helvetica, sans-serif;
23
        scrollbar-face-color: #DEE3E7;
24
        scrollbar-highlight-color: #FFFFFF;
25
        scrollbar-shadow-color: #DEE3E7;
26
        scrollbar-3dlight-color: #D1D7DC;
27
        scrollbar-arrow-color:  #006699;
28
        scrollbar-track-color: #EFEFEF;
29
        scrollbar-darkshadow-color: #98AAB1;
30
}
31
td {
32
        font-size: 12px
33
}
34
h1 {
35
        font-weight: bolder; font-size: 24px; color: #0E72A4; line-height: 120%; font-family: "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif; text-decoration: none
36
}
37
h2 {
38
        font-size: 20px; color: #0E72A4; font-family: Arial, Helvetica, sans-serif; text-decoration: none;
39
}
40
h3 {
41
        font-weight: bolder; font-size: 16px; font-family: Verdana, Arial, Helvetica, sans-serif; text-decoration: none; color: #0E72A4;
42
}
43
h4 {
44
        font-weight: bold; font-size: 14px; font-family: Verdana, Arial, Helvetica, sans-serif; text-decoration: none; color: #0E72A4;
45
}
46
p {
47
        font-size: 12px; margin: 10px 10px 0px 0px; font-family: Verdana, Arial, Helvetica, sans-serif
48
}
49
pre {
50
        border-right: #999999 1px solid; padding-right: 5px; border-top: #999999 1px solid; padding-left: 5px; font-size: 12px; padding-bottom: 5px; margin: 10px 10px 0px 0px; border-left: #999999 1px solid; padding-top: 5px; border-bottom: #999999 1px solid; font-style: normal; font-family: "Courier New", Courier, mono; background-color: #E0E0E0
51
}
52
ul {
53
        padding-right: 0px; padding-left: 0px; padding-bottom: 0px; margin: 10px 0px 10px 5px; padding-top: 0px
54
}
55
ul.content {
56
        padding-right: 0px; padding-left: 0px; padding-bottom: 0px; margin: 5px 5px 0px 0px; padding-top: 0px
57
}
58
li {
59
        padding-right: 0px; margin-top: 4px; padding-left: 0px; list-style-position: outside; margin-bottom: 4px; padding-bottom: 0px; margin-left: 10px; padding-top: 0px; list-style-type: disc
60
}
61
li.content {
62
        padding-right: 0px; margin-top: 0px; padding-left: 0px; list-style-position: outside; margin-bottom: 5px; padding-bottom: 0px; margin-left: 10px; padding-top: 0px; list-style-type: none;
63
}
64
hr {
65
        border-right: #000000 0px solid; border-top: #000000 1px solid; border-left: #000000 0px solid; border-bottom: #000000 0px solid; height: 0px
66
}
67
.navbar {
68
        font-weight: bold; font-size: 10px; background: url(/coppermine/themes/pixel-rave-blue100/images/nav-bar-button.gif) #72a5cc no-repeat; vertical-align: middle; color: #A5C6DF; font-family: Arial, Helvetica, sans-serif
69
}
70
a.navbar {
71
        display: block; vertical-align: middle; width: 100px; color: #A5C6DF; line-height: 25px; position: relative; height: 25px; text-align: center; text-decoration: none
72
}
73
a.navbar:hover {
74
        color: #ffffff; text-decoration: none
75
}
76
 
77
a.external {
78
        background: transparent url('pics/link.gif') 100% 50% no-repeat;
79
        padding-right: 10px;
80
}
81
 
82
.back {
83
        margin-top: 10px; font-size: 10px; margin-bottom: 10px
84
}
85
.important { color: red }
86
.menu1 {font-weight:bolder;font-stretch:expanded;font-size:120%}
87
.menu2 {font-weight:bold;font-stretch:normal;font-size:100%}
88
.menu3 {font-weight:normal;font-stretch:condensed }
89
.code {
90
        font-size: 12px; font-style: normal; font-family: "Courier New", Courier, mono; background-color: #E0E0E0
91
}
92
.border1 {
93
        border-right: #999999 1px solid; padding-right: 5px; border-top: #999999 1px solid; padding-left: 5px; font-size: 12px; padding-bottom: 5px; margin: 10px 10px 0px 0px; border-left: #999999 1px solid; padding-top: 5px; border-bottom: #999999 1px solid;
94
          }
95
.quote
96
{
97
        color: #000000;
98
        background-color: #C3B8D0;
99
        border: 1px solid #000000;
100
        margin: 1px;
101
        padding: 1px;
102
        font-size: x-small;
103
}
104
</style>
105
</head>
106
<body>
107
<table cellspacing="0" cellpadding="0" width="100%" border="0">
108
  <tbody>
109
  <tr>
110
    <td>
111
                        <p><img src="../images/coppermine_logo.png" alt="Coppermine Photo Gallery - Your Online Photo Gallery">
112
<h1>Coppermine Photo Gallery v1.3.3: Documentation and Manual</h1>
113
<h1>About Coppermine</h1>
114
<p>Coppermine Photo Gallery is a picture gallery script. Users can upload pictures
115
  with a web browser (thumbnails are created on the fly), rate pictures, add comments
116
  and send e-cards. The admins can manage the galleries and batch add pictures
117
  that have been uploaded on the server by FTP. Support for multimedia files has been added recently.</p>
118
<p>Images are stored in albums and albums can be grouped by categories. The script
119
  supports multiple users and each user can possibly have its own set of albums.</p>
120
<p>The script also supports multiple languages and has a theme system. It uses
121
  PHP, a MySQL database and the GD library (version 1.x or 2.x) or ImageMagick
122
  to make the thumbnails. An install script makes the installation fast and simple.</p>
123
 
124
      <a id="top" name="top"></a>
125
      <h1>Table of contents</h1>
126
      <ul class="content">
127
        <!--<li class="content"><a href="#testVersion"><span class="menu1">0. Beta (Testing) version</span></a></li>-->
128
        <li class="content"><a href="#what"><span class="menu1">1. What is required</span></a></li>
129
        <li class="content"><a href="#installation"><span class="menu1">2. Installation and setup</span></a></li>
130
        <ul style="margin-top:0px;margin-bottom:0px;list-style-type:none">
131
          <li class="content"><a href="#how"><span class="menu2">2.1 How To Install The Script</a></span></li>
132
          <li class="content"><a href="#getting"><span class="menu2">2.2 Getting Started</a></span></li>
133
          <li class="content"><a href="#xp"><span class="menu2">2.3 Using Windows XP Web Publishing Wizard with Coppermine</a></span></li>
134
          <li class="content"><a href="#creating"><span class="menu2">2.4 Creating or upgrading your own themes</a></span></li>
135
          <li class="content"><a href="#safe"><span class="menu2">2.5 Safe mode issues</a></span></li>
136
          <li class="content"><a href="#smtp"><span class="menu2">2.6 Using SMTP to send emails</a></span></li>
137
        </ul>
138
        <li class="content"><a href="#upgrade"><span class="menu1">3. Upgrading</span></a></li>
139
        <ul class="content">
140
          <li class="content"><a href="#10"><span class="menu2">3.1 Upgrading from version 1.0</span></a></li>
141
          <li class="content"><a href="#11"><span class="menu2">3.2 Upgrading from releases of version 1.1</a></span></li>
142
          <li class="content"><a href="#13"><span class="menu2">3.4 Upgrading from cpg1.2.0 (or better) to version cpg1.3.3</a></span></li>
143
        </ul>
144
        <li class="content"><a href="#administration"><span class="menu1">4. Configuration &amp; Administration</span></a></li>
145
        <ul class="content">
146
          <li class="content"><a href="#cat_alb_pic"><span class="menu2">4.1 Categories, albums and files</a></span></li>
147
          <li class="content"><a href="#admin_user_mode"><span class="menu2">4.2 Admin mode &amp; User mode</a></span></li>
148
          <li class="content"><a href="#group_cp"><span class="menu2">4.3 The group control panel</a></span></li>
149
          <li class="content"><a href="#cat_cp"><span class="menu2">4.4 The category control panel</a></span></li>
150
          <li class="content"><a href="#albmgr"><span class="menu2">4.5 The album manager</a></span>
151
          <ul class="content">
152
            <li class="content"><a href="#albmgr_create">4.5.1 Creating albums</a></li>
153
            <li class="content"><a href="#albmgr_rename">4.5.2 Renaming albums</a></li>
154
            <li class="content"><a href="#albmgr_order">4.5.3 Changing the album order</a></li>
155
            <li class="content"><a href="#albmgr_delete">4.5.4 Deleting albums</a></li>
156
          </ul>
157
          </li>
158
          <li class="content"><a href="#modif_alb_pics"><span class="menu2">4.6 Modifying album/files</a></span></li>
159
          <li class="content"><a href="#batch_add_pics"><span class="menu2">4.7 Uploading pics by FTP / Batch-Add Pictures</a></span></li>
160
          <li class="content"><a href="#album_prop"><span class="menu2">4.8 Album properties</a></span></li>
161
          <li class="content"><a href="#edit_pics"><span class="menu2">4.9 Editing files</a></span></li>
162
            <ul class="content">
163
            <li class="content"><a href="#edit_vids">4.9.1 Editing videos</a></li>
164
            <li class="content"><a href="#cust_thmb">4.9.2 Custom thumbnails</a></li>
165
            </ul>
166
          <li class="content"><a href="#config"><span class="menu2">4.10 The configuration page</a></span></li>
167
            <ul class="content">
168
            <li class="content"><a href="#config_general">4.10.1 General settings</a></li>
169
            <li class="content"><a href="#config_language">4.10.2 Language, Themes &amp; Charset settings</a></li>
170
            <li class="content"><a href="#config_album_list">4.10.3 Album list view</a></li>
171
            <li class="content"><a href="#config_thumbnail_view">4.10.4 Thumbnail view</a></li>
172
            <li class="content"><a href="#config_image_comment">4.10.5 Image view &amp; Comment settings</a></li>
173
            <li class="content"><a href="#config_picture_thumbnail">4.10.6 File and thumbnail settings</a></li>
174
            <li class="content"><a href="#config_picture_thumb_advanced">4.10.7 Files and thumbnails advanced settings</a></li>
175
            <li class="content"><a href="#config_user">4.10.8 User settings</a></li>
176
            <li class="content"><a href="#config_custom">4.10.9 Custom fields for image description</a></li>
177
            <li class="content"><a href="#config_cookie">4.10.10 Cookie settings</a></li>
178
            <li class="content"><a href="#config_misc">4.10.11 Miscellaneous settings</a></li>
179
            </ul>
180
          </ul>
181
        <li class="content"><a href="#integrating" class="menu1">5. Integrating the script with your bulletin board</a>
182
            <ul class="content">
183
               <li class="content"><a href="#integrating_bridge_start" class="menu2">5.1 Available bridge files</a></li>
184
               <li class="content"><a href="#integrating_prerequisites_start" class="menu2">5.2 Pre-requistes</a>
185
                   <ul class="content">
186
                       <li class="content"><a href="#integrating_cookie_start">5.2.1 Authentification by cookie</a></li>
187
                       <li class="content"><a href="#integrating_standalone_start">5.2.2 Standalone version first</a></li>
188
                       <li class="content"><a href="#integrating_users_start">5.2.3 Coppermine users, groups and pics uploaded by users are lost when integrating</a></li>
189
                       <li class="content"><a href="#integrating_backup_start">5.2.4 Backup</a></li>
190
                       <li class="content"><a href="#integrating_database_start">5.2.5 Keep Coppermine and bbs tables in the same database</a></li>
191
                   </ul>
192
               </li>
193
               <li class="content"><a href="#integrating_steps_start" class="menu2">5.3 Integration steps</a>
194
                   <ul class="content">
195
                       <li class="content"><a href="#integrating_steps_settings_start">5.3.1 Check your bbs settings</a></li>
196
                       <li class="content"><a href="#integrating_steps_bridge_start">5.3.2 Edit your bridge file</a></li>
197
                       <li class="content"><a href="#integrating_steps_init_start">5.3.3 Enable bbs integration</a></li>
198
                       <li class="content"><a href="#integrating_steps_special_start">5.3.4 Special steps depending on the bbs you use</a>
199
                           <ul class="content">
200
                               <li class="content"><a href="#integrating_steps_special_phpbb_start">5.3.4.1 For phpBB only</a></li>
201
                               <li class="content"><a href="#integrating_steps_special_punbb_start">5.3.4.2 For PunBB only</a></li>
202
                           </ul>
203
                       </li>
204
                       <li class="content"><a href="#integrating_steps_upload_start">5.3.5 Upload the modified files</a></li>
205
                       <li class="content"><a href="#integrating_steps_sync_start">5.3.6 Synchronsising the bbs groups with Coppermine's groups</a></li>
206
                   </ul>
207
               </li>
208
            </ul>
209
        </li>
210
        <li class="content"><a href="#translating"><span class="menu1">6. Translating Coppermine into other languages</span></a></li>
211
        <li class="content"><a href="#known_issues"><span class="menu1">7. Known Issues</span></a></li>
212
        <li class="content"><a href="#credits"><span class="menu1">8. Credits</span></li>
213
        <ul class="content">
214
          <li class="content"><a href="#developers"><span class="menu2">8.1 Coppermine team</a></span></li>
215
          <li class="content"><a href="#contributors"><span class="menu2">8.2 Contributors</a></span></li>
216
          <li class="content"><a href="#codebase"><span class="menu2">8.3 Code used in Coppermine</a></span></li>
217
          <li class="content"><a href="#copyright"><span class="menu2">8.4 License</a> (Copyright &amp; disclaimer)</span></li>
218
        </ul>
219
      </ul>
220
      <hr />
221
<!--
222
<a name="testVersion"></a>
223
<h1>0. Beta (Testing) version</h1>
224
<p>Dear Tester,<br />&nbsp;<br />
225
Thank you for taking the time to test Coppermine Photo Gallery.
226
Please be rough on the program so that we can track down and
227
eliminate bugs from our public release of version 1.3.<br />
228
Please understand that this is still beta software that is meant to be used for testing purposes and not for production, so there is no support for cpg1.3.0beta yet.</p>
229
 
230
<p>While testing CPG 1.3, please make certain to note any odd behavior you
231
encounter.  This could include typographical errors, misleading instructions,
232
or any other out-right error.  If you encounter a major error, please switch
233
the debug mode to &quot;on&quot; in the configuration panel and copy the text in the
234
debug window.  This will greatly aid the development team in hunting down the
235
problem.</p>
236
 
237
<p><b>Areas to be particularly mindful of:</b></p>
238
<ul>
239
<li>Please test every facet of CPG, from the installation on to every feature available (and in as many themes as possible).</li>
240
<li>If you have the ability to test GD, GD2 and ImageMagick, please test all of them.</li>
241
<li>Please attempt to use multiple types of graphics such as JPEG, PNG and GIF (for IM users).</li>
242
</ul>
243
<p>Please report your test results to the <a href="http://coppermine.sourceforge.net/board/viewforum.php?f=19">testing board</a>, but before starting a new thread make sure that the potential bug you're going to report hasn't been posted before.</p>
244
 
245
<p><b>The report format should include:</b></p>
246
<ul>
247
<li>Server OS</li>
248
<li>Web Server Software</li>
249
<li>GD, GD2 or ImageMagick Test</li>
250
<li>PHP Version</li>
251
<li>BB Integration (if any)</li>
252
<li>Themes fully tested (by fully tested, we mean as many different features as</li>
253
<li>possible using that theme)</li>
254
<li>Major Errors</li>
255
<li>Client OS and Browser</li>
256
<li>Fresh install or upgrade (if yes, from which version of cpg)</li>
257
</ul>
258
 
259
<p>Your test results will not merely be used to fix problems but will also be used
260
to tout the compatibility of CPG with multiple browsers and OS's.  That is why
261
this information is important EVEN IF YOU FIND NOTHING WRONG.</p>
262
 
263
<p>Thanks for your participation and your time in making CPG the premiere
264
open-source photo gallery!</p>
265
 
266
<p>Coppermine Development Team</p>
267
<p><a class="back" href="#top">Back to
268
      top</a></p>
269
-->
270
 
271
 
272
<a name="what"></a>
273
<h1>1. What is required</h1>
274
<ul>
275
  <li>A web server that supports PHP (the script should work with any version
276
    &gt;= 4.1.0)</li>
277
  <li>A MySQL database</li>
278
  <li>PHP compiled with the support for the GD library or the ImageMagick &quot;convert&quot;
279
    utility in order to make thumbnails and reduced size images</li>
280
</ul>
281
 
282
<p><a class="back" href="#top">Back to
283
      top</a></p>
284
 
285
<a name="installation"></a>
286
<h1>2. Installation and Setup</h1>
287
<a name="how"></a>
288
<h2>2.1 How to install the script</h2>
289
<ul>
290
  <li><b>Unpack the archive preserving the directory structure</b><br />(you can rename the coppermine folder, but not the files or folders within).</li>
291
  <li><b>Upload all files onto your webserver</b> (make sure to use the correct ftp mode)</li>
292
  <li><b>CHMOD the folders <i>albums</i> and <i>include</i> to 755 (or 777, depending on your server config)</b> - this step is really important, don't skip it!<br />There are a lot of tutorials for beginners how to use chmod available: <a href="http://www.google.com/search?q=chmod+tutorial" class="external">search chmod tutorials with google</a>. If you're on a windows server, you'll have to set permissions accordingly as well (usually the webserver runs under the user name &quot;IUSR_hostname&quot; - you'll have to set rwx-permissions for this user).</li>
293
  <li><b>Run the install script on your server</b> (http://your_server/coppermine_dir/install.php)
294
    and follow the instructions</li>
295
</ul>
296
<p><a class="back" href="#top">Back to top</a></p>
297
 
298
 
299
<a name="getting"></a>
300
<h2>2.2 Getting started</h2>
301
<p>Log in with the admin username and password you set up during install, click on the &quot;admin mode&quot;
302
  link if it is visible, go to the <b>Config</b> page and start to configure your
303
  gallery. Note that even if you are a member of the administrator group, you
304
  need to be in &quot;admin mode&quot; to configure your gallery.</p>
305
<p>There are some settings in config that can't be changed later (if there are already files in the database) - make sure to set them up correctly in the first place. Although you'll surely want to start using coppermine immediately it is advisable to configure those settings (marked with an asterisk &quot;*&quot;) properly at the very beginning.</p>
306
<p>Use the &quot;<b><a href="#albmgr">Album Manager</a></b>&quot; (&quot;Albums&quot; link in the admin
307
  menu) in to create and order your albums. You'll need at least one album your files can go into.</p>
308
<p>Use the <b>anonymous</b> group to define what non-regsitered users can and
309
  can't do (in the <a href="#group_cp">groups</a> panel).</p>
310
<p>Use the <b><a href="#modif_alb_pics">properties</a></b> of an album to modify its description and permissions.
311
</p>
312
<p>In order for a user to be allowed to upload a file in album two conditions
313
  must be met:</p>
314
<ul>
315
  <li> The user must be part of a <a href="#group_cp">group</a> that can upload files.</li>
316
  <li>There must be at least one album where &quot;<b>Visitors can upload files</b>&quot;
317
    has been set to &quot;<b>Yes</b>&quot;,<br> <b>OR</b> <br>The user has created an album in the 'user galleries', if allowed.</li>
318
</ul>
319
<p>The same applies to <b>picture rating</b> and <b>comment posting</b>.</p>
320
<p>If you have installed the script succesfully but are having trouble getting
321
  it working properly you can enable the &quot;<b><a href="#debug_mode">debug mode</a></b>&quot; on the
322
  <b>config page</b>. In this mode, the script outputs most of the warning/error
323
  messages produced by PHP in addition to some debug information. This can provide
324
  valuable information to understand what is wrong.</p>
325
<p><a class="back" href="#top">Back to top</a></p>
326
 
327
<a name="xp"></a>
328
<h2>2.3 Using Windows XP Web Publishing Wizard with Coppermine</h2>
329
<p>If you are using Windows XP, you can use its built-in web publishing wizard
330
  to upload your photos to your gallery.</p>
331
<p>Once you have properly installed the script on your server, call the xp_publish.php
332
  file from your web browser (http://your_site.com/coppermine_dir/xp_publish.php).</p>
333
<p>The script displays some information on how to do the installation on the client
334
  side and how to use the Wizard. Basically you will need to download a small
335
  file created by the script that needs to be loaded into your Windows registry.</p>
336
<img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
337
<img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
338
<img src="pics/cpg111.gif" width="23" height="20" border="0" alt="" /><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="" ><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
339
<img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
340
<img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
341
<img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
342
<p><a class="back" href="#top">Back to top</a></p>
343
 
344
<a name="creating"></a>
345
<h2>2.4 Creating or upgrading your own themes</h2>
346
<p>To upgrade an existing custom theme, to version 1.3.x, read <a href="theme.htm">theme.htm</a></p>
347
<p>Coppermine themes are stored in the &quot;<b>themes</b>&quot; directory, they
348
  consist of 3 files : </p>
349
<ul>
350
  <li>&quot;<b>template.html</b>&quot; the main template in plain HTML.</li>
351
  <li>&quot;<b>style.css</b>&quot; the stylesheet associated with the template</li>
352
  <li>&quot;<b>theme.php</b>&quot; the PHP theme file</li>
353
</ul>
354
<p>To create a new template, the best solution is to use an existing one as a basis. To do that, make a copy of the folder of the theme you want to use as a basis. Then edit the &quot;<b>template.html</b>&quot; and &quot;<b>theme.php</b>&quot; files and replace all occurences of &quot;<b>themes/old_theme_dir</b>&quot; with &quot;<b>themes/new_theme_dir</b>&quot; in order for the links to point to the correct place.</p>
355
<p>When editing the &quot;<b>template.html</b>&quot; file do not remove the elements
356
  between <b>{}</b> these are the placeholders used by the script. Also keep in
357
  mind that despite this file being located in the &quot;<b>themes/your_theme_dir</b>&quot;
358
  directory, it must be build like if it was in the main directory of the script.
359
  Practically to load an image, you must use <i>&lt;img src=&quot;themes/theme_dir/images/image.gif&quot;
360
  alt=&quot;&quot;/&gt;</i> and not <i>&lt;img src=&quot;images/image.gif&quot;
361
  alt=&quot;&quot;/&gt;.</i> The same apply for the &quot;<b>theme.php</b>&quot;
362
  file.</p>
363
  <p>Also, make sure not to delete the line <i>&lt;script type="text/javascript" src="scripts.js"&gt;&lt;/script&gt;</i> that is needed for the full-size pop-ups and other stuff related to JavaScript.</p>
364
<p>If you are using an HTML editor to make your template, the best solution is
365
  that you copy the &quot;<b>template.html</b>&quot; file into the main directory
366
  of the script and edit it there. If the script find a file named &quot;<b>template.html</b>&quot;
367
  in the main directory it will load it instead of the one of the theme directory.
368
  Once you have finished your editings, move the file back to the directory of
369
  your theme.</p>
370
<p>To modify the colors, fonts, font sizes, etc... used by the script, edit the
371
  &quot;<b>style.css</b>&quot; stylesheet. If you want to increase or decrease
372
  the size of the fonts you can simply modify the line with : <i>table { font-size:
373
  12px; }</i>. Most of the font sizes used by the script are defined as a percentage
374
  of this size.</p>
375
<p>The &quot;<b>theme.php</b>&quot; file contains all the HTML templates used
376
  by the script. You can also edit them. When making modifications to these templates,
377
  don't touch the lines with <i>&lt;!-- BEGIN xxx --&gt;</i> and <i>&lt;!-- END
378
  xxx --&gt;</i>.</p>
379
<p>If you're not sure how to create your own theme, you could also have a look at the download section of the coppermine homepage: there are tons of <a href="http://sourceforge.net/project/showfiles.php?group_id=89658&package_id=98541">user-contributed themes</a> available for download that can be previewed on the <a href="http://coppermine.sourceforge.net/demo/">coppermine demo page</a>.</p>
380
<p>While you're in the process of creating a new theme, you might not want to show the theme to the visitors of your page, but you (as coppermine admin) want to be able to preview your theme. To do that, simply add <tt class="code">theme=your_theme_name</tt> to the url in your browser.</p>
381
<b>Examples:</b>
382
<ul>
383
<li><tt class="code">http://yoursite.tld/coppermine/index.php?theme=your_theme_name</tt> will show the coppermine index page, using your theme</li>
384
<li><tt class="code">http://yoursite.tld/coppermine/thumbnails.php?album=1&theme=your_theme_name</tt> will show the thumbnail view of album 1, using your theme</li>
385
<li><tt class="code">http://yoursite.tld/coppermine/?theme=xxx</tt> will reset your view back to the theme you chose as your default theme in coppermine config</li>
386
</ul>
387
<p><a class="back" href="#top">Back to top</a></p>
388
 
389
<a name="safe"></a>
390
<h2>2.5 Safe mode issues</h2>
391
<p>A significant number of webhost on the Internet run PHP in safe mode. Coppermine
392
  runs without any problem in safe mode and with the &quot;open basedir restriction&quot;
393
  active, provided safe mode is properly configured. Unfortunately on many hosts,
394
  safe mode is not configured properly.</p>
395
<p>If your webhost is running PHP in safe mode but is misconfigured, you may need
396
  to do the following :</p>
397
<ul>
398
  <li>With a FTP program, change the mode of Coppermine's &quot;<b>include</b>&quot;
399
    directory on your server to <b>0777</b>.</li>
400
  <li>Do the same for the &quot;<b>albums</b>&quot; and &quot;<b>userpics</b>&quot;
401
    directories.</li>
402
  <li>Check that at the beginning the the &quot;<b>include/config.inc.php</b>&quot;
403
    file, you have a line with : &quot;<b>define('SILLY_SAFE_MODE', 1);</b>&quot;</li>
404
</ul>
405
<p><a class="back" href="#top">Back to top</a></p>
406
 
407
<a name="smtp"></a>
408
<h2>2.6 Using SMTP to send emails</h2>
409
<p>By default the script uses the PHP built-in <b>mail</b> function to send emails.
410
  In some cases, the PHP built-in function can't be used.</p>
411
<p> If in order to send emails with PHP you need to supply a <b>hostname</b>,
412
  a <b>username</b> and a <b>password</b>, you need to edit the file &quot;<b>include/mailer.inc.php</b>&quot;
413
  and put the correct values there (<i>$CONFIG['smtp_host'] = 'smtp.somewhere.com';
414
  $CONFIG['smtp_username'] = 'username'; $CONFIG['smtp_password'] = 'password';</i>).
415
  If you don't need a username and password to connect to your SMTP server, just
416
  leave them blank.</p>
417
<p><a class="back" href="#top">Back to top</a></p>
418
 
419
<a name="upgrade"></a>
420
<h1>3. Upgrading</h1>
421
<a name="10"></a>
422
<h2>3.1 Upgrading from version 1.0</h2>
423
 
424
<p>If you already have installed version 1.0 and you want to transfer your albums
425
  to version 1.3.3 proceed in the following way:</p>
426
<ul>
427
  <li>First, make a backup (dump) of your database.</li>
428
  <li> Install version 1.3.3 normally in a directory different from the one where you installed v 1.0. Note that in order to use the upgrade script, <b>tables for version 1.0 and 1.3.3 must be stored in the same database</b>.</li>
429
  <li>Copy the &quot;<b>albums</b>&quot; directory of version 1.0 into the directory where you installed version 1.3.3</li>
430
  <li>The upgrade script assumes that you used the &quot;<b>CPG_</b>&quot; prefix for tables (default value) when you installed version 1.0, if this is not the case, edit upgrade-1.0-to-1.2.php and edit the $prefix10 variable.</li>
431
  <li>Login to your 1.3.3 Gallery, enter the admin mode</li>
432
  <li>Call the upgrade script, http://yousitename/coppermine_dir/upgrade-1.0-to-1.2.php</li>
433
  <li><b>The upgrade from 1.0 to 1.3.3 is a two-step process.</b> You must click the link which comes up on the bottom of the page to complete the upgrade!.</li>
434
        <li><b>Delete upgrade-1.0-to-1.2.php from your server</b>. <li>If you get an error, go to Coppermine 1.3.3 config page, enable <a href="#debug_mode">debug mode</a>, try to call the upgrade script again and check what errors you get.</li>
435
</ul>
436
<p> <b>This upgrade process leaves your v1.0 gallery untouched </b></p>
437
<p><a class="back" href="#top">Back to top</a></p>
438
 
439
<a name="11"></a>
440
<h2>3.2 Upgrading from releases of version 1.1</h2>
441
        <ul>
442
                                <li>First, make a backup (dump) of your database.</li>
443
                <li>Backup your include/config.inc.php file, your anycontent.php file and your "albums" directoy.</li>
444
                <li>Unpack the archive</li>
445
                <li>If the file <b>install.php</b> exists in the root directory, delete it.</li>
446
                <li>Upload all of the new files and directories</li>
447
                <li>CHMOD the albums directory and all subfolders once more to 755 or 777 (depending on your server config)</li>
448
                <li>Call the upgrade script http://yousitename/coppermine_dir/update.php</li>
449
                <li>Your upgrade should be complete.</li>
450
        </ul>
451
<p><a class="back" href="#top">Back to top</a></p>
452
 
453
 
454
<a name="13"></a>
455
<h2>3.4 Upgrading from cpg1.2.0rc2 or better to version cpg1.3.3</h2>
456
        <ul>
457
                                <li>First, make a backup (dump) of your database.</li>
458
                <li>Backup your include/config.inc.php file, your anycontent.php file and your &quot;albums&quot; directoy.</li>
459
                <li>Unpack the archive</li>
460
                <li>If the file <b>install.php</b> exists in the root directory, delete it.</li>
461
                <li><b>Except for the &quot;albums&quot; directory</b>, upload all of the new files and directories making sure not to overwrite the include/config.inc.php file, your anycontent.php file or the albums directory.</li>
462
                <li>If you have not already done so, create a folder called &quot;edit&quot; within your &quot;albums&quot; directory - this folder will be used by coppermine as a temporary folder, do not ftp-upload files there. Make sure the new &quot;edit&quot;-folder is CHMODed the same way your albums-directory is (755 or 777, depending on your server's config)</li>
463
                <li>Run the file &quot;update.php&quot; in the coppermine directory once in your browser (e.g. http://yourdomain.tld/coppermine/update.php). This will update your coppermine install by making all necessary changes in the database.</li>
464
                <li>If you have made a custom theme, apply the changes that were introduced in the themes structure to your custom-made theme - refer to the <a href="theme.htm">theme-upgrade guide</a>.</li>
465
                <li>You can not use language files from older versions of Coppermine - make sure to only have the language files that come with this package inside your lang folder (delete or rename all files from older versions within the lang folder)</li>
466
        </ul>
467
<p>Please note: as there have been changes both in the coppermine files and the database from cpg1.3.0, cpg1.3.1 or cpg1.3.2 to cpg1.3.3, users of cpg1.3.0/1.3.1/1.3.2 will have to apply all steps mentioned above: both the files have to be replaced and the update.php script has to be run once.</p>
468
 
469
<p><a class="back" href="#top">Back to top</a></p>
470
 
471
<hr />
472
 
473
<a name="administration"></a>
474
<h1>4. Configuration &amp; Administration</h1>
475
 
476
      <h2>4.1 Categories, albums and files<a id="cat_alb_pic"
477
      name="cat_alb_pic"></a></h2>
478
      <p>The Coppermine Photo Gallery (CPG) works in the following way:</p>
479
      <ul>
480
        <li>Files are stored in albums</li>
481
        <li>Albums are organised in categories</li>
482
        <li>Categories can be nested (subcategories)</li>
483
                        </ul>
484
      <p>If you don't have many albums, you don't need to use categories. In
485
      that case you don't create any category and all your albums will appear on
486
      the main page of the script.</p>
487
      <p>There is a special category named "<b>User galleries</b>". This
488
      category can't be deleted. If a user belongs to a group where "can have a
489
      personal gallery" is set to YES, he will have the right to create his own
490
      albums and his gallery will be a sub-category of "User galleries".</p>
491
      <p>The administrator can create albums in any category. Regular users can
492
      only create albums in "User galleries/Their_username".</p>
493
      <p><a class="back" href="#top">Back to
494
      top</a></p>
495
      <hr>
496
 
497
      <h2>4.2 Admin mode &amp; User mode<a id="admin_user_mode"
498
      name="admin_user_mode"></a></h2>
499
      <p>When you are logged in as an admin, the script has two modes of
500
      operation : Admin mode &amp; User mode. You switch between Admin &amp;
501
      User mode by clicking on the corresponding link in the menu bar at the top
502
      of the screen.</p>
503
      <p>When you are in admin mode, you can administer your gallery and the
504
      following menu bar appears :</p>
505
      <p><a name="admin_menu"></a><img src="pics/admin_menu.gif" border="0" alt="Admin menu" /></p>
506
      <p>When you are in user mode you are just a regular user and can't access
507
      the admin pages.</p>
508
      <p>The items in the admin menu should be pretty self-explanatory:</p>
509
      <ul>
510
      <li><b>Upload approval</b><br />See all pics that await approval by the admin (depending on the settings in the &quot;<a href="#group_cp">groups</a>&quot; control panel)</li>
511
      <li><b>Config</b><br />Configure the overall look of your gallery and the settings using the &quot;<a href="#config">Config</a>&quot; button in the admin menu (note: you can not access the configuration by manually entering the url of the config file)</li>
512
      <li><b>Albums</b><br />Create/edit/delete <a href="#albmgr">albums</a></li>
513
      <li><b>Categories</b><br />Create/edit/delete <a href="#cat_cp">categories</a></li>
514
      <li><b>Users</b><br />Create/edit/delete <!--<a href="#users_cp">-->users<!--</a>--></li>
515
      <li><b>Groups</b><br />Create/edit/delete <a href="#group_cp">groups</a></li>
516
      <li><b>Ban Users</b><br />Ban users based on hostname or IP address. Make sure not to ban yourself! Use this feature with extreme care, since most users don't have static IP addresses, this feature should only be used if you really know what you're doing.<br />
517
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
518
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
519
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
520
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
521
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
522
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
523
      </li>
524
      <li><b>Display Ecards</b><br />View the ecards sent by users.<br />
525
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
526
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
527
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
528
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
529
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
530
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
531
      </li>
532
      <li><b>Review Comments</b><br />edit/delete user's comments</li>
533
      <li><b>Batch add files</b><br /><a href="#batch_add_pics">Batch-add files</a> to the coppermine database that have been uploaded by FTP.</li>
534
      <li><b>Admin Tools (Resize Pictures)</b><br />Collection of utilities to;<br><br>
535
                <dd><b>Rebuild or resize intermediate pictures and thumbnails.</b><br>
536
                <dd><img src="pics/util_re-size.gif" width="451" height="188" alt="" border="0"><br>Use this if you have changed the settings for thumbnail or intermediate images in config, or if you have to replace corrupt versions.<br>Select the radio button for this action, then choose to rebuild the thumbnails, intermediates, or both.<br>This uses a lot of server resources, so if you have timeout problems, try doing it in smaller batches.
537
                <br><br><dd><b>Delete full-size pictures.</b><br></dd>
538
                Use this to save space on your webspace.<br>When selected, Coppermine checks to see if an intermediate copy exists, and if it does, it deletes the original sized picture, then re-names the intermediate. If no intermediate exists, Coppermine leaves the original in place.<br><br>
539
                <dd><b>Delete orphaned comments.</b><br></dd>
540
                Sometimes, when pictures have been deleted, any comments associated with them remain in the database.  Use this to remove them from the database entirely.<br><br>
541
                <dd><b>Rename file titles.</b><br></dd>
542
                Use this to re-name the title of all files in an album, using info from the filename.<br><br>
543
                <dd><b>Delete file titles.</b><br></dd>
544
                Use this to clear the file titles from one or more albums.<br><br>
545
                <dd><b>View your server php info.</b><br></dd>
546
                If you are having problems, it is sometimes caused by server setup.  Clicking this link will provide you with all your php and mySQL settings, as well as on the GD library (if installed).  This may be needed by the support team, if you are unable to sort problems yourself.<br>It is not possible for visitors to your site to browse to this information, so if asked for it, copy and paste it to the support board.<br><br>
547
                <dd><b>Run a database update (update.php).</b><br></dd>
548
                After an update/upgrade, it is usually necessary to run update.php.  This can be done by typing the address directly into your browser, or by clicking this link.
549
 
550
                </li><br><br>
551
      <li><b>My profile</b><br />Edit your own user profile</li>
552
      </ul>
553
      <p>There's an admin mode and user mode for &quot;regular&quot; users as well - the user admin has these options:</p>
554
      <ul>
555
      <li><b>Create / order my albums</b><br />similar to album manager in admin mode, the user can create albums within his user gallery</li>
556
      <li><b>Modify my albums</b><br />The user can edit album title and description (similar to &quot;<a href="#album_prop">album properties</a>&quot; for the admin, but the user can't move his albums to other categories)</li>
557
      <li><b>My profile</b><br />The user can edit his profile (changing passwords, edit location, interests, home page and occupation properties, view quota usage). If you're using bbs integration, the &quot;My profile&quot; link will send the user to the bbs's profile page. </li>
558
 
559
      </ul>
560
      <p><a class="back" href="#top">Back to
561
      top</a></p>
562
      <hr>
563
 
564
 
565
 
566
      <h2>4.3 The group control panel<a id="group_cp" name="group_cp"></a></h2>
567
      <p><img src="pics/group_cp.GIF" border="1" /></p>
568
      <p>This is where you define what members of a group can and can't do.</p>
569
      <p>The disk quota applies only for groups where &quot;<i>Can have a personal</i>&quot;
570
      gallery has been set to &quot;<b>YES</b>&quot;. Both files uploaded by a user in his
571
      personal gallery as well as files uploaded to public galleries are included in the quota.</p>
572
      <p>Use the <b>anonymous</b> group to define what non-registered users can
573
      and can't do. Quota and &quot;<i>Can have a personal gallery</i>&quot; are meaningless for anonymous users.</p>
574
      <p>Bear in mind that if a user is a member of a group where &quot;<i>can rate pictures</i>&quot;, &quot;<i>can post comments</i>&quot; or &quot;<i>can upload files</i>&quot; is set &quot;<i>YES</i>&quot;, he will have the right to perform these operations only in albums where they are allowed, ie. uploading files will only be possible in albums where
575
      &quot;<i>Visitors can upload files</i>&quot; has been set to <i>YES</i>.</p>
576
      <p>If &quot;<i>can have a personal gallery</i>&quot; is set to <i>YES</i>, the members of the
577
      group will have their own gallery in the &quot;<i>User galleries</i>&quot; category where
578
      they will be able to create their own albums.</p>
579
      <p>If &quot;<i>priv. upl. approval</i>&quot; is set to <i>NO</i>, files uploaded by members of
580
      the group in albums created in their own gallery won't need to be approved
581
      by the admin.</p>
582
      <p><img src="pics/groupsscrsht2.jpg" border="1" /></p>
583
      <p>The group control panel enables you to control the upload experience of any group.</p>
584
      <p><i>Upload form configuration</i> lets you select the type of upload form a group may use. Four form types are currently available.
585
      <ul>
586
      <li><b>Single file uploads only</b> - The group may not use advanced uploading features. They may upload one file at a time.</li>
587
      <li><b>Multiple file uploads only</b> - The group may upload multiple files at one time.</li>
588
      <li><b>URI uploads only</b> - The group may only upload files using URIs. Acceptable URIs must begin with 'http://' or 'ftp://'.</li>
589
      <li><b>File-URI</b> - The group may upload files using file upload boxes and URIs.</li>
590
      </ul>
591
      </p>
592
      <p><i>User may customize number of upload boxes?</i> allows the user to select the number of upload boxes for an upload.</p>
593
      <p><i>Maximum/exact number of file upload boxes</i> controls the number of file upload boxes presented to the user. If the user may customize the number of boxes, this setting serves a maximum limit for the number of boxes he may request. Otherwise, this setting determines the number of boxes that will appear on the upload form.</p>
594
      <p><i>Maximum/exact number of URI upload boxes</i> is the same type of control as <i>Maximum/exact number of file upload boxes</i>, but it controls the presentation of URI upload boxes.</p>
595
      <p><a class="back" href="#top">Back to
596
      top</a></p>
597
      <hr>
598
 
599
      <h2>4.4 The categories control panel<a id="cat_cp" name="cat_cp"></a></h2>
600
      <p><img src="pics/category_cp.GIF" border="1" /></p>
601
      <p>This is where you can edit your categories.</p>
602
      <ul>
603
        <li>The <img src="pics/edit.gif" border="0" width="16" height="16" alt="" /> button
604
        allows you to edit the title, description and parent category of an
605
        existing cetegory.
606
        <li>The <img src="pics/delete.gif" width="16" height="16" alt="" /> button
607
        allows you to delete a category. Deleting a category does not delete the
608
        albums and files it contains. They are simply moved to the &quot;Root&quot;
609
        category.
610
        <li>The <img src="pics/up.gif" width="16" height="16" alt="" /> and <img
611
        src="pics/down.gif" width="16" height="16" alt="" /> buttons allow you to
612
        order your categories.
613
        <li>The &quot;<b>Move into</b>&quot; dropdown lists allow you to change the parent
614
        of a specific category. </li></ul>
615
      <p>&quot;<b>User galleries</b>&quot; is a special category. It is not visible unless
616
      you have some users that have created their own gallery. It can't be
617
      deleted but you can edit its title and description by using the <img
618
      src="pics/edit.gif" width="16" height="16" alt="" /> button. </p>
619
      <p><a class="back" href="#top">Back to
620
      top</a></p>
621
      <hr>
622
 
623
      <h2><a name="albmgr"></a>4.5 The Album Manager</h2>
624
      <p><img src="pics/albmgr.gif" width="360" height="288" border="0" alt="" title="Album Manager" /></p>
625
      <p>Coppermine stores files inside of albums, so you'll need at least one album your pictures/files can go to. Albums can be stored in categories (but they don't <i>need</i> a category, they can as well go into the coppermine &quot;root&quot;).<br />
626
      When you click on &quot;albums&quot; in the admin menu, you will see the <i>Album Manager</i>.</p>
627
      <h3><a name="albmgr_create"></a>4.5.1 Creating albums</h3>
628
      <ul>
629
      <li><b>Choose a category from the dropdown list</b> &quot;Select category&quot; where your album should go to (or choose &quot;* No category *&quot; if the album should go into the coppermine &quot;root&quot;). If you haven't created a category yet, go to the <a href="#cat_cp">categories control panel</a> first, but you can later move the album as well using the <a href="#album_prop">album properties</a> page.</li>
630
      <li><b>Click on the button &quot;New&quot;</b> - your new album will appear on the list, by default labelled &quot;New album&quot;</li>
631
      <li><b>Click on the text input filed at the bottom of the screen</b>, highlighting the default name &quot;New album&quot;</li>
632
      <li><b>Type the album name you want to assign</b></li>
633
      <li>(repeat steps 2 to 4 to add more than one album)</li>
634
      <li><b>click &quot;Apply modifications&quot;</b> to submit your changes to the database (if you don't, all changes will be lost)</li>
635
      <li><b>Confirm the alert box with &quot;OK&quot;</b> (<i>Are you sure you want to make these modifications ?</i>)</li>
636
      </ul>
637
      <h3><a name="albmgr_rename"></a>4.5.2 Renaming albums</h3>
638
      <ul>
639
      <li><b>Choose a category from the dropdown list</b></li>
640
      <li><b>Click on the album you want to change</b></li>
641
      <li><b>Click on the text input filed at the bottom of the screen</b>, highlighting the album name</li>
642
      <li><b>Type the album name you want to assign</b></li>
643
      <li><b>click &quot;Apply modifications&quot;</b></li>
644
      <li><b>Confirm the alert box with &quot;OK&quot;</b> (<i>Are you sure you want to make these modifications ?</i>)</li>
645
      </ul>
646
      <h3><a name="albmgr_order"></a>4.5.3 Changing the album order</h3>
647
      <ul>
648
      <li><b>Choose a category from the dropdown list</b></li>
649
      <li><b>Click on the album you want to move up or down in the list</b></li>
650
      <li><b>Use the arrow buttons to move the album up<img src="../images/move_up.gif" width="26" height="21" border="0" alt="" title="move the album up" /> or down<img src="../images/move_down.gif" width="26" height="21" border="0" alt="" title="move the album down" /></b></li>
651
      <li><b>click &quot;Apply modifications&quot;</b></li>
652
      <li><b>Confirm the alert box with &quot;OK&quot;</b> (<i>Are you sure you want to make these modifications ?</i>)</li>
653
      </ul>
654
      <h3><a name="albmgr_delete"></a>4.5.4 Deleting albums</h3>
655
      <ul>
656
      <li><b>Choose a category from the dropdown list</b></li>
657
      <li><b>Click on the album you want to delete</b></li>
658
      <li><b>Click the &quot;Delete&quot; button</b></li>
659
      <li><b>Confirm the alert box with &quot;OK&quot;</b> (<i>Are you sure you want to delete this album ? All files and comments it contains will be lost !</i>)</li>
660
      <li><b>click &quot;Apply modifications&quot;</b></li>
661
      <li><b>Confirm the alert box with &quot;OK&quot;</b> (<i>Are you sure you want to make these modifications ?</i>)</li>
662
      </ul>
663
      <p><a class="back" href="#top">Back to
664
      top</a></p>
665
      <hr>
666
 
667
      <h2>4.6 Modifying albums/files<a id="modif_alb_pics"
668
      name="modif_alb_pics"></a></h2>
669
      <p>When you are in admin mode there is a menu displayed next to each
670
      album</p>
671
      <p></p>
672
      <p><img src="pics/album_menu.GIF" border="1" /></p>
673
      <p><b>Delete</b> allows you to delete the album and all files it
674
      contains.</p>
675
      <p><b>Properties</b> allows you to modify the name, description and
676
      permissions of the album</p>
677
      <p><b>Edit pics</b> allows you to modify the title/caption/keywords etc...
678
      of the files in the album</p>
679
      <p><a class="back" href="#top">Back to
680
      top</a></p>
681
      <hr>
682
 
683
<a name="ftp"></a><a name="batch_add_pics"></a>
684
<h2>4.7 Uploading pics by FTP / Batch-Add Pictures</h2>
685
<p>It's recommended that the coppermine admin uses ftp to upload many pics in one go. Use your ftp software to create sub-folders within <i>your_coppermine_directory/albums/</i>, where your ftp uploads can go to. It's a good idea to have a folder structure within the <i>albums</i> folder that reflects your coppermine categories and albums, but it's not mandatory.<br /><span class="important">Important</span>: do not create folders or upload to the <i>userpics</i>- nor the <i>edit</i>-folder by ftp: these folders are used by coppermine internally and mustn't be used for any other purpose! Folder names mustn't contain dots and it's even recommended not to use any special chars - only use a-z, numbers and maybe <tt class="code">-</tt> or <tt class="code">_</tt>. Make sure to upload in binary or auto-mode.</p>
686
<p>Once you have uploaded your photos by ftp, click on the Batch Add Pictures button. The batch-add is done in three steps:</p>
687
<ul>
688
<li>find the directory under which you have uploaded your photos. Select this directory by clicking on it.
689
<br /><img src="pics/searchnew_1.gif" width="602" height="185" border="0" alt="" /></li>
690
<li>select the photos you wish to upload (by ticking them, the new pics are pre-selected, those that already are in your coppermine database are not selected) and the album you wish to insert them into. Click &quot;Insert Selected Pictures&quot; to start the batch-add process.<br />
691
<img src="pics/searchnew_2.gif" width="561" height="320" border="0" alt="" /></li>
692
<li>CPG will then display the results of the batch-add (allow some time untill all results are being shown).<br />
693
If the OK, DP, PB 'signs' does not appear click on the broken file to see any error message produced by PHP.<br />
694
If your browser times out, hit the reload button.
695
<ul>
696
<li>OK : means that the file was succesfully added</li>
697
<li>DP : means that the file is a duplicate and is already in the database</li>
698
<li>PB : means that the file could not be added, check your configuration and the permission of directories where the files are located</li>
699
<li>NA : means that you haven't selected an album the files should go to, hit 'back' and select an album. If you don't have an album create one first</li>
700
</ul>
701
</li>
702
</ul>
703
<p>Giving FTP-access to other users is a serious security threat, that's why batch-add is only available for the coppermine gallery admin.</p>
704
<p>Once files have been added to coppermine's database, make sure not to rename or delete them by ftp - use coppermine's admin menu to remove files instead, since this way they will be removed both from the file system <b>and</b> the database.</p>
705
<p><a class="back" href="#top">Back to top</a></p>
706
<hr />
707
 
708
      <h2>4.8 Album properties<a id="album_prop" name="album_prop"></a></h2>
709
      <p><img src="pics/edit_album.GIF" border="1" /></p>
710
      <p>The "Album category" drop down list allows you to move an album between
711
      categories. If you set this to "* No category *" then the album will be
712
      displayed on your main page.</p>
713
      <a name="bbcode"></a><p>Coppermine understands the following bbCodes (the same bbCodes that are
714
      used by phpBB) in image and album description</p>
715
      <ul>
716
        <li>[b]<b>bold</b>[/b]
717
        <li>[i]<i>italic</i>[/i]
718
        <li>[url=http://url]URL text[/url]
719
        <li>[email]user@domain.tld[/email] </li></ul>
720
      <p>The thumbnail is the picture that will represent the album in the album
721
      list.</p>
722
      <p>If you have set &quot;Users can can have private albums&quot; to YES on the
723
      <a href="#config">config page</a>, you can define who can view the files of this album.</p>
724
      <p>When &quot;visitors can upload file&quot; is set to YES, it is possible to
725
      upload files in this album. <b>Note that a visitor will have the right
726
      to upload files into an album where this option is set to YES only if
727
      he is a member of a group for which &quot;Can upload pictures&quot; is set to YES.
728
      </b>Non registered users are members of the "Anonymous" group.</p>
729
      <p>The same rules as above apply for &quot;Visitors can post comments&quot; and
730
      &quot;Visitors can rate files&quot;.</p>
731
      <p><a class="back" href="#top">Back to
732
      top</a></p>
733
      <hr>
734
 
735
      <h2>4.9 Editing files<a id="edit_pics" name="edit_pics"></a></h2>
736
      <p><img src="pics/edit_picture.GIF" border="1" /></p>
737
      <p>This is where you can modify the title description, keywords and custom
738
      fields (if they are used) of a file.</p>
739
      <p>Use the album drop down menu to move the file to another album.<br /></p>
740
      <p><a class="back" href="#top">Back to
741
      top</a></p>
742
      <hr>
743
 
744
      <h3>4.9.1 Editing videos<a id="edit_vids" name="edit_vids"></a></h3>
745
      <p><img src="pics/edit_video.gif" border="1" /></p>
746
      <p>This is where you can modify the title description, keywords and custom
747
      fields (if they are used) of a video.</p>
748
      <p>Use the album drop down menu to move the video to another album.</p>
749
      <p>Use the height and width fields to set the size of the video.</p>
750
      <p>Video uploads are available for cpg1.3.0 (or better) as part of the distribution and for cpg1.2.1 as separate modification.<br />
751
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
752
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
753
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
754
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
755
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
756
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
757
      <p><a class="back" href="#top">Back to
758
      top</a></p>
759
      <hr>
760
 
761
      <h3>4.9.2 Custom Thumbnails<a id="cust_thmb" name="cust_thmb"></a></h3>
762
      <p><img src="pics/cust_thmb.gif" border="1" /></p>
763
      <p><b>Order of thumbnails:</b><br />
764
      <b style="color:red;">Thumbnails are selected by level (user-defined, theme-defined, global) then by type (file-specific,
765
      extension-specific, media-specific) in order.</b> User-defined thumbnails are stored in the folder where the file is located. Theme-defined thumbnails
766
      are stored in the themes 'images' folder. Global thumbnails are stored within the 'images' folder of the Coppermine root.
767
      <b style="color:red;">Thumbnails can be either a 'gif', 'png', or 'jpg'.</b>
768
      </p>
769
      <p><b>Types of thumbnails:</b><br />
770
      <b style="color:red;">File-specific thumbnails must have the same base name as the file.</b> Using the example in the screenshot, its thumbnails could be
771
      'thumb_<b>thailand_waterfall</b>.gif', 'thumb_<b>thailand_waterfall</b>.png', or 'thumb_<b>thailand_waterfall</b>.jpg'
772
      , chosen in that order.
773
      </p>
774
      <p><b style="color:red;">Extension-specific thumbnails are named after the extension of the file.</b>
775
      (Examples: 'thumb_wmv.jpg', 'thumb_wav.jpg'.)
776
      </p>
777
      <p><b style="color:red;">The base name for media-specific thumbnails are 'thumb_movie', 'thumb_document', and 'thumb_audio'.</b>
778
      Images use file-specific thumbnails by default.
779
      </p>
780
      <p><b>Uploading:</b><br />
781
      There are 2 ways to upload custom thumbnails:</p>
782
      <p>
783
      1. Have an image already uploaded then upload a video via the upload page. (or vice versa) The video will share the thumbnail of the image.<br />
784
      </p><br /><br />
785
      <p><img src="pics/cust_thmb_3.gif" border="1" /></p>
786
      <p>
787
      2. FTP upload both the video and (thumbnail or image) then batch-add. If you FTP upload the thumbnail, the thumbnail will be shown instead of the default Coppermine thumbnail on the batch-add page.
788
      If you upload an image it will look like the screenshot. However, when the two files are added, the thumbnail of the image will be used by the video.</p>
789
      <br /><br />
790
      <p><img src="pics/cust_thmb_final.gif" border="1" /></p>
791
      <p>Final result.</p>
792
      <p>Note: If methods 1 is used and the image is deleted, the thumbnail will be deleted also, and the default Coppermine thumbnails will be used.<br />
793
      If a previous video has be uploaded via FTP, the thumbnail must be uploaded via FTP to the same folder.
794
      </p>
795
      <p>Video uploads are available for cpg1.3.0 (or better) as part of the distribution and for cpg1.2.1 as separate modification.
796
      Custom thumbnails aren't supported in versions prior to 1.3.0. <b style="color:red;">Using these instructions, a custom thumbnail can be applied to any file, not just videos.</b>
797
      </p>
798
<p><b>FAQS:</b>
799
<ul>
800
<p><li><b>Quote</b><br /><div class="quote">I have a video named <b>'movie.wmv'</b>, when I upload a thumbnail for it <b>'thumb_movie.jpg'</b> it replaces multiple videos!!!!</div>
801
Duhh. <b>'thumb_movie.jpg'</b> is a media-specific thumbnail. Rename the video and the thumbnail to something other than just <b>'movie'</b>.</li>
802
</p>
803
<p><li><b>Quote</b><br /><div class="quote">I can't find my user's folder!</div>
804
From within Coppermine, browse to the user's album. Look in the url of your browser and you should see the folder's name. (See screenshot for an example.)<br />
805
<img src="pics/user_folder_link.gif" /><br />
806
Your users can upload their own thumbnails by using this trick: Create an album. Change the permissions on it so no one can view it except him. Then upload the fullsize images of the thumbnails to this folder. Files outside this album will be able to use the thumbnails of these images. (See above for naming.)</li>
807
</p>
808
<p><li><b>Quote</b><br /><div class="quote">How do I stop my users from creating their own custom thumbnails?</div>
809
Right now, you can't.</li>
810
</p>
811
</ul>
812
      <br />
813
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
814
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
815
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
816
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
817
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
818
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
819
      <p><a class="back" href="#top">Back to
820
      top</a></p>
821
      <hr>
822
 
823
      <h2>4.10 The configuration page<a id="config" name="config"></a></h2>
824
      <a name="config_general"></a>
825
      <h3>4.10.1 General settings</h3>
826
      <h4>Gallery name</h4>
827
      <p>This is the name of your gallery. It will appear in the title of your
828
      page and is shown on some templates.</p>
829
      <h4>Gallery description</h4>
830
      <p>This is a short description of your gallery. This description is shown
831
      on some templates below the name of your gallery.</p>
832
      <h4>Gallery administrator email</h4>
833
      <p>All emails sent by the gallery are sent with this email address.</p>
834
      <h4>Target address for the 'See more pictures' link in e-cards</h4>
835
      <p>This is the URL where a user will be directed when he will click on the
836
      &quot;See more pictures&quot; link in an e-card (just the path to your coppermine folder, e.g. <i>http://yourdomain.tld/coppermine/</i>). Don't specify a certain file (like index.php) in this field.<br />This <i>must</i> be the URL of
837
      your gallery, since the value entered here is used in other parts of Coppermine as well.</p>
838
      <h4>Gallery is offline</h4>
839
      <p>If you have to do maintenance work to do on your gallery, switch it to offline mode. Only members of the admin group will be able to log in, all other users will only see &quot;Gallery is offline&quot;. Remember to switch this option off once your maintenance work is done.<br />
840
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
841
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
842
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
843
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
844
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
845
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
846
      <h4>Log ecards</h4>
847
      <p>When enabled, all ecards that are being sent are as well written into the database, where the coppermine admin can view them. Before switching this option on, make sure that logging is legal in your country. It is also advisable to notify your users that all ecards are being logged (preferrably on the registration screen).<br />
848
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
849
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
850
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
851
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
852
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
853
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
854
      <h4>Allow ZIP-download of favorites</h4>
855
      <p>When enabled, the user can download the files put into the favorites in a zip-file from the &quot;My favorites&quot; page. This option requires zlib to be installed on your server (run <a href="http://www.php.net/phpinfo" class="external">phpinfo</a> to check if this library exists on your server).<br />
856
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
857
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
858
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
859
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
860
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
861
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
862
      <p><a class="back" href="#top">Back to top</a></p>
863
      <hr />
864
 
865
      <a name="config_language"></a>
866
      <h3>4.10.2 Language, Themes &amp; Charset settings</h3>
867
      <p><img src="pics/config_language.gif" width="612" height="234" border="1" alt=""></p>
868
      <h4>Language</h4>
869
      <p>This is the default language for your gallery. All language files are
870
      stored in the <b>lang</b> directory on your server.</p>
871
      <p>The language files with an "<b>-utf8</b>" suffix are unicode encoded
872
      files. If you select an -utf8 file as the default language and you set
873
      "Character encoding" to "Unicode (utf-8)" then the script will auto detect
874
      the preferred language of the visitor based on what is configured in his
875
      browser. If the corresponding language is available it will be used else
876
      the default language file will be used.</p>
877
      <p>When the script auto detect the preferred language, it stores the
878
      result in a cookie on the visitor's computer. To reset this cookie (and so
879
      force the script to do another auto detection) call it with something
880
      like: <a
881
      href="#">http://yoursite.com/coppermine_dir/index.php?lang=xxx</a></p>
882
      <p>Once you have added some comments or files to your gallery, you
883
      should not change the character set of your gallery. If you do so,
884
      non-ASCII character may not be shown correctly.</p>
885
      <h4>Theme</h4>
886
      <p>Use this line to select the theme of your gallery. Themes are stored in
887
      sub-directories of the <b>themes</b> directory.</p>
888
      <h4>Display language list</h4>
889
      <p>Enable this option if you want your users to be able to select their own language with a dropdown list (you can specify to display only the list itself or a label saying &quot;<b>Choose your language:</b>&quot; in front of the list). Edit your template file (/themes/yourtheme/template.html) to specify where the language dropdown list should appear on your gallery (look for <b>{LANGUAGE_SELECT_LIST}</b>).<br />
890
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
891
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
892
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
893
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
894
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
895
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
896
      <h4>Display language flags</h4>
897
      <p>Enable this option if you want your users to be able to select their own language by clicking on a flag representing their language (you can specify to display only the flags themselves or a label saying &quot;<b>Choose your language:</b>&quot; in front of the flags). Edit your template file (/themes/yourtheme/template.html) to specify where the language dropdown list should appear on your gallery (look for <b>{LANGUAGE_SELECT_FLAGS}</b>).<br />
898
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
899
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
900
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
901
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
902
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
903
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
904
      <h4>Display &quot;reset&quot; in language selection</h4>
905
      <p>This option only applies if you enabled language selection at all - it will show a &quot;default&quot;-icon or list entry to let the users go back to the original language of your gallery.<br />
906
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
907
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
908
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
909
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
910
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
911
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
912
      <h4>Display theme list</h4>
913
      <p>Enable this option if you want your users to be able to select another theme with a dropdown list (you can specify to display only the list itself or a label saying &quot;<b>Choose your theme:</b>&quot; in front of the list). Edit your template file (/themes/yourtheme/template.html) to specify where the theme dropdown list should appear on your gallery (look for <b>{THEME_SELECT_LIST}</b>).<br />
914
      This option only makes sense if you have at least one other theme in your /themes/ folder than your default theme. It's recommended to only offer this option if there's an additional benefit for the user (for example a theme with less graphics in it that loads faster for users on a dial-up connection, or a theme with reduced color pallettes and good contrast).<br />
915
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
916
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
917
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
918
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
919
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
920
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
921
      <h4>Display &quot;reset&quot; in theme selection</h4>
922
      <p>This option only applies if you enabled theme selection at all - it will show a &quot;default&quot; list entry to let the users go back to the original theme of your gallery.<br />
923
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
924
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
925
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
926
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
927
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
928
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
929
      <h4>Display FAQ</h4>
930
      <p>This option adds &quot;FAQ&quot; to the menu bar when enabled. If a user clicks on it, it will display a list of &quot;Frequently asked question&quot; on how to use coppermine. To change the content of the FAQ, edit the file /your_coppermine_folder/lang/yourlanguage.php (e.g. english.php) and look for <pre>// ------------------------------------------------------------------------- //
931
// File faq.php
932
// ------------------------------------------------------------------------- //</pre><br />Edit the stuff that comes after it.<br />
933
<img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
934
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
935
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
936
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
937
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
938
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
939
      <h4>Display bbcode help</h4>
940
      <p>When enabled, this will display the <a href="#bbcode">bulletin board codes</a> that are allowed to use in description fields next to the field.<br />
941
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
942
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
943
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
944
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
945
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
946
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
947
      <h4>Character encoding</h4>
948
      <p>This should normally be set to "Default (language file)" or "Unicode
949
      (utf-8)". See the discussion in the &quot;<b><a href="#config_language">language</a></b>&quot; section of this
950
      page.</p>
951
      <p><a class="back" href="#top">Back to
952
      top</a></p>
953
      <hr />
954
 
955
      <a name="config_album_list"></a>
956
      <h3>4.10.3 Album list view</h3>
957
      <h4>Width of the main table (pixels or %)</h4>
958
      <p>This is the width of tables used on your main page or when you are
959
      viewing thumbnails of an album. You can enter a width in pixels or specify
960
      it in percents. The default value is 100%.</p>
961
      <h4>Number of levels of categories to display</h4>
962
      <p>The default value is 2. With this value the script will display the
963
      current categories plus one level of sub-categories.</p>
964
      <h4>Number of albums to display</h4>
965
      <p>This is the number of albums to display on a page. If the current
966
      category contains more albums, the album list will spread over multiple
967
      pages.</p>
968
      <h4>Number of columns for the album list</h4>
969
      <p>Self explanatory. The default value is 2.</p>
970
      <h4>Size of thumbnails in pixels</h4>
971
      <p>This is the size of the thumbnails that are displayed for each album.
972
      50 means that the thumbnail will fit inside a square of 50x50 pixels.</p>
973
      <p>If the size you specify there is larger than &quot;Pictures and thumbnails
974
      settings/Max width or height of a thumbnail&quot;, the thumbnail will be
975
      stretched.</p>
976
      <a name="changing"></a><h4>The content of the main page</h4>
977
      <p>This option allows you to change the content of the main page displayed
978
      by the script.</p>
979
      <p>The default value is "<b>catlist/alblist/random,2/lastup,2</b>"</p>
980
      <p>You can use the following "codes"</p>
981
      <ul>
982
        <li>'<b>breadcrumb</b>': navigation inside the gallery (e.g. &quot;home &gt; category &gt; subcategory &gt; album&quot;)<br />
983
        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
984
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
985
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
986
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
987
        <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
988
        <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
989
        </li>
990
        <li>'<b>catlist</b>': category list
991
        <li>'<b>alblist</b>': album list
992
        <li>'<b>random</b>': random files (leaving random files &quot;on&quot; for huge galleries with more than 10,000 pics might result in performance problems; switch random &quot;off&quot; in this case)
993
        <li>'<b>lastup</b>': last uploads
994
        <li>'<b>topn</b>': most viewed
995
        <li>'<b>toprated</b>': top rated
996
        <li>'<b>lastcom</b>': last comments </li>
997
        <li>'<b>lasthits</b>': last viewed </li>
998
        <li>'<b>anycontent</b>': inserts php-generated content that has to reside within the file 'anycontent.php' into the index page. Can be used to include banner-rotation scripts or similar.<br />
999
        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1000
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1001
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1002
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1003
        <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1004
        <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
1005
        </li>
1006
        <li>'<b>lastalb</b>': last created albums<br />
1007
        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1008
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1009
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1010
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1011
        <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1012
        <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
1013
        </li>
1014
        </ul>
1015
      <p></p>
1016
      <p>The <b>,2</b> means 2 rows of thumbnails.</p>
1017
 
1018
                        <h4>Show first level album thumbnails in categories</h4>
1019
                        <p>Use this setting to choose between showing or not showing thumbnails from
1020
                        the first album in the categories.</p>
1021
                        <p><a class="back" href="#top">Back to
1022
      top</a></p>
1023
      <hr />
1024
 
1025
      <a name="config_thumbnail_view"></a>
1026
      <h3>4.10.4 Thumbnail view</h3>
1027
      <h4>Number of columns on thumbnail page</h4>
1028
      <p>Default value is 4 this means that each row will show 4 thumbnails.</p>
1029
      <h4>Number of rows on thumbnail page</h4>
1030
      <p>Default value is 3.</p>
1031
      <h4>Maximum number of tabs to display</h4>
1032
      <p>When the thumbnails spread over multiple pages, tabs are displayed at
1033
      the bottom of the page. This value define how many tabs will be
1034
      displayed.</p>
1035
                        <h4>Display file caption (in addition to title) below the thumbnail </h4>
1036
                        <p>Toggles whether the file caption is displayed
1037
                        below each thumbnail while user is in thumbnail view.<br />
1038
                        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1039
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1040
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1041
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1042
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1043
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1044
                        <h4>Display number of views below the thumbnail</h4>
1045
                        <p>Toggles whether the number of views is displayed
1046
                        below each thumbnail while user is in thumbnail view.<br />
1047
                        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1048
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1049
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1050
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1051
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1052
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1053
                        <h4>Display number of comments below the thumbnail</h4>
1054
                        <p>Toggles the display of the number of comments for below each thumbnail.<br />
1055
                        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1056
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1057
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1058
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1059
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1060
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1061
                        <h4>Default sort order for files</h4>
1062
                        <p>This option determines if you wish to have the file caption displayed
1063
                        below each thumbnail while user is in thumbnail view.</p>
1064
      <h4>Minimum number of votes for a file to appear in the 'top-rated'
1065
      list</h4>
1066
                        Used to determine how many votes a file must receive before appearing as
1067
                        &quot;top-rated.&quot;  If a file has received less than &quot;this value&quot;
1068
                        votes, it will not be displayed on the "top-rated" page.</p>
1069
                        <p><a class="back" href="#top">Back to
1070
      top</a></p>
1071
      <hr />
1072
 
1073
      <a name="config_image_comment"></a>
1074
      <h3>4.10.5 Image view &amp; Comment settings</h3>
1075
      <h4>Width of the table for picture display (pixels or %)</h4>
1076
      <p>The width of the table used to display the intermediate picture.</p>
1077
      <h4>File information are visible by default</h4>
1078
      <p>Define whether or not file information (those that appear when you
1079
      click on the (i) button) should be visible by default.</p>
1080
      <h4>Filter bad words in comments</h4>
1081
      <p>Remove "bad words" from comments. The "bad words" list is in the
1082
      language file. So far only the English language file has one.</p>
1083
      <h4>Max length for an image description</h4>
1084
      <p>Maximum number of characters that an image description may contain.</p>
1085
      <h4>Max number of characters in a word</h4>
1086
      <p>This is intended to prevent that someone break the layout of the
1087
      gallery by posting a long comment without space. With the default value,
1088
      words with more than 38 characters are censored.</p>
1089
      <h4>Max number of lines in a comment</h4>
1090
      <p>Prevent a comment for containing too many new line char.</p>
1091
      <h4>Maximum length of a comment</h4>
1092
      <p>Maximum number of characters that a comment may contain.</p>
1093
                        <h4>Show film strip</h4>
1094
                        <p>Toggles display of a "film strip" showing thumbnails of prior
1095
                        and following photos in the album.<br />
1096
                        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1097
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1098
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1099
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1100
                        <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1101
                        <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1102
                        <h4>Number of items in film strip</h4>
1103
                        <p>Set the number of thumbnails to display in film strip.<br />
1104
                        <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1105
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1106
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1107
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1108
                        <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1109
                        <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1110
                        <p><a class="back" href="#top">Back to
1111
      top</a></p>
1112
      <hr />
1113
 
1114
      <a name="config_picture_thumbnail"></a>
1115
      <h3>4.10.6 Picture and thumbnail settings</h3>
1116
      <h4>Quality for JPEG files</h4>
1117
      <p>The quality used for JPEG compression when the script resizes an image.
1118
      Value can range from 0 (worst) to 100 (best). This value can be set to 75
1119
      when using ImageMagick.</p>
1120
                        <h4>Max dimension of a thumbnail</h4>
1121
                        <p>Sets the maximum size in pixels for the specified dimension for thumbnails.
1122
                        <div class="important">When changing this setting, only the files that are added from that point on are affected, so it is advisable that this setting must not be changed if there are already photos in the gallery. You can, however, apply the changes to the existing pictures with the &quot;admin tools (resize pictures)&quot; utility from the admin menu.</div></p>
1123
                        <h4>Use dimension ( width or height or Max aspect for thumbnail )</h4>
1124
                        <p>Sets the dimension for which the maximum pixel size should apply to.
1125
                        <div class="important">When changing this setting, only the files that are added from that point on are affected, so it is advisable that this setting must not be changed if there are already photos in the gallery. You can, however, apply the changes to the existing files with the &quot;resize pictures&quot; utility from the admin menu.</div></p>
1126
      <h4>Create intermediate pictures</h4>
1127
      <p>By default, whenever you upload a file, the script creates a
1128
      thumbnail of the file (file name with a thumb_ prefix) plus an
1129
      intermediate version (file name with a normal_ prefix). If you set this
1130
      option to NO, the intermediate file is not created.</p>
1131
      <h4>Max width or height of an intermediate picture</h4>
1132
      <p>The intermediate pictures are those that appears when you click on a
1133
      thumbnail. The default value is 400, it means that the intermediate
1134
      picture will fit inside a square of 400x400 pixels.</p>
1135
      <h4>Max size for uploaded files (KB)</h4>
1136
      <p>Any file with a file size larger than this value will be rejected by
1137
      the script.</p>
1138
      <h4>Max width or height for uploaded pictures (pixels)</h4>
1139
      <p>Limit the dimensions of the pictures that are uploaded. Resizing large
1140
      pictures requires a lot of memory and consumes CPU.</p>
1141
      <p><a class="back" href="#top">Back to
1142
      top</a></p>
1143
      <hr />
1144
 
1145
      <a name="config_picture_thumb_advanced"></a>
1146
      <h3>4.10.7 Files and thumbnails advanced settings</h3>
1147
                        <h4>Show private album Icon to unlogged user </h4>
1148
                        <p>Toggles the display of the private album icon to unlogged users.<br>Set to 'NO', the album is hidden from unauthorised users.<br>Set to 'YES', the album name, description and statistics are shown, but not the thumbnails or files.</p>
1149
      <h4>Characters forbidden in filenames</h4>
1150
      <p>When the filename of a file that is uploaded contains one of these
1151
      characters, it will be replaced with an underscore.</p>
1152
      <p>Don't change this unless you know exactly what you are doing.</p>
1153
      <h4>Accepted file extensions for uploaded pictures</h4>
1154
      <p>Any file uploaded whose extension is not in this list will be rejected
1155
      by the script. This is intended to prevent a user from uploading non-image
1156
      files.</p>
1157
      <p>The GD library only supports JPEG and PNG images so other types of
1158
      files will be rejected even if their extension is valid.<br />
1159
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1160
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1161
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1162
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1163
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1164
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""></p>
1165
      <h4>Allowed image types</h4>
1166
      <p>&quot;<i>ALL</i>&quot; will result in all allowed image file types that your image library (GD or ImageMagick) is capable of handling to be allowed. If you want to restrict the allowed file types to certain types only, enter a coma-separated list of extensions, e.g. <tt class="code">jpg,bmp,tif</tt>
1167
      <br />
1168
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1169
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1170
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1171
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1172
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1173
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1174
      <h4>Allowed movie types</h4>
1175
      <p>&quot;<i>ALL</i>&quot; will result in all allowed movie file types to be uploaded. If you want to restrict the allowed file types to certain extensions only, enter a coma-separated list of extensions, e.g. <tt class="code">wmv,avi,mov</tt>.<br />
1176
      Note that being able to display a movie requires the cpg-user to have the codecs needed to display the movie installed and configured properly on their computer, e.g. if you allow the file type <tt class="faq">mov</tt>, the user who is going to watch the movie will need to have Apple's Quick-Time plug-in installed. Also note that <tt class="code">avi</tt> is just a container for different codecs - this means that a computer which is capable of playing movie1.avi may not be capable of playing movie2.avi if those files have been encoded with different codecs.
1177
      <br />
1178
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1179
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1180
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1181
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1182
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1183
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1184
      <h4>Allowed audio types</h4>
1185
      <p>&quot;<i>ALL</i>&quot; will result in all allowed audio file types to be uploaded. If you want to restrict the allowed file types to certain extensions only, enter a coma-separated list of extensions, e.g. <tt class="code">wav,mp3,wma</tt>.<br />
1186
      Note that being able to listen to an audio file requires the cpg-user to have the codecs needed installed and configured properly on their computer, e.g. if you allow the file type <tt class="code">mp3</tt>, the user who is going to listen to the file will need to have an mp3-player installed.<br />
1187
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1188
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1189
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1190
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1191
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1192
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1193
      <h4>Allowed document types</h4>
1194
      <p>&quot;<i>ALL</i>&quot; will result in all allowed document file types to be uploaded. If you want to restrict the allowed file types to certain extensions only, enter a coma-separated list of extensions, e.g. <tt class="code">txt,pdf</tt>.<br />
1195
      Note that being able to browse a document file requires the cpg-user to have a software installed and configured properly on their computer that is capable of displaying the document type uploaded, e.g. if you allow the file type <tt class="code">xls</tt>, the user who is going browse the file will need to have an application installed that can display MS-Excel sheets. Be carefull with some document types (especially if you allow users to be capable of uploading documents without admin approval), as they may contain macro viruses.
1196
      <br />
1197
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1198
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1199
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1200
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1201
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1202
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1203
      <h4>Method for resizing images</h4>
1204
      <p>If you are using GD 1.x and the colors of your thumbnails or
1205
      intermediate image are wrong then switch to GD 2.x</p>
1206
      <h4>Path to ImageMagick 'convert' utility (example /usr/bin/X11/)</h4>
1207
      <p>If you are using ImageMagick convert utility to resize you picture, you
1208
      must enter the name of the directory where the convert program is located
1209
      there. Don't forget the trailing "/".</p>
1210
      <p>If your server is running under Windows, use / and not \ to separate
1211
      components of the path (eg. use C:/ImageMagick/ and not C:\ImageMagick\).
1212
      This path must not contain any space so under Windows don't put
1213
      ImageMagick in the "Program files" directory.</p>
1214
      <p><b>ImageMagick will hardly work if PHP on your server is running in
1215
      SAFE mode and it is a real challenge to get it running under Windows.
1216
      Consider using GD in these cases and don't waste your time asking for
1217
      support in the forum. There are too many things that can prevent
1218
      ImageMagick to work correctly and without a physical access to your server
1219
      it is hard to guess what is wrong.</b></p>
1220
      <h4>Allowed image types (only valid for ImageMagick)</h4>
1221
      <p>This is the list of image types that the script will accept when using
1222
      ImageMagick. Image type detection is performed by reading the header of
1223
      the file and not by looking at its file extension.</p>
1224
      <h4>Command line options for ImageMagick</h4>
1225
      <p>Here you can add options that will be appended to the command line when
1226
      executing ImageMagick. Read the ImageMagick Convert manual to see what is
1227
      available.</p>
1228
      <h4>Read EXIF data in JPEG files</h4>
1229
      <p>With this option turned on, the script will read the EXIF data stored
1230
      by digicams in JPEG files. For cpg1.x to cpg1.2.1, this option will work only if PHP was compiled
1231
      with the EXIF extension. Coppermine 1.3.0 (or better) comes with built-in EXIF support even if the webserver itself doesn't have EXIF support, as it uses a <a href="http://www.sanisoft.com/phpexifrw/" class="external">separate EXIF class</a>.<br />
1232
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1233
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1234
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1235
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1236
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_exclam.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1237
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1238
      <h4>Read IPTC data in JPEG files</h4>
1239
      <p>With this option turned on, the script will read the <a href="http://www.iptc.org/" class="external">IPTC</a> data stored
1240
      by digicams in picture files.
1241
      <br />
1242
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1243
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1244
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1245
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1246
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1247
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1248
      <h4>The album directory</h4>
1249
      <p>This is the base directory for your "Image Store". The path is relative
1250
      to the main directory of the script. </p>
1251
      <p>You can use ../ in the path to move-up one level in the directory
1252
      tree.</p>
1253
      <p>You can <b>not</b> use an absolute path there ("/var/my_images/" will not
1254
      work) and the album directory must be visible by your web server.</p>
1255
      <h4>The directory for user files</h4>
1256
      <p>This is the directory where files uploaded with the web interface
1257
      are stored. This directory is a subdirectory of the album directory.</p>
1258
      <p>The same remarks as above apply.</p>
1259
      <p>When you upload files by FTP, store them in a subdirectory of the
1260
      "album directory" and not inside the &quot;directory for user files&quot;. </p>
1261
                        <h4>The prefix for intermediate pictures</h4>
1262
                        <p>This prefix is added to the file name of created pictures.</p>
1263
                        <h4>The prefix for thumbnails</h4>
1264
                        <p>This prefix is added to the file name of created intermediate thumbnails.</p>
1265
      <h4>Default mode for directories</h4>
1266
      <p>If during the installation, the installer complained about directory
1267
      not having the right permissions set this to <b>0777</b> else you won't be
1268
      able to delete the directories created by the script with your FTP client
1269
      the day you will decide to uninstall the script.</p>
1270
      <h4>Default mode for files</h4>
1271
      <p>If during the installation, the installer complained about directories
1272
      not having the right permissions set this to <b>0666</b>.</p>
1273
      <p><a class="back" href="#top">Back to
1274
      top</a></p>
1275
      <hr />
1276
 
1277
      <a name="config_user"></a>
1278
      <h3>4.10.8 User settings</h3>
1279
      <h4>Allow new user registrations</h4>
1280
      <p>Define whether new users can self-register or not.</p>
1281
      <h4>User registration requires email verification</h4>
1282
      <p>If set to YES an email will be sent to the user that will contain a
1283
      code to activate his account. If set to NO, user accounts become
1284
      immediately active.</p>
1285
      <h4>Notify admin of user registration by email</h4>
1286
      <p>If set to YES an email will be sent to the gallery admin when a new user registers.<br />
1287
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1288
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1289
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1290
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1291
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1292
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt="">
1293
      </p>
1294
      <h4>Allow two users to have the same email address</h4>
1295
      <p>Allow or prevent two users from registering with the same email
1296
      address. Recommended setting is NO</p>
1297
      <h4>Users can can have private albums</h4>
1298
      <p>If set to YES then your gallery can contain albums that can be visible
1299
      only by users that belong to a certain group.</p>
1300
      <p>If a user is a member of a group that can have its own gallery and this
1301
      option is turned on then this user will have the permission to hide some
1302
      of their albums to other users.</p>
1303
      <p class="important">Note: if you switch from 'yes' to 'no' any current private albums will become public!</p>
1304
      <h4>Notify admin of user upload awaiting approval</h4>
1305
      <p>When enabled, the gallery admin receives an email notification of all pics that wait for his approval (depends on the approval settings in &quot;<a href="#group_cp">groups</a>&quot;). The email is sent to the address specified in &quot;<a href="#config_general">General settings</a>&quot;.<br />This option is only recommended with low or medium traffic (if users only upload every now and then).<br />
1306
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1307
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1308
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1309
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1310
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1311
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1312
      <h4>Allow logged in users to view memberlist</h4>
1313
      <p>When enabled, an additional menu item &quot;Memberlist&quot; is being displayed in the coppermine main menu if a user is logged in, to let him see a list of all users, with stats on their last visits, uploads and quota usage.<br />This is a new feature in cpg1.3.0 (user contribution by <a href="#contributors">Jason</a>) - it's available as <a href="http://sourceforge.net/project/showfiles.php?group_id=89658&package_id=98542">mod</a> (not in the regular coppermine package) for older versions than cpg1.3.0.<br />
1314
      <img src="pics/cpg10.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1315
      <img src="pics/cpg110.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1316
      <img src="pics/cpg111.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1317
      <img src="pics/cpg120.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1318
      <img src="pics/cpg121.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_no.gif" width="18" height="20" border="0" alt=""><img src="pics/spacer.gif" width="5" height="20" border="0" alt="" />
1319
      <img src="pics/cpg13x.gif" width="23" height="20" border="0" alt=""><img src="pics/cpg_ok.gif" width="18" height="20" border="0" alt=""></p>
1320
      <p><a class="back" href="#top">Back to
1321
      top</a></p>
1322
      <hr />
1323
 
1324
      <a name="config_custom"></a>
1325
      <h3>4.10.9 Custom fields for image description (leave blank if unused)</h3>
1326
      <p>These fields are displayed within the &quot;file information&quot; area. They
1327
      will appear only if you give them a name.</p>
1328
      <p><a class="back" href="#top">Back to
1329
      top</a></p>
1330
      <hr />
1331
 
1332
      <a name="config_cookie"></a>
1333
      <h3>4.10.10 Cookie settings</h3>
1334
      <h4>Name of the cookie used by the script</h4>
1335
      <p>Default value is "cpg130". Even if you have multiple instances of the
1336
      script running on the same server you can keep the default value.<br /><span class="important">When using bbs integration, make sure it <b>differs</b> from the bbs's cookie name</span></p>
1337
      <h4>Path of the cookie used by the script</h4>
1338
      <p>Default value is "/". Don't change this unless you know what you are
1339
      doing. This may prevent you from logging in.</p>
1340
      <p>If you have broken your gallery by modifying this value, use phpMyAdmin
1341
      to edit the xxxx_config table in your database and restore the default
1342
      value. </p>
1343
      <p>When using bbs integration into Coppermine, make sure to use <b>different</b> cookie names for coppermine and your bbs!</p>
1344
      <p><a class="back" href="#top">Back to
1345
      top</a></p>
1346
      <hr />
1347
 
1348
      <a name="config_misc"></a>
1349
      <h3>4.10.11 Miscellaneous settings</h3>
1350
      <a name="debug_mode"></a><h4>Enable debug mode</h4>
1351
      <p>CPG will show error messages which are normally suppressed.  This is
1352
      helpful in troubleshooting problems with your gallery or when asking
1353
      for help on the <a href="http://coppermine.sourceforge.net/board/">
1354
      CPG Support Forums</a>. Turn this feature off if you don't experience problems.<br />
1355
      Turn it on (option &quot;Everyone&quot;) if you are requesting help on the <a href="http://coppermine.sourceforge.net/board/">coppermine support board</a>, so the supporters can have a look at the debug output as well. Choose the option &quot;Admin only&quot; when trouble-shooting on your own - debug output will be only visible when you're logged in as admin, regular users or guests won't see the debug output.</p>
1356
      <h4>Display notices in debug mode</h4>
1357
      <p>May be helpfull to trouble-shoot problems with your coppermine install - only recommended if you know a little PHP and you can understand the additional error messages this option shows. This option only applies if debug mode is enabled.</p>
1358
      <p><a class="back" href="#top">Back to
1359
top</a></p>
1360
      <hr />
1361
 
1362
<a name="integrating"></a>
1363
<h1>5. Integrating the script with your bulletin board</h1>
1364
<a name="integrating_bridge_start"></a>
1365
<h2>5.1 Available bridge files</h2>
1366
<p>Coppermine can be integrated with the following bulletin boards (eg. Coppermine
1367
  and your bulletin board will share the same user database).</p>
1368
<ul>
1369
  <li>phpBB 2</li>
1370
  <li>Invision Power Board</li>
1371
  <li>vBulletin</li>
1372
  <li>YaBB SE</li>
1373
  <li>Woltlab Burning Board 2.1</li>
1374
  <li>SMF</li>
1375
  <li>PunBB 1.1.5</li>
1376
</ul>
1377
<a name="integrating_bridge_end"></a>
1378
 
1379
<a name="integrating_prerequisites_start"></a>
1380
<h2>5.2 Pre-requistes</h2>
1381
 
1382
<a name="integrating_cookie_start"></a>
1383
<h3>5.2.1 Authentification by cookie</h3>
1384
<p>The login integration uses your bulletin board cookies, therefore it won't work if your board cookies are not visible by Coppermine. So unless you are an expert, keep things simple and install Coppermine and your bulletin board on the same domain. Examples :</p>
1385
<table border="0" cellspacing="5" cellpadding="5" class="border1">
1386
<tr>
1387
<td>This <b>will</b> work:</td>
1388
<td>This <b class="important">won't</b> work:</td>
1389
</tr>
1390
<tr>
1391
<td class="code">Bulletin board: http://yourdomain.com/board/<br />
1392
Coppermine: http://yourdomain.com/gallery/</td>
1393
<td class="code">Bulletin board: http://board.yourdomain.com/<br />
1394
Coppermine: http://gallery.yourdomain.com/</td>
1395
</tr>
1396
</table>
1397
<p><span class="important">Important</span>: the cookie names of your bbs and coppermine must <b>not</b> be the same - they <b>must</b> differ!</p>
1398
<a name="integrating_cookie_end"></a>
1399
 
1400
<a name="integrating_standalone_start"></a>
1401
<h3>5.2.2 Standalone version first</h3>
1402
<p>To avoid confusion, make sure to set up both coppermine and your bbs as standalone first. Make sure they both run correctly without integration. Test all features of coppermine (like upload, registration etc.) when Coppermine is installed, before you even start integration.</p>
1403
<a name="integrating_standalone_end"></a>
1404
 
1405
<a name="integrating_users_start"></a>
1406
<h3>5.2.3 Coppermine users, groups and pics uploaded by users are lost when integrating</h3>
1407
<p><span class="important">Warning:</span> If you already have users and custom groups in your coppermine database when you enable bbs integration, be aware that they will be lost. If your coppermine users have already created private albums and uploaded pics to them, they will be lost as well!</p>
1408
<a name="integrating_users_end"></a>
1409
 
1410
<a name="integrating_backup_start"></a>
1411
<h3>5.2.4 Backup</h3>
1412
<p><span class="important">Backup</span>: it is very advisable to backup both your coppermine database before enabling bbs integration, so you can savely go back if the integration fails.</p>
1413
<p>In fact you're encouraged to backup your database on a regular base, and especially before applying code changes.</p>
1414
<a name="integrating_backup_end"></a>
1415
 
1416
<a name="integrating_database_start"></a>
1417
<h3>5.2.5 Keep Coppermine and bbs tables in the same database</h3>
1418
<p>It is recommended that you use the same database for your board and Coppermine (in fact it is even mandatory!).</p>
1419
<a name="integrating_database_end"></a>
1420
 
1421
<a name="integrating_prerequisites_end"></a>
1422
 
1423
<a name="integrating_steps_start"></a>
1424
<h2>5.3 Integration steps</h2>
1425
 
1426
<a name="integrating_steps_settings_start"></a>
1427
<h3>5.3.1 Check your bbs settings</h3>
1428
<p>You will also need to perform the following operations after having unpacked the archive on your harddrive and before uploading the files to your webserver:</p>
1429
<ul>
1430
<li>If you are using <b>phpBB</b> 2, go to the admin control panel and check that &quot;Cookie domain&quot; corresponds to your domain, &quot;Cookie name&quot; is &quot;phpbb2mysql&quot; and &quot;Cookie path&quot; is &quot;/&quot;.</li>
1431
<li>If you are using <b>Invision Power Board</b>, go to the &quot;admin control panel / board settings / cookies&quot; and check that all fields are blank. If they are not, you modified the default values and you are an expert.</li>
1432
<li>If you are using <b>vBulletin</b>, go to the &quot;admin control panel / vBulletin options / HTTP Headers and output&quot; and check that the value for &quot;Cookie Domain&quot; corresponds to your domain and that &quot;Path to save cookies&quot; is &quot;/&quot;</li>
1433
</ul>
1434
<a name="integrating_steps_settings_end"></a>
1435
 
1436
<a name="integrating_steps_bridge_start"></a>
1437
<h3>5.3.2 Edit your bridge file</h3>
1438
<p>Go to the <i>bridge</i> directory and open the file that corresponds to the bulletin board you use (eg. <i>phpbb.inc.php</i> if you use phpBB) with a text editor.</p>
1439
<p>At the beginning of the file there are a number a configuration values that need to be set. For phpBB as an example they are the following :</p>
1440
<pre>// database configuration
1441
define('PHPBB_DB_NAME','phpBB');     // The name of the database used by the board
1442
define('PHPBB_BD_HOST','localhost'); // The name of the database server
1443
define('PHPBB_DB_USERNAME','root');  // The username to use to connect to the    database
1444
define('PHPBB_DB_PASSWORD','');      // The password to use to connect to the database
1445
 
1446
// The web path to your phpBB directory
1447
// If your URL to your board is for example 'http://yoursite_name.com/phpBB2/',
1448
// you'll have to set the below var to '/phpBB2/'.
1449
define('PHPBB_WEB_PATH', '/phpBB2/');
1450
// Logout Flag
1451
// the value of this boolean constant depends on your phpBB version:
1452
// If your version of phpBB is 2.0.4 or lower - change the value to FALSE;
1453
// if your version of phpBB is 2.0.5 or newer - leave it as TRUE
1454
define('PHPBB_LOGOUT_GET', TRUE);</pre>
1455
<p>Modify them according to the configuration of your board and save the file.</p>
1456
<a name="integrating_steps_bridge_end"></a>
1457
 
1458
<a name="integrating_steps_init_start"></a>
1459
<h3>5.3.3 Enable bbs integration</h3>
1460
<p>Edit the file <i>include/init.inc.php</i>. At the beginning of the file you will find the following lines :</p>
1461
<pre>// User database integration
1462
// Uncomment the applicable line if you want to use it
1463
// define('UDB_INTEGRATION', 'phpbb');
1464
// define('UDB_INTEGRATION', 'invisionboard');
1465
// define('UDB_INTEGRATION', 'vbulletin23');
1466
// define('UDB_INTEGRATION', 'vbulletin30');
1467
// define('UDB_INTEGRATION', 'yabbse');
1468
// define('UDB_INTEGRATION', 'smf');
1469
// define('UDB_INTEGRATION', 'woltlab21');
1470
// define('UDB_INTEGRATION', 'punbb');</pre>
1471
<p>Un-comment the line that corresponds to the bulletin board you use (eg. remove the &quot;//&quot; that are at the beginning of the line)</p>
1472
<pre>define('UDB_INTEGRATION', 'phpbb');</pre>
1473
<a name="integrating_steps_init_end"></a>
1474
 
1475
<a name="integrating_steps_special_start"></a>
1476
<h3>5.3.4 Special steps depending on the bbs you use</h3>
1477
<p><span class="important">Important</span>: if you use phpBB or PunBB, you'll have to do this additional steps</p>
1478
 
1479
<a name="integrating_steps_special_phpbb_start"></a>
1480
<h4>5.3.4.1 For phpBB only</h4>
1481
<p>Create a new file named <b>cpg_redir.php</b> in your <b>phpBB directory</b>, and paste the following code into the file:</p>
1482
<pre>&lt;?php
1483
if (!$_SERVER['HTTP_HOST']) {
1484
  $cpg_host=$HTTP_SERVER_VARS['HTTP_HOST'];
1485
} else {
1486
  $cpg_host=$_SERVER['HTTP_HOST'];
1487
}
1488
$cpg_path='/gallery';
1489
header("Location: http://".$cpg_host.$cpg_path);
1490
exit;
1491
?&gt;</pre>
1492
<p><span class="important">Important</span> - before you save the file, you must ensure that:</p>
1493
<ul>
1494
<li><b>$cpg_path</b> - contains the the path in which Coppermine is installed </li>
1495
<li><b>$cpg_host</b> - contains the domain pointer to Coppermine. If Coppermine and phpBB are installed on the same server and domain (the &quot;normal&quot; case), you should leave the default value. Otherwise you should provide a string constant which contains the domain where Coppermine is installed (for example: '<i>www.my-other-domain.com</i>').</li>
1496
<li>If you change both variables make sure that either $cpg_host contains a trailing slash or $cpg_path contains a leading slash. In other words, the concatenation of the two variables must result in a correct path such as <i>www.my-other-domain.com<span class="important">/</span>my_gallery_dir</i></li>
1497
</ul>
1498
<a name="integrating_steps_special_phpbb_end"></a>
1499
 
1500
<a name="integrating_steps_special_punbb_start"></a>
1501
<h4>5.3.4.2 For PunBB only</h4>
1502
<p>Create a new file named <b>redir.php</b> in your <b>PunBB directory</b>, and paste the following code into the file:</p>
1503
<pre>&lt;?php
1504
 
1505
/// Set URL of coppermine to return to after login
1506
$cpg_url = 'http://www.yousite.com/coppermine';
1507
 
1508
if (isset($_POST['redir'])){
1509
        echo '&lt;html&gt;
1510
                  &lt;body onload="document.redir.submit();"&gt;
1511
                      &lt;form name="redir" method="post" action="'.$_POST['redir'].'"&gt;
1512
                      &lt;/form&gt;
1513
                  &lt;/body&gt;
1514
              &lt;/html&gt;';
1515
} else {
1516
        header("Location: $cpg_url");
1517
}
1518
?&gt;</pre>
1519
<span class="important">Important</span> - before you save the file, you must ensure that:
1520
<ul>
1521
<li><b>$cpg_url</b> - contains the the path in which Coppermine is installed </li>
1522
</ul>
1523
<a name="integrating_steps_special_punbb_end"></a>
1524
<a name="integrating_steps_special_end"></a>
1525
 
1526
<a name="integrating_steps_upload_start"></a>
1527
<h3>5.3.5 Upload the modified files</h3>
1528
<p>Upload all modified files (the file in the &quot;bridge&quot; folder that corresponds to your bbs and the file <i>include/init.inc.php</i>, plus the redirector files your created in step &quot;Special steps for depending on the bbs you use&quot; if you're using one of the mentioned bbs) onto your webserver. Visit your coppermine gallery in your browser. To login as an admin, you will need to use the admin username and password of your board.</p>
1529
<a name="integrating_steps_upload_end"></a>
1530
 
1531
<a name="integrating_steps_sync_start"></a>
1532
<h3>5.3.6 Synchronsising the bbs groups with Coppermine's groups</h3>
1533
<p>Login using the admin account of your board. Go to the gallery, enter admin mode and click on the &quot;Groups&quot; button. This will synchronize Coppermine groups with those of your board. The permission you will see for each group will be completely messy, so take some time to set them properly.</p>
1534
<p>Each time you add or delete a group in your board you will need to do the operation above in order to keep the synchronisation of the groups.</p>
1535
<p>When you will try to login / logout or manage users from Coppermine, you will be redirected to the corresponding page of your bulletin board. Once the login or logout is performed you won't be redirected automatically to the gallery because your board does not have any function for that. It's up to you to add a link on your board to get you back to the gallery.</p>
1536
<a name="integrating_steps_sync_end"></a>
1537
<a name="integrating_steps_end"></a>
1538
<a name="integrating_end"></a>
1539
<p><a class="back" href="#top">Back to top</a></p><hr />
1540
 
1541
<a name="translating"></a>
1542
<h1>6. Translating Coppermine into other languages</h1>
1543
<p>Coppermine has a separate language file that make the translation of the
1544
  script much more easy. The language files are stored in the <b>lang </b>directory.
1545
  The files with the <b>utf-8</b> suffix are unicode encoded files. They are automatically
1546
  generated with the <b>iconv</b> program so there is no need for you to make
1547
  an unicode version of your translation.</p>
1548
<p>If you select an utf-8 language file as the default one, then the script will
1549
  be able to automatically select a language file based on the visitor browser
1550
  configuration. For instance if the default language file is danish-utf-8 and
1551
  an english visitor access your gallery, the english-utf-8 language file will
1552
  be used by the script.</p>
1553
<p> If you have translated Coppermine into a language not already supported, please read the <a href="translation.htm">translator's guide</a> and visit the <a href="http://coppermine.sourceforge.net/board/index.php?topic=4623.0">Coppermine Web Site</a> at Sourceforge and follow the instructions for submitting your language.</p>
1554
<p></p>
1555
<p><a class="back" href="#top">Back to top</a></p>
1556
<hr />
1557
 
1558
<a name="known_issues"></a>
1559
<h1>7. Known Issues</h1>
1560
<p>The following slight quirks and tiny issues are known and will be fixed in future releases.</p>
1561
<ul>
1562
        <li>Some small text items are only available in English, e.g picEditor. (Language issue)</li>
1563
        <li>Various error messages (especially notices) while in debug mode with notices display turned on. (Does not affect main CPG app)</li>
1564
        <li>Documentation (this document) and FAQ still incomplete.</li>
1565
        <li>User upload settings breaks table-width display in groups manager. This feature has been added recently before the release of cpg1.3.0; the broken layout will be fixed in the next version.</li>
1566
        <li>&quot;Download favorites as zip&quot; only works if the zlib library is installed on the server</li>
1567
        <li>The <a href="http://coppermine.sourceforge.net/board/index.php?topic=1866.0">arrows used for navigation</a> from one pic to the other display in the wrong order for rtl-languages</li>
1568
        <li>There is a bar that appears underneath the menus and above the album title on the category and thumbnail page that shouldn't be there in the theme &quot;Mac OX X&quot;</li>
1569
        <li>On pages with high traffic load the &quot;top rated&quot; pic might get outdated while the user watches the page, resulting in the thumbnail linking to a different pic.</li>
1570
        <li>minor issue with the filmstrip not displaying correctly when the number of pics to appear on the filmstrip is set to an even number</li>
1571
        <li>Crop and rotate not working on all server setups.</li>
1572
                <li>ISO settings missing from exif data in most languages.</li>
1573
</ul>
1574
<p><a class="back" href="#top">Back to top</a></p>
1575
<hr />
1576
 
1577
<a name="credits"></a>
1578
<h1>8. Credits</h1>
1579
<a name="developers"></a>
1580
<h2>8.1 Coppermine team</h2>
1581
<table border="0" cellspacing="6" cellpadding="4">
1582
<tr>
1583
        <td><b>Developer</b></td>
1584
        <td><b>Username</b></td>
1585
        <td><b>Role/Position</b></td>
1586
        <td><b>Status</b></td>
1587
</tr>
1588
<tr>
1589
        <td>Aditya Mooley</td>
1590
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=5957">Aditya</a></td>
1591
        <td>Developer</td>
1592
        <td>active</td>
1593
</tr>
1594
<tr>
1595
        <td>Clive Leech</td>
1596
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=56">casper</a></td>
1597
        <td>Supporter</td>
1598
        <td>active</td>
1599
</tr>
1600
<tr>
1601
        <td>Maarten Hagoort</td>
1602
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=404">DJ Maze</a></td>
1603
        <td>Developer (nuke team)</td>
1604
        <td>active</td>
1605
</tr>
1606
<tr>
1607
        <td>Eyal Zvi</td>
1608
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=94">EZ</a></td>
1609
        <td>Developer</td>
1610
        <td>active</td>
1611
</tr>
1612
<tr>
1613
        <td>Joachim M&uuml;ller</td>
1614
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=2">gaugau</a></td>
1615
        <td>Project Manager</td>
1616
        <td>active</td>
1617
</tr>
1618
<tr>
1619
        <td>Scott Gahres</td>
1620
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=66">gtroll</a></td>
1621
        <td>Developer (nuke team project manager)</td>
1622
        <td>active</td>
1623
</tr>
1624
<tr>
1625
        <td>Jack</td>
1626
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=6">datajack</a></td>
1627
        <td>Developer</td>
1628
        <td>active</td>
1629
</tr>
1630
<tr>
1631
        <td>Dave Kazebeer</td>
1632
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=7">kegobeer</a></td>
1633
        <td>Support Technician</td>
1634
        <td>active</td>
1635
</tr>
1636
<tr>
1637
        <td>Tommy</td>
1638
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=941">Nibbler</a></td>
1639
        <td>Supporter</td>
1640
        <td>active</td>
1641
</tr>
1642
<tr>
1643
        <td>Jay Hao-En Liu</td>
1644
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=59">Oasis</a></td>
1645
        <td>Developer</td>
1646
        <td>active</td>
1647
</tr>
1648
<tr>
1649
        <td>Christopher Brown-Floyd</td>
1650
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=1874">omniscientdeveloper</a></td>
1651
        <td>Developer</td>
1652
        <td>active</td>
1653
</tr>
1654
<tr>
1655
        <td>Timothy</td>
1656
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=6949">skybax</a></td>
1657
        <td>Developer</td>
1658
        <td>active</td>
1659
</tr>
1660
<tr>
1661
        <td>Dr Tarique Sani</td>
1662
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=4">tarique</a></td>
1663
        <td>Lead Developer</td>
1664
        <td>active</td>
1665
</tr>
1666
<tr>
1667
        <td>DJ Axion</td>
1668
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=9">djaxion</a></td>
1669
        <td>Developer</td>
1670
        <td>retired</td>
1671
</tr>
1672
<tr>
1673
        <td>Gr&eacute;gory Demar</td>
1674
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=259">Greg</a></td>
1675
        <td>Developer, Original creator of Coppermine</td>
1676
        <td>retired</td>
1677
</tr>
1678
<tr>
1679
        <td>Hyperion</td>
1680
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=125">hyperion01</a></td>
1681
        <td>Developer</td>
1682
        <td>retired</td>
1683
</tr>
1684
<tr>
1685
        <td>John Asendorf</td>
1686
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=30">jasendorf</a></td>
1687
        <td>Developer</td>
1688
        <td>pending</td>
1689
</tr>
1690
<tr>
1691
        <td>mitirapa</td>
1692
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=133">mitirapa</a></td>
1693
        <td>Porter (Cross Platform Devel.)</td>
1694
        <td>retired</td>
1695
</tr>
1696
<tr>
1697
        <td>Moorey</td>
1698
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=13">moorey</a></td>
1699
        <td>Web Designer</td>
1700
        <td>pending</td>
1701
</tr>
1702
<tr>
1703
        <td>David Holm</td>
1704
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=14">wormie_dk</a></td>
1705
        <td>Developer</td>
1706
        <td>pending</td>
1707
</tr>
1708
<tr>
1709
        <td>Mark Zerr</td>
1710
        <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=11">zarsky99</a></td>
1711
        <td>Tester</td>
1712
        <td>retired</td>
1713
</tr>
1714
</table>
1715
<p><a class="back" href="#top">Back to top</a></p>
1716
<hr />
1717
 
1718
<a name="contributors"></a>
1719
<h2>8.2 Contributors</h2>
1720
<table border="0" cellspacing="6" cellpadding="4">
1721
<tr>
1722
  <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=101">DaMysterious</a></td>
1723
  <td>DaMysterious has created loads of fantastic themes for Coppermine</td>
1724
</tr>
1725
<tr>
1726
  <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=1399">Nanobot</a></td>
1727
  <td>Doug has done the vBulletin v3 bridge file</td>
1728
</tr>
1729
<tr>
1730
  <td><a href="http://www.sanisoft.com/aboutus.php3">Girish Nair</a></td>
1731
  <td>Girish has contributed to the film strip feature</td>
1732
</tr>
1733
<tr>
1734
  <td><a href="http://coppermine.sourceforge.net/board/index.php?action=profile;u=378">Jason Kawaja</a></td>
1735
  <td>Jason did the <a href="http://coppermine.sourceforge.net/board/index.php?topic=1985.0">memberlist hack</a></td>
1736
</tr>
1737
</table>
1738
<p><a class="back" href="#top">Back to top</a></p>
1739
<hr />
1740
 
1741
<a name="codebase"></a>
1742
<h2>8.3 Coppermine uses code from the following free softwares :</h2>
1743
<p><b>phpBB</b><br />
1744
  Author: phpBBGroup <br />
1745
  URL: <a href="http://www.phpbb.com/">http://www.phpbb.com/</a><br />
1746
</p>
1747
<p><b>phpMyAdmin</b><br />
1748
  Author: phpMyAdmin devel team<br />
1749
  URL: <a href="http://www.phpmyadmin.net/">http://www.phpmyadmin.net/</a><br />
1750
</p>
1751
<p><b>phpPhotoAlbum</b><br />
1752
  Author: Henning St&oslash;verud<br />
1753
  E-mail: henning AT stoverud DOT com<br />
1754
  URL: <a href="http://www.stoverud.com/PHPhotoalbum/">http://www.stoverud.com/PHPhotoalbum/</a><br />
1755
</p>
1756
<p><b>DOM Tooltip 0.6.0</b><br />
1757
  Author: Dan Allen<br />
1758
  E-mail: dan AT mojavelinux DOT com<br />
1759
  URL: <a href="http://www.mojavelinux.com/forum/viewtopic.php?t=127">http://www.mojavelinux.com/forum/viewtopic.php?t=127</a><br />
1760
  Note: DOM Tooltip, which is being used with the theme &quot;styleguide&quot; only, is released under <a href="http://www.gnu.org/copyleft/lesser.html">LGPL</a><br />
1761
</p>
1762
<p><b>TAR/GZIP/ZIP Archive Classes</b><br />
1763
  Author: Devin Doucette<br />
1764
  E-mail: darksnoopy AT shaw DOT ca<br />
1765
</p>
1766
<p><b>phpExifRW</b><br />
1767
  Author: Vinay Yadav (vinayRas)<br />
1768
  E-mail: vinay AT sanisoft DOT com<br />
1769
  URL: <a href="http://www.sanisoft.com/phpexifrw/">http://www.sanisoft.com/phpexifrw</a><br />
1770
  Note: phpExifRW is a pure PHP class to read, write and transfer EXIF information  that most of the digital camera produces. It is released under <a href="http://www.gnu.org/copyleft/lesser.html">LGPL</a><br />
1771
</p>
1772
<p><b>Codelifter Slideshow</b><br />
1773
  URL: <a href="http://www.codelifter.com/">http://www.codelifter.com</a><br />
1774
</p>
1775
<p><a class="back" href="#top">Back to top</a></p>
1776
<hr />
1777
 
1778
<a name="copyright"></a>
1779
<h2>8.4 Copyright and disclaimer</h2>
1780
<p>This application is opensource software released under the <a href="http://www.gnu.org/copyleft/gpl.html">GPL</a>.
1781
</p>
1782
<p>Because the program is licensed free of charge, there is no warranty
1783
  for the program, to the extent permitted by applicable law. Except when
1784
  otherwise stated in writing the copyright holders and/or other parties
1785
  provide the program &quot;as is&quot; without warranty of any kind, either expressed
1786
  or implied, including, but not limited to, the implied warranties of
1787
  merchantability and fitness for a particular purpose. The entire risk as
1788
  to the quality and performance of the program is with you. Should the
1789
  program prove defective, you assume the cost of all necessary servicing,
1790
  repair or correction. </p>
1791
<p>Coppermine Photo Gallery is Copyright &copy; 2002 - 2004 <a href="http://www.chezgreg.net/coppermine/">Gr&eacute;gory
1792
  DEMAR</a> and the Coppermine Dev Team, All Rights Reserved.<br />
1793
</p>
1794
<p><a class="back" href="#top">Back to top</a></p>
1795
<hr />
1796
 
1797
 
1798
                        </td></tr></tbody></table>
1799
</body>
1800
</html>