source: branches/2.0/language/hr_HR/help.html @ 3132

Last change on this file since 3132 was 3132, checked in by plg, 15 years ago

modification: phpwebgallery.net moves to piwigo.org

modification: doc/README_*.txt much simpler with link to piwigo.org for
installation and upgrade guides.

modification: latest_version has changed its path on the website to download
directory.

deletion: doc/ChangeLog was useless and outdated.

File size: 10.4 KB
Line 
1<div class="instructions">
2<h2>Help</h2>
3
4<div id="instructionPLoader" class="instructionBlock">
5  <div
6    id="pLoader_header"
7    class="instructionBlockHeaderCollapsed"
8    onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
9  ><span>
10    Add photos, the pLoader way
11  </span></div>
12  <div
13    id="pLoader_content"
14    class="instructionBlockContent"
15    style="display:none"
16  >
17    <ol>
18      <li>Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.</li>
19      <li>Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.</li>
20      <li>Drag'n drop photos from your directory browser into pLoader photo selection.</li>
21      <li>Create a category and select it.</li>
22      <li>Select some photos.</li>
23      <li>Click on the green arrow to transfer photos in your gallery</li>
24    </ol>
25Congratulations! You have successfuly created the first category of your photo gallery.
26  </div> <!-- pLoader_content -->
27</div> <!-- instructionPLoader -->
28
29<div id="instructionFTP" class="instructionBlock">
30  <div
31    id="FTP_header"
32    class="instructionBlockHeaderCollapsed"
33    onclick="blockToggleDisplay('FTP_header', 'FTP_content')"
34  ><span>
35    Add photos, the FTP way
36  </span></div>
37  <div
38    id="FTP_content"
39    class="instructionBlockContent"
40    style="display:none"
41  >
42
43<h3>Quick Start</h3>
44
45<ol>
46  <li>Create a directory on your computer.</li> 
47
48  <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>
49
50  <li>With a FTP client, copy your directory in the "galleries" directory of your Piwigo installation.</li>
51
52  <li>Logon your gallery and go to <span class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> to create missing thumbnails.</li>
53
54  <li>Go to <span class="pwgScreen">Administration</span> and click on the big Synchronization button.</li>
55</ol>
56
57Congratulations! You have successfuly created the first category of your photo gallery.
58
59<h3>Directories and files organization</h3>
60<ul>
61
62  <li>
63
64    <p>Category directories are in the Piwigo directory
65    "galleries". Here follows the directory tree of a very small gallery (but
66    using many features) :</p>
67
68    <pre>
69.
70|-- admin
71|-- doc
72|-- galleries
73|   |-- category-1
74|   |   |-- category-1.1
75|   |   |   |-- category-1.1.1
76|   |   |   |   |-- category-1.1.1.1
77|   |   |   |   |   |-- pwg_high
78|   |   |   |   |   |   +-- wedding.jpg
79|   |   |   |   |   |-- thumbnail
80|   |   |   |   |   |   +-- TN-wedding.jpg
81|   |   |   |   |   +-- wedding.jpg
82|   |   |   |   +-- category-1.1.1.2
83|   |   |   +-- category-1.1.2
84|   |   |-- category-1.2
85|   |   |   |-- pookie.jpg
86|   |   |   +-- thumbnail
87|   |   |       +-- TN-pookie.jpg
88|   |   +-- category-1.3
89|   +-- category-2
90|       |-- piglet.gif
91|       |-- pwg_representative
92|       |   +-- video.jpg
93|       |-- thumbnail
94|       |   +-- TN-piglet.jpg
95|       +-- video.avi
96|-- include
97|-- install
98|-- language
99|-- template
100+-- tool</pre>
101
102  </li>
103 
104  <li>Each directory under "galleries" produces a category. There is no limit on deepness.</li>
105
106  <li>Basically, an element is represented by a file. A file can be a
107  Piwigo element if its extenstion is among <code>file_ext</code>
108  configuration parameter possibilities (see <span
109  class="filename">include/config_default.inc.php</span> file). A file can
110  be a picture if its extension is among <code>picture_ext</code>
111  configuration parameter possibilities.</li>
112
113  <li>Picture elements must have an associated thumbnail (see section below
114  about thumbnails)</li>
115
116  <li>Picture elements can have a high quality file associated. As for
117  wedding.jpg in the example above. No prefix on the high quality picture.</li>
118
119  <li>Non picture elements (video, sounds, file texts, what you want...) are
120  by default represented by an icon corresponding to the filename
121  extension. Optionaly, you can associate a thumbnail and a representative
122  file (see video.avi in the example above).</li>
123
124  <li><em>Warning</em>: the name of directories and files must contain only letters, figures, "-", "_" or ".". No blank space, no accentuated characters.</li>
125
126  <li>Once files, thumbnails and representatives are correctly placed in the
127  directories, go to : <span class="pwgScreen">Administration &raquo; Categories &raquo;
128  Synchronize</span></li>
129
130</ul>
131
132<h3>Thumbnails</h3>
133<ul>
134
135  <li>Each photo must have its thumbnail.</li>
136
137  <li>Thumbnails are stored in the sub-directory "thumbnail" of the category
138  directory. The thumbnail has the same filename as the corresponding photo, with <em>TN-</em> as prefix.</li>
139
140  <li><em>Advise</em>: use an external module for thumbnails creation.</li>
141
142  <li>Even if it is not recommended (image quality, web server resource load), you can use <span
143  class="pwgScreen">Administration &raquo; Pictures &raquo; Thumbnails</span> page to create thumbnails.</li>
144
145  <li>Give write access on all category directories.</li>
146
147</ul>
148
149  </div> <!-- FTP_content -->
150</div> <!-- instructionFTP -->
151
152<div id="instructionPermissions" class="instructionBlock">
153  <div
154    id="permissions_header"
155    class="instructionBlockHeaderCollapsed"
156    onclick="blockToggleDisplay('permissions_header', 'permissions_content')"
157  ><span>
158    Permissions
159  </span></div>
160  <div
161    id="permissions_content"
162    class="instructionBlockContent"
163    style="display:none"
164  >
165<ul>
166
167  <li>You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.</li>
168
169  <li>You can set a category to private by editing a single category (<span
170  class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span>) or by
171  setting options to your whole category tree (<span
172  class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Public / Private</span>).</li>
173
174  <li>
175
176    <p>Once the category is private, you can manage permissions for groups
177    and users with 3 screens:</p>
178
179    <ul>
180
181      <li><span class="pwgScreen">Administration &raquo; Identification &raquo; Users &raquo;
182      permissions action</span> (one link per user)</li>
183
184      <li><span class="pwgScreen">Administration &raquo; Identification &raquo; Groups &raquo;
185      permissions action</span> (one link per group)</li>
186
187      <li><span class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit
188      category permissions action</span> (one link per category)</li>
189
190    </ul>
191
192  </li>
193
194</ul>
195  </div> <!-- permissions_content --> 
196</div> <!-- instructionPermissions -->
197
198<div id="instructionGroups" class="instructionBlock">
199  <div
200    id="groups_header"
201    class="instructionBlockHeaderCollapsed"
202    onclick="blockToggleDisplay('groups_header', 'groups_content')"
203  ><span>
204    Groups
205  </span></div>
206  <div
207    id="groups_content"
208    class="instructionBlockContent"
209    style="display:none"
210  >
211<ul>
212
213  <li>Groups is a convenient way to set permissions for a list of users.</li>
214
215  <li>Create groups in <span class="pwgScreen">Administration &raquo;
216  Identification &raquo; Groups</span> and associate users to this group in <span
217  class="pwgScreen">Administration &raquo; Identication &raquo; Users</span>.</li>
218
219  <li>A user can belong to several groups. Authorization is stronger
220  than forbiddance : if user "jack" belongs to groups "family" and
221  "friends", and that only group "family" can see category "Christmas 2003" category then
222  "jack" will be able to see "Christmas 2003".</li>
223
224</ul>
225  </div> <!-- groups_content --> 
226</div> <!-- instructionGroups -->
227
228<div id="instructionUpload" class="instructionBlock">
229  <div
230    id="upload_header"
231    class="instructionBlockHeaderCollapsed"
232    onclick="blockToggleDisplay('upload_header', 'upload_content')"
233  ><span>
234    Upload by users
235  </span></div>
236  <div
237    id="upload_content"
238    class="instructionBlockContent"
239    style="display:none"
240  >
241<p>Users can upload their photos too.</p>
242
243<ol>
244
245  <li>Authorize upload on any physical categories (<span
246  class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span> or <span
247  class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Upload</span>). Virtual categories can't receive any upload.</li>
248
249  <li>Give write access on corresponding directories.</li>
250
251</ol>
252
253<p>Photos uploaded by users are not directly visible on the website. An administrator
254must validate uploaded photos in <span class="pwgScreen">Administration &raquo; Pictures &raquo; Waiting</span>.</p>
255  </div> <!-- upload_content --> 
256</div> <!-- instructionUpload -->
257
258<div id="instructionCategoryLinks" class="instructionBlock">
259  <div
260    id="categoryLinks_header"
261    class="instructionBlockHeaderCollapsed"
262    onclick="blockToggleDisplay('categoryLinks_header', 'categoryLinks_content')"
263  ><span>
264    Links between photos and categories, virtual categories
265  </span></div>
266  <div
267    id="categoryLinks_content"
268    class="instructionBlockContent"
269    style="display:none"
270  >
271<ul>
272
273  <li>Photos are displayed in the category corresponding to the file directory.</li>
274
275  <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>
276
277  <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>
278
279</ul>
280  </div> <!-- categoryLinks_content --> 
281</div> <!-- instructionCategoryLinks -->
282
283<div id="instructionMisc" class="instructionBlock">
284  <div
285    id="misc_header"
286    class="instructionBlockHeaderCollapsed"
287    onclick="blockToggleDisplay('misc_header', 'misc_content')"
288  ><span>
289    Miscellanous informations
290  </span></div>
291  <div
292    id="misc_content"
293    class="instructionBlockContent"
294    style="display:none"
295  >
296<ul>
297
298  <li>As soon as you created your gallery, modify default display properties
299  in <span class="pwgScreen">Administration &raquo; Configuration &raquo;
300  Default</span>. Every new registered user will use these default configuration settings.</li>
301
302  <li>If you have any question, Piwigo community will welcome you on <a
303  href="http://piwigo.org/forum">its forum</a>.</li>
304
305</ul>
306  </div> <!-- misc_content --> 
307</div> <!-- instructionMisc -->
308
309</div>
Note: See TracBrowser for help on using the repository browser.