[Php-blog-plugin-cvs] additional_plugins/serendipity_event_imageselectorplus/UTF-8 documentation_cs.html, NONE, 1.1 documentation_cz.html, NONE, 1.1 documentation_en.html, NONE, 1.1 lang_cs.inc.php, NONE, 1.1 lang_cz.inc.php, NONE, 1.1

[Garvin H. <gar...@us...>]

Update of /cvsroot/php-blog/additional_plugins/serendipity_event_imageselectorplus/UTF-8
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27740/UTF-8

Added Files:
	documentation_cs.html documentation_cz.html 
	documentation_en.html lang_cs.inc.php lang_cz.inc.php 
Log Message:
Update by Vladimir Ajgl:
- Add documentation
- Add czech translation
- Add ability to post XML code into entries for displaying galleries



--- NEW FILE: documentation_en.html ---
<h1>Serendipity ImageSelectorPlus Plugin Documentation</h1>

<h2>General description</h2>
<p>
    ImageSelectorPlus plugin is used to facilitate manipulation with images, especially their insertion into posts.
</p>

<h2>QuickBlog</h2>
<p>
When uploading an image, you can post it directly. Follow the instructions above the QuickBlog form. 
</p>

<h3>Modifying the design of QuickBlog post</h3>
<p>
    Plugin uses template file "plugin_quickblog.tpl" to display the inserted pictures. So by modifying it, you can change the design of displayed images.</p>
    <p>Information about pictures is stored in an array {$quickblog} which has several parts you can use in your template:
    <ul>
        <li>fullimage - path and filename to the big image</li>
        <li>image - path and filename to the thumbnail</li>
        <li>body - the body of the post</li>
        <li>exif_mode - type of exif information extraction ('internal', 'jhead', 'none'</li>
        <li>exif - field of exif information, pleasu use the exif specifications to see the field values - use them like eq. $quickblog.exif.COMMENT or $quickblog.exif.Focal_length</li>
    </ul>
</p>


<h2>Multiple image insertions</h2>
<p>
Another functionality of this plugin is multiple image insertion. If you write an xml structure in your entry, this plugin then replaces this xml structure by pictures from your media library.
</p>

<h3>When is it useful?</h3>
<p>
    When you write a blog, where you want to include many pictures in your entries. When you have fifty images and these images numbered in an ascending row, it is lengthy to insert them one by one through the images selector. With this plugin, you can insert all of them using on a single line. 
</p>

<h3>Examples</h3>
    <h4>Example 1 - including parts of gallery</h4>
    <code><pre>
        &lt;mediainsert&gt;
            &lt;gallery name="MyHolidays/" /&gt;
            &lt;media type="single" name="pict0034" /&gt;
            &lt;media type="single" name="pict0032" /&gt;
            &lt;media type="range" prefix="pict00" start="35" stop="52" /&gt;
        &lt;/mediainsert&gt;
    </pre></code>
    <p>
        This example inserts from the directory "MyHolidays" picture "pict0034", then picture "pict0032" and then all pictures from "pict0035" to "pict0052".
        <ul>
        Plugin features:
        <li>It shows only picturse which are in the database. So if pictures 44,45,48 and 50 does not exist, the plugin will not fail. Simply it will not display the non-existing pictures.</li>
        <li>It respects order of pictures, so 34 will be displayed before 32.</li>
        </ul>
    </p>

    <h4>Example 2 - including whole gallery at once</h4>
    <code><pre>
        &lt;mediainsert&gt;
            &lt;gallery name="MyHolidays/" /&gt;
            &lt;media type="gallery" /&gt;
        &lt;/mediainsert&gt;
    </pre></code>
      
<h3>Important</h3>
<p>The plugin is sensitive to bad xml syntax. So if it is not perfect, for example if you ommit ending backslash in the media tag, it can cause fail to your whole blog!!!</p>

<h3>Review of xml tags</h3>
<dl>
    <dt>&lt;mediainsert&gt;</dt>
    <dd>general container of media insertion</dd>

    <dt>&lt;gallery&gt;</dt>
    <dd>from which gallery to choose the images, attribute name gives the path (prom the directory uploads/ - without the first backslash and WITH the final backslash - "MyHolidays" or "/MyHolidays/" is false. Right is "MyHolidays/".)</dd>

    <dt>&lt;media&gt;</dt>
    <dd>Defines which media to insert, first attribute is "type" and it can have next values:
        <ul>
            <li>"single" - includes single image given by attribute "name"</li>
            <li>"gallery" - without other attributes, includes all images in gallery</li>
            <li>"range" - includes numbered images from "prefix""start" to "prefix""stop" (see example1)</li>
        </ul>
    </dd>
</dl>

<h3>Modifying the design of inserted galleries</h3>
<p>
    Plugin uses template file "plugin_mediainsert.tpl" to display the inserted pictures. So by modifying it, you can change the design of displayed images.</p>
    <p>Information about pictures is stored in an array {$plugin_mediainsert_media} which has these parts you can use in your template:
    <ul>
        <li>name - name of picture (filename without extension)</li>
        <li>extension - extension of filename</li>
        <li>realname - filename, the same as {$name}.{$extension}</li>
        <li>thumbnail_name - you can get the thumbnail name by {$name}.{$thumbnail_name}.{$extension}</li>
        <li>path - the same value as you provide in gallery tag</li>
        <li>comment1 - comment from database</li>
        <li>width - width of original image</li>
        <li>height - height of original image</li>
        <li>thumbwidth - width of thumbnail</li>
        <li>thumbheight - height of thumbnail</li>
    </ul>
</p>

<h3>Author</h3>
<p>Vladimír Ajgl (vlada [at] ajgl [dot] cz), Czech Republic, 2007-11-19
</p>

--- NEW FILE: documentation_cz.html ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: documentation_cs.html ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: lang_cs.inc.php ---
(This appears to be a binary file; contents omitted.)

--- NEW FILE: lang_cz.inc.php ---
(This appears to be a binary file; contents omitted.)