=== Modal Links ===
Contributors: grglaz
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=43B53PFVBN9HA
Tags: modal, modal window, modal link, link, jquery modal, jquery dialog
Requires at least: 3.0.1
Tested up to: 3.9
Stable tag: 0.0.8
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
This plugin opens a "modal" link in modal window.
== Description ==
Plugin is in HOT development.
We appreciate any bugs reports. Thank you
This plugin opens a "modal" link in modal window.
Install it and activate it to see it in action.
Go to Settings->Modal Links and check the options.
Basic Features:
* Create modal link of post/page using shortcode or plain html.
* Use id or permalink to target the post/page.
* Add posts into category "Modals" to hide the post's title in modal window.
* 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).
* Setup width and height.
* Choose if draggable and resizable.
* It is multisite ready.
* Add extensions to expand functionality.
* Check the FAQ.
Shortcode Attributes:
* id : The post's/page's id.
* permalink : The post's/page's permalink.
* title : To force the post's/page's title hide or show in modal window.
* login : Use it without id or permalink attributes to show wp's login/logout form.
* action : Use action="register" with 'login' attribute provided to show wp's register form.
Note that If both id and permalink provided, id will be used.
Extensions:
* Shortcode GUI
(adds a GUI way to insert the shortcode into the wp editor. No need to know the shortcode and post's/page's id.)
* Read More [Free extension]
(uses the post's/page's read more link to open the complete post/page in modal window.)
* Auto Open
(opens a post/page in modal window automatically. Selectable option for each post/page and front page.)
* Login Register [Free extension]
(Uses the meta widget and opens Login/Logout and Register links in modal window.)
check some screenshots for these extensions in Screenshots tab.
TODO:
- Width and Height in percent %.
- Show or Hide buttons.
- Add your own buttons.
- much more...
API:
Playing with the link name
Link name is OPTIONAL.
* Link name is ‘link’
Shortcode: [modalLinks id=“1”]link[/modalLinks]
HTML: link
* Link name is empty so id ‘1’ takes the place
Shortcode: [modalLinks id=“1”][/modalLinks]
HTML: 1
* Link name is empty so id ‘1’ takes the place (unclosed shortcode)
Shortcode: [modalLinks id=“1” /]
HTML: 1
Referring to the post/page by id or permalink
Id or Permalink is REQUIRED to open a post/page.
* Opens post/page with id ‘1’
Shortcode: [modalLinks id=“1”]...
HTML: ...
* Opens post/page with permalink ‘?p=1’
Shortcode: [modalLinks permalink=“?p=1”]...
HTML: ...
* Opens post/page with id ‘1’
Shortcode: [modalLinks id=“1” permalink=“?p=2”]...
HTML: ...
Showing or hiding the title of post/page
OPTIONAL shortcode attribute. Title is showing by default to all posts/pages except for posts in ‘Modal’ category.
* Title is NOT showing for post/page with id ‘1’
Shortcode: [modalLinks id=“1” title=“false”]...
HTML: ...
* Title is showing for post with id ‘2’ which is in ‘Modal’ category
Shortcode: [modalLinks id=“2” title=“true”]...
HMTL: ...
Open wordpress’s Login/Logout or Register form
‘login’ attribute is REQUIRED to open login/logout form and ‘action’ attribute along with ‘login’ to open the registration form.
* Opens login or logout according of user’s state.
Shortcode: [modalLinks login=“true”]...
HTML: ...
* Opens registration form no matter of user’s state
Shortcode: [modalLinks login=“true” action=“register”]...
HTML: ...
Website:
Modal Links Website
== 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
[modalLinks]LINK_NAME[/modalLinks]
in a post or page.
Shortcode Attributes:
* id : The post's/page's id.
(ex. [modalLinks id="1"]LINK_NAME[/modalLinks])
* permalink : The post's/page's permalink.
(ex. [modalLinks permalink="?p=ID"]LINK_NAME[/modalLinks])
* title : To force the post's/page's title hide or show in modal window
(ex. [modalLinks id="1" title="false"]LINK_NAME[/modalLinks])
* login : Use it without id or permalink attributes to show wp's login/logout form
(ex. [modalLinks login="true"]LINK_NAME[/modalLinks])
* action : Use action="register" with 'login' attribute provided to show wp's register form
(ex. [modalLinks login="true" action="register"]LINK_NAME[/modalLinks])
Note that If both id and permalink provided, id will be used.
(ex. [modalLinks id="1" permalink="/post_name"]LINK_NAME[/modalLinks])
= What if i have shortcodes in my post or page? =
No problem, shortcodes are rendering fine in the modal.
= 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 plugin's website: Modal Links Website
== 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 Shortcode GUI extension
7. screenshot-7.png Read More extension
8. screenshot-8.png Auto Open extension
== Changelog ==
= 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 ==
= 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