Difference between revisions of "Extensions:Alias Logins"

From Lorekeeper Wiki
Jump to navigation Jump to search
(Created page with "{{subst:Extension Page}}")
Tag: 2017 source edit
 
m (Add the "this is in V3" warning box thingamabob)
Tag: 2017 source edit
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Extensioninfobox|title=the extension's name|desc=A short description|auth=Author(s)|status=status (such as WIP, testing, stable)|github={{Github|user=username|branch=branch}}|LKVer=What Lorekeeper version the ext is built on|migration=yes/no|package=yes/no}}
+
{{Extensioninfobox|title=Alias Logins|desc=Allows the usage of Auth Alias' as stand-in for passwords for logging in and registering|auth=moif|status=stable|github={{Github|repo=lorekeeper-extensions|user=AW0005|branch=extension/alias-logins}}|LKVer=2.1.0|migration=yes|package=no|dev300=yes}}
<!-- Put a short summary of your extension here! -->
+
 
 +
{| style="margin: 4px auto; width: 80%; border: 1px solid #9ADC38; background: #A1F524;"
 +
|-
 +
| '''<u>THIS EXTENSION IS PART OF v3.0.0</u>'''
 +
|-
 +
| This extension has been merged into the v3.0.0 branch as [https://github.com/corowne/lorekeeper/pull/493 Alias Login].
 +
|}
 +
 
 +
Adds the ability to allow users to login or register accounts via the same OAuth2 mechanism previously used for Aliases. Does require configuration updates to the Aliases you turn it on for, please see below for details.
 +
 
 +
This does not currently support tumblr.
 +
 
 
== Installation ==
 
== Installation ==
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
+
# Pull the extension, deal with conflicts
== Configuration ==
+
# <code>php artisan migrate</code>
<!-- Is any configuration necessary? Describe it here! -->
+
# <code>php artisan optimize</code>
 +
# In "config/lorekeeper/sites.php" update the login field to 1 for the auths you wish to use.
 +
# For each of those Auths you will need to refer back to their setup instructions ( [[http://wiki.lorekeeper.me/index.php?title=Category:Social_Media_Authentication| Social Media Authentication]] ) and make sure that you update any redirect link lists to also include "https://your-site.com/login/callback/provider-name" ''and'' "https://www.your-site.com/login/callback/provider-name" making sure to swap out for your site name and the provider name (toyhouse, deviantart, etc) for each one as appropriate.
 +
# If you want to use twitter specifically, where you used the API key and secret before as described in [[Auth: Twitter]] you'll need to get the client id and secret instead, from the "User authentication settings" in your app on the twitter developer portal, and replace those in your .env file.
 +
 
 +
If you add the same url, but with the url for your local testing environment, you should be able to test this locally too.
 +
 
 
== Usage ==
 
== Usage ==
<!-- Is there anything users should know about using your extension? -->
+
'''IMPORTANT''' Any existing users that want to make use of this feature will need to remove their existing aliases and re-add them for the ones that allow login. This is because the extension uses a more unique id snowflake from each service to identify users than what was stored prior for aliases.
== Troubleshooting ==
+
 
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
 
 
== Images ==
 
== Images ==
<!-- Do you have any images to show what it looks like in action? -->
+
<gallery heights="200" widths="200">
 +
File:Screen_Shot_2023-01-06_at_11.54.14_PM.png
 +
</gallery>
 +
 
 
== See Also ==
 
== See Also ==
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->
+
* [[Updating:_to_3.0.0]]
 
 

Latest revision as of 12:38, 14 November 2024

Alias Logins
Description Allows the usage of Auth Alias' as stand-in for passwords for logging in and registering
Author(s) moif
Status stable
Github AW0005/lorekeeper-extensions/extension/alias-logins
LK Version 2.1.0
Contains a Migration
Is part of LK v3.0.0's release






THIS EXTENSION IS PART OF v3.0.0
This extension has been merged into the v3.0.0 branch as Alias Login.

Adds the ability to allow users to login or register accounts via the same OAuth2 mechanism previously used for Aliases. Does require configuration updates to the Aliases you turn it on for, please see below for details.

This does not currently support tumblr.

Installation

  1. Pull the extension, deal with conflicts
  2. php artisan migrate
  3. php artisan optimize
  4. In "config/lorekeeper/sites.php" update the login field to 1 for the auths you wish to use.
  5. For each of those Auths you will need to refer back to their setup instructions ( [Social Media Authentication] ) and make sure that you update any redirect link lists to also include "https://your-site.com/login/callback/provider-name" and "https://www.your-site.com/login/callback/provider-name" making sure to swap out for your site name and the provider name (toyhouse, deviantart, etc) for each one as appropriate.
  6. If you want to use twitter specifically, where you used the API key and secret before as described in Auth: Twitter you'll need to get the client id and secret instead, from the "User authentication settings" in your app on the twitter developer portal, and replace those in your .env file.

If you add the same url, but with the url for your local testing environment, you should be able to test this locally too.

Usage

IMPORTANT Any existing users that want to make use of this feature will need to remove their existing aliases and re-add them for the ones that allow login. This is because the extension uses a more unique id snowflake from each service to identify users than what was stored prior for aliases.

Images

See Also