1 | <div class="instructions"> |
---|
2 | <h2>Help</h2> |
---|
3 | |
---|
4 | <h3>Quick start</h3> |
---|
5 | |
---|
6 | <ol> |
---|
7 | |
---|
8 | <li>Create a local directory "test_category".</li> |
---|
9 | |
---|
10 | <li>Copy pictures in "test_category".</li> |
---|
11 | |
---|
12 | <li>Open an FTP connection to this remote gallery.</li> |
---|
13 | |
---|
14 | <li>Upload local directory "test_category" into your remote directory |
---|
15 | names "galleries". Set authorizations to 777 on directory |
---|
16 | "galleries/test_category".</li> |
---|
17 | |
---|
18 | <li>Connect to your Piwigo as an admin.</li> |
---|
19 | |
---|
20 | <li>Go to <span class="pwgScreen">Administration, Pictures, |
---|
21 | Thumbnails</span>. Piwigo find the picture from "test_category" |
---|
22 | without thumbnails. Ask to create thumbnails.</li> |
---|
23 | |
---|
24 | <li>Go to <span class="pwgScreen">Administration, Categories, |
---|
25 | Synchronize</span>. Check "directories + files" option, uncheck "only |
---|
26 | perform a simulation" and submit the synchronization.</li> |
---|
27 | |
---|
28 | <li>Job's done. You've created a category "test_category" at the root of |
---|
29 | your gallery.</li> |
---|
30 | |
---|
31 | </ol> |
---|
32 | |
---|
33 | <h3>Adding elements</h3> |
---|
34 | |
---|
35 | <ul> |
---|
36 | |
---|
37 | <li> |
---|
38 | |
---|
39 | <p>Category directories are in the Piwigo directory |
---|
40 | "galleries". Here follow the directory tree of a very small gallery (but |
---|
41 | using many features) :</p> |
---|
42 | |
---|
43 | <pre> |
---|
44 | . |
---|
45 | |-- admin |
---|
46 | |-- doc |
---|
47 | |-- galleries |
---|
48 | | |-- category-1 |
---|
49 | | | |-- category-1.1 |
---|
50 | | | | |-- category-1.1.1 |
---|
51 | | | | | |-- category-1.1.1.1 |
---|
52 | | | | | | |-- pwg_high |
---|
53 | | | | | | | +-- wedding.jpg |
---|
54 | | | | | | |-- thumbnail |
---|
55 | | | | | | | +-- TN-wedding.jpg |
---|
56 | | | | | | +-- wedding.jpg |
---|
57 | | | | | +-- category-1.1.1.2 |
---|
58 | | | | +-- category-1.1.2 |
---|
59 | | | |-- category-1.2 |
---|
60 | | | | |-- pookie.jpg |
---|
61 | | | | +-- thumbnail |
---|
62 | | | | +-- TN-pookie.jpg |
---|
63 | | | +-- category-1.3 |
---|
64 | | +-- category-2 |
---|
65 | | |-- piglet.gif |
---|
66 | | |-- pwg_representative |
---|
67 | | | +-- video.jpg |
---|
68 | | |-- thumbnail |
---|
69 | | | +-- TN-piglet.jpg |
---|
70 | | +-- video.avi |
---|
71 | |-- include |
---|
72 | |-- install |
---|
73 | |-- language |
---|
74 | |-- template |
---|
75 | +-- tool</pre> |
---|
76 | |
---|
77 | </li> |
---|
78 | |
---|
79 | <li>Basically, a category is represented by a directory at any level in |
---|
80 | Piwigo directory "galleries". Each category can contain as many |
---|
81 | sub-level as you wish. In the example above, category-1.1.1.1 is at level |
---|
82 | 4 of deepness.</li> |
---|
83 | |
---|
84 | <li>Basically, an element is represented by a file. A file can be a |
---|
85 | Piwigo element if its extenstion is among <code>file_ext</code> |
---|
86 | configuration parameter possibilities (see <span |
---|
87 | class="filename">include/config_default.inc.php</span> file). A file can |
---|
88 | be a picture if its extension is among <code>picture_ext</code> |
---|
89 | configuration parameter possibilities.</li> |
---|
90 | |
---|
91 | <li>Picture elements must have an associated thumbnail (see section below |
---|
92 | about thumbnails)</li> |
---|
93 | |
---|
94 | <li>Picture elements can have a high quality file associated. As for |
---|
95 | wedding.jpgin the example above. No prefix on the high quality picture is |
---|
96 | required.</li> |
---|
97 | |
---|
98 | <li>Non picture elements (video, sounds, file texts, what you want...) are |
---|
99 | by default represented by an icon corresponding to the filename |
---|
100 | extension. Optionaly, you can associate a thumbnail and a representative |
---|
101 | file (see video.avi in the example above).</li> |
---|
102 | |
---|
103 | <li><em>Warning</em> : the name of directories and files must be composed |
---|
104 | of letters, figures, "-", "_" or ".". No blank space, no accentuated |
---|
105 | characters</li> |
---|
106 | |
---|
107 | <li><em>Advise</em> : a category can contain elements and sub-categories |
---|
108 | in the same time. Nerverthless, you are strongly advised for each category |
---|
109 | to choose between category containing elements <strong>or</strong> category |
---|
110 | containing sub-categories.</li> |
---|
111 | |
---|
112 | <li>Once files, thumbnails and representatives are correctly placed in the |
---|
113 | directories, go to : <span class="pwgScreen">Administration, Categories, |
---|
114 | Synchronize</span></li> |
---|
115 | |
---|
116 | </ul> |
---|
117 | |
---|
118 | <h3>Thumbnails</h3> |
---|
119 | |
---|
120 | <ul> |
---|
121 | |
---|
122 | <li>As said earlier, each element of picture type must be associated with |
---|
123 | a thumbnail.</li> |
---|
124 | |
---|
125 | <li>Thumbnails are stored in the sub-directory "thumbnail" of the category |
---|
126 | directory. The thumbnail is a picture (same filename extensions possible |
---|
127 | than picture files) which filename is prefixed by the configured |
---|
128 | "Thumbnail prefix" (see admin panel, Configuration, General).</li> |
---|
129 | |
---|
130 | <li>Thumbnails don't need to have the same extension as their associated |
---|
131 | picture (a picture with .jpg extension can have a thumbnail in .GIF |
---|
132 | extention for instance).</li> |
---|
133 | |
---|
134 | <li>Advise: use an external module for thumbnails creation.</li> |
---|
135 | |
---|
136 | <li>You can also use the thumbnail creation page (<span |
---|
137 | class="pwgScreen">Administration, Pictures, Thumbnails</span>), but it is |
---|
138 | not recommended. Indeed, thumbnail quality may be poor and it uses a high |
---|
139 | CPU load which can be a problem if you use free web hosting.</li> |
---|
140 | |
---|
141 | <li>If you choose to use your hosting provider to create thumbnails, you |
---|
142 | must give write rights on all category directories and sub-directories |
---|
143 | "thumbnail" for ugo (user, group, other).</li> |
---|
144 | |
---|
145 | </ul> |
---|
146 | |
---|
147 | <h3>Access authorization</h3> |
---|
148 | |
---|
149 | <ul> |
---|
150 | |
---|
151 | <li>You can forbid access to categories. Categories can be "public" or |
---|
152 | "private". Permissions (for groups and users) can be set only if the |
---|
153 | category is private.</li> |
---|
154 | |
---|
155 | <li>You can set a category to private by editing a single category (<span |
---|
156 | class="pwgScreen">Administration, Categories, Manage, edit</span>) or by |
---|
157 | setting options to your whole category tree (<span |
---|
158 | class="pwgScreen">Administration, Categories, Properties, Public / Private</span>).</li> |
---|
159 | |
---|
160 | <li> |
---|
161 | |
---|
162 | <p>Once the category is private, you can manage permissions for groups |
---|
163 | and users through 3 screens :</p> |
---|
164 | |
---|
165 | <ul> |
---|
166 | |
---|
167 | <li><span class="pwgScreen">Administration, Identification, Users, |
---|
168 | permissions action (one link per user)</span></li> |
---|
169 | |
---|
170 | <li><span class="pwgScreen">Administration, Identification, Groups, |
---|
171 | permissions action (one link per group)</span></li> |
---|
172 | |
---|
173 | <li><span class="pwgScreen">Administration, Categories, Manage, edit |
---|
174 | category permissions action (one link per category)</span></li> |
---|
175 | |
---|
176 | </ul> |
---|
177 | |
---|
178 | </li> |
---|
179 | |
---|
180 | </ul> |
---|
181 | |
---|
182 | <h3>Users Groups</h3> |
---|
183 | |
---|
184 | <ul> |
---|
185 | |
---|
186 | <li>Piwigo is able to manage groups of users. It can be very useful |
---|
187 | to have common permission access for private categories.</li> |
---|
188 | |
---|
189 | <li>You can create groups in <span class="pwgScreen">Administration, |
---|
190 | Identification, Groups</span> and associate users to this group in <span |
---|
191 | class="pwgScreen">Administration, Identication, Users</span>.</li> |
---|
192 | |
---|
193 | <li>A user can belong to several groups. The authorization is stronger |
---|
194 | than prohibition : if user "jack" belongs to groups "family" and |
---|
195 | "friends", and that only group "family" can see category "Christmas 2003", |
---|
196 | "jack" will be able to see "Christmas 2003".</li> |
---|
197 | |
---|
198 | </ul> |
---|
199 | |
---|
200 | <h3>Files upload by users</h3> |
---|
201 | |
---|
202 | <p>Piwigo offers the possibility for users to upload images. in |
---|
203 | order to do it:</p> |
---|
204 | |
---|
205 | <ol> |
---|
206 | |
---|
207 | <li>authorize upload on any categories (<span |
---|
208 | class="pwgScreen">Administration, Categories, Manage, edit</span> or <span |
---|
209 | class="pwgScreen">Administration panel, Categories, Properties, Upload</span>)</li> |
---|
210 | |
---|
211 | <li>give write rights on directories for ugo (user, group, other)</li> |
---|
212 | |
---|
213 | </ol> |
---|
214 | |
---|
215 | <p>Files uploaded by users are not directly visible on the website, they |
---|
216 | must be validated by an administrator. For that purpose, an administrator |
---|
217 | must go in <span class="pwgScreen">Administration, Pictures, Waiting</span> |
---|
218 | in order to validate or to refuse the files proposed, then to synchronize |
---|
219 | filesystem with database.</p> |
---|
220 | |
---|
221 | |
---|
222 | <h3>Links between elements and categories, virtual categories</h3> |
---|
223 | |
---|
224 | <ul> |
---|
225 | |
---|
226 | <li>Piwigo dissociates categories where elements are stored and |
---|
227 | categories where they are shown.</li> |
---|
228 | |
---|
229 | <li>By default, elements are shown only in their real categories : the |
---|
230 | ones corresponding to directories on the web server.</li> |
---|
231 | |
---|
232 | <li>To link an element to a category, you just have to make the |
---|
233 | association on the page of element edition (link to this screen on |
---|
234 | picture.php logged as an administrator) or on the informations of all |
---|
235 | elements of a category.</li> |
---|
236 | |
---|
237 | <li>Using this principle, it is possible to create virtual categories : no |
---|
238 | directory coresponds to this category. You can create virtual categories |
---|
239 | in <span class="pwgScreen">Administration, Categories, Manage</span>.</li> |
---|
240 | |
---|
241 | </ul> |
---|
242 | |
---|
243 | <h3>Miscellanous informations</h3> |
---|
244 | |
---|
245 | <ul> |
---|
246 | |
---|
247 | <li>As soon as you created your gallery, modify default display properties |
---|
248 | in <span class="pwgScreen">Administration panel, Configuration, |
---|
249 | Default</span>. Indeed, every new registered user will have by default the |
---|
250 | same display properties.</li> |
---|
251 | |
---|
252 | <li>If you have any question, do not hesitate to take a look at the forum |
---|
253 | or ask a question there. The <a |
---|
254 | href="http://forum.phpwebgallery.net">forum</a> (message board) is |
---|
255 | available on the presentation site of Piwigo. Check the <a |
---|
256 | href="http://phpwebgallery.net/doc/">official Piwigo |
---|
257 | documentation</a> for further reading.</li> |
---|
258 | |
---|
259 | </ul> |
---|
260 | </div> |
---|