Presentation

Principe
The objective of the GalleryInsert plugin is to allow users to easily insert picture galleriez inside a post.
Tag
The plugin uses a system of tags which are replaced by the corresponding gallery while the post is saved. The simpliest tag is "::gallery dir='toto'::". This tag will display inside the post a gallery of pictures wich are inside the "toto" directory under the shape of linked thumbnails.
The tag can be different in function of the things to be display and of the shapes you want to display them. For example, to display the pictures "img1.jpg" and "img4.jpg" which are inside the directory "toto" the tag is written like this "::gallery imgurl='toto;img1.jpg;img4.jpg'::"
Insertion interface
After plugin installation an icon is displayed in the post edition bar (). A clic on this icon made appears an insertion window which allow to generate tag and insert it into the current post.

After selected the directory you can select pictures to display or you can select the whole directiry. You can also choose different options to be used.

Size options

Displayed sizes
To select the size of the displayed picture the option is thumb='xx'. Where xx can take different values :
To select the size of the picture linked the option is linkto='xx'. Where xx can take different values :
Example, to display the directory "toto" in medium size without link : ::gallery dir='toto' thumb='m' linkto='none'::

Jquery scripts

Display with divbox
The GalleryInsert plugin includes the jquery divbox module (http://jquery.phpbasic.com/divbox) wich allow to zoom on a picture but also to display every media type (mp3, flv, ...). By activating the option into the administrator interface it allows to zoom on pictures like a lightbox effect but also to explore all your multimedia files!
Note that this option is not activated by default and if you activate it you will have to regenerate the already published post. To do this you nloy have to open the post and save it once more.
Divbox example :
Display with carousel
The jquery jcarousel module (http://sorgalla.com/jcarousel/) has been replaced by the tosrus jquery module (http://tosrus.frebsite.nl) which allow to display the pictures list under carousel format. It also allow to display the icon of media files if the divbox option is activated. By default galleries are not displayed under the carousel format : you firstly have to activate the "carousel" option into the administration interface and then to add the "carousel" option in the gallery tag (example "::gallery dir='toto' carousel::")
Carousel example :
Display with "galleria"
The GalleryInsert plugin includes the jquery galleria module (http://galleria.aino.se/) which allows to display pictures under a better gallery shape. By default galleries are not displayed under the "galleria" format : you firstly have to activate the "galleria" option into the administration interface and then to add the "galleria" option in the gallery tag (example "::gallery dir='toto' caroussel::"). Notice that the size of the galleria and thumbnails can now be changed in the plugin options.
Galleria example :

Pictures metadatas

Pictures metadatas
It is possible to automatically integrate pictures metadatas. For this you have to specify the "showmeta" option in the gallery tag (example : "::gallery dir='toto' showmeta::"). Then, at the construction ofd the gallery the plugin will automatically detect pictures metadata and add them after the picture title. The shape of the metadata display is defined by the metadata string which can be modified in the administration options.
Example of pictures metadatas :
The default string for metadata display is : [%FocalLength% - %FNumber% - %Exposure% - ISO:%ISOSpeedRatings%]. Possible insertions are :

Others

Gallery xhtml code génération
In order to be more efficient the xhtml code of a gallery is not generated at each post display but only once at the post saving. Then when the post is dieplayed the gallery code is directly available. The disadvantage of this method is that the gallery is not fully dynamic : the gallery code must be generated again if the media directory as changed, if you modify some options or if the plugin is updated.
For example if you have created a gallery with the carousel option, but if after you disactivate the carousel option into the administration panel then the gallery will not be displayed well because it will be trying to use no more accessible jquery script. To solve the problem you hav to open the post and just save it one more time.
Autoupdate gallery in posts
In the administration panel you have the list of posts that contains a gallery. This list allows you to quickly access to your galleries, but it also allows you to generate all xhtml galleries codes with one click. But be careful, even if this function has been tested we cannot warranty that it should not cause some problems in your blog. For this reason we recommend that you save your blog database before the first use of this function.
Thumbnail display
You can modify ths display style of thumbnails via the moreCSS plugin or directly in the current theme styls.css (example : #galleryinsert_tn { border: 1px solid black; margin: 0px 3px 0px 0px; }).