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
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
|
<div class="instructions">
<h2>Aiuto</h2>
<div id="instructionPLoader" class="instructionBlock">
<div
id="pLoader_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
><span>
<!--TODO-->Add photos, the pLoader way
</span></div>
<div
id="pLoader_content"
class="instructionBlockContent"
style="display:none"
>
<ol>
<!--TODO--><li>Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.</li>
<!--TODO--><li>Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.</li>
<!--TODO--><li>Drag'n drop photos from your directory browser into pLoader photo selection.</li>
<!--TODO--><li>Create a category and select it.</li>
<!--TODO--><li>Select some photos.</li>
<!--TODO--><li>Click on the green arrow to transfer photos in your gallery</li>
</ol>
<!--TODO-->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')"
><span>
<!--TODO-->Add photos, the FTP way
</span></div>
<div
id="FTP_content"
class="instructionBlockContent"
style="display:none"
>
<h3>Presa in mano rapida</h3>
<ol>
<!--TODO--><li>Create a directory on your computer.</li>
<!--TODO--><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>
<!--TODO--><li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>
<!--TODO--><li>Logon your gallery and go to <span class="pwgScreen">Administration » Pictures » Thumbnails</span> to create missing thumbnails.</li>
<!--TODO--><li>Go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
</ol>
<!--TODO-->Congratulations! You have successfuly created the first category of your photo gallery.
<!--TODO--><h3>Directories and files organization</h3>
<ul>
<li>
<p>Nella directory "galleries" si trovano le categorie di Piwigo.
Qui di seguito potete vedere lo schema di un albero di una piccola galleria
(ma che usa moltissime funzionalità:</p>
<pre>
.
|-- admin
|-- doc
|-- galleries
| |-- categoria-1
| | |-- categoria-1.1
| | | |-- categoria-1.1.1
| | | | |-- categoria-1.1.1.1
| | | | | |-- pwg_high
| | | | | | +-- matrimonio.jpg
| | | | | |-- thumbnail
| | | | | | +-- TN-matrimonio.jpg
| | | | | +-- matrimonio.jpg
| | | | +-- categoria-1.1.1.2
| | | +-- categoria-1.1.2
| | |-- categoria-1.2
| | | |-- pookie.jpg
| | | +-- thumbnail
| | | +-- TN-pookie.jpg
| | +-- categoria-1.3
| +-- categoria-2
| |-- porcello.gif
| |-- pwg_representative
| | +-- video.jpg
| |-- thumbnail
| | +-- TN-porcello.jpg
| +-- video.avi
|-- include
|-- install
|-- language
|-- template
+-- tool</pre>
</li>
<li>In linea di massima, una categoria è rappresentata da una directory
che si trova a qualsiasi livello della directory "galleries" di
Piwigo. Ogni categoria può contenere altretanti sottolivelli che
si desidera. Nell'esempio qui sopra, categoria-1.1.1.1 si trova al 4 livello
di profondità.</li>
<li>Un elemento è invece rappresentato da un file. Un file può essere un
elemento di Piwigo se la sua estensione è tra quelle previste tra
le possibilità previste nel parametro di configuarzione <code>file_ext</code>
(vedi file <span class="filename">include/config_default.inc.php</span>).
Un file è considerato come un immagine se la sua estensione si trova tra
quelle previste nel file <code>picture_ext</code>.</li>
<li>Ogni elemento di tipo immagine deve essere associato ad una miniatura
(vedi la sezione più in basso riguardante le miniature)</li>
<li>Gli elementi di tipo immagine possono avere un'immagine associata
in alta qualità. Come per il file <span class="filename">matrimonio.jpg</span>
nell'esempio proposto. Nessun prefisso è necessario prima del nome del
file.</li>
<li>Gli elementi che non sono delle immagini (video, suoni, file di testo o
quant'altro...) sono generalmente rappresentati con un'icona corrispondente
all'estensione del file. In modo opzionale è possibile associare una miniatura
e un file rappresentativo (come per il file <span class="filename">video.avi</span>
nell'esempio proposto).</li>
<li><em>Attenzione</em>: il nome delle directory o del file deve essere
composto da lettere, numeri o caratteri come "-", "_" o ".". Nessuno spazio
ne caratteri con gli accenti.</li>
<li><em>Consiglio</em>: una categoria può contenere elementi e
sottocategorie nello stesso tempo. Ad ogni modo è altamente consigliato di
scegliere per ciascuna categoria quelle che contengono elementi <strong>e</strong>
quelle che invece contengono sottocategorie.</li>
<li>Una volta che i file, le miniature e i file rappresentativi sono
correttamente piazzati nelle directory, andare nello schermo <span
class="pwgScreen">Amministrazione » Generale » Sincronizza</span>.</li>
</ul>
<h3>Miniature</h3>
<ul>
<li>Come detto prima, ciascun elemento immagine deve essere associato
ad una miniatura.</li>
<li>Le miniature si trovano nella sottodirectory "thumbnail" di ogni
directory che rappresenta una categoria. La miniatura è un file di tipo
immagine (stesso nome del file) con un prefisso che può essere
personalizzato dal parametro di configurazione <code>prefix_thumbnail</code>
(vedi <span class="filename">include/config.inc.php</span>).</li>
<li>Non è necessario che le miniature abbiano la stessa estensione
dell'immagine che rappresenta (per esempio, un'immagine ".JPG" può avere
come miniatura un'immagine ".GIF").</li>
<li>È altamente consigliato di usare un software esterno per la
creazione delle miniature.</li>
<li>È anche possibile usare la creazione delle miniature integrata a
Piwigo, ma ciò non è raccomandato in quanto la qualità delle miniature
può essere scadente ed il processo potrebbe utilizzare troppe risorse del
server (ciò può essere un problema per un servizio di web hosting gratuito.</li>
<li>Se decidete di usare il server per la creazione delle miniature
è necessario dare i diritti di scrittura su tutte le directory e
sottodirectory per tutte le categorie di utenti (utente, gruppo,
altri).</li>
</ul>
</div> <!-- FTP_content -->
</div> <!-- instructionFTP -->
<div id="instructionPermissions" class="instructionBlock">
<div
id="permissions_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('permissions_header', 'permissions_content')"
><span>
<!--TODO-->Permissions
</span></div>
<div
id="permissions_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<!--TODO--><li>You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.</li>
<li>Potete rendere una categoria privata modificandola da <span
class="pwgScreen">Amministrazione » Categorie » Gestire » Modificare</span>
o selezionando l'opzione nell'albero delle categorie <span
class="pwgScreen">Amministrazione » Categorie » Pubblica/Privata</span>).</li>
<li>
<p><!--TODO-->Once the category is private, you can manage permissions for groups
and users with 3 screens:</p>
<ul>
<!--TODO--><li><span class="pwgScreen">Administration » Identification » Users »
permissions action</span> (one link per user)</li>
<!--TODO--><li><span class="pwgScreen">Administration » Identification » Groups »
permissions action</span> (one link per group)</li>
<!--TODO--><li><span class="pwgScreen">Administration » Categories » Manage » 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')"
><span>
Utenti e gruppi
</span></div>
<div
id="groups_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<!--TODO--><li>Groups is a convenient way to set permissions for a list of users.</li>
<li>È possibile creare gruppi in <span class="pwgScreen">Amministrazione » Identificazione » Gruppi</span> e associarci degli utenti.</li>
<li>Un utente può appartenere a diversi gruppi. L'autorizzazione è
prioritaria rispetto alla proibizione. Ad esempio se l'utente "pippo"
appartiene ai gruppi "famiglia" e "amici" e, tra questi gruppi, solo il gruppo
"famiglia" può vedere la categoria "Natale 2006", ne consegue che l'utente
"pippo" sarà abilitato a visionare la categoria "Natale 2006".</li>
</ul>
</div> <!-- groups_content -->
</div> <!-- instructionGroups -->
<div id="instructionUpload" class="instructionBlock">
<div
id="upload_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('upload_header', 'upload_content')"
><span>
Immagini caricate dagli utenti
</span></div>
<div
id="upload_content"
class="instructionBlockContent"
style="display:none"
>
<!--TODO--><p>Users can upload their photos too.</p>
<ol>
<!--TODO--><li>Authorize upload on any physical categories (<span
class="pwgScreen">Administration » Categories » Manage » edit</span> or <span
class="pwgScreen">Administration » Categories » Properties » Upload</span>). Virtual categories can't receive any upload.</li>
<li>dare i diritti di scrittura (per tutti gli utenti) sulle directory
delle categorie autorizzate a l'aggiunta dei file</li>
</ol>
<!--TODO--><p>Photos uploaded by users are not directly visible on the website. An administrator
must validate uploaded photos in <span class="pwgScreen">Administration » Pictures » 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')"
><span>
Collegamenti tra elementi e categorie e le categorie virtuali
</span></div>
<div
id="categoryLinks_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<!--TODO--><li>Photos are displayed in the category corresponding to the file directory.</li>
<!--TODO--><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>
<!--TODO--><li>Virtual categories are based on this concept: they have no corresponding directory. Create virtual categories from <span class="pwgScreen">Administration » Categories » 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')"
><span>
Informazioni
</span></div>
<div
id="misc_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Dopo aver creato la Vostra galleria, modificatene le proprietà
di visualizzazione di default da <span class="pwgScreen">Amministrazione » Configurazione » Visualizzazione di default</span>. In questo modo
ogni nuovo utente visualizzerrà la galleria con le stesse impostazioni.</li>
<!--TODO--><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>
|