forked from mjljr/Steam-Authentication-for-XenForo
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
146 lines (116 loc) · 6.12 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
Steam Authentication & Integration
A XenForo Addon
== Description ==
This addon provides Steam Integration allowing new & existing users to establish
accounts via their Steam accounts. This is similar to the Twitter (New) plugin
which adds no custom template code by hand and instead properly creates
templates and implements them using hooks.
== Prerequisites ==
* cURL
* BCMath (PHP Extension, usually installed already)
* Steam Web API Key (http://steamcommunity.com/dev/apikey)
* PHP safe_mode off
* PHP open_basedir should not be set
== Installation Steps ==
1. Install Prerequisites
CentOS / Redhat:
* yum install php-bcmath
Debian / Ubuntu:
* apt-get install php5-curl
2. Upload files in the upload directory to your forum
3. Make the folder "js/steam/cache" world writable (chmod 777)
4. Install using the provided "addon-Steam.xml"
5. Change options for "Steam Integration" as necessary
== Upgrade Steps From 1.0.9 to 1.1.0+ ==
1. Upload the upload directory to your forum (overwrite any files)
2. Upgrade the addon using the provided "addon-Steam.xml" file
== Upgrade Steps From 1.0.x to 1.0.9 ==
1. Backup root/js/steam somewhere safe
2. Delete root/js/steam directory
3. Upload the upload directory to your forum (overwrite any files)
4. Upgrade the addon using the provided "addon-Steam.xml" file
== Features ==
* Single Sign On / Authentication via Steam
* Statistics
* Notices
== Need Help? ==
Glad you've decided to use Steam Authentication and Integration, but please do
not ask me directly for help via a Conversation. We are all working on building
our communities so 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 discussion!
Steps to take BEFORE asking for help:
* 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 your log files!
Pretty please???
* 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 discussions! (available on the XenForo Community / Releases)
Someone else probably already had the same exact issue...go hunt through
the thread to see if that is the case.
* Ask your question in the 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 respond in the discussion I promise!
== 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.
== Common Issues (and fixes) ==
* Server Error 302 on Steam Badges
Steam community is over capacity and cannot process your request. It should
resolve itself over time.
Having open_basedir set other than none or safe_mode on can cause 302 errors
on the Steam Profile badge. This has to do with the that project using
XML and CURL without the API.
* SQL errors during install
Drop xf_steam_games and xf_user_steam_games tables from your database prior
to the install.
* Invalid profile data
This occurs when the AJAX calls fail when using the "steamprofile" library.
Check your error log to set the appropriate permissions but likely files in
the "js" folder are writable.
* How do I migrate from other Steam Integration Addons?
Uninstalling the previous addon usually leaves Steam as an external
authentication source if you look in xf_user_external_auth after you
uninstall your users will still have Steam listed). Then you'll want to
also remove the custom field you created for the older add-on as it is no
longer used then follow the install process. It will use the existing data
stored within the xf_user_external_auth table so once you've completed the
migration your users will likely not notice the change.
Also, you'll need to revert any templates you had to change such as the part
for the login_bar. You should just reference the old addons install steps to
find exactly what to remove.
== 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 2013 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]>
In the original developers absence, I wanted to get this working again for
the XenForo community. I haven't noticed any more errors and things are running smoothly.
Of course though, I do ask that you try this update at your own risk.
If you'd like to see a current working example, please visit my XenForo forum
at http://ragecagegaming.com