Subversion Repositories svnkaklik

Rev

Details | Last modification | View Log

Rev Author Line No. Line
6 kaklik 1
<?php
2
// +-----------------------------------------------------------------------+
3
// | PhpWebGallery - a PHP based picture gallery                           |
4
// | Copyright (C) 2002-2003 Pierrick LE GALL - pierrick@phpwebgallery.net |
5
// | Copyright (C) 2003-2005 PhpWebGallery Team - http://phpwebgallery.net |
6
// +-----------------------------------------------------------------------+
7
// | branch        : BSF (Best So Far)
8
// | file          : $RCSfile: faq.lang.php,v $
9
// | last update   : $Date: 2005/03/12 10:57:01 $
10
// | last modifier : $Author: plg $
11
// | revision      : $Revision: 1.7 $
12
// +-----------------------------------------------------------------------+
13
// | This program is free software; you can redistribute it and/or modify  |
14
// | it under the terms of the GNU General Public License as published by  |
15
// | the Free Software Foundation                                          |
16
// |                                                                       |
17
// | This program is distributed in the hope that it will be useful, but   |
18
// | WITHOUT ANY WARRANTY; without even the implied warranty of            |
19
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU      |
20
// | General Public License for more details.                              |
21
// |                                                                       |
22
// | You should have received a copy of the GNU General Public License     |
23
// | along with this program; if not, write to the Free Software           |
24
// | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
25
// | USA.                                                                  |
26
// +-----------------------------------------------------------------------+
27
 
28
// Admin FAQ
29
$lang['help_images_title'] = 'Adding elements';
30
$lang['help_images'] =
31
array(
32
  'Category directories are in the PhpWebGallery directory "galleries". Here
33
follow the directory tree of a very small gallery (but using many features)
34
: <br />
35
<pre>
36
.
37
|-- admin
38
|-- doc
39
|-- galleries
40
|   |-- category-1
41
|   |   |-- category-1.1
42
|   |   |   |-- category-1.1.1
43
|   |   |   |   |-- category-1.1.1.1
44
|   |   |   |   |   |-- pwg_high
45
|   |   |   |   |   |   +-- wedding.jpg
46
|   |   |   |   |   |-- thumbnail
47
|   |   |   |   |   |   +-- TN-wedding.jpg
48
|   |   |   |   |   +-- wedding.jpg
49
|   |   |   |   +-- category-1.1.1.2
50
|   |   |   +-- category-1.1.2
51
|   |   |-- category-1.2
52
|   |   |   |-- pookie.jpg
53
|   |   |   +-- thumbnail
54
|   |   |       +-- TN-pookie.jpg
55
|   |   +-- category-1.3
56
|   +-- category-2
57
|       |-- piglet.gif
58
|       |-- pwg_representative
59
|       |   +-- video.jpg
60
|       |-- thumbnail
61
|       |   +-- TN-piglet.jpg
62
|       +-- video.avi
63
|-- include
64
|-- install
65
|-- language
66
|-- template
67
+-- tool
68
</pre>',
69
 
70
  'Basically, a category is represented by a directory at any level in
71
PhpWebGallery directory "galleries". Each category can contain as many
72
sub-level as you wish. In the example above, category-1.1.1.1 is at level 4
73
of deepness.',
74
 
75
  'Basically, an element is represented by a file. A file can be a
76
PhpWebGallery element if its extenstion is among $conf[\'file_ext\']
77
possibilities (see include/config.inc.php file). A file can be a picture if
78
its extension is among $conf[\'picture_ext\'] (see include/config.inc.php
79
file).',
80
 
81
  'Picture elements must have an associated thumbnail (see section below about
82
thumbnails)',
83
 
84
  'Picture elements can have a high quality file associated. As for wedding.jpg
85
in the example above. No prefix on the high quality picture is required.',
86
 
87
  'Non picture elements (video, sounds, file texts, what you want...) are by
88
default represented by an icon corresponding to the filename
89
extension. Optionaly, you can associate a thumbnail and a representative
90
file (see video.avi in the example above).',
91
 
92
  'Warning : the name of directories and files must be composed of letters,
93
figures, "-", "_" or ".". No blank space, no accentuated characters',
94
 
95
  'Advise : a category can contain elements and sub-categories in the same
96
time. Nerverthless, you are strongly advised for each category to choose
97
between category containing elements OR category containing sub-categories.'
98
  );
99
 
100
$lang['help_thumbnails_title'] = 'Thumbnails';
101
$lang['help_thumbnails'] =
102
array(
103
  'As said earlier, each element of picture type must be associated with a
104
thumbnail.',
105
 
106
  'Thumbnails are stored in the sub-directory "thumbnail" of the category
107
directory. The thumbnail is a picture (same filename extensions possible
108
than picture files) which filename is prefixed by the configured "Thumbnail
109
prefix" (see admin panel, Configuration, General).',
110
 
111
  'Thumbnails don\'t need to have the same extension as their associated
112
picture (a picture with .jpg extension can have a thumbnail in .GIF
113
extention for instance).',
114
 
115
  'I advise you to use an external module for thumbnails creation (such as
116
ThumbClic available on the presentation site of PhpWebGallery).',
117
 
118
  'You can also use the thumbnail creation page integrated in PhpWebGallery,
119
but I don\'t advise you so, because thumbnail quality may be poor and it
120
uses a high CPU load which can be a problem if you use free web hosting.',
121
 
122
  'If you choose to use your hosting provider to create thumbnails, you must
123
give write rights on all category directories and sub-directories
124
"thumbnail" for ugo (user, group, other).'
125
 
126
  );
127
 
128
$lang['help_database_title'] = 'Synchronize filesystem and database';
129
$lang['help_database'] =
130
array(
131
  'Once files, thumbnails and representatives are correctly placed in the
132
directories, go to : administration panel, General, Synchronize',
133
 
134
  'There are 2 synchronizations possible : directories/files and file
135
metadata. directories/files is about synchronizing your directories tree
136
with the category tree in the database. metadata is about updating elements
137
informations such as filesize, dimensions in pixels, EXIF or IPTC
138
informations.',
139
 
140
  'The first synchronization must be the directories/files one.',
141
 
142
  'Synchronization process may take long (depending on your server load and
143
quantity of elements to manage) so it is possible to progress by step :
144
category by category.'
145
 
146
  );
147
 
148
$lang['help_access_title'] = 'Access authorization';
149
$lang['help_access'] =
150
array(
151
  '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.',
154
 
155
  'You can set a category to private by editing a single category
156
(administration panel, Categories, Manage, edit) or by setting options to
157
your whole category tree (administration panel, Categories, Public/Private)',
158
 
159
  'Once the category is private, you can manage permissions for groups and
160
users (administration panel, Permissions).'
161
 
162
  );
163
 
164
$lang['help_groups_title'] = 'Users Groups';
165
$lang['help_groups'] =
166
array(
167
 
168
  'PhpWebGallery is able to manage groups of users. It can be very useful to
169
have common permission access for private categories.',
170
 
171
  'You can create groups and add users to a group in administration panel,
172
Identification, Groups.',
173
 
174
  'A user can belong to several groups. The authorization is stronger than
175
prohibition : if user "jack" belongs to groups "family" and "friends", and
176
that only group "family" can see category "Christmas 2003", "jack" will be
177
able to see "Christmas 2003".'
178
 
179
  );
180
 
181
$lang['help_remote_title'] = 'Remote site';
182
$lang['help_remote'] =
183
array(
184
 
185
  'PhpWebGallery offers the possibility to use several servers to store the
186
images which will compose your gallery. It can be useful if your gallery is
187
installed on one limited space and that you have a big quantity of images to
188
be shown.',
189
 
190
  '1. edit file tools/create_listing_file.php, by modifying parameters section
191
such as $conf[\'prefix_thumbnail\'] or $conf[\'use_exif\'].',
192
 
193
  '2. place file "tools/create_listing_file.php" modified on your distant
194
website, in the same directory than your category directories (as the
195
directory "galleries" of this website) by ftp. For the example, let\'s say
196
that you can access http://example.com/galleries/create_listing_file.php.',
197
 
198
  '3. go to administration panel, General, Remote sites. Ask to create a new
199
site, for example http://example.com/galleries',
200
 
201
  '4. a new remote site is registered. You can perform 4 actions :
202
<ol>
203
 
204
  <li>generate listing : launches a distant request to generate a distant
205
  file listing</li>
206
 
207
  <li>update : reads the distant listing.xml file and synchronizes with
208
  database informations</li>
209
 
210
  <li>clean : removes distant listing.xml file</li>
211
 
212
  <li>delete : deletes the site (and all related categories and elements) in
213
  the database</li>
214
 
215
</ol>',
216
 
217
  'You can do all this by hand by generating yourself the listing.xml file,
218
moving it from your distant server to you local PhpWebGallery root
219
directory and opening the remote site management screen : PhpWebGallery will
220
propose you to use the found listing.xml file.'
221
 
222
  );
223
 
224
$lang['help_upload_title'] = 'Files upload by users';
225
$lang['help_upload'] =
226
array(
227
  'PhpWebGallery offers the possibility for users to upload images. in order to
228
do it :',
229
 
230
  '1. authorize upload on any categories (administration panel, Categories,
231
Manage, edit or administration panel, Categories, Upload)',
232
 
233
  '2. give write rights on directories for ugo (user, group, other)',
234
 
235
  'Files uploaded by users are not directly visible on the website, they must
236
be validated by an administrator. For that purpose, an administrator must go
237
on administration panel, Pictures, Waiting in order to validate or to refuse
238
the files proposed, then to synchronize filesystem with database.'
239
  );
240
 
241
$lang['help_virtual_title'] = 'Links between elements and categories, virtual categories';
242
$lang['help_virtual'] =
243
array(
244
  'PhpWebGallery dissociates categories where elements are stored and
245
categories where they are shown.',
246
 
247
  'By default, elements are shown only in their real categories : the ones
248
corresponding to directories on the web server.',
249
 
250
  'To link an element to a category, you just have to make the association on
251
the page of element edition (link to this screen on picture.php logged as an
252
administrator) or on the informations of all elements of a category.',
253
 
254
  'Using this principle, it is possible to create virtual categories : no
255
directory coresponds to this category. You can create virtual categories in
256
administration panel, Categories, Manage.'
257
  );
258
 
259
$lang['help_infos_title'] = 'Miscellanous informations';
260
$lang['help_infos'] =
261
array(
262
  'As soon as you created your gallery, modify default display properties in
263
administration panel, Configuration, Default. Indeed, every new registered
264
user will have by default the same display properties.',
265
 
266
  'If you have any question, do not hesitate to take a look at the forum or ask
267
a question there. The <a href="http://forum.phpwebgallery.net"
268
style="text-decoration:underline">forum</a> (message board) is available on
269
the presentation site of PhpWebGallery. Check the <a
270
href="http://doc.phpwebgallery.net"
271
style="text-decoration:underline">official PhpWebGallery documentation</a> for
272
further reading.'
273
  );
274
?>