=== Modal Links ===

Contributors: grglaz
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=43B53PFVBN9HA
Tags: modal, shortcode, modal window, modal link, link, jquery modal, jquery ui dialog
Requires at least: 3.0.1
Tested up to: 3.9
Stable tag: 1.7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

This is NOT just another modal plugin. Its much more. With this plugin you add modal functionalities to your wordpress.

== Description ==

This is NOT just another modal plugin. Its much more. With this plugin you add modal functionalities to your wordpress.
Go to Settings->Modal Links and check the options.<br />

<strong>We appreciate any bug report. Thank you</strong> <br />
<strong><a href="http://georgelazarou.info/modal-links/">SEE THE PLUGIN AND THE EXTENSIONS IN ACTION ON OUR TEST SITE</a></strong>

<strong>Important Things!</strong>

1) This plugin is being developed with the latest wordpress version, PHP 5.5.8 and MySQL 5.6.12 <br />
2) Before posting an issue to the support forum make sure that: <br />
- you use a valid shortcode or html link as modal links plugin expects. <br />
- you have checked the issue by disabling all the others plugins you have on your wordpress. <br />
3) If an update includes new settings options, disable and re-enable the plugin in order to let them be initialized.
_________________________

<strong>News:</strong>

* All donatable extensions have new version uploaded. We have added a "New Version Notice" system on them, so from now and on you will be notified in the admin panel if new version found. Please all owners download the new versions from the plugin's url using your existing credentials. Thank you
* The free extensions Read More, Meta Widget Login Register and Shortcode Validation now have been merged into the basic plugin.
* Responsive options have been added.
* You can now select a pre-loading image for the modal. Select the color and the size of the image.
_________________________

<strong>Basic Features:</strong>

* Create modal link of post/page using shortcode or plain html link.
* Use of posts/pages as modals. No need to create new content somewhere else.
* Use id or permalink to target the post/page. Id is recommended.
* Use of special category "Modals" for different mechanism behaviour.
* Hide or Show post's/page's title in modal window using the shortcode attribute "title".
* Open wp's Login/Logout and Register form (in beta).
* Many options to adjust the modal to your own needs.
* Option to use Login/Register links of Meta Widget as "Modal Links".
* Option to use Read More Links as "Modal Links".
* It is multisite ready.
* Translation ready.
* It IS flexible.
* Add extensions to expand functionality.
* Check the <a href="https://wordpress.org/plugins/modal-links/faq/">FAQ</a>.
_________________________

<strong>Options:</strong>

* Width               : Choose the width of dialog. Leave empty or '0' for auto.
* Width Type          : Choose between fixed and fluid type. (fixed/fluid)
* Responsive Width    : Choose true if you want the width to be re-calculated on window resize. Will work only for fluid width type. (true/false)
* Height              : Choose the height of dialog. After that value dialog goes scrollable.
* Height Type         : Choose between fixed and responsive type. (fixed/fluid)
* Max Height          : Choose the max height of dialog. After that value dialog goes scrollable.
* Max Height Type     : Choose between fixed and responsive type. (fixed/fluid)
* Responsive Height   : Choose true if you want the height to be re-calculated on window resize. Will work only for fluid height type. (true/false)
* Draggable           : Choose if the dialog will be draggable. (true/false)
* Resizable           : Choose if the dialog will be resizable. (true/false)
* Title               : Choose to show or hide the title, global option overrides title attribute in shortcodes or the data-title attribute in "modal" links. (true/false)
* Animate on Show     : Choose if the dialog will animate on opening. (true/false)
* Animate on Hide     : Choose if the dialog will animate on hiding. (true/false)
* Dialog is Modal     : Choose if the dialog will behave as modal or no. (true/false)
* Close Icon          : Choose false to hide close (X) icon. (true/false)
* Close on Escape     : Choose if the dialog will close using esc key. (true/false)
* Loading Image       : Switch off or select the pre-loading image. (off/images)
* CSS Class           : Enter any additional class that you want to attach to the dialog.
* Position            : Choose the position of the dialog. (left, center, right, top, bottom)
* Responsive Position : Choose true if you want to re-position the dialog on window resize. (true/false)
_________________________

<strong>Donatable Extensions:</strong>

* <strong>Shortcode GUI</strong>
(adds a GUI way to insert easily the shortcode into the wp editor. No need to know or remember the id or permalink of the post/page.) <br />
<a href="http://georgelazarou.info/modalLinksExtensions/shortcodegui">download</a> | <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HZ96FEXBA8NKA"> donate </a> <br />

* <strong>Auto Open</strong></a>
(opens a post/page in modal window automatically. Selectable option for every post/page and front page) <br />
<a href="http://georgelazarou.info/modalLinksExtensions/autoopen">download</a> | <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=8FPXMMF7LJDVC"> donate </a> <br />

* <strong>Menu Item</strong></a>
(adds the ability to put a post/page as a menu item into navigation menus. Post's/page's title becomes menu item name.) <br />
<a href="http://georgelazarou.info/modalLinksExtensions/menuitem">download</a> | <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=C7ZGVUDTDEWU2"> donate </a> <br />

* <strong>Category Carousel</strong></a>
(adds the ability to create a modal carousel using the posts from a category. Use the shortcode attribute category="catID" or the html link attribute data-category="catID") <br />
<a href="http://georgelazarou.info/modalLinksExtensions/categorycarousel">download</a> | <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SEQPMTLRED2GL"> donate </a> <br />

This is the proccess to get any of the donatable extensions:
step 1) Click on the donate link below of the extension.
step 2) Donate an amount of your decision.
step 3) We get an email notification from paypal about the donation.
step 4) We create an account based on the transaction details and we allow access to the download page. Username becomes the first part of your email and password the donation's confirmation number.
step 5) We email you the credentials

*** NOTE that this is not an automate proccess but we do it manually. Normally when the donation comes to us, we respond within 8 hours.

Check some screenshots for these extensions in <a href="https://wordpress.org/plugins/modal-links/screenshots/">Screenshots</a>.
_________________________

<strong>Shortcode Attributes:</strong>

* <strong>id</strong>     : The post's/page's id.
* <strong>permalink</strong> : The post's/page's permalink.
* <strong>title</strong>  : To force the post's/page's title hide or show in modal window.
* <strong>login</strong>  : Use login="true" to show wp's login/logout or register form.
* <strong>action</strong> : Use action="register" to show wp's register form.

Notes: <br />
* id or permalink are required to open a post/page. <br />
* login="true" is required to open login/logout or register form. <br />
* action="register" is required to open registration form. <br />
* title is optional in any case. <br />
* if both id and permalink provided, id will be used.
_________________________

<strong>HTML Link Attributes:</strong>

* <strong>id</strong>          : The post's/page's id.
* <strong>href</strong>        : The post's/page's permalink otherwise "#".
* <strong>data-title</strong>  : To force the post's/page's title hide or show in modal window.
* <strong>data-login</strong>  : Use data-login="true" to show wp's login/logout or register form.
* <strong>data-action</strong> : Use data-action="register" to show wp's register form.

Notes: <br />
* always provide target="_modal". <br />
* href should be set to '#' or set the post's/page's permalink. <br />
* data-login="true" is required to open login/logout or register form. <br />
* data-action="register" is required to open registration form. <br />
* data-title is optional in any case. <br />
* if both id and href="PERMALINK" provided, id will be used.
_________________________

<strong>Learn by example:</strong>

Playing with the link name <br />

* Normal usage of link name. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1”]link[/modalLinks]</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” id=“1”>link</a></code>

* If you leave empty the link name in the shortcode dont worry, id/permalink or login/register form name will get in place. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1”][/modalLinks]</code> <br />
<strong>Result:</strong> <code><a target="_modal" href=“#” id=“1”>1</a></code>

* You can use unclosed shortcode, again we take care the link name. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1” /]</code> <br />
<strong>Result:</strong> <code><a target="_modal" href=“#” id=“1”>1</a></code>

Referring to the post/page by id or permalink <br />

* Open post/page with id ‘1’. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” id=“1”>...</code>

* Open post/page with permalink ‘?p=1’. <br />
<strong>Shortcode:</strong> <code>[modalLinks permalink=“?p=1”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“?p=1”>...</code>

* If you provide both id and permalink in the shortcode, id will be used. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1” permalink=“?p=2”]...</code> <br />
<strong>RESULT:</strong> <code><a target="_modal" href=“#” id=“1”>...</code>

Showing or hiding the title of post/page <br />

* Title is NOT showing for post/page with id ‘1’. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“1” title=“false”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” id=“1” data-title=“false”>...</code>

* Title is showing for post with id ‘2’ which is in ‘Modal’ category. <br />
<strong>Shortcode:</strong> <code>[modalLinks id=“2” title=“true”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” id=“2” data-title=“true”>...</code>

Open wordpress’s Login/Logout or Register form. <br />

* Opens login or logout according of user’s state. <br />
<strong>Shortcode:</strong> <code>[modalLinks login=“true”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” data-login=“login”>...</code>

* Opens registration form no matter of user’s state. <br />
<strong>Shortcode:</strong> <code>[modalLinks login=“true” action=“register”]...</code> <br />
<strong>HTML:</strong> <code><a target="_modal" href=“#” data-login=“login” data-action=“register”>...</code>

== Installation ==

1. Upload the folder "modal-links" to the "/wp-content/plugins/" directory or install it through WordPress directly.
2. Activate the "Modal Links" plugin through the 'Plugins' menu in WordPress.
3. Go to Settings->Modal Links and check the options.

== Frequently Asked Questions ==

= How do i create a modal link? =

Use the shortcode <br /><strong>[modalLinks]LINK_NAME[/modalLinks]</strong><br /> in a post or page.<br />

<strong>Shortcode Attributes:</strong>

* <strong>id</strong>        : The post's/page's id.
* <strong>permalink</strong> : The post's/page's permalink.
* <strong>title</strong>     : To force the post's/page's title hide or show in modal window.
* <strong>login</strong>     : Use it without id or permalink attributes to show wp's login/logout form.
* <strong>action</strong>    : Use action="register" with 'login' attribute provided to show wp's register form.

<strong>Notes:</strong> <br />
* id or permalink are required to open a post/page. <br />
* login is required to open login/logout form. <br />
* action="register" is required to open registration form. <br />
* title is optional in any case. <br />
* if both id and permalink provided, id will be used.

= What if i have shortcodes in my post or page? =

Shortcodes should render fine in the modal.
Alhough some seems that not responding.

= Does this plugin works for both posts and pages? =

Yes.

= Does this plugin works for any permalink setting? =

Yes, except of custom permalinks if you refer to a post/page by permalink.

= Which library do you use for the modal? =

Wordpress's built in jQuery Dialog.

= Where can i find extensions? =

In <a href="https://wordpress.org/plugins/modal-links/">Description</a>.

== Screenshots ==

1. screenshot-1.png The menu in settings
2. screenshot-2.png The plugin's settings
3. screenshot-3.png The shorthand
4. screenshot-4.png The link
5. screenshot-5.png The modal in action
6. screenshot-6.png
7. screenshot-7.png Read More extension
8. screenshot-8.png Validation extension
9. screenshot-9.png Shortcode GUI extension
10. screenshot-10.png Auto Open extension (for Post/Page)
11. screenshot-11.png Auto Open extension (for Front Page)
12. screenshot-12.png Auto Open extension (Options)
13. screenshot-13.png Menu Item extension (admin area)
14. screenshot-14.png Menu Item extension
15. screenshot-15.png Category Carousel extension

== Changelog ==

= 1.7.2 =
Bug fixed.

= 1.7.1 =
Bug fixed.

= 1.7.0 =
Shortcode Validation extension merged. Bug fixed.

= 1.6.0 =
Read More extension merged. Bug fixed.

= 1.5.3 =
Bug fixed.

= 1.5.2 =
Bug fixed.

= 1.5.1 =
New options added. Bug fixed.

= 1.5.0 =
New options added. Bug fixed.

= 1.3.8 =
Bug fixed.

= 1.3.7 =
New option added. Bug fixed.

= 1.3.6 =
Bug fixed.

= 1.3.5 =
Better shortcode rendering.

= 1.3.1 =
Bugs fixed.

= 1.3.0 =
New option added, Bugs fixed.

= 1.2.0 =
New option added, Bugs fixed.

= 1.1.0 =
Animation options added in the settings page.

= 1.0.0 =
First stable version

= 0.0.9 =
bugs fix, faster code...

= 0.0.8 =
login/logout and register form improved css...

= 0.0.7 =
bugs fix, lots of new things

= 0.0.6 =
modal window width can now be setup

= 0.0.5 =
many fixes

= 0.0.4 =
now you can hide post's or page's title

= 0.0.3 =
now you can use permalink instead id in shortcode

= 0.0.2 =
Bugs fix

= 0.0.1 =
First version

== Upgrade Notice ==

= 1.7.2 =
Bug fixed.

= 1.7.1 =
Bug fixed.

= 1.7.0 =
Shortcode Validation extension merged. Bug fixed.

= 1.6.0 =
Read More extension merged. Bug fixed.

= 1.5.3 =
Bug fixed.

= 1.5.2 =
Bug fixed.

= 1.5.1 =
New options added. Bug fixed. Please disable and re-enable the plugin after updating.

= 1.5.0 =
New options added. Bug fixed.

= 1.3.8 =
Bug fixed.

= 1.3.7 =
New option added. Bug fixed.

= 1.3.6 =
Bug fixed.

= 1.3.5 =
Better shortcode rendering.

= 1.3.1 =
Bugs fixed.

= 1.3.0 =
New option added, Bugs fixed.

= 1.2.0 =
New option added, Bugs fixed.

= 1.1.0 =
Animation options added in the settings page.

= 1.0.0 =
First stable version

= 0.0.9 =
bugs fix, faster code...

= 0.0.8 =
login/logout and register form improved css...

= 0.0.7 =
bugs fix, lots of new things

= 0.0.6 =
modal window width can now be setup

= 0.0.5 =
many fixes

= 0.0.4 =
now you can hide post's or page's title

= 0.0.3 =
now you can use permalink instead id in shortcode

= 0.0.2 =
Bugs fix

= 0.0.1 =
This is the first version