=== WP Steam Auth ===
Contributors: hwk-fr
Donate link: http://hwk.fr/
Tags: Steam, Steam Auth, Steam Authentification, Openid, OAuth, Register, Login, User, Avatar
Requires at least: 4.0
Tested up to: 4.6.1
Stable tag: 0.5.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Register, Login & Synchronize WP Users via Steam Authentification

== Description ==

This plugin will let your visitors register & login to your Wordpress via their Steam account using one and unique button.

All new authentification will create a new Wordpress legacy user and will be automatically logged in the process. Once they are registered via Steam, users may logout/leave or come back later to login to your Wordpress using the same button.

Old WP users (registered before the plugin activation) have the possibility to synchronize their account with Steam once loggedin with the legacy Wordpress system.

Note: WP Steam Auth Plugin is fully compatible with the WP backend. Steam profile data is stored in the WP_user meta data. WP Steam Auth doesn't interfere with the legacy WP Login/Registration system, it means that you'll be always able to login with the legacy method.

= Features: =

* Register/Login with one unique button
* Automatically create a new Wordpress legacy user
* Automatically Upload the Steam avatar during registration
* Choose to use the wordpress avatar or the steam avatar
* Synchronize button available for old WP Users
* Customize the Post-login & Post-Logout URL, or use Referer instead
* Customize URLs & base slugs (Login / Sync. / Logout)
* Login/Register via a popup for a better user experience

= Contributions: =

* Reworked & enhanced version of [PHP library Steam Authentification](https://github.com/SmItH197/SteamAuthentication) by SmItH197 ([demo](http://bensmith.in/steam/))

* [The original Steam Openid script](http://pastebin.com/6vZT4RhD) by JTX

* [The LightopenID library](http://gitorious.org/lightopenid)

== Installation ==

= Wordpress Install =

1. Upload the plugin files to the `/wp-content/plugins/wp-steam-auth` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Setup your Steam API via: http://steamcommunity.com/dev/apikey
4. Use the Settings->Steam Auth screen to configure the plugin

= Available PHP Functions & Conditions =

* `<?php wpsap_button_login(); ?>`
* `<?php wpsap_button_sync(); ?>`
* `<?php wpsap_button_loggout(); ?>`

* `<?php echo wpsap_button_login_url(); ?>`
* `<?php echo wpsap_button_sync_url(); ?>`
* `<?php echo wpsap_button_loggout_url(); ?>`

* `<?php if(!wpsap_is_user_synced()){ wpsap_button_sync(); } ?>`

== Frequently Asked Questions ==

= Do I need a Steam API key? =

Yes, you can get one for free here: http://steamcommunity.com/dev/apikey

= How can I display the login via Steam button? =

Use the following PHP functions:

* `<?php wpsap_button_login(); ?>`
* `<?php wpsap_button_sync(); ?>`
* `<?php wpsap_button_loggout(); ?>`

* `<?php echo wpsap_button_login_url(); ?>`
* `<?php echo wpsap_button_sync_url(); ?>`
* `<?php echo wpsap_button_loggout_url(); ?>`

* `<?php if(!wpsap_is_user_synced()){ wpsap_button_sync(); } ?>`

== Screenshots ==

1. WP Steam Auth Settings

== Changelog ==

= 0.5.2 =
* Added URL Rewriting Settings (Login / Sync / Logout)
* Added Logout Redirection + Referer options
* Improved code

= 0.5.0.2 =
* Removed session_start()

= 0.5.0.1 =
* Checking if LightOpenID already exists before require
* Better ABS path names
* Better custom filters names
* Better session_start encapsulation
* Removed ob_start()

= 0.5 =
* Initial Release

== Upgrade Notice ==

None