=== GB Gallery Slideshow === Contributors: Gb-plugins Donate link: http://gb-plugins.com/ Tags: gallery, slideshow, image, photo, link, custom post, widget, ajax, jquery ui, admin, special effects, album. Requires at least: 3.5 Tested up to: 3.7 Stable tag: 1.5 License: GPLv2 License URI: http://www.gnu.org/licenses/gpl-2.0.html GB gallery is an awesome new type of gallery slideshow. It is an easy to use, innovative plugin that allows you to create your own effects. == Description == GB Gallery is an awesome new type of gallery slideshow. It is the most innovative and original WordPress gallery plugin. We are the first and only gallery that allows you to choose, customize and design your own special effect. We also allow you to display images in a variety of sizes without changing the actual image. For more info, please visit our website [gb-plugins.com](http://gb-plugins.com/). = Post images = GB Gallery successfully displays any image from your WordPress media center or images you find on the web by pasting its full URL. The gallery creates a custom post type which contains a title, description, choose image option, attachment to album, index and an option to insert a special effect that can be customized or copied from the effect admin. There is also a check box for "active" or "non active" status and a "link to..." option that allows you to link the image to anywhere on the web by inserting the full URL. = Manage albums = GB centralized gallery management allows you to enjoy a single location where you can see and manage all your albums and effects. Create and organize groups and albums super-fast with no need to load unnecessary pages all thanks to the latest Ajax software technology. Comfortably display albums such as thumbnails and rearrange them by "drag and drop". You can add and delete as many albums as you want but no album can be registered more than once. The default "general group" can't be deleted but it can store all image posts from previously deleted albums. = Display slideshow = GB Gallery Slideshow allows you to display any album and choose from a wide variety of options to set up your perfect slideshow. You can display one or more slideshows on the same page or post, change the size of the displayed images without changing the actual image size, determine duration or transition time by milliseconds and set your own style by entering a "master class". You can also choose to display special effects. For your convenience there is a variety of special effect templates. Furthermore, you can choose a mini jquery UI general effect. Work with the widget or the shortcode. The GB Gallery Slideshow can be automatically or manually responsive to different media types. = Shortcode = In order to display the GB Gallery Slideshow in a post or a page, use the shortcode generator. Just copy-paste the shortcode to any post or page and the slideshow will appear in that post or page. Plese note: Some features introduced only in the premium version. == Installation == There are two ways to install GB Gallery Slideshow. 1. You can locate it on your WordPress dashboard-> Plugins -> Add New, search for "GB Gallery Slideshow" and click to install and activate the plugin. 2. You can download the [zip file](http://gb-plugins.com/wp-content/uploads/general/GBgallery.zip) and upload it from the WordPress dashboard -> Plugins -> Add New and click on the "Upload" link on top of the page. == Frequently Asked Questions == = General questions = 1. **How to install GB Gallery Slideshow in wordpress?** There are two ways to install GB Gallery Slideshow. You can locate it on your WordPress dashboard - just go to Plugins -> Add New, search for "GB Gallery Slideshow" and click to install. Or you can download the [zip file](http://gb-plugins.com/wp-content/uploads/general/GBgallery.zip) and upload it from the WordPress dashboard -> Plugins -> Add New and click on the "Upload" link on top of the page. 2. **What will happen to all my GB Gallery posts once I delete the plugin?** Once you delete the GB Gallery plugin all the plugin data will be deleted from your database. 3. **What are the gray areas on the GB Gallery dashboard?** The gray areas throughout the plugin represent the upgrades of the premium version. For more information about GB Gallery premium versions please visit [gb-plugins.com](http://gb-plugins.com/). = Post = 1. **How do I insert a new image post?** * On your wordpress dashboard navigate to "GB Gallery" -> "add image". * You may enter a title and a description. * Press the "select" btn to choose an image from your media or paste a full URL (http://www.site name.com/image name.jpg) * Choose the group to attach the image to. * Make shore the "active" checkbox is checked. * Press "publish" 2. **Is there an option to upload more than one image at a time?** GB Gallery Slideshow is a c.p.t. - custom post type gallery, therefore each image must have its own post for future moderation or development. 3. **What is the "special effect" text field in the post and how do I use it?** The "special effect" text field is designed for pasting a special effect matrix that is copied from the "special effect admin". * Navigate to "GBGallery admin" -> "special effect admin". * Choose the effect you want to copy. * Click the "copy effect" btn. An alert box will appear, copy the text box content (ctrl + C) and press "enter". * Navigate back to your post. * Paste (ctrl + V) the effect to the special effect text box. 4. **Do I have to edit my image size before uploading?** Yes, you need to adjust all image sizes to the recommended sizes. 5. **What are the recommended sizes for the images?** GB Gallery Slideshow works with 2 basic shapes. The ratio aspect of these shapes is 1.80:1 and 2.78:1. * Size options for 1.80:1 are: 900X500, 800X444, and 600X333. * Size options for 2.78:1 are: 900X324, 800X288, and 700X252. 6. **What happens if I don't follow the recommended aspect ratio of my images?** In that case you must find the closest size (Width and Height) to your images. If you don't find a matched size the image might be disproportioned. = Group Admin = 1. **How to create a new group?** On your wordpress dashboard navigate to "GBGallery admin" -> "group admin". * Press "add group" btn. * Type in the name for the new group. * Press the "save" btn. 2. **How to delete a group?** On your wordpress dashboard navigate to "GBGallery admin" -> "group admin". * Select the group you want to delete. * Press "delete group". 3. **How do I view a created group of images?** On your wordpress dashboard navigate to "GBGallery admin" -> "group admin". * Select the group you want to view. * Press "show group". = Special effect admin = 1. **How do I create my own special effect?** On your wordpress dashboard navigate to "GBGallery admin" -> "special effect admin" * Choose the group of the image and press "show group". * Click on the image you want to add effect to. * To add a new custom effect click on the matrix boxes in the order you want the image to appear. * Once you are done click "save" (You don't have to click on all the boxes, the slider will finish your effect automatically in a default pattern- from top left to bottom right) 2. **Can I save a created effect and use it again?** Yes, once you click the "save effect" btn, you can always come back to that image or post. * Click the "load effect" btn. * Copy and paste it in the post page (special effect text box). 3. **Can I change a saved effect?** No, you must delete the saved effect and create a new one. 4. **Can I edit a created special effect?** You can unclick the last matrix box. Further changes will affect the order of the entire matrix above the chosen box number. It will not affect the order of matrix numbers below. 5. *How do I delete a saved effect? Load the unwanted effect and press "delete" button. = Shortcode generator and widget = 1. **How do I create a shortcode?** On your dashboard navigate to "GBGallery admin" -> "shortcode generator". * Select the group you wish to display. * Determine the size of the slideshow. * Set the duration time in milliseconds. * Check/uncheck the special effect box. * Choose the "general effect". * Click the "generate shortcode" button. * Follow the "GB Gallery Slideshow Shortcode instructions". 2. **How do I choose the slider size?** GB Gallery Slideshow provides you with a variety of sizes. As long as you follow the recommended image aspect ratio you can select any slider size from a given variety and the images will be proportionally adjusted automatically. 3. **Why is my GB Slider size different on my mobile and tablet?** GB Gallery is responsive to mobile and tablet media types. There is an automatic resize for media devises. 4. **Is the duration time in seconds or milliseconds?** The duration time is in milliseconds. 1s = 1000ms. 5. **What is the difference between the special effect and the general effect?** * **The special effect** you create determines the **order** of the matrix appearance for each image. * **The general effect** determines the **way** each matrix box will hide. == Screenshots == 1. **GB Gallery custom post type (cpt)** this is the place to insert your images, title and description to the GB Gallery Slider. 2. **GB Gallery custom post type list** this is the place to view all your GB Gallery posts. 3. **GB Gallery Slideshow widget area** this is one of the options you have to insert GB Gallery Slider to your site. 4. **GB Gallery Slideshow Group - Admin** this is the place to manage your gallery groups. 5. **GB Gallery Slideshow Special Effect - Admin** this is the place to create and manage your special effects. 6. **GB Gallery Slideshow ShortCode - Generator** this is another option to insert GB Gallery Slideshow to your site.