This repository has been archived by the owner on Jun 12, 2023. It is now read-only.
forked from cerealcable/Steam-Authentication-for-XenForo
-
Notifications
You must be signed in to change notification settings - Fork 8
/
README
170 lines (130 loc) · 6.67 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
Steam Authentication & Integration
A XenForo Addon
== Description ==
Authenticate to your XenForo forum with Steam! Steam Authentication &
Integration allows new and existing users to establish accounts via
their Steam accounts using the Steam Web API. There are additional
features such as: Steam statistics for your users; Generate notices
for users based on steam data (ex. notices for people who own a
specific game); Create trophies based on steam data (ex. trophy for
associating a steam account to your xenforo account). Best of all,
there are no template edits required!
This addon is a continuation of the original Steam Authentication &
Integration addon created by Morgan. If you have this version installed
already, you can upgrade to this addon without the need to re-install.
Just follow the upgrade steps below.
== IMPORANT NOTE ==
Steam Authentication & Integration 1.6.0+ only works on XenForo 1.5.0+
== Features ==
* Single Sign On / Authentication via Steam
* Statistics
* Notices
* SteamProfile
* Power by the Steam Web API
* No Template Hooks or Editing Required
== Minimum Requirements ==
* BCMath (PHP Extension, usually installed already)
* Steam Web API Key (http://steamcommunity.com/dev/apikey)
* allow_url_fopen = 1 (On by default in PHP)
== Recommended Requirements ==
* BCMath (PHP Extension, usually installed already)
* Steam Web API Key (http://steamcommunity.com/dev/apikey)
* cURL
== Installation Steps ==
1. Install Configure Prerequisites (if necessary)
CentOS / Redhat:
* yum install php-bcmath
Debian / Ubuntu:
* apt-get install php5-curl
2. Upload files in the upload directory to your forum
3. Install using the provided "addon-Steam.xml"
4. Change options for "Steam Integration" as necessary
== Upgrade Steps ==
== If your current version is < 1.5.0 ==
1. Delete root/js/steam directory (optional)
2. Upload the upload directory to your forum (overwrite any files)
3. Upgrade the addon using the provided "addon-Steam.xml" file
== Configuration ==
Steam Authentication & Integration can be configured in
Home > Options > Steam Integration under the Admin Control Panel.
>> IMPORTANT <<
Make sure that you have a STEAM API KEY entered into the configuration
options. This addon will NOT function properly without a valid API key.
>> /IMPORTANT <<
If you choose to display the steam statistics navbar tab, make sure to
also give allow permissions to the appropriate user groups or users.
Otherwise, they will not be able to view statistics. Permissions can be
changed under the Users section in the ACP.
The same goes for steam profile banners. Permissions need to be
configured to display them to users/groups.
== Troubleshooting ==
Please do not ask me (HowIChrgeLazer) directly for help via a Conversation.
Unless you have sensitive information to share (which you shouldn't share
with me anyways) then don't make a conversation and instead post in the
resource discussion! It also provides public documentation for others in
case they have similar issues.
Steps to take BEFORE asking for help:
* If you are using files from the develop branch on GitHub
I use GitHub as a way to track my progress and save my edits as I
develop the addon. There will be some occasions where commits to develop
branch will break features of the addon, or break it entirely. If you use
files from that branch, you do so at YOUR OWN RISK. I will accept bug
reports, but I will not support the develop branch of the addon.
* Read your log files
Don't know where they are or what they mean? Well then this is a good time
to research. You should be familiar with your forums environment before
installing an addon (and if you are not, you should become familiar or
consider contracting the work).
* Read the entire description & readme file
They contain instructions and hints which you may have missed or need to
do before you can continue.
* Read the resource discussion (available on the XenForo Community / Releases)
It is possible that someone else probably already has experience the same
exact issue. Go hunt through the thread to see if that is the case.
* Ask your question in the discussion!
If none of the above solved your problem, ask your question in the
resource discussion. I'll answer any questions there, and if you start a
conversation asking for help with your installation, I'll only tell you to
post in the discussion thread. I will try to respond in the discussion,
I promise.
== Known Issues / Fixes ==
* Problems displaying user activity in Firefox *
Firefox will not correctly report last seen on any page that has the SteamProfile
javascript.
* Failed to open stream: HTTP request failed! HTTP/1.1 401 Unauthorized *
This means that a SteamAPI key has not been configured or is invaild.
Please read the configuration section for information on getting the API
key configured.
* Name or service not known *
This can happen if you're having DNS issues with your webserver. Make
sure steam community URLs can resolve correctly.
== Like this Addon? ==
Awesome! Leave a review and tell me how much you like it and why! Feedback is
important so you might as well give it so those who develop for this addon can
make it better and others can see your opinions.
== License ==
Steam Authentication for XenForo
Original Code Written by Morgan Humes <[email protected]>
Copyright 2012 Morgan Humes
Code Forked and Updated by Michael Linback Jr. <[email protected]>
Copyright 2014 Michael Linback Jr.
Website: http://ragecagegaming.com
JSON steam profile badge idea by Luke Foreman
Steam Authentication for XenForo is free software: you can redistribute
it and/or modify it under the terms of the GNU General Public License
as published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.
Steam Authentication for XenForo is distributed in the hope that it
will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with SteamProfile. If not, see <http://www.gnu.org/licenses/>.
== Source Code ==
Steam Authentication for XenForo is open source! Visit our git repository at
github to fork, submit code, or even discuss the code.
== Additional Information ==
This fork was updated by Michael Linback Jr. <[email protected]>
If you'd like to see a current working example, please visit my XenForo
forum at https://ragecagegaming.com
This addon is in no affiliation with or endorsed by Steam or Valve Software.