<!-- distributed with AuthDrupal v 0.6, 2008-0620 -->

If you are reading this in an INSTALL.txt file, then these instructions are for
the version of the files you have.

The latest version of these instructions and of the code can be found at
[http://www.mediawiki.org/w/index.php?title=Extension:AuthDrupal].

* download the AuthDrupal files and save or unpack them into
  wiki/extensions/AuthDrupal/

* Add code in AddToLocalSettings.php to the end of your wiki/LocalSettings.php
  file. Change the database settings to match your setup.
  
  Change the cookie domain name  to the domain under which your Drupal and wiki
  are hosted.  If drupal and mediawiki use the same database, just set
  $wgAuthDrupal_UseExtDatabase = false and ignore most of the  _MySQL_ settings.

* You need to assign a key to use to encode the username to prevent spoofing.
  Make up a key string (something unique, think of it as a password) and set
  the same value for wgAuthDrupal_security_key in LocalSettings.php.
  That key needs to be configured in the Drupal module later.
  
* To get rid of the "You must log in to edit pages" notice when a non-logged-in
  user clicks the Edit tab, do the following:

  ** Go to the article called "MediaWiki:Whitelistedittext".
  ** The edit box should be preloaded with this text: "You have to $1 to edit
     pages."
  ** Change this to the following (replace the url with whatever you've set for
     $wgAuthDrupal_LoginURL):

     You have to <span class="plainlinks">[http://mydomain.com log in]</span> to edit pages.

* Then you need to install the Drupal module and follow instructions in
  that module, which has now seperate releases at
  http://drupal.org/project/mediawikiauth

Things should work at this point. If behavior is funny at first, delete the
cookies for your domain, and try it again with a fresh start.

Optional parts:

* you may want to ensure that account creation is blocked. Try going to
  /wiki/index.php?title=Special:Userlogin&type=signup
  (TODO: document how to turn off account creation)

* even though the extension can change the login/logout link to point to Drupal,
  that does not stop a savvy user from going to Special:Userlogin directly. You
  may want to edit .htaccess to redirect that URL. There are instructions for
  this at the bottom of this page:
  [http://wiki.case.edu/CaseWiki:External_Authentication]