=== Plugin Name ===
Contributors: sms225
Tags: authentication, cas, phpCAS
Requires at least: 2.0.2
Tested up to: 2.2.3
Stable tag: 1.5

Authenticate users using the phpCAS package (http://www.ja-sig.org/wiki/display/CASC/phpCAS).

== Description ==

Central Authentication System (CAS) is a single signon service provided by some universities.  <a href="http://www.ja-sig.org/wiki/display/CAS/Home">Read about it here.</a>

phpCAS is a client for the CAS service.  You can <a href="http://www.ja-sig.org/wiki/display/CASC/phpCAS">read about that here</a>.  You have to download it separately and point this script to it.

This plugin uses some hooks in WordPress's authentication system to bypass the normal login screen and authenticate over CAS instead.  Note that logged-in state is still maintained in cookies, and user entries are created in the local database.

== Installation ==

1. Download <a href="http://www.ja-sig.org/wiki/display/CASC/phpCAS">phpCAS</a> to a directory on your web server.  Comment out lines 60 - 103 of CAS.php unless you plan to configure and use the advanced PGT features.
2. Upload cas-authentication.php to the wp-content/plugins/ directory of your wordpress installation.
3. Change line 29 to point to your copy of phpCAS.
4. Configure the phpCAS::client part on line 35.  Default should work for Yale.
5. Change or delete the $user_email variable on line 85 (your school may not have emails that can be guessed from student netids).
6. Activate the plugin, and STAY LOGGED IN to your original administrator account.  You won't be able to log back in once you log out.
7. Open a window in a different browser (i.e. Internet Explorer if you were using FireFox), or on another computer.  Log in through CAS.
8. In the first browser window, make the newly created CAS user the new administrator.  You can log out now. (alternately, you can change some entries in the wp_usermeta table to make a new user the admin)
9. Disable Options -> Membership -> Anyone can register (they won't be able to)

== Frequently Asked Questions ==

= What school was this originally written for? =

Yale. Go Bulldogs.

= What about foo bar? =

Answer to foo bar dilemma.

= Did you come up with this all by yourself? =

Heck no.  <a href="http://dev.webadmin.ufl.edu/~dwc/2005/03/02/authentication-plugins/">This man</a> seems to deserve the credit for making WordPress's login system so flexible.  This plugin was made possible by his HTTP authentication plugin.

Also, thanks to Lou Rinaldi for feedback and encouragement.