=== Galdget ===
Contributors: unforget
Donate link: https://plugins.unforget.rs/galdget/#donate
Tags: wordpress gallery plugin, photo gallery, image gallery, gallery widget, animated gallery, image slider, wordpress gallery widget, gallery with frame, gallery shortcode, gallery, slider, shortcode, widget, images, sites, urls
Requires at least: 4.5.0
Tested up to: 4.9
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Gallery and Widget of images and web pages

== Description ==

This plugin provides two features, a gallery shortcode and a widget, which slide-show the images and webpages from the list that you define, as may be seen on demo pages [demo 1][galdget animations] and [demo 2][galdget restaurant menu]. The list consists of URLs that point to images or web pages, residing either on your blog website or on some other web server on the internet. You can include one or more directories from your web server into the list, and all images and html/php files from the directories will participate in the slide show.

So you can display galleries on your posts and pages, but also in the widget areas of your blog. The galleries can display images and/or web pages.

Features

* Gallery shortcode with a large set of options, to be included in posts and pages
* Gallery widget
* Both pictures and web pages can be displayed in the gallery
* Multiple galleries can be set up on the same page/post, with different content and options
* Multiple widgets can be set up, with different content and options
* Gallery content can be post/page/tag/category/date/time... specific
* Each image from the directory can have custom title and link
* User-friendly links setup screen
* Export and import of the links list in TSV format
* Links list can be processed in external applications (OpenOffice Calc, LibreOffice Calc, Excel…) and imported into your site
* Various animations for switching between gallery items
* \[premium feature\] Gallery frame, preset or user defined

Each item in the list (picture, web page, directory) can be set up to appear on a specific page or post, designated by a slug, tag or category, or at specific date, day, hour, so your galleries can display different content each time the visitors come back to your site. These features can be used to set up a scheduled content to appear when certain conditions are met. For example, a restaurant can have a large slide show with today’s menu on the front page, and the menus for the next two days displayed as two separate widgets in the widget area ([as shown in the example and tutorial here][galdget restaurant menu]).

The animation used for transition between the pictures/webpages can be chosen from a predefined set, as shown in the [animations demo page][galdget animations].


Demo and tutorial pages

* [Various animations][galdget animations]
* [Restaurant menu demo and tutorial][galdget restaurant menu]
* [5 minute setup][galdget 5 minute setup]
* [Detailed URL list setup description][galdget url list setup]



== Installation ==

Galdget is best installed via Wordpress plugins screen, as described in [5 minute setup](https://plugins.unforget.rs/galdget/galdget_5-minute-setup/):

1. Log into administrator panel
1. Navigate to Plugins
1. Click the "Add New" button
1. Type "Galdget" in the search text box
1. Click the "Install Now" button in the Galdget box in search results
1. Navigate to Plugins
1. Click "Activate" in Galdget section

Alternatively, you may download zip archive from the Wordpress plugins site to your local folder and:

1. Log into administrator panel
1. Navigate to Plugins
1. Click the "Add New" button
1. Click the "Upload Plugin" button
1. Click the "Browse" button and navigate to the zip archive that you saved
1. Click the "Install Now" button
1. Navigate to Plugins
1. Click "Activate" in Galdget section

Please take a look at [galdget 5 minute setup](https://plugins.unforget.rs/galdget/galdget_5-minute-setup/), it will show you how to get your gallery displayed in a widget, or within a post/page.


== Frequently Asked Questions ==

= What to do after plugin activation =

When you install and activate the plugin, you have to set up your list of images and web pages to display. In Wordpress admin panel (dashboard), go to Settings / Galdget and set up your gallery contents. It would not hurt to read the instructions for [URL list setup](https://plugins.unforget.rs/galdget/galdget_url-list-setup/).

After that, your gallery may be displayed in a widget, for this you go to Appearance / Widgets, and drag "Galdget" into one of the sidebars.

You may also want to display your gallery on a post or page, in which case you will have to insert a shortcode using post/page editor.

Either way, you should read, at least, [5 minute setup](https://plugins.unforget.rs/galdget/galdget_5-minute-setup/) page.

= Why do I get two strange items in the URL list after plugin install =

It's the following two:

* [https://plugins.unforget.rs/galdget](https://plugins.unforget.rs/galdget), the web page of Galdget plugin, where documentation and tutorials can be found.
* [https://www.topirot.com](https://www.topirot.com), the web page displaying a small city and surrounding landscapes.

They are here if you want to see the gallery running before you set up your links. Also as a sample, so you can see what goes where.

Normally, you delete them and put your own links in the list.


== Screenshots ==

1. Gallery on the page, created by inserting a shortcode into the page.
2. Two galleries on the page, two shortcodes (inside a table, for proper alignment).
3. Two galleries in two widgets.
4. URL list setup page
5. Widget setup page
6. Post/Page editor, with the shortcode and tools to help you create one.

== Changelog ==

= 1.0.3 =
* Added SEO friendly img alt attributes
* "dir" directive in the URL list now can point to single file

= 1.0.2 =
* Added minutely content schedule.
* Fixed "Open" and "Open in new window" behavior
* Improved folder URL processing, now web pages in gallery can have separate URLs and descriptions.

= 1.0.1 =
* Fixed bad interpretation of tags and categories.
* Improved coexistence with other plugins, which tend to take onLoad event handlers for themselves.

= 1.0.0 =
* Initial version

== Upgrade Notice ==

= 1.0.3 =
Version 1.0.3 features "alt" descriptions for all images in the gallery, either user-defined or default, which is good for SEO since search engines don't like images without alt tag.
Also, "dir://" directive, which is used to include the contents of a directory into the gallery, can now point to a single file instead of a directory. The file can be either image or a web page, and may have acompanying .txt file with link and tooltip text.

== URL list setup ==

Links to pictures and/or web pages, that you want to display in your galleries, are specified in the URL list setup page. It is located in the Wordpress dashboard under Settings / Galdget. The list setup is described on [URL list setup page][galdget url list setup].

= Default URL list =

During plugin installation the initial URL list is provided as a sample, in order to facilitate first setup and run. It contains two links that point to the following web pages:

* [https://plugins.unforget.rs/galdget][galdget plugin site], the web page of Galdget plugin, where documentation and tutorials can be found.
* [https://www.topirot.com][to pirot], the web page displaying a small city and surrounding landscapes.

Normally, you will delete these links and put your own in the list, but if you want to run a gallery out of the box first, all you need to do is put the "Galdget" widget in one of your blog's sidebars and visit your blog, you will see a gallery with these two sites.

Once you put your URLs in the list, instead of the two above, they will not appear again.


[galdget animations]: https://plugins.unforget.rs/galdget/galdget_animations/ "Galdget animations"
[galdget restaurant menu]: https://plugins.unforget.rs/galdget/galdget_restaurant-menu/ "Galdget restaurant menu demo"
[galdget 5 minute setup]: https://plugins.unforget.rs/galdget/galdget_5-minute-setup/ "Galdget 5 minute setup"
[galdget url list setup]: https://plugins.unforget.rs/galdget/galdget_url-list-setup/ "Galdget URL list setup"
[galdget plugin site]: https://plugins.unforget.rs/galdget/ "Galdget plugin site, demos, documentation, tutorials"
[to pirot]: https://www.topirot.com "Local tourist organization of a small city"
