#SteamAuthentication

SteamAuthentication is a basic set of PHP files that enable users to login using their steam account to view protected content on your website. it creates a session using their steamid as the sessionID and checks for the session when a user visits the page. It also includes a file which allows you to use their profile information such as their avatar and online status.

See a demo at http://bensmith.in/steam/

##Download

Please note the main repository is constantly being updated so may contain bugs and other bleeding edge risks. For a stable download please visit the releases page: https://github.com/SmItH197/SteamAuthentication/releases

##Foreword

Thanks goes to:

• JTX for the original steam openid script (http://pastebin.com/6vZT4RhD)
• The LightopenID library (http://gitorious.org/lightopenid)

Using MySQL? Don't forget to sanitise your inputs!

##To Install

Upload the steamauth folder.

Open up settings.php and change domainname to your domain name. Add your API-Key from http://steamcommunity.com/dev/apikey

Now in your file add the following at the top:

<?php

require 'steamauth/steamauth.php';

?>

And where you want the protected content to be:

<?php
if(!isset($_SESSION['steamid'])) {

    echo steamlogin(); //login button

}  else {

    include ('steamauth/userInfo.php'); //To access the $steamprofile array
    //Protected content

    logoutbutton(); //Logout Button
}     
?>

You can also pass variables to steamlogin() to get them back once the user logs in by sending them as an array.

<?php
if(!isset($_SESSION['steamid'])) {

    $vars = array('foo' => 'bar', 'some' => 'thing');
    echo steamlogin($vars); //login button

}  else {

    include ('steamauth/userInfo.php'); //To access the $steamprofile array
    //Protected content

    echo $_GET['foo']; //Outputs bar
    echo $_GET['some']; //Outputs thing

    logoutbutton(); //Logout Button
}     
?>

By default, the logout button redirects to the root of the current folder, this can be changed in the settings.

#####Be aware that naming a file in your webpage root like any file in the steamauth folder will break SteamAuth.

###Choosing a login button style

You can choose the style of the login button by opening the settings and changing the value of buttonstyle to one of the following:

buttonstyle = "small";

buttonstyle = "large_no";

buttonstyle = "large";

##Using Profile Variables

I have create a userInfo.php file which creates an array of ready to use variables that includes profile information of the steam user that has logged in:

• $steamprofile['steamid'] - The users unique SteamID
• $steamprofile['communityvisibilitystate'] - This represents whether the profile is visible or not.
• $steamprofile['profilestate'] - If set, indicates the user has a community profile configured (will be set to '1')
• $steamprofile['personaname'] - Their current set profile name
• $steamprofile['lastlogoff'] - Last time the user was online in unix time
• $steamprofile['profileurl'] - The URL to their steam profile
• $steamprofile['avatar'] - The image URL to the smallest size of their avatar (32px x 32px)
• $steamprofile['avatarmedium'] - The image URL to the medium sized version of their avatar (64px x 64px)
• $steamprofile['avatarfull'] - The image URL to the largest size of their avatar (184px x 184px)
• $steamprofile['personastate'] - The users current state, 1 - Online, 2 - Busy, 3 - Away, 4 - Snooze, 5 - looking to trade, 6 - looking to play
• $steamprofile['realname'] - Get the real name
• $steamprofile['primaryclanid'] - The users primary group
• $steamprofile['timecreated'] - When the account was created
• $_SESSION['steam_uptodate'] - Set to false to refresh data from Steam

Please note that some of these variables may be unavailable for some users as it depends on their privacy settings.

• For more help on laying out the document or using the $steamprofile variable see the example.php file!