donkeyGallery (v1.2.1)
donkeyGallery is an asynchronous ajax/php dynamic gallery with pagination and fancybox included, simple to install and use. With this tool you can create any galleries you want on the same site and on the same page.
Each gallery, once is configured, can be updated simply charging your new images on gallery dir.
To configure the gallery loading we provide a plugin that help you to create thumbnails, load images complitly dinamically and asynchronously. This makes your page loading faster!
Last Update
Version 1.2.1 -Bug fixed on jquery.donkeyGallery.packed.min.css
History
Version 1.1.1 - fluid style options added
Version 1.1.2 - two more style colors added: magenta and cyan
Version 1.2.0 - jQueryHDimg plugin added and responsive features added
Version 1.2.1 -Bug fixed on jquery.donkeyGallery.packed.min.css
Install and Use
In order to install donkeyGallery do the following steps:
- unzip the download pack on your local disk
- upload the directory "dnk-gallery" on your server, at the same level of your html page (when you want load some galleries)
- include dnk-gallery/css/jquery.donkeyGallery.packed.min.css on your html page;
- include jQuery on your html page;
- include dnk-gallery/js/jquery.donkeyGallery.packed.min.js on your html page;
- place one div for each gallery you want on your html page. Each div needs an univocal ID and must be leaved empty;
- charge your images on dnk-gallery/images/ and create one directory for each gallery you are charging;
- initialize and configure your galleries by javascript
Example of Javascript configuration
On the following code you can see all plugin options setted at the default values.
$(document).on('ready', function(){ $("#your-gallery-id").donkeyGallery({ webservice : "dnk-gallery/php/gallery.webservice.php", // link to php gallery file galleryPath : "dnk-gallery/images/your-gallery-dir/", // gallery dir path. This option must end with a slash subdomain: "", // this option is needed in case of a sub-dir installation (see below more information about this) style: "default", // this option define a gallery style color: "default", // this option define a style color // fluid style (included from v1.1.0) fluidStyle: { active : false, // fluid style activation columns: 4, // columns number for fluid grid (accepted 1,2,3,4,5,10) responsive: false, imgReplacement: false }, // thumbnails settings thumbs: { thumbW: 150, // thumb width thumbH: 150, // thumb height thumbsGen: false // force to generate thumb each time and not only if is nedeed }, // fancybox settings fancybox : { active: true, // fancybox activation galleryGroup: "donkeyGallery", // this option define a group for fancybox gallery view linkClass: "dnk-gallery-link" // this option define a class for the fancybox toggle click }, // pagination settings pagination: { active: true, // easy paginate activation pageItems: 4 // this option define the items showed on each gallery page } }); });
Minimal Configuration example
$(document).on('ready', function(){ $("#your-gallery-id").donkeyGallery({ galleryPath : "dnk-gallery/images/your-gallery-dir/", // gallery path must end with a slash style: "squared", color: "gray", fancybox : { active: true, galleryGroup: "gallery-1", }, pagination: { active: false } }); });
Styles and Colors
On gallery plugin configuration you can use the following styles and colors:
- STYLES: squared - tin-squared - circle
- COLORS: white - black - gray - magenta - cyan
Installation on sub-dir
If you install donkeyGallery on a sub-dir of your site root, you need to specify the path of subdir (relative at site root), using the plugin option subdir : "/here/your/subdir/path/"
Helper Plugins
donkeyGallery uses two third party plugins: Fancybox 2.1.5 and Easy Paginate 1.0
License Caveat
donkeyGallery license is valid only for gallery code and not for the helper plugins included. To use donkeyGallery on commercial products, check the plugin licenses on their official sites.
HomePage
See more complete documentation and live examples at http://factory.brainleaf.eu/donkeyGallery/