/SteamAuthentication

A simple PHP Authentication that enables steam users to log into their steam account to access content!

Primary LanguagePHPMIT LicenseMIT

Updated SteamAuthentication

This is an updated, simplified and PHP OOP version of SmItH197 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 https://bensmith.in/steam/

Gambling Sites

I nor Steam condone the use of this library for the purpose of gambling sites. Any sites that use this library for this purpose violates their API agreement and will receive notices from Steam to cease operations.

Read more here: http://store.steampowered.com/news/22883/

By downloading this library you agree that you will not use it for any gambling or illegal activity.

Issues

For Issues relating directly to this SteamAuthentication Library feel free to create a Github Issue.

For any general PHP or SQL problems please use stackoverflow or similar, else we will generally close these straight away if created here, thanks!

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:

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

To Install

Upload the files.

Open up class.php

  • change $domain_name to your domain name.
  • change $api_key to your Steam API Key from here.
  • change $login_page to your login page (optional).
  • change $logout_page to your logout page (optional).

In any pages you want steam authentication use (see apage.php):

<?php
require_once('class.php');
$sa = new steamAuth();
$sa->sessionStart();

if (!isset($_SESSION['steamid'])) {//Not logged in
    $sa->headerExit('index.php');//Go to login page (index.php for now)
} else {//Logged in
    //Page content....
    $sa->examplePlayerInfo();//Example data output
}
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

by default loginButton(); will display image

You can choose the style of the login button by specifying a variable like the following:

loginbutton("rectangle");

image

loginbutton(); -OR- loginbutton("square");

image

Using Profile Variables

I have created 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 user's 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 Check out the wiki for help on converting to date/time
  • $steamprofile['profileurl'] - The URL to their steam profile
  • $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 user's current state, 1 - Online, 2 - Busy, 3 - Away, 4 - Snooze, 5 - looking to trade, 6 - looking to play
  • $steamprofile['realname'] - The user's "real" name
  • $steamprofile['timecreated'] - When the account was created in unix time Check out the wiki for help on converting to date/time

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

Automatically refresh Steam profile data if older than specified time when they next visit your site