PHPackages                             topshelfcraft/legacy-login - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. topshelfcraft/legacy-login

ActiveCraft-plugin[Authentication & Authorization](/categories/authentication)

topshelfcraft/legacy-login
==========================

Seamless legacy user authentication for Craft CMS

5.0.0(1y ago)198147[1 issues](https://github.com/TopShelfCraft/Legacy-Login/issues)proprietaryPHP

Since Apr 5Pushed 1y ago4 watchersCompare

[ Source](https://github.com/TopShelfCraft/Legacy-Login)[ Packagist](https://packagist.org/packages/topshelfcraft/legacy-login)[ RSS](/packages/topshelfcraft-legacy-login/feed)WikiDiscussions 5.x Synced 2d ago

READMEChangelogDependencies (2)Versions (15)Used By (0)

Legacy Login
============

[](#legacy-login)

*Seamless legacy user authentication for Craft CMS*

**A [Top Shelf Craft](https://topshelfcraft.com) creation**
[Michael Rog](https://michaelrog.com), Proprietor

---

TL;DR.
------

[](#tldr)

The **Legacy Login** plugin provides a way to authenticate users from a legacy system into your Craft CMS site.

The `legacy-login/login` custom action stands in for Craft's native `login` form action. If a submitted `loginName`/`password` fails Craft's native authentication, the plugin checks the legacy system(s) and tries to authenticate a user from there. If a matching legacy user is found and authenticated, the plugin creates or updates the User in Craft and logs into the newly created/matched account.

What legacy systems are supported?
----------------------------------

[](#what-legacy-systems-are-supported)

Legacy Login provides drivers for authenticating legacy users from:

- Craft CMS 5.x
- Craft CMS 4.x
- Craft CMS 3.x
- Craft CMS 2.x
- ExpressionEngine 2.x
- WordPress

Two legacy drivers are not yet ported to the Craft 5 version of Legacy Login:

- BigCommerce (Self-hosted)
- Wellspring

Installation
------------

[](#installation)

1. From your project directory, use Composer to require the plugin package:

    ```
    composer require topshelfcraft/legacy-login

    ```

    *Note: Legacy Login is also available for installation via the Craft CMS Plugin Store.*
2. In the Control Panel, go to **Settings → Plugins** and click the **“Install”** button for Legacy Login.
3. Finally, add the Legacy Login form to your login template. The template follows the same design as Craft's native login form, except the form action should point to the *LegacyLoginController* rather than Craft's native *UsersController*:

```

    {{ csrfInput() }}
    {{ actionInput('legacy-login/login') }}

    Username or email

    Password

        Remember me

    {% if errorMessage ?? false %}
        {{ errorMessage }}
    {% endif %}

```

Configuration
-------------

[](#configuration)

To customize the plugin's behavior, add a `legacy-login.php` file to your Craft config directory:

```