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
|
<fieldset>
<legend>Quick Start</legend>
<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 » Pictures » 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.
</fieldset>
<fieldset>
<legend>Directories and files organization</legend>
<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 » Categories »
Synchronize</span></li>
</ul>
</fieldset>
<fieldset>
<legend>Thumbnails</legend>
<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 » Pictures » Thumbnails</span> page to create thumbnails.</li>
<li>Give write access on all category directories.</li>
</ul>
</fieldset>
|
