Differences

This shows you the differences between two versions of the page.

--- plugin:authdjango [2018-03-30 13:10] – Author full name zygentoma
+++ plugin:authdjango [2021-01-13 04:45] (current) – [Discussion] toastedbagel
@@ Line 1: / Line 1: @@
-====== authdjango Plugin ======
+====== AuthDjango Plugin ======
 ---- plugin ----
 description:
 author     : Robert Czechowski
-email      : robert+dokuwiki@czecho.de
+email      : robert+dokuwiki at czecho.de
 type       : authentication
-lastupdate : 2017-03-29
+lastupdate : 2018-03-30
-compatible : Frusterick Manners
+compatible : Frusterick Manners, Greebo, Hogfather
 depends    :
 conflicts  :
@@ Line 13: / Line 13: @@
 tags       : auth authentication django
-downloadurl: http://github.com/zgtm/dokuwiki-plugin-authdjango/zipball/master
+downloadurl: https://github.com/zgtm/dokuwiki-plugin-authdjango/zipball/master
-bugtracker : http://github.com/zgtm/dokuwiki-plugin-authdjango/issues
+bugtracker : https://github.com/zgtm/dokuwiki-plugin-authdjango/issues
-sourcerepo : http://github.com/zgtm/dokuwiki-plugin-authdjango/
+sourcerepo : https://github.com/zgtm/dokuwiki-plugin-authdjango
 ----
+This plugin allows to authenticate users using a running Django installation.
+It uses the session of Django, thus the users need to login via Django first.
 ===== Installation =====
-Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
 ===== Configuration and Settings =====
-  * Set the following fields in local.php
+  * Set the following fields in Dokuwiki configuration
+    * authtype to ''authdjango''
+    * plugin»authdjango»protocol: Database type of Django database (currently supported: ''pgsql'', ''mysql'', ''sqlite'')
+    * plugin»authdjango»server: Hostname or file (sqlite) of Django database
+    * plugin»authdjango»user: Database username of Django database (empty for sqlite)
+    * plugin»authdjango»db: Database name of Django database (empty for sqlite)
+    * plugin»authdjango»password: Database password for Django database (empty for sqlite)
+  * or in ''conf/local.php'':
 <code php>
 $conf['authtype'] = 'authdjango';
-$conf['auth']['django']['server'] = '';
+$conf['plugin']['authdjango']['server'] = '';
-$conf['auth']['django']['user'] = '';
+$conf['plugin']['authdjango']['user'] = '';
-$conf['auth']['django']['db'] = '';
+$conf['plugin']['authdjango']['db'] = '';
-$conf['auth']['django']['password'] = '';
+$conf['plugin']['authdjango']['password'] = '';
-$conf['auth']['django']['protocol'] = 'pgsql'; // or other, see PHP PDO documentation
+$conf['plugin']['authdjango']['protocol'] = 'pgsql'; // or other, see PHP PDO documentation
 </code>
@@ Line 44: / Line 52: @@
   * **2018-03-29**
     * Initial release, based on [[auth:django]]
+  * **2018-03-29**
+    * Add config defaults and config description strings
+    * Some bugfixes
 === Known Bugs and Issues ===
@@ Line 53: / Line 64: @@
 ===== Discussion =====
+Note that as of Django 3.1, your django project seems to require
+    DEFAULT_HASHING_ALGORITHM='sha1'
+in your ''settings.py'' for this Authdjango plugin to read everything correctly. While that doesn't explicitly makes sense, for now it appears to be needed.
+See the [[https://docs.djangoproject.com/en/3.1/releases/3.1/|release notes]] for Django 3.1 for more details