# osom-modal-login

=== Osom Modal Login ===
Contributors: osompress, esther_sola, nahuai, davidperalvarez
Donate link: https://osompress.com
Tags:  Login, modal, logout, login form, custom login, wordpress login, overlay
Requires at least: 5.0
Tested up to: 5.5
Stable tag: 1.0.4
Requires PHP: 5.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 

== Description ==

Osom Modal Login lets you easily create a modal box displaying the WordPress login form. It automatically adds a menu item named "Login" at the end of the selected menu which will launch the login modal box one you click on it.

Alternatively, you can also use the included shortcode to add the modal login box in any place of the web.

= Features =

With Osom Modal Login you can customize several parameters in the options page:
1. Set the title of the modal box.
2. Select the navigation menu where you want to add login/logout item.
3. Set the login URL.
4. Set the logout URL.
5. Display/hide "Remember me" checkbox.
6. Display/hide "Did you forget your password" link.

The menu item will display the text "Login" to users that are not already logged in and "Logout" to the ones logged in.

You can also use the built-in shortcode to add the modal box any where in your website.

= Shortcode usage (optional) =

You just need to enclose your custom text in [osom-login] shortcode.
For example: [osom-login] Custom text [/osom-login]

### Follow Along:

* [Visit the OsomPress site](https://osompress.com/)
* [Follow on Twitter](https://twitter.com/osompress)

== Installation ==

This plugin can be installed directly from your site.

1. Log in and navigate to _Plugins → Add New.
2. Type "Osom Modal Login" into the Search and hit Enter.
3. Locate the Osom Blocks plugin in the list of search results and click **Install Now**.
4. Once installed, click the Activate link.
5. Now you have the new block available on editor.

It can also be installed manually.

1. Download the Osom Blocks plugin from WordPress.org.
2. Unzip the package and move to your plugins directory.
3. Log into WordPress and navigate to the Plugins screen.
4. Locate Osom Blocks in the list and click the *Activate* link.
5. Now you have the new block available on editor.


== Frequently Asked Questions ==

= Can I use Osom Modal Login with any theme? =

Yes, you can use Osom Login Modal with any theme. 

= Where can I modify Osom Modal Login settings? =

You can find the settings page on WordPress left sidebar under OsomPress > Osom Login Modal. 

= Can I use Osom Modal Login in other locations apart from the menus? =

Yes, you can add a login modal window anywhere on the website using the shortcode [osom-login] Custom text [/osom-login].

= Can I change the Login/Logout text? =

Yes, you can do it using a plugin like Loco Translate but we will add the option to do it from the settings page in an upcoming update. 

= Can I use Osom Modal Login on WordPress Multisite?  =

Yes, you can. Take into account that if you set the login or logout URL you will have to use an absolute URL, ie, https://yoursite.com/redirect-page. If you use a  relative ULR, such as /redirect-page/, it will point to the the main site URL (of the network).

= Is Osom Modal Login compatible with WordPress Multiligual plugin?  =

Yes, it is. 
 

== Screenshots == 
 
 1. Dashboard plugin view
 2. Front-end modal window 

== Changelog ==

= 1.0 =
* Initial release. 

= 1.0.1 =
* Translation improvements
= 1.0.2 =
* Translation improvements
= 1.0.3 =
* Fix warnings
= 1.0.4 =
* Add labels for login/logut menu item
* Removal of the jQuery used and replaced with Vanilla JavaScript
* Add settings link in plugins page
= 1.0.5 =
* Add redirection to the plugin settings page when activated.
* Tested on WordPress Multisite.
* Tested with WordPress Multilingual.