## Thank you!

### Thanks for purchasing 'WP Magic Link Login' plugin!

If you have any questions that are beyond of the scope of this documentation,
please feel free to email us at tickets@pixolette.com or open a ticket here.

Version: 1.5.8

Updated: April, 4th, 2020

By: Pixolette

Contact: tickets@pixolette.com

Check online documentation on our website

### About 'WP Magic Link Login'

WP Magic Link Login (WPMLL) is a Premium WordPress Plugin that allow users to login on your website via link that is send on their email address. Simple but powerful, you can customize the email content, allow all type of emails or only from specific domains to be able to login, allow guest to login and automatically create user account, redirect to a specific page after login and many more!

## Installation

#### Step 1 – Installing the WordPress

First of all, you need to install the latest version of WordPress on your server. Installing WordPress is a quite easy process, almost all hosting providers have implemented tools to automate this process. However, if you wish to install WordPress yourself, we recommend you to check this tutorial.

#### Step 2 – Downloading the Plugin

Next, you have to download the plugin from the CodeCanyon Downloads page. If you have not bought yet the plugin, then you can get it from here.

#### Step 3 – Installing the Plugin

Follow these steps to install the plugin:

1. Extract the archive package
2. In your WordPress dashboard (admin panel), go to Plugins
3. Select the 'Add new' tab in the top panel:
4. Choose the 'Upload Plugin' button and upload the wp-magic-link-login.zip file from your extracted plugin package folder and click the 'Install Now' button
5. Now, click on 'Activate button'

That's all. WP Magic Link Login plugin is installed and you can start configuring it;

## Setting up the plugin

By default, when installing the plugin, the Magic Link functionality is disabled. You'll have to enable it. Go to Admin dashboard -> Magic Link:

Click on the "Enabled" and then choose the needed settings.

2. Magic Link form should

- Replace the login form - in this case, on the login page, only the form that asks for email and sends the Login Link will be displayed; see the image below:
- Displayed below login form - in this case, the magic link form will be appended below the default WordPress login form; see the image below:

3. Link validity (minutes)

We care about your website security and created the WPMLL plugin to be secure. Here you can choose how many minutes should be a link valid after it was generated. Some emails can be received with a delay and this is why by default it will be valid for 3 minutes. You can choose any value bigger or equal to 1 minute.

4. Display Magic Link for WooCommerce Pages

- Display - in this case, on the My Account page will be displayed:
- If you want to display the form on the checkout page, you have to enable it from the WooCommerce Settings page::

5. User should login from the same IP that requested the magic link?

Here you can choose if the users should access the link from the same IP or not.

6. Allowed users to login

Here you can choose who can login via magic link: only users that are registered on your website (also users that are added manualy by admin) or you allow all users to login, even those that don't have an account. In this case, on first login, an account will be created with the email address that guest submitted.

7. What role should be assigned to new users that will login with magic link

If you'll allow guest users to login, on their first login, an acount will be created. Here you can choose what role should be assigned to user's account.

8. On successful login, redirect user to:

Here you can choose tha landing page for a user that logged in via Magic Link;

- Profile page - user will be redirect to his profile page
- Custom url - user will be redirected to a custom url
- Page - user will be redirect to an internal page

Important! If the URL contains the redirect_to parameter (on page where Magic Login Link is requested) it will override settings you've made above.
9. Allowed domains or emails to login

You can set the email tld or a list of emails that are allowed to login. Useful when your website is used by company's internal users. For example, your company websites is https://awesome-co.tld - you can set that only users that have an email address with awesome-co.tld to be able to login.

10. Email subject

Set the subject for the email that will be received by user.

11. Email sender

Set the email sender for the email that will be received by user.

12. Email content

Set the email content for the email that will be received by user. You must use the shortcode {{WPMLL_LINK}} - it will be replaced with Magic Link

12. Save button

Don't forget to save the settings :)

## Firewall (brute force) protection

In version 1.5.7 we've introduced the brute force protection. You can enable it in the magic link settings page in admin section.

If enabled, there's 3 more fields that needs to be completed:

- Block IP after how many login failures - set the max number of failures.
- Count failures over what time period (hours) - set the time frame in hours to count failures.
- Amount of time a user is locked out (hours) - set the time frame in hours to block user. It counts from the last failure.

## Using the Shortcode

In some cases you'll need to display the Magic Link Login Form on a custom page or a specific widget area. To achieve that, you'll have to use the following shortcode.

`[wpmll_form]`

If you need to redirect users to the page where shortcode is used, then you'll have to add an attribute to the shortcode:

`[wpmll_form redirect_to="current-page"]`

If you need to redirect users to a custom page, then you'll have to add the url as an attribute to the shortcode:

`[wpmll_form redirect_to="https://your-website.com/the-page-where-user-will-be-redirected-after-login"]`

Since version 1.5.5 the following attributes are available:

- heading - default value set to "Magic Link"
- description - default value set to "Login without password: send the one time unique login link to your email and login with 1 click"
- login-button-text - default value set to "Send me the link"
- logout-link-text - default value set to "Logout"

`[wpmll_form heading="Form Heading" description="Form short description" login-button-text="Email login link" logout-link-text="Click here to logout"]`

If you want to create custom CSS styles for the form, please use the following css ids and classes:

- #wpmll-login-wrapper
- #wpmll-login-wrapper #wpmll-login
- #wpmll-login-wrapper #wpmll-login .wpmll-login-heading
- #wpmll-login-wrapper #wpmll-login form
- #wpmll-login-wrapper #wpmll-login form input[type="email"]
- #wpmll-login-wrapper #wpmll-login form input[type="submit"]

## Force Display The WP Default Login Form

WP Magic Link Login can be set up to display only the magic link form and hide the default WordPress Login Form. There can be situations and your WP_MAIL/SMTP functionality is not working properly (for example, using on local machine and not sending emails, or using on a shared server which has the IP address in Black List for spamming). For this situation, we've added an option to force display the WordPRess Default Login Form. You have to add show_login_form parameter to the url. For example: https://my-awesome-url.tld/login?show_login_form=1 and this will solve your issue.

## WPML / Polylang Compatibility

WP Magic Link Login is translation ready. In the languages directory, there is a wp-magic-link-login.pot file that contains all translatable / hardcoded strings. If you're using the Poedit, then you'll have to create new translation files from this .pot file. Load it in poedit, translate strings and export to .po and .mo file. Important! Language files should contain the language code. For example, if I want to translate it in romanian, files will be: wp-magic-link-login-ro_RO.mo and wp-magic-link-login-ro_RO.po

If you want to translate the Email content and subject, then you can do it with Polylang plugin. Go to Languages -> String Translations and you'll find the WP Magic Link Login plugin strings:

## Login reports

To see the login reports, go to admin dashboard -> Magic Link -> Reports. Here you'll see a list with all requested magic links and their status: Activated (means that user logged in via link) or Expired.

## Frequently Asked Questions

#### Is my theme compatible with 'WP Magic Login Link' plugin?

WP Magic Link Login plugin works fine with any 3rd party theme or plugin. It's independent and should not create any conflicts with other plugins. In case you're having any compatibility issues, please open a support ticket on Pixolette's Support Portal

#### Is your plugin secure?

Yes, it's secure. Link is generated randomly, we suggest you to use a short validity time for the links and allow users to login only from same ip

#### Can I use 1 licence on multiple websites?

Unfortunately, no. According to Envato policy, you have to buy a new licence for each website where you're using WP Magic Link Login plugin.

#### Your plugin is not working on my website

In case you're facing issues with our plugin, please open a support ticket on https://support.pixolette.com or send us an email to tickets@pixolette.com

## Thanks again for purchasing 'WP Magic Link Login' plugin. Have fun!

Feel free to check the Pixolette website for WordPress tips and plugins.

Demo of the plugin: http://wpmll.pixolette.com

If you have any questions that are beyond of the scope of this documentation,
please feel free to email us at tickets@pixolette.com or open a ticket here.

Support services will only cover theme setup, trouble using any features, and bug fixes. Regretfully we can't always provide support for modifications or 3rd party plugins issues. Thanks for your understanding.