Changeset 3010 for branches


Ignore:
Timestamp:
Dec 22, 2008, 1:31:28 AM (15 years ago)
Author:
plg
Message:

modification: strongly updated admin>instructions content

bug fixed: CSS class pwgScreen had disappeared (even in Piwigo 1.6)

Location:
branches/2.0
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • branches/2.0/admin/template/goto/theme/roma/theme.css

    r3009 r3010  
    5050
    5151.instructions { text-align:left;}
     52.instructions LI { margin-bottom:5px; }
    5253.instructionBlock {border: 1px solid #666; margin: 5px; overflow: hidden;}
    5354.instructionBlockHeaderCollapsed, .instructionBlockHeaderExpanded {font-size:110%; cursor: pointer; overflow: hidden; background-repeat: no-repeat; background-position: left center; padding-left: 20px; background-color: #111; padding: 5px 20px; color: #ff3363;}
    … …  
    5556.instructionBlockHeaderExpanded { background-image: url(../../icon/collapse.png);}
    5657.instructionBlockContent { padding:5px;}
     58SPAN.pwgScreen { font-style:italic; border-bottom:1px dotted #666}
    5759
    5860.content ul.thumbnails span.wrap2:hover { background-color:#111; border:1px solid #FF3363; color:#666; }

  • branches/2.0/language/en_UK/help.html

    r3009 r3010  
    22<h2>Help</h2>
    33
    4 <div id="instructionQuickStart" class="instructionBlock">
    5   <div
    6     id="quickStart_header"
    7     class="instructionBlockHeaderCollapsed"
    8     onclick="blockToggleDisplay('quickStart_header', 'quickStart_content')"
    9   >
    10     Quick Start
    11   </div>
    12   <div
    13     id="quickStart_content"
    14     class="instructionBlockContent"
    15     style="display:none"
    16   >
     4<div id="instructionPLoader" class="instructionBlock">
     5  <div
     6    id="pLoader_header"
     7    class="instructionBlockHeaderCollapsed"
     8    onclick="blockToggleDisplay('pLoader_header', 'pLoader_content')"
     9  >
     10    Add photos, the pLoader way
     11  </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  >
     35    Add photos, the FTP way
     36  </div>
     37  <div
     38    id="FTP_content"
     39    class="instructionBlockContent"
     40    style="display:none"
     41  >
     42
     43<h3>Quick Start</h3>
     44
    1745<ol>
    18  
    19   <li>Create a local directory "test_category".</li>
    20 
    21   <li>Copy pictures in "test_category".</li>
    22 
    23   <li>Open an FTP connection to this remote gallery.</li>
    24 
    25   <li>Upload local directory "test_category" into your remote directory
    26   names "galleries". Set authorizations to 777 on directory
    27   "galleries/test_category".</li>
    28 
    29   <li>Connect to your Piwigo as an admin.</li>
    30 
    31   <li>Go to <span class="pwgScreen">Administration, Pictures,
    32   Thumbnails</span>. Piwigo find the picture from "test_category"
    33   without thumbnails. Ask to create thumbnails.</li>
    34 
    35   <li>Go to <span class="pwgScreen">Administration, Categories,
    36   Synchronize</span>. Check "directories + files" option, uncheck "only
    37   perform a simulation" and submit the synchronization.</li>
    38 
    39   <li>Job's done. You've created a category "test_category" at the root of
    40 your gallery.</li>
    41  
     46  <li>Create a directory on your computer.</li> 
     47
     48  <li>Copy some photos inside this directory, resize them for web display.</li>
     49
     50  <li>With a FTP client, copy your directory in the "gallerie" directory of your Piwigo installation.</li>
     51
     52  <li>Logon your gallery and go to <span class="pwgScreen">Administration, Pictures, Thumbnails</span> to create missing thumbnails.</li>
     53
     54  <li>Go to <span class="pwgScreen">Administration, Links, Administration</span> and click on the big Synchronization button.</li>
    4255</ol>
    43   </div> <!-- quickStart_content -->
    44 </div> <!-- instructionQuickStart -->
    45 
    46 <div id="instructionAddPhotos" class="instructionBlock">
    47   <div
    48     id="addPhotos_header"
    49     class="instructionBlockHeaderCollapsed"
    50     onclick="blockToggleDisplay('addPhotos_header', 'addPhotos_content')"
    51   >
    52     Adding elements
    53   </div>
    54   <div
    55     id="addPhotos_content"
    56     class="instructionBlockContent"
    57     style="display:none"
    58   >
     56
     57Congratulations! You have successfuly created the first category of your photo gallery.
     58
     59<h3>Directories and files organization</h3>
    5960<ul>
    6061
    … …  
    6263
    6364    <p>Category directories are in the Piwigo directory
    64     "galleries". Here follow the directory tree of a very small gallery (but
     65    "galleries". Here follows the directory tree of a very small gallery (but
    6566    using many features) :</p>
    6667
    … …  
    101102  </li>
    102103 
    103   <li>Basically, a category is represented by a directory at any level in
    104   Piwigo directory "galleries". Each category can contain as many
    105   sub-level as you wish. In the example above, category-1.1.1.1 is at level
    106   4 of deepness.</li>
     104  <li>Each directory under "galleries" produces a category. There is no limit on deepness.</li>
    107105
    108106  <li>Basically, an element is represented by a file. A file can be a
    … …  
    117115
    118116  <li>Picture elements can have a high quality file associated. As for
    119   wedding.jpgin the example above. No prefix on the high quality picture is
    120   required.</li>
     117  wedding.jpg in the example above. No prefix on the high quality picture.</li>
    121118
    122119  <li>Non picture elements (video, sounds, file texts, what you want...) are
    … …  
    129126characters</li>
    130127
    131   <li><em>Advise</em> : a category can contain elements and sub-categories
    132 in the same time. Nerverthless, you are strongly advised for each category
    133 to choose between category containing elements <strong>or</strong> category
    134 containing sub-categories.</li>
    135 
    136128  <li>Once files, thumbnails and representatives are correctly placed in the
    137129  directories, go to : <span class="pwgScreen">Administration, Categories,
    … …  
    139131
    140132</ul>
    141   </div> <!-- addPhotos_content -->
    142 </div> <!-- instructionAddPhotos -->
    143 
    144 <div id="instructionThumbnails" class="instructionBlock">
    145   <div
    146     id="thumbnails_header"
    147     class="instructionBlockHeaderCollapsed"
    148     onclick="blockToggleDisplay('thumbnails_header', 'thumbnails_content')"
    149   >
    150     Thumbnails
    151   </div>
    152   <div
    153     id="thumbnails_content"
    154     class="instructionBlockContent"
    155     style="display:none"
    156   >
    157 <ul>
    158 
    159   <li>As said earlier, each element of picture type must be associated with
    160   a thumbnail.</li>
     133
     134<h3>Thumbnails</h3>
     135<ul>
     136
     137  <li>Each photo must have its thumbnail.</li>
    161138
    162139  <li>Thumbnails are stored in the sub-directory "thumbnail" of the category
    163   directory. The thumbnail is a picture (same filename extensions possible
    164   than picture files) which filename is prefixed by the configured
    165   "Thumbnail prefix" (see admin panel, Configuration, General).</li>
    166 
    167   <li>Thumbnails don't need to have the same extension as their associated
    168   picture (a picture with .jpg extension can have a thumbnail in .GIF
    169   extention for instance).</li>
    170 
    171   <li>Advise: use an external module for thumbnails creation.</li>
    172 
    173   <li>You can also use the thumbnail creation page (<span
    174   class="pwgScreen">Administration, Pictures, Thumbnails</span>), but it is
    175   not recommended. Indeed, thumbnail quality may be poor and it uses a high
    176   CPU load which can be a problem if you use free web hosting.</li>
    177 
    178   <li>If you choose to use your hosting provider to create thumbnails, you
    179   must give write rights on all category directories and sub-directories
    180   "thumbnail" for ugo (user, group, other).</li>
    181 
    182 </ul>
    183   </div> <!-- thumbnails_content -->
    184 </div> <!-- instructionThumbnails -->
     140  directory. The thumbnail has the same filename as the corresponding photo, with <em>TN-</em> as prefix.</li>
     141
     142  <li><em>Advise</em>: use an external module for thumbnails creation.</li>
     143
     144  <li>Even if it is not recommended (image quality, web server resource load), you can use <span
     145  class="pwgScreen">Administration, Pictures, Thumbnails</span> page to create thumbnails.</li>
     146
     147  <li>Give write access on all category directories.</li>
     148
     149</ul>
     150
     151  </div> <!-- FTP_content -->
     152</div> <!-- instructionFTP -->
    185153
    186154<div id="instructionPermissions" class="instructionBlock">
    … …  
    199167<ul>
    200168
    201   <li>You can forbid access to categories. Categories can be "public" or
    202   "private". Permissions (for groups and users) can be set only if the
    203   category is private.</li>
     169  <li>You can forbid access to categories. Switch the category access type to "private" if you want to manage permissions.</li>
    204170
    205171  <li>You can set a category to private by editing a single category (<span
    … …  
    211177
    212178    <p>Once the category is private, you can manage permissions for groups
    213     and users through 3 screens :</p>
     179    and users with 3 screens:</p>
    214180
    215181    <ul>
    216182
    217183      <li><span class="pwgScreen">Administration, Identification, Users,
    218       permissions action (one link per user)</span></li>
     184      permissions action</span> (one link per user)</li>
    219185
    220186      <li><span class="pwgScreen">Administration, Identification, Groups,
    221       permissions action (one link per group)</span></li>
     187      permissions action</span> (one link per group)</li>
    222188
    223189      <li><span class="pwgScreen">Administration, Categories, Manage, edit
    224       category permissions action (one link per category)</span></li>
     190      category permissions action</span> (one link per category)</li>
    225191
    226192    </ul>
    … …  
    247213<ul>
    248214
    249   <li>Piwigo is able to manage groups of users. It can be very useful
    250   to have common permission access for private categories.</li>
    251 
    252   <li>You can create groups in <span class="pwgScreen">Administration,
     215  <li>Groups is a convenient way to set permissions for a list of users.</li>
     216
     217  <li>Create groups in <span class="pwgScreen">Administration,
    253218  Identification, Groups</span> and associate users to this group in <span
    254219  class="pwgScreen">Administration, Identication, Users</span>.</li>
    255220
    256   <li>A user can belong to several groups. The authorization is stronger
    257   than prohibition : if user "jack" belongs to groups "family" and
    258   "friends", and that only group "family" can see category "Christmas 2003",
     221  <li>A user can belong to several groups. Authorization is stronger
     222  than forbiddance : if user "jack" belongs to groups "family" and
     223  "friends", and that only group "family" can see category "Christmas 2003" category then
    259224  "jack" will be able to see "Christmas 2003".</li>
    260225
    … …  
    276241    style="display:none"
    277242  >
    278 <p>Piwigo offers the possibility for users to upload images. in
    279 order to do it:</p>
     243<p>Users can upload their photos too.</p>
    280244
    281245<ol>
    282246
    283   <li>authorize upload on any categories (<span
     247  <li>Authorize upload on any categories (<span
    284248  class="pwgScreen">Administration, Categories, Manage, edit</span> or <span
    285   class="pwgScreen">Administration panel, Categories, Properties, Upload</span>)</li>
    286 
    287   <li>give write rights on directories for ugo (user, group, other)</li>
     249  class="pwgScreen">Administration, Categories, Properties, Upload</span>).</li>
     250
     251  <li>Give write access on corresponding directories.</li>
    288252
    289253</ol>
    290254
    291 <p>Files uploaded by users are not directly visible on the website, they
    292 must be validated by an administrator. For that purpose, an administrator
    293 must go in <span class="pwgScreen">Administration, Pictures, Waiting</span>
    294 in order to validate or to refuse the files proposed, then to synchronize
    295 filesystem with database.</p>
     255<p>Photos uploaded by users are not directly visible on the website. An administrator
     256must validate uploaded photos in <span class="pwgScreen">Administration, Pictures, Waiting</span>
     257screen and launch a synchronization process.</p>
    296258  </div> <!-- upload_content -->
    297259</div> <!-- instructionUpload -->
    … …  
    312274<ul>
    313275
    314   <li>Piwigo dissociates categories where elements are stored and
    315   categories where they are shown.</li>
    316 
    317   <li>By default, elements are shown only in their real categories : the
    318   ones corresponding to directories on the web server.</li>
    319 
    320   <li>To link an element to a category, you just have to make the
    321   association on the page of element edition (link to this screen on
    322   picture.php logged as an administrator) or on the informations of all
    323   elements of a category.</li>
    324 
    325   <li>Using this principle, it is possible to create virtual categories : no
    326   directory coresponds to this category. You can create virtual categories
    327   in <span class="pwgScreen">Administration, Categories, Manage</span>.</li>
     276  <li>Photos are displayed in the category corresponding to the file directory.</li>
     277
     278  <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>
     279
     280  <li>Virtual categories are based on this concept: they have no corresponding directory. Create virtual categories from <span class="pwgScreen">Administration, Categories, Manage</span>.</li>
    328281
    329282</ul>
    … …  
    347300
    348301  <li>As soon as you created your gallery, modify default display properties
    349   in <span class="pwgScreen">Administration panel, Configuration,
    350   Default</span>. Indeed, every new registered user will have by default the
    351   same display properties.</li>
    352 
    353   <li>If you have any question, do not hesitate to take a look at the forum
    354   or ask a question there. The <a
    355   href="http://forum.phpwebgallery.net">forum</a> (message board) is
    356   available on the presentation site of Piwigo. Check the <a
    357   href="http://phpwebgallery.net/doc/">official Piwigo
    358   documentation</a> for further reading.</li>
     302  in <span class="pwgScreen">Administration, Configuration,
     303  Default</span>. Every new registered user will use these default configuration settings.</li>
     304
     305  <li>If you have any question, Piwigo community will welcome you on <a
     306  href="http://forum.phpwebgallery.net">its forum</a>.</li>
    359307
    360308</ul>
Note: See TracChangeset for help on using the changeset viewer.