aboutsummaryrefslogtreecommitdiffstats
path: root/language/en_UK/help.html
blob: 98e5d31a5a1a197960b025985ecf49041259a084 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
<div class="instructions">
<h2>Help</h2>

<div id="instructionPLoader" class="instructionBlock">
  <div
    id="pLoader_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
  >
    Add photos, the pLoader way
  </div>
  <div
    id="pLoader_content"
    class="instructionBlockContent"
    style="display:none"
  >
    <ol>
      <li>Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.</li>
      <li>Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.</li>
      <li>Drag'n drop photos from your directory browser into pLoader photo selection.</li>
      <li>Create a category and select it.</li>
      <li>Select some photos.</li>
      <li>Click on the green arrow to transfer photos in your gallery</li>
    </ol>
Congratulations! You have successfuly created the first category of your photo gallery.
  </div> <!-- pLoader_content -->
</div> <!-- instructionPLoader -->

<div id="instructionFTP" class="instructionBlock">
  <div
    id="FTP_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('FTP_header', 'FTP_content')"
  >
    Add photos, the FTP way
  </div>
  <div
    id="FTP_content"
    class="instructionBlockContent"
    style="display:none"
  >

<h3>Quick Start</h3>

<ol>
  <li>Create a directory on your computer.</li>  

  <li>Copy some photos inside this directory, resize them for web display. <em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.</li>

  <li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>

  <li>Logon your gallery and go to <span class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> to create missing thumbnails.</li>

  <li>Go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
</ol>

Congratulations! You have successfuly created the first category of your photo gallery.

<h3>Directories and files organization</h3>
<ul>

  <li>

    <p>Category directories are in the Piwigo directory
    "galleries". Here follows the directory tree of a very small gallery (but
    using many features) :</p>

    <pre>
.
|-- admin
|-- doc
|-- galleries
|   |-- category-1
|   |   |-- category-1.1
|   |   |   |-- category-1.1.1
|   |   |   |   |-- category-1.1.1.1
|   |   |   |   |   |-- pwg_high
|   |   |   |   |   |   +-- wedding.jpg
|   |   |   |   |   |-- thumbnail
|   |   |   |   |   |   +-- TN-wedding.jpg
|   |   |   |   |   +-- wedding.jpg
|   |   |   |   +-- category-1.1.1.2
|   |   |   +-- category-1.1.2
|   |   |-- category-1.2
|   |   |   |-- pookie.jpg
|   |   |   +-- thumbnail
|   |   |       +-- TN-pookie.jpg
|   |   +-- category-1.3
|   +-- category-2
|       |-- piglet.gif
|       |-- pwg_representative
|       |   +-- video.jpg
|       |-- thumbnail
|       |   +-- TN-piglet.jpg
|       +-- video.avi
|-- include
|-- install
|-- language
|-- template
+-- tool</pre>

  </li>
  
  <li>Each directory under "galleries" produces a category. There is no limit on deepness.</li>

  <li>Basically, an element is represented by a file. A file can be a
  Piwigo element if its extenstion is among <code>file_ext</code>
  configuration parameter possibilities (see <span
  class="filename">include/config_default.inc.php</span> file). A file can
  be a picture if its extension is among <code>picture_ext</code>
  configuration parameter possibilities.</li>

  <li>Picture elements must have an associated thumbnail (see section below
  about thumbnails)</li>

  <li>Picture elements can have a high quality file associated. As for
  wedding.jpg in the example above. No prefix on the high quality picture.</li>

  <li>Non picture elements (video, sounds, file texts, what you want...) are
  by default represented by an icon corresponding to the filename
  extension. Optionaly, you can associate a thumbnail and a representative
  file (see video.avi in the example above).</li>

  <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.</li>

  <li>Once files, thumbnails and representatives are correctly placed in the
  directories, go to : <span class="pwgScreen">Administration &raquo; Categories &raquo;
  Synchronize</span></li>

</ul>

<h3>Thumbnails</h3>
<ul>

  <li>Each photo must have its thumbnail.</li>

  <li>Thumbnails are stored in the sub-directory "thumbnail" of the category
  directory. The thumbnail has the same filename as the corresponding photo, with <em>TN-</em> as prefix.</li>

  <li><em>Advise</em>: use an external module for thumbnails creation.</li>

  <li>Even if it is not recommended (image quality, web server resource load), you can use <span
  class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> page to create thumbnails.</li>

  <li>Give write access on all category directories.</li>

</ul>

  </div> <!-- FTP_content -->
</div> <!-- instructionFTP -->

<div id="instructionPermissions" class="instructionBlock">
  <div
    id="permissions_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('permissions_header', 'permissions_content')"
  >
    Permissions
  </div>
  <div
    id="permissions_content"
    class="instructionBlockContent"
    style="display:none"
  >
<ul>

  <li>You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.</li>

  <li>You can set a category to private by editing a single category (<span
  class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span>) or by
  setting options to your whole category tree (<span
  class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Public / Private</span>).</li>

  <li>

    <p>Once the category is private, you can manage permissions for groups
    and users with 3 screens:</p>

    <ul>

      <li><span class="pwgScreen">Administration &raquo; Identification &raquo; Users &raquo;
      permissions action</span> (one link per user)</li>

      <li><span class="pwgScreen">Administration &raquo; Identification &raquo; Groups &raquo;
      permissions action</span> (one link per group)</li>

      <li><span class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit
      category permissions action</span> (one link per category)</li>

    </ul>

  </li>

</ul>
  </div> <!-- permissions_content --> 
</div> <!-- instructionPermissions -->

<div id="instructionGroups" class="instructionBlock">
  <div
    id="groups_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('groups_header', 'groups_content')"
  >
    Groups
  </div>
  <div
    id="groups_content"
    class="instructionBlockContent"
    style="display:none"
  >
<ul>

  <li>Groups is a convenient way to set permissions for a list of users.</li>

  <li>Create groups in <span class="pwgScreen">Administration &raquo;
  Identification &raquo; Groups</span> and associate users to this group in <span
  class="pwgScreen">Administration &raquo; Identication &raquo; Users</span>.</li>

  <li>A user can belong to several groups. Authorization is stronger
  than forbiddance : if user "jack" belongs to groups "family" and
  "friends", and that only group "family" can see category "Christmas 2003" category then
  "jack" will be able to see "Christmas 2003".</li>

</ul>
  </div> <!-- groups_content --> 
</div> <!-- instructionGroups -->

<div id="instructionUpload" class="instructionBlock">
  <div
    id="upload_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('upload_header', 'upload_content')"
  >
    Upload by users
  </div>
  <div
    id="upload_content"
    class="instructionBlockContent"
    style="display:none"
  >
<p>Users can upload their photos too.</p>

<ol>

  <li>Authorize upload on any physical categories (<span
  class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span> or <span
  class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Upload</span>). Virtual categories can't receive any upload.</li>

  <li>Give write access on corresponding directories.</li>

</ol>

<p>Photos uploaded by users are not directly visible on the website. An administrator
must validate uploaded photos in <span class="pwgScreen">Administration &raquo; Pictures &raquo; Waiting</span>.</p>
  </div> <!-- upload_content --> 
</div> <!-- instructionUpload -->

<div id="instructionCategoryLinks" class="instructionBlock">
  <div
    id="categoryLinks_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('categoryLinks_header', 'categoryLinks_content')"
  >
    Links between elements and categories, virtual categories
  </div>
  <div
    id="categoryLinks_content"
    class="instructionBlockContent"
    style="display:none"
  >
<ul>

  <li>Photos are displayed in the category corresponding to the file directory.</li>

  <li>You can also display a picture in several categories, without duplicating the file on your web server. Associate the photo to any category from the photo editing screen (that any administrator can reach from the photo page on the gallery side).</li>

  <li>Virtual categories are based on this concept: they have no corresponding directory. Create virtual categories from <span class="pwgScreen">Administration &raquo; Categories &raquo; Manage</span>.</li>

</ul>
  </div> <!-- categoryLinks_content --> 
</div> <!-- instructionCategoryLinks -->

<div id="instructionMisc" class="instructionBlock">
  <div
    id="misc_header"
    class="instructionBlockHeaderCollapsed"
    onclick="blockToggleDisplay('misc_header', 'misc_content')"
  >
    Miscellanous informations
  </div>
  <div
    id="misc_content"
    class="instructionBlockContent"
    style="display:none"
  >
<ul>

  <li>As soon as you created your gallery, modify default display properties
  in <span class="pwgScreen">Administration &raquo; Configuration &raquo;
  Default</span>. Every new registered user will use these default configuration settings.</li>

  <li>If you have any question, Piwigo community will welcome you on <a
  href="http://forum.phpwebgallery.net">its forum</a>.</li>

</ul>
  </div> <!-- misc_content --> 
</div> <!-- instructionMisc -->

</div>