aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/emailauth.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joeyh@joeyh.name>2015-05-13 23:43:16 -0400
committerJoey Hess <joeyh@joeyh.name>2015-05-13 23:43:16 -0400
commitb89f4b7ec584e60ae817b55f352bd69cfd4811c1 (patch)
tree83f582465a54ddfb7f7c6a6d38cae8bf306c76ad /doc/plugins/emailauth.mdwn
parent369bfd45cc0d923a6903ea24b8a65091c12d930c (diff)
downloadikiwiki-b89f4b7ec584e60ae817b55f352bd69cfd4811c1.tar
ikiwiki-b89f4b7ec584e60ae817b55f352bd69cfd4811c1.tar.gz
fix page extension
Diffstat (limited to 'doc/plugins/emailauth.mdwn')
-rw-r--r--doc/plugins/emailauth.mdwn17
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/plugins/emailauth.mdwn b/doc/plugins/emailauth.mdwn
new file mode 100644
index 000000000..8cb060e93
--- /dev/null
+++ b/doc/plugins/emailauth.mdwn
@@ -0,0 +1,17 @@
+[[!template id=plugin name=emailauth core=1 author="[[Joey]]"]]
+[[!tag type/auth]]
+
+This plugin lets users log into ikiwiki using any email address. To complete
+the login, a one-time-use link is emailed to the user, and they can simply
+open that link in their browser.
+
+It is enabled by default, but can be turned off if you want to only use
+some other form of authentication, such as [[passwordauth]] or [[openid]].
+
+Users who have logged in using emailauth will have their email address used as
+their username. In places where the username is displayed, like the
+RecentChanges page, the domain will be omitted, to avoid exposing the
+user's email address.
+
+This plugin needs the [[!cpan Mail::SendMail]] perl module installed,
+and able to send outgoing email.