iarv/Piwigo
1
0
Fork 0
mirror of https://github.com/Piwigo/Piwigo.git synced 2026-03-28 17:42:57 +01:00
Code Issues Packages Projects Releases Wiki Activity

feature 1519: admin instructions are dispatched into several tabs. Only

Browse Source 
applied to en_UK and fr_FR. The help content itself needs some updates
but it will be another set of commits, in this commit, I nearly only
modified the container.

The new "Add Photos" help page only introduces you to 3 main ways to add
photos: direct upload, pLoader and FTP. Each of them has a dedicated tab
on the Admin>Photos>Add screen.

No use of the big question mark icon linked to the Help pages in the
administration header, to avoid having this icon twice : in the header
+ in the content next to H2.

git-svn-id: http://piwigo.org/svn/trunk@5182 68402e56-0260-453c-a942-63ccdbb3a9ee
This commit is contained in:
plegall
2010-03-18 22:12:30 +00:00
parent d158f116d2
commit 27de15e076
28 changed files with 733 additions and 648 deletions
Download Patch File Download Diff File Expand all files Collapse all files

74
admin/help.php
View File

@@ -22,11 +22,83 @@
// +-----------------------------------------------------------------------+
include_once(PHPWG_ROOT_PATH.'admin/include/functions.php');
include_once(PHPWG_ROOT_PATH.'admin/include/tabsheet.class.php');
// +-----------------------------------------------------------------------+
// | Check Access and exit when user status is not ok |
// +-----------------------------------------------------------------------+
check_status(ACCESS_ADMINISTRATOR);
$template->assign('ADMIN_CONTENT', load_language('help.html','',array('return'=>true)) );
$link = get_root_url().'admin.php?page=help&section=';
$selected = null;
$help_section_title = null;
$tabs = array(
array(
'code' => 'add_photos',
'label' => 'Add Photos',
),
array(
'code' => 'permissions',
'label' => 'Permissions',
),
array(
'code' => 'groups',
'label' => 'Groups',
),
array(
'code' => 'user_upload',
'label' => 'User Upload',
),
array(
'code' => 'virtual_links',
'label' => 'Virtual Links',
),
array(
'code' => 'misc',
'label' => 'Miscellaneous',
),
);
if (!isset($_GET['section']))
{
$section = $tabs[0]['code'];
}
else
{
$section = $_GET['section'];
}
$tabsheet = new tabsheet();
foreach ($tabs as $tab)
{
if ($tab['code'] == $section)
{
$selected_tab = $tab['code'];
$help_section_title = l10n($tab['label']);
}
$tabsheet->add($tab['code'], l10n($tab['label']), $link.$tab['code']);
}
$tabsheet->select($selected_tab);
$tabsheet->assign();
$template->set_filenames(array('help' => 'help.tpl'));
$template->assign(
array(
'HELP_CONTENT' => load_language(
'help/help_'.$selected_tab.'.html',
'',
array('return'=>true)
),
'HELP_SECTION_TITLE' => $help_section_title,
)
);
// +-----------------------------------------------------------------------+
// | sending html code |
// +-----------------------------------------------------------------------+
$template->assign_var_from_handle('ADMIN_CONTENT', 'help');
?>

10
admin/photos_add.php
View File

@@ -147,7 +147,15 @@ $tabs = array(
array(
'code' => 'settings',
'label' => 'Settings',
)
),
array(
'code' => 'ploader',
'label' => 'Piwigo Uploader',
),
array(
'code' => 'ftp',
'label' => 'FTP + Synchronisation',
),
);
$tab_codes = array_map(

45
admin/photos_add_ftp.php Normal file
View File

@@ -0,0 +1,45 @@
<?php
// +-----------------------------------------------------------------------+
// | Piwigo - a PHP based picture gallery |
// +-----------------------------------------------------------------------+
// | Copyright(C) 2010 Pierrick LE GALL http://piwigo.org |
// +-----------------------------------------------------------------------+
// | This program is free software; you can redistribute it and/or modify |
// | it under the terms of the GNU General Public License as published by |
// | the Free Software Foundation |
// | |
// | This program is distributed in the hope that it will be useful, but |
// | WITHOUT ANY WARRANTY; without even the implied warranty of |
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
// | General Public License for more details. |
// | |
// | You should have received a copy of the GNU General Public License |
// | along with this program; if not, write to the Free Software |
// | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
// | USA. |
// +-----------------------------------------------------------------------+
if (!defined('PHOTOS_ADD_BASE_URL'))
{
die ("Hacking attempt!");
}
// +-----------------------------------------------------------------------+
// | template init |
// +-----------------------------------------------------------------------+
$template->assign(
'FTP_HELP_CONTENT',
load_language(
'help/photos_add_ftp.html',
'',
array('return'=>true)
)
);
// +-----------------------------------------------------------------------+
// | sending html code |
// +-----------------------------------------------------------------------+
$template->assign_var_from_handle('ADMIN_CONTENT', 'plugin_admin_content');
?>

45
admin/photos_add_ploader.php Normal file
View File

@@ -0,0 +1,45 @@
<?php
// +-----------------------------------------------------------------------+
// | Piwigo - a PHP based picture gallery |
// +-----------------------------------------------------------------------+
// | Copyright(C) 2010 Pierrick LE GALL http://piwigo.org |
// +-----------------------------------------------------------------------+
// | This program is free software; you can redistribute it and/or modify |
// | it under the terms of the GNU General Public License as published by |
// | the Free Software Foundation |
// | |
// | This program is distributed in the hope that it will be useful, but |
// | WITHOUT ANY WARRANTY; without even the implied warranty of |
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
// | General Public License for more details. |
// | |
// | You should have received a copy of the GNU General Public License |
// | along with this program; if not, write to the Free Software |
// | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
// | USA. |
// +-----------------------------------------------------------------------+
if (!defined('PHOTOS_ADD_BASE_URL'))
{
die ("Hacking attempt!");
}
// +-----------------------------------------------------------------------+
// | template init |
// +-----------------------------------------------------------------------+
$template->assign(
array(
'URL_DOWNLOAD_WINDOWS' => $conf['ploader_download_windows'],
'URL_DOWNLOAD_MAC' => $conf['ploader_download_mac'],
'URL_DOWNLOAD_LINUX' => $conf['ploader_download_linux'],
)
);
// +-----------------------------------------------------------------------+
// | sending html code |
// +-----------------------------------------------------------------------+
$template->assign_var_from_handle('ADMIN_CONTENT', 'plugin_admin_content');
?>

5
admin/themes/clear/theme.css
View File

@@ -209,4 +209,7 @@ html>body #menubar {min-height:477px; height:477px;} /* IE 7 and modern browsers
#themesContent H3 {border-bottom:1px solid #aaa;}
.themeDefault {background-color:#dbe8f3;}
#pluginsMenuSeparator {border:1px solid #ddd;}
#pluginsMenuSeparator {border:1px solid #ddd;}
#helpContent A {border-bottom:1px dotted #005E89;}
#helpContent A:hover {border-bottom:1px solid #d54e21;}

8
admin/themes/default/default-layout.css
View File

@@ -540,7 +540,7 @@ ul.holder li.bit-box-focus a.closebutton, ul.holder li.bit-box-focus a.closebutt
}
#pwgHead {
background-color:#222;
background-color:#464646;
height:46px;
}
@@ -744,4 +744,8 @@ BODY#thePopuphelpPage {
h2 { letter-spacing:2px; font-weight:bold;}
h2:lang(en) { text-transform:capitalize; }
#pluginsMenuSeparator {width:80%; margin:5px auto;}
#pluginsMenuSeparator {width:80%; margin:5px auto;}
#helpContent P {text-align:left; margin-left:10px;}
#helpContent LI, #ftpPage LI {margin-top:10px;}
#helpContent P.nextStepLink {text-align:center; font-weight:bold; margin-bottom:20px;}

4
admin/themes/default/template/header.tpl
View File

@@ -48,9 +48,9 @@
<div id="headActions">
Hello {$USERNAME} :
<a href="{$U_RETURN}" title="Visit Gallery">Visit Gallery</a> |
<a href="{$U_CHANGE_THEME}" title="Switch to clear theme for administration">Change Theme</a> |
<a href="{$U_CHANGE_THEME}" title="Switch to clear theme for administration">Change Admin Colors</a> |
<a href="{$U_FAQ}" title="{'Instructions to use Piwigo'|@translate}">Help Me</a> |
<a href="{$U_LOGOUT}">{'Logout'|@translate}</a>
<a href="{$U_FAQ}" title="{'Instructions'|@translate}" id="instructions"><img style="padding-left:10px;" src="{$ROOT_URL}admin/themes/default/icon/help.png" class="button" alt="(?)"></a>
</div>
</div>

7
admin/themes/default/template/help.tpl Normal file
View File

@@ -0,0 +1,7 @@
<h2>{'Help'|@translate} &raquo; {$HELP_SECTION_TITLE}</h2>
<div id="helpContent">
{$HELP_CONTENT}
</div>

7
admin/themes/default/template/photos_add_ftp.tpl Normal file
View File

@@ -0,0 +1,7 @@
<div class="titrePage" style="height:25px">
<h2>{'FTP + Synchronization'|@translate}</h2>
</div>
<div id="ftpPage">
{$FTP_HELP_CONTENT}
</div>

88
admin/themes/default/template/photos_add_ploader.tpl Normal file
View File

@@ -0,0 +1,88 @@
{literal}
<script type="text/javascript">
$().ready(function(){
$("#pLoaderPage img").fadeTo("fast", 0.6);
$("#pLoaderPage img").hover(
function(){
$(this).fadeTo("fast", 1.0); // Opacity on hover
},
function(){
$(this).fadeTo("fast", 0.6); // Opacity on mouseout
}
);
});
</script>
<style>
#pLoaderPage {
width:600px;
margin:0 auto;
font-size:1.1em;
}
#pLoaderPage P {
text-align:left;
}
#pLoaderPage .downloads {
margin:10px auto 0 auto;
}
#pLoaderPage .downloads A {
display:block;
width:150px;
text-align:center;
font-size:16px;
font-weight:bold;
}
#pLoaderPage .downloads A:hover {
border:none;
}
#pLoaderPage LI {
margin:20px;
}
</style>
{/literal}
<div class="titrePage">
<h2>{'Piwigo Uploader'|@translate}</h2>
</div>
<div id="pLoaderPage">
<p>pLoader stands for <em>Piwigo Uploader</em>. From your computer, pLoader prepares your photos and transfer them to your Piwigo photo gallery.</p>
<ol>
<li>
Download,
<table class="downloads">
<tr>
<td>
<a href="{$URL_DOWNLOAD_WINDOWS}">
<img src="http://piwigo.org/screenshots/windows.png"/>
<br>Windows
</a>
<td>
<td>
<a href="{$URL_DOWNLOAD_MAC}">
<img src="http://piwigo.org/screenshots/mac.png" />
<br>Mac
</a>
<td>
<td>
<a href="{$URL_DOWNLOAD_LINUX}">
<img src="http://piwigo.org/screenshots/linux.png" />
<br>Linux
</a>
<td>
</tr>
</table>
</li>
<li>Install on your computer,</li>
<li>Start pLoader and add your photos.</li>
</ol>
</div>

4
admin/themes/roma/theme.css
View File

@@ -221,4 +221,6 @@ html>body #menubar {min-height:522px; height:522px;} /* IE 7 and modern browsers
.themeActions A {border-bottom:none;}
.themeDefault {background-color:#555;}
#pluginsMenuSeparator {border:1px solid #333;}
#pluginsMenuSeparator {border:1px solid #333;}
#helpContent, #pLoaderPage, #ftpPage, #ftpPage LEGEND {color:#aaa;}

9
include/config_default.inc.php
View File

@@ -771,4 +771,13 @@ $conf['no_photo_yet_url'] = 'admin.php?page=photos_add';
// directory with themes inside
$conf['themes_dir'] = PHPWG_ROOT_PATH.'themes';
// pLoader direct download url for windows
$conf['ploader_download_windows'] = 'http://piwigo.org/ext/download.php?eid=270';
// pLoader direct download url for mac
$conf['ploader_download_mac'] = 'http://piwigo.org/ext/download.php?eid=353';
// pLoader direct download url for linux
$conf['ploader_download_linux'] = 'http://piwigo.org/ext/download.php?eid=269';
?>

310
language/en_UK/help.html
View File

@@ -1,310 +0,0 @@
<div class="instructions">
<h2>Help</h2>
<div id="instructionPLoader" class="instructionBlock">
<div
id="pLoader_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
><span>
Add photos, the pLoader way
</span></div>
<div
id="pLoader_content"
class="instructionBlockContent"
style="display:none"
>
<p><a href="http://piwigo.org/ext/extension_view.php?eid=270">pLoader for Windows</a> or <a href="http://piwigo.org/ext/extension_view.php?eid=269">pLoader for Linux</a> : description, download and details about new revisions.</p>
<ol>
<li>Create a directory "upload" next to directory "galleries" in your Piwigo installation, with write access.</li>
<li>Install pLoader on your computer, start it and fill the connection settings : your gallery URL, your username and password.</li>
<li>Drag'n drop photos from your directory browser into pLoader photo selection.</li>
<li>Create a category and select it.</li>
<li>Select some photos.</li>
<li>Click on the green arrow to transfer photos in your gallery</li>
</ol>
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>
Add photos, the FTP way
</span></div>
<div
id="FTP_content"
class="instructionBlockContent"
style="display:none"
>
<h3>Quick Start</h3>
<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 &raquo; Pictures &raquo; 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.
<h3>Directories and files organization</h3>
<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 &raquo; Categories &raquo;
Synchronize</span></li>
</ul>
<h3>Thumbnails</h3>
<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 &raquo; Pictures &raquo; Thumbnails</span> page to create thumbnails.</li>
<li>Give write access on all category directories.</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>
Permissions
</span></div>
<div
id="permissions_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.</li>
<li>You can set a category to private by editing a single category (<span
class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span>) or by
setting options to your whole category tree (<span
class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Public / Private</span>).</li>
<li>
<p>Once the category is private, you can manage permissions for groups
and users with 3 screens:</p>
<ul>
<li><span class="pwgScreen">Administration &raquo; Identification &raquo; Users &raquo;
permissions action</span> (one link per user)</li>
<li><span class="pwgScreen">Administration &raquo; Identification &raquo; Groups &raquo;
permissions action</span> (one link per group)</li>
<li><span class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; 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>
Groups
</span></div>
<div
id="groups_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Groups is a convenient way to set permissions for a list of users.</li>
<li>Create groups in <span class="pwgScreen">Administration &raquo;
Identification &raquo; Groups</span> and associate users to this group in <span
class="pwgScreen">Administration &raquo; Identication &raquo; Users</span>.</li>
<li>A user can belong to several groups. Authorization is stronger
than forbiddance : if user "jack" belongs to groups "family" and
"friends", and that only group "family" can see category "Christmas 2003" category then
"jack" will be able to see "Christmas 2003".</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>
Upload by users
</span></div>
<div
id="upload_content"
class="instructionBlockContent"
style="display:none"
>
<p>Users can upload their photos too.</p>
<ol>
<li>Authorize upload on any physical categories (<span
class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit</span> or <span
class="pwgScreen">Administration &raquo; Categories &raquo; Properties &raquo; Upload</span>). Virtual categories can't receive any upload.</li>
<li>Give write access on corresponding directories.</li>
</ol>
<p>Photos uploaded by users are not directly visible on the website. An administrator
must validate uploaded photos in <span class="pwgScreen">Administration &raquo; Pictures &raquo; 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>
Links between photos and categories, virtual categories
</span></div>
<div
id="categoryLinks_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Photos are displayed in the category corresponding to the file directory.</li>
<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>
<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>
</ul>
</div> <!-- categoryLinks_content -->
</div> <!-- instructionCategoryLinks -->
<div id="instructionMisc" class="instructionBlock">
<div
id="misc_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('misc_header', 'misc_content')"
><span>
Miscellanous informations
</span></div>
<div
id="misc_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>As soon as you created your gallery, modify default display properties
in <span class="pwgScreen">Administration &raquo; Configuration &raquo;
Default</span>. Every new registered user will use these default configuration settings.</li>
<li>If you have any question, Piwigo community will welcome you on <a
href="http://piwigo.org/forum">its forum</a>.</li>
</ul>
</div> <!-- misc_content -->
</div> <!-- instructionMisc -->
</div>

29
language/en_UK/help/help_add_photos.html Normal file
View File

@@ -0,0 +1,29 @@
<p>Several ways to add your photos in your gallery:</p>
<ul>
<li><strong>Direct upload</strong> inside your web browser. It is the
simplest and most immediate way. It depends on your browser capabilities
and your web server. For a high quantity of photos or in case of problem,
the other ways are just waiting for you!</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=direct">Go to Direct Upload </a></p>
<ul>
<li><strong>pLoader</strong> is desktop application, to install on your
computer. Drag &amp; drop photos into pLoader window, click on <em>"Upload
to Piwigo"</em> and let pLoader do the job. You can find other desktop
applications such as comme <strong>WinToPiwigo</strong> or the export
plugin for <strong>Digikam</strong>.</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=ploader">Go to pLoader</a></p>
<ul>
<li><strong>FTP transfer</strong> is the most recommended way to add a
very large collection of photos with a minimum number of clicks. Follow
the guide to prepare your photos. The FTP method let you control precisely
the physical organization of your photos on your server.</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=ftp">Go to FTP</a></p>

11
language/en_UK/help/help_groups.html Normal file
View File

@@ -0,0 +1,11 @@
<p>Groups is a convenient way to set permissions for a list of users.</p>
<p>Create groups in <span class="pwgScreen">Administration &raquo; Users
&raquo; Groups</span> and associate users to this group
in <span class="pwgScreen">Administration &raquo; Users &raquo;
Manage</span>.</p>
<p>A user can belong to several groups. Authorization is stronger than
forbiddance : if user "jack" belongs to groups "family" and "friends", and
that only group "family" can see category "Christmas 2003" category then
"jack" will be able to see "Christmas 2003".</p>

7
language/en_UK/help/help_misc.html Normal file
View File

@@ -0,0 +1,7 @@
<p>As soon as you created your gallery, modify default display properties
in <span class="pwgScreen">Administration &raquo; Configuration &raquo;
Default</span>. Every new registered user will use these default
configuration settings.</p>
<p>If you have any question, Piwigo community will welcome you
on <a href="http://piwigo.org/forum">its forum</a>.</p>

24
language/en_UK/help/help_permissions.html Normal file
View File

@@ -0,0 +1,24 @@
<p>You can forbid access to categories. Switch the category access type to
"private" if you want to manage permissions.</p>
<p>You can set a category to private by editing a single category
(<span class="pwgScreen">Administration &raquo; Categories &raquo; Manage
&raquo; edit</span>) or by setting options to your whole category tree
(<span class="pwgScreen">Administration &raquo; Categories &raquo;
Properties &raquo; Public / Private</span>).</p>
<p>Once the category is private, you can manage permissions for groups and
users with 3 screens:</p>
<ul>
<li><span class="pwgScreen">Administration &raquo; Users &raquo; Manage &raquo;
permissions action</span> (one link per user)</li>
<li><span class="pwgScreen">Administration &raquo; Users &raquo; Groups &raquo;
permissions action</span> (one link per group)</li>
<li><span class="pwgScreen">Administration &raquo; Categories &raquo; Manage &raquo; edit
category permissions action</span> (one link per category)</li>
</ul>

18
language/en_UK/help/help_user_upload.html Normal file
View File

@@ -0,0 +1,18 @@
<p>Users can upload their photos too.</p>
<ol>
<li>Authorize upload on any physical categories
(<span class="pwgScreen">Administration &raquo; Categories &raquo; Manage
&raquo; edit</span> or <span class="pwgScreen">Administration &raquo;
Categories &raquo; Properties &raquo; Upload</span>). Virtual categories
can't receive any upload.</li>
<li>Give write access on corresponding directories.</li>
</ol>
<p>Photos uploaded by users are not directly visible on the website. An
administrator must validate uploaded photos
in <span class="pwgScreen">Administration &raquo; Photos &raquo;
Waiting</span>.</p>

12
language/en_UK/help/help_virtual_links.html Normal file
View File

@@ -0,0 +1,12 @@
<p>Photos are displayed in the category corresponding to the file
directory.</p>
<p>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).</p>
<p>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>.</p>

112
language/en_UK/help/photos_add_ftp.html Normal file
View File

@@ -0,0 +1,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 &raquo; Pictures &raquo; 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 &raquo; Categories &raquo;
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 &raquo; Pictures &raquo; Thumbnails</span> page to create thumbnails.</li>
<li>Give write access on all category directories.</li>
</ul>
</fieldset>

330
language/fr_FR/help.html
View File

@@ -1,330 +0,0 @@
<div class="instructions">
<h2>Aide</h2>
<div id="instructionPLoader" class="instructionBlock">
<div
id="pLoader_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
><span>
Ajouter des photos avec pLoader
</span></div>
<div
id="pLoader_content"
class="instructionBlockContent"
style="display:none"
>
<p><a href="http://fr.piwigo.org/ext/extension_view.php?eid=270">pLoader pour Windows</a> ou <a href="http://fr.piwigo.org/ext/extension_view.php?eid=269">pLoader pour Linux</a> : description, téléchargement et détails des nouvelles versions.</p>
<ol>
<li>Créez un répertoire "upload" à côté du répertoire "galleries" sur votre installation de Piwigo, avec un accès en écriture.</li>
<li>Installez pLoader sur votre ordinateur, démarrez le et remplissez les paramètres de connection : l'URL de votre galerie, votre nom d'utilisateur et votre mot de passe.</li>
<li>Ajoutez des photos dans la sélection par glisser/déposer depuis votre navigateur de fichiers.</li>
<li>Créez une catégorie et sélectionnez la.</li>
<li>Sélectionnez des photos.</li>
<li>Cliquez sur la flêche verte pour charger les photos dans votre galerie.</li>
</ol>
<p>Bravo ! Vous avez créé avec succès la première catégorie de votre galerie.</p>
</div> <!-- pLoader_content -->
</div> <!-- instructionPLoader -->
<div id="instructionFTP" class="instructionBlock">
<div
id="FTP_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('FTP_header', 'FTP_content')"
><span>
Ajouter des photos par FTP
</span></div>
<div
id="FTP_content"
class="instructionBlockContent"
style="display:none"
>
<h3>Démarrage rapide</h3>
<ol>
<li>Créez un répertoire sur votre ordinateur.</li>
<li>Copiez des photos à l'intérieur de ce répertoire, puis redimensionnez les pour un affichage sur le web. <em>Attention</em> : le nom des répertoires et des fichiers ne doit contenir que des lettres, des chiffres et les caractères "-", "_" or ".". Pas d'espace ou de caractères accentués.</li>
<li>Avec un client FTP, copiez le répertoire dans le répertoire "galleries" de votre installation de Piwigo.</li>
<li>Connectez vous à votre installation de Piwigo et rendez vous sur <span class="pwgScreen">Administration &raquo; Images &raquo; Miniatures</span> pour créer les miniatures manquantes.</li>
<li>Rendez vous sur <span class="pwgScreen">Administration</span> et cliquez sur le gros bouton de synchronisation.</li>
</ol>
<p>Bravo ! Vous avez créé avec succès la première catégorie de votre galerie.</p>
<h3>Organisation des répertoires et des fichiers</h3>
<ul>
<li>
<p>Les répertoires représentant les catégories sont dans le répertoire
"galleries". Ci-dessous l'arbre des répertoires d'une très petite galerie
(mais utilisant de nombreuses fonctionnalités) : </p>
<pre>
.
|-- admin
|-- doc
|-- galleries
| |-- categorie-1
| | |-- categorie-1.1
| | | |-- categorie-1.1.1
| | | | |-- categorie-1.1.1.1
| | | | | |-- pwg_high
| | | | | | +-- mariage.jpg
| | | | | |-- thumbnail
| | | | | | +-- TN-mariage.jpg
| | | | | +-- mariage.jpg
| | | | +-- categorie-1.1.1.2
| | | +-- categorie-1.1.2
| | |-- categorie-1.2
| | | |-- pookie.jpg
| | | +-- thumbnail
| | | +-- TN-pookie.jpg
| | +-- categorie-1.3
| +-- categorie-2
| |-- porcinet.gif
| |-- pwg_representative
| | +-- video.jpg
| |-- thumbnail
| | +-- TN-porcinet.jpg
| +-- video.avi
|-- include
|-- install
|-- language
|-- template
+-- tool</pre>
</li>
<li>Fondamentalement, une catégorie est représentée par un répertoire à
n'importe quel niveau sous le répertoire "galleries" de votre installation
de Piwigo. Chaque catégorie peut contenir autant de sous-niveaux que
désiré. Dans l'exemple ci-dessus, categorie-1.1.1.1 est à un niveau 4 de
profondeur.</li>
<li>Fondamentalement, un élément est représenté par un fichier. Un fichier
peut être un élément pour Piwigo si l'extension du nom du fichier est
parmi la liste du paramètre de configuration <code>file_ext</code> (voir
fichier <span class="filename">include/config.inc.php</span>). Un fichier
peut être une image si son extension est parmi le paramètre de configuration
<code>picture_ext</code>.</li>
<li>Les éléments de type image doivent avoir une miniature associée (voir la
section suivante à propos des miniatures).</li>
<li>Les éléments de type image peuvent avoir un image en grand format
associé. Comme pour le fichier <span class="filename">mariage.jpg</span>
dans l'exemple ci-dessus. Aucun préfixe n'est nécessaire sur le nom du
fichier.</li>
<li>Les éléments non image (vidéos, sons, fichiers texte, tout ce que vous
voulez...) sont par défaut représentés par un icône correspondant à
l'extension du nom du fichier. Optionnellement, une miniature et un
représentant peuvent être associés (voir le fichier <span
class="filename">video.avi</span> dans l'exemple).</li>
<li><em>Attention</em> : le nom d'un répertoire ou d'un fichier ne doit
être composé que de lettres, de chiffres, de "-", "_" ou ".". Pas d'espace
ou de caractères accentués.</li>
<li><em>Conseil</em> : une catégorie peut contenir des éléments et des
sous-catégories à la fois. Néanmoins, il est fortement conseillé pour chaque
catégorie de choisir entre contenir des éléments <strong>ou bien</strong>
des sous-catégories.</li>
<li>Une fois que les fichiers, les miniatures et les représentants sont
correctement placés dans les répertoires, se rendre sur l'écran <span
class="pwgScreen">Administration &raquo; Catégories &raquo; Synchroniser</span>.</li>
</ul>
<h3>Miniatures</h3>
<ul>
<li>Comme mentionné précédemment, chaque élément de type image doit être
associé à une miniature.</li>
<li>Les miniatures sont stockées dans le sous-répertoire "thumbnail" de
chaque répertoire représentant une catégorie. Une miniature est un fichier
de type image (même extension du nom du fichier) dont le nom de fichier est
préfixé par le paramètre de configuration <code>prefix_thumbnail</code>
(voir <span class="filename">include/config.inc.php</span>).</li>
<li>Les miniatures n'ont pas besoin d'avoir la même extension que leur
image associée (une image avec ".jpg" comme extension peut avoir une
miniature en ".GIF" par exemple).</li>
<li>Il est conseillé d'utiliser un outil externe pour la création des
miniatures.</li>
<li>Vous pouvez également utiliser l'outil de création de miniature
intégré à Piwigo mais cela est déconseillé car la qualité risque
d'être décevante et cela utilise inutilement les ressources du serveur (ce
qui peut être un grave problème sur un serveur mutualisé).</li>
<li>Si vous choisissez d'utiliser le serveur web pour générer les
miniatures, vous devez donner les droits en écriture sur les
répertoires.</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>
Permissions
</span></div>
<div
id="permissions_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Vous pouvez interdire l'accès aux catégories. Passez le type d'accès à "privé" si vous souhaitez gérer les permissions.</li>
<li>Vous pouvez rendre une catégorie privée en l'éditant (<span
class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer &raquo; Editer</span>) ou en
gérant les options pour votre arbre complet des catégories (<span
class="pwgScreen">Administration &raquo; Catégories &raquo; Propriétés &raquo; Publique/Privée</span>).</li>
<li>
<p>Une fois que certaines catégories sont privées, vous pouvez gérer les
permissions avec 3 écrans :</p>
<ul>
<li><span class="pwgScreen">Administration &raquo; Identification &raquo; Utilisateurs &raquo; action Permissions</span> (1 lien par utilisateur)</li>
<li><span class="pwgScreen">Administration &raquo; Identification &raquo; Groupes &raquo; action Permissions</span> (1 lien par groupe)</li>
<li><span class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer &raquo; Modifier les permissions</span> (1 lien par catégorie)</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>
Groupes d'utilisateurs
</span></div>
<div
id="groups_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Les groupes d'utilisateurs permettent d'assigner des permissions à une liste d'utilisateurs.</li>
<li>Vous pouvez créer des groupes et y ajouter des utilisateurs dans la
<span class="pwgScreen">Administration &raquo; Identification &raquo; Groupes</span>.</li>
<li>Un utilisateur peut appartenir à plusieurs groupes. L'autorisation est
plus forte que l'interdiction : si l'utilisateur "pierre" appartient aux
groupes "famille" et "amis", et que seul le groupe "famille" peut visiter la
catégorie "Noël 2003", alors "pierre" peut visiter cette catégorie.</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>
Ajout de fichiers par les utilisateurs
</span></div>
<div
id="upload_content"
class="instructionBlockContent"
style="display:none"
>
<p>Vos utilisateurs peuvent également ajouter leurs photos.</p>
<ol>
<li>Autorisez l'ajout d'images sur une ou plusieurs catégories (<span
class="pwgScreen">Administation &raquo; Catégories &raquo; Gestion &raquo; Edit</span> ou <span
class="pwgScreen">Administration &raquo; Catégories &raquo; Propriétés &raquo; Ajout d'images</span>). Les catégories virtuelles ne permettent pas l'ajout d'images.</li>
<li>donner les droits en écriture (pour tous les utilisateurs) sur les
répertoires correspondant aux catégories qui sont autorisées à l'ajout.</li>
</ol>
<p>Les photos ajoutées par les utilisateurs ne sont pas directement
visibles sur le site, ils doivent être validés par un administrateur. Pour
cela, un administrateur doit se rendre dans <span class="pwgScreen">Administration &raquo; Images &raquo; En attente &raquo; Images</span> afin d'accepter ou de rejeter les photos proposées.</p>
</div> <!-- upload_content -->
</div> <!-- instructionUpload -->
<div id="instructionCategoryLinks" class="instructionBlock">
<div
id="categoryLinks_header"
class="instructionBlockHeaderCollapsed"
onclick="blockToggleDisplay('categoryLinks_header', 'categoryLinks_content')"
><span>
Liens entre les photos et les catégories, catégories virtuelles
</span></div>
<div
id="categoryLinks_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Les photos sont affichées dans les catégories correspondant aux répertoires.</li>
<li>Vous pouvez également afficher une photo dans plusieurs catégories, sans dupliquer le fichier sur votre serveur web. Associez la photo à n'importe quelle autre catégorie depuis l'écran d'édition de la photo (auquel vous accéder depuis la page de visualisation de la photo côté galerie, lorsque vous êtes connecté en tant qu'administrateur)</li>
<li>Les catégories virtuelles partent de ce principe : elles n'ont pas de répertoire associé. Créez des catégories virtuelles depuis <span class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer</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>
Informations diverses
</span></div>
<div
id="misc_content"
class="instructionBlockContent"
style="display:none"
>
<ul>
<li>Une fois votre galerie créée, configurez l'affichage par
défaut tel que désiré dans <span class="pwgScreen">Administation &raquo; Configuration &raquo; Affichage par défaut</span>. En effet, chaque nouvel
utilisateur héritera de ces propriétés d'affichage.</li>
<li>Pour tout question, la communauté francophone Piwigo est à l'écoute sur le <a href="http://fr.piwigo.org/forum">forum</a>.</li>
</ul>
</div> <!-- misc_content -->
</div> <!-- instructionMisc -->
</div>

32
language/fr_FR/help/help_add_photos.html Normal file
View File

@@ -0,0 +1,32 @@
<p>Plusieurs méthodes existent pour ajouter des photos dans votre
galerie :</p>
<ul>
<li><strong>L'ajout direct</strong> dans votre navigateur web. C'est la
méthode la plus simple et la plus immédiate. Elle dépend des capacités de
votre navigateur et de votre serveur. Pour des gros volumes ou en cas de
problèmes, les méthodes alternatives vous attendent !</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=direct">Utiliser l'ajout direct</a></p>
<ul>
<li><strong>pLoader</strong> est un client à installer sur votre
ordinateur. Glissez vos photos dans la fenêtre de pLoader, cliquez
sur <em>"Transférer vers Piwigo"</em> et pLoader s'occupe du reste. Il
existe d'autres clients comme <strong>WinToPiwigo</strong> ou le plugin
d'export Piwigo dans <strong>Digikam</strong>.</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=ploader">Utiliser pLoader</a></p>
<ul>
<li><strong>Le transfert FTP</strong>
est la méthode idéale pour ajouter une collection importante en un minimum
d'opérations. Suivez le guide pour préparer vos photos. Cette méthode vous
permet de controller avec précision l'organisation physique de vos photos
sur votre serveur.</li>
</ul>
<p class="nextStepLink"><a href="admin.php?page=photos_add&section=ftp">Utiliser FTP</a></p>

9
language/fr_FR/help/help_groups.html Normal file
View File

@@ -0,0 +1,9 @@
<p>Les groupes d'utilisateurs permettent d'assigner des permissions à une liste d'utilisateurs.</p>
<p>Vous pouvez créer des groupes et y ajouter des utilisateurs dans la
<span class="pwgScreen">Administration &raquo; Utilisateurs &raquo; Groupes</span>.</p>
<p>Un utilisateur peut appartenir à plusieurs groupes. L'autorisation est
plus forte que l'interdiction : si l'utilisateur "pierre" appartient aux
groupes "famille" et "amis", et que seul le groupe "famille" peut visiter la
catégorie "Noël 2003", alors "pierre" peut visiter cette catégorie.</p>

5
language/fr_FR/help/help_misc.html Normal file
View File

@@ -0,0 +1,5 @@
<p>Une fois votre galerie créée, configurez l'affichage par
défaut tel que désiré dans <span class="pwgScreen">Administation &raquo; Configuration &raquo; Affichage par défaut</span>. En effet, chaque nouvel
utilisateur héritera de ces propriétés d'affichage.</p>
<p>Pour tout question, la communauté francophone Piwigo est à l'écoute sur le <a href="http://fr.piwigo.org/forum">forum</a>.</p>

15
language/fr_FR/help/help_permissions.html Normal file
View File

@@ -0,0 +1,15 @@
<p>Vous pouvez interdire l'accès aux catégories. Passez le type d'accès à "privé" si vous souhaitez gérer les permissions.</p>
<p>Vous pouvez rendre une catégorie privée en l'éditant (<span
class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer &raquo; Editer</span>) ou en
gérant les options pour votre arbre complet des catégories (<span
class="pwgScreen">Administration &raquo; Catégories &raquo; Propriétés &raquo; Publique/Privée</span>).</p>
<p>Une fois que certaines catégories sont privées, vous pouvez gérer les
permissions avec 3 écrans :</p>
<ul>
<li><span class="pwgScreen">Administration &raquo; Utilisateurs &raquo; Gérer &raquo; action Permissions</span> (1 lien par utilisateur)</li>
<li><span class="pwgScreen">Administration &raquo; Utilisateurs &raquo; Groupes &raquo; action Permissions</span> (1 lien par groupe)</li>
<li><span class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer &raquo; Modifier les permissions</span> (1 lien par catégorie)</li>
</ul>

15
language/fr_FR/help/help_user_upload.html Normal file
View File

@@ -0,0 +1,15 @@
<p>Vos utilisateurs peuvent également ajouter leurs photos.</p>
<ol>
<li>Autorisez l'ajout d'images sur une ou plusieurs catégories (<span
class="pwgScreen">Administation &raquo; Catégories &raquo; Gestion &raquo; Edit</span> ou <span
class="pwgScreen">Administration &raquo; Catégories &raquo; Propriétés &raquo; Ajout d'images</span>). Les catégories virtuelles ne permettent pas l'ajout d'images.</li>
<li>donner les droits en écriture (pour tous les utilisateurs) sur les
répertoires correspondant aux catégories qui sont autorisées à l'ajout.</li>
</ol>
<p>Les photos ajoutées par les utilisateurs ne sont pas directement
visibles sur le site, ils doivent être validés par un administrateur. Pour
cela, un administrateur doit se rendre dans <span class="pwgScreen">Administration &raquo; Photos &raquo; En attente</span> afin d'accepter ou de rejeter les photos proposées.</p>

5
language/fr_FR/help/help_virtual_links.html Normal file
View File

@@ -0,0 +1,5 @@
<p>Les photos sont affichées dans les catégories correspondant aux répertoires.</p>
<p>Vous pouvez également afficher une photo dans plusieurs catégories, sans dupliquer le fichier sur votre serveur web. Associez la photo à n'importe quelle autre catégorie depuis l'écran d'édition de la photo (auquel vous accéder depuis la page de visualisation de la photo côté galerie, lorsque vous êtes connecté en tant qu'administrateur)</p>
<p>Les catégories virtuelles partent de ce principe : elles n'ont pas de répertoire associé. Créez des catégories virtuelles depuis <span class="pwgScreen">Administration &raquo; Catégories &raquo; Gérer</span>.</p>

141
language/fr_FR/help/photos_add_ftp.html Normal file
View File

@@ -0,0 +1,141 @@
<fieldset>
<legend>Démarrage rapide</legend>
<ol>
<li>Créez un répertoire sur votre ordinateur.</li>
<li>Copiez des photos à l'intérieur de ce répertoire, puis redimensionnez les pour un affichage sur le web. <em>Attention</em> : le nom des répertoires et des fichiers ne doit contenir que des lettres, des chiffres et les caractères "-", "_" or ".". Pas d'espace ou de caractères accentués.</li>
<li>Avec un client FTP, copiez le répertoire dans le répertoire "galleries" de votre installation de Piwigo.</li>
<li>Connectez vous à votre installation de Piwigo et rendez vous sur <span class="pwgScreen">Administration &raquo; Images &raquo; Miniatures</span> pour créer les miniatures manquantes.</li>
<li>Rendez vous sur <span class="pwgScreen">Administration</span> et cliquez sur le gros bouton de synchronisation.</li>
</ol>
<p>Bravo ! Vous avez créé avec succès la première catégorie de votre galerie.</p>
</fieldset>
<fieldset>
<legend>Organisation des répertoires et des fichiers</legend>
<ul>
<li>
<p>Les répertoires représentant les catégories sont dans le répertoire
"galleries". Ci-dessous l'arbre des répertoires d'une très petite galerie
(mais utilisant de nombreuses fonctionnalités) : </p>
<pre>
.
|-- admin
|-- doc
|-- galleries
| |-- categorie-1
| | |-- categorie-1.1
| | | |-- categorie-1.1.1
| | | | |-- categorie-1.1.1.1
| | | | | |-- pwg_high
| | | | | | +-- mariage.jpg
| | | | | |-- thumbnail
| | | | | | +-- TN-mariage.jpg
| | | | | +-- mariage.jpg
| | | | +-- categorie-1.1.1.2
| | | +-- categorie-1.1.2
| | |-- categorie-1.2
| | | |-- pookie.jpg
| | | +-- thumbnail
| | | +-- TN-pookie.jpg
| | +-- categorie-1.3
| +-- categorie-2
| |-- porcinet.gif
| |-- pwg_representative
| | +-- video.jpg
| |-- thumbnail
| | +-- TN-porcinet.jpg
| +-- video.avi
|-- include
|-- install
|-- language
|-- template
+-- tool</pre>
</li>
<li>Fondamentalement, une catégorie est représentée par un répertoire à
n'importe quel niveau sous le répertoire "galleries" de votre installation
de Piwigo. Chaque catégorie peut contenir autant de sous-niveaux que
désiré. Dans l'exemple ci-dessus, categorie-1.1.1.1 est à un niveau 4 de
profondeur.</li>
<li>Fondamentalement, un élément est représenté par un fichier. Un fichier
peut être un élément pour Piwigo si l'extension du nom du fichier est
parmi la liste du paramètre de configuration <code>file_ext</code> (voir
fichier <span class="filename">include/config.inc.php</span>). Un fichier
peut être une image si son extension est parmi le paramètre de configuration
<code>picture_ext</code>.</li>
<li>Les éléments de type image doivent avoir une miniature associée (voir la
section suivante à propos des miniatures).</li>
<li>Les éléments de type image peuvent avoir un image en grand format
associé. Comme pour le fichier <span class="filename">mariage.jpg</span>
dans l'exemple ci-dessus. Aucun préfixe n'est nécessaire sur le nom du
fichier.</li>
<li>Les éléments non image (vidéos, sons, fichiers texte, tout ce que vous
voulez...) sont par défaut représentés par un icône correspondant à
l'extension du nom du fichier. Optionnellement, une miniature et un
représentant peuvent être associés (voir le fichier <span
class="filename">video.avi</span> dans l'exemple).</li>
<li><em>Attention</em> : le nom d'un répertoire ou d'un fichier ne doit
être composé que de lettres, de chiffres, de "-", "_" ou ".". Pas d'espace
ou de caractères accentués.</li>
<li><em>Conseil</em> : une catégorie peut contenir des éléments et des
sous-catégories à la fois. Néanmoins, il est fortement conseillé pour chaque
catégorie de choisir entre contenir des éléments <strong>ou bien</strong>
des sous-catégories.</li>
<li>Une fois que les fichiers, les miniatures et les représentants sont
correctement placés dans les répertoires, se rendre sur l'écran <span
class="pwgScreen">Administration &raquo; Catégories &raquo; Synchroniser</span>.</li>
</ul>
</fieldset>
<fieldset>
<legend>Miniatures</legend>
<ul>
<li>Comme mentionné précédemment, chaque élément de type image doit être
associé à une miniature.</li>
<li>Les miniatures sont stockées dans le sous-répertoire "thumbnail" de
chaque répertoire représentant une catégorie. Une miniature est un fichier
de type image (même extension du nom du fichier) dont le nom de fichier est
préfixé par le paramètre de configuration <code>prefix_thumbnail</code>
(voir <span class="filename">include/config.inc.php</span>).</li>
<li>Les miniatures n'ont pas besoin d'avoir la même extension que leur
image associée (une image avec ".jpg" comme extension peut avoir une
miniature en ".GIF" par exemple).</li>
<li>Il est conseillé d'utiliser un outil externe pour la création des
miniatures.</li>
<li>Vous pouvez également utiliser l'outil de création de miniature
intégré à Piwigo mais cela est déconseillé car la qualité risque
d'être décevante et cela utilise inutilement les ressources du serveur (ce
qui peut être un grave problème sur un serveur mutualisé).</li>
<li>Si vous choisissez d'utiliser le serveur web pour générer les
miniatures, vous devez donner les droits en écriture sur les
répertoires.</li>
</fieldset>