http://wiki.prometheusipn.com/api.php?action=feedcontributions&user=Tristan&feedformat=atomPrometheusIPN Wiki - User contributions [en]2024-03-28T09:50:34ZUser contributionsMediaWiki 1.29.0http://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3491Installation:WebHosts2017-03-28T18:00:03Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This is in no way a <strong>full list</strong> of all hosts compatible with Prometheus. If you're wondering whether your host supports Prometheus before buying it, you can [https://nmscripts.com/prometheusCheck.zip download the requirements checker] to find out.</div><br />
<br />
In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Support:General&diff=3490Support:General2017-02-15T22:49:55Z<p>Tristan: /* TECHNICAL QUESTIONS */</p>
<hr />
<div>{{DISPLAYTITLE:General Questions about Prometheus}}<br />
<br />
=== PURCHASE QUESTIONS ===<br />
<br />
==== Are Prometheus updates free? How long will they be available? ====<br />
Yes! Prometheus updates are free for all of our customers and are made available whenever a new feature is developed or a security exploit patched. You will be notified by Scriptfodder and your admin panel every time a new update is released.<br />
<br />
While we cannot confirm whether Prometheus v2 is free for existing customers (due to it essentially being an entirely new script), it will be available at a discount to existing Prometheus customers.<br />
<br />
==== Do you offer refunds for Prometheus? ====<br />
Generally, no. Because of the digital distribution of our product, we do not offer refunds to our customers due to incompatibilities of their web host or for any reason that is not directly related to us. That being said, because we are cool, we may sometimes offer a refund for your transaction if we deem it necessary, but do not purchase our script and expect a refund.<br />
<br />
If you bought Prometheus and don't have a web host to put it on, there are free ones and paid ones for as low as $2 a month that you can choose. Please see our [[Installation:requirements|Installation Requirements]] page to see some good alternatives - both paid and free.<br />
<br />
==== I was banned from Scriptfodder. Can I still receive Prometheus updates? ====<br />
No, because we do licensing through Scriptfodder unless you are using our automatic update feature it is not possible to receive any further updates. '''That is why you should keep your account and scripts to yourself.'''<br />
<br />
=== DOWNLOAD QUESTIONS ===<br />
<br />
==== I cannot download Prometheus... help! ====<br />
If you're having issues installing Prometheus, please check the following:<br />
* '''Are you downloading from Scriptfodder?''' If you're trying to download via Scriptfodder (manually), double check that you have disabled Avast! if you have it installed. For some reason, Avast! marks Prometheus as a virus.<br />
* '''Are you trying to download via the automatic-updater?''' Please make sure you've read through our [[Dashboard:updating|Requirements for Automatic Updating]] if you haven't already.<br />
* '''Are you banned from Scriptfodder?''' Then the manual download method most likely won't work.<br />
<br />
=== TECHNICAL QUESTIONS ===<br />
<br />
==== How do I reinstall Prometheus? ====<br />
To reinstall Prometheus, please remove the /cache folder from your web server and also completely wipe and reinstall your MySQL database. Once you've reinstalled MySQL go back to install.php in Prometheus (reupload it if it doesn't exist, along with the install folder) and then run the installer again.<br />
<br />
==== Do you include a backdoor into Prometheus? ====<br />
No, we do not include any backdoor into Prometheus nor Neutron. We strongly believe in transparency and do not have any way to gain access to your server without you directly giving us access.<br />
<br />
Note that this means that we also cannot assist if you have deleted yourself from an admin account - in this instance, it will be necessary to either reinstall Prometheus or to run a SQL command to readd yourself. You can contact us for assistance with this.<br />
<br />
==== How many sites can Prometheus be activated on? ====<br />
As many as you'd like! So long as you're complying with our Terms of Service and only using it on your own community, we do not limit where or how many Prometheus installations you have. That being said, we may sometimes limit your access to Prometheus if we believe that you are acting in violation to your License Agreement, but will only do so after contacting you for clarification.<br />
<br />
==== What should I do if I discover a security exploit? ====<br />
Please contact us via our support center immediately. We take great consideration and care in ensuring our customers' privacy, and will work with you to discover the exploit and patch it as soon as possible.<br />
<br />
==== How often does Prometheus check for licensing? What happens if the licensing server goes down? ====<br />
Because we understand that sometimes our server may become overloaded by traffic requests - either naturally or as the result of a DDoS attack - * ''we only check Prometheus for activation every 6 hours''. This means that you can use Prometheus while our servers are down up to this point. * This only applies to old Prometheus versions, the newer versions only check once unless the software changes.<br />
<br />
If our servers by some chance are down longer, we will work our a solution and notify our customers via Scriptfodder.<br />
<br />
=== MISCELLANEOUS QUESTIONS ===<br />
<br />
==== A server owner who uses Prometheus is abusing the system / stole my money! ====<br />
Prometheus is merely a donation administration tool which is used to more easily process payments and make the job easier for the administrators to focus on what matters most - their community. And while we understand that some administrators have abused our service in the past, we do not and cannot be the middleman who is in control of the business practises of a server owner.<br />
<br />
If you are encountering a user who is abusing the Prometheus system, we highly recommend that you contact PayPal or the payment processor that you used to resolve the issue instead of contacting us.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=PrometheusIPN_Wiki:About&diff=3488PrometheusIPN Wiki:About2017-01-10T02:06:35Z<p>Tristan: </p>
<hr />
<div>This wiki is designed to provide an easy and quick way to setup, customise, configure and debug Prometheus for our clients. You can consider it a knowledgebase if you would like.<br />
<br />
Please note that while we do our best to make things as easy and straightforward during installation as possible, there are some instances in which your question is not solved, and you need further assistance. If this is the case, we offer support for free to all of our clients via our Support Center.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3486Integration:api2017-01-01T17:32:00Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px; margin-bottom: 10px;"><i class="fa fa-exclamation-triangle"></i> Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This page is recommended only for <strong>advanced users</strong>. If you don't have any familiarity with PHP or APIs, consider getting a developer to look this over for you. Support is <b>not provided</b> with the API.</div><br />
<br><br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3482Installation:WebHosts2016-11-15T17:18:09Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This is in no way a <strong>full list</strong> of all hosts compatible with Prometheus. If you're wondering whether your host supports Prometheus before buying it, you can [https://nmscripts.com/prometheusCheck.zip download the requirements checker] to find out.</div><br />
<br />
In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**<br />
<br />
=== ADDITIONAL HOSTS ===<br />
If you're a web hosting service and are looking to be showcased on this list, please [https://tristanp.ca/index.php#contact contact TristanP13].<br />
<br />
If you're a Prometheus user with a suggestion of either a paid or free web host, please [http://nmscripts.com/prometheus/support contact us via our Support Panel] with the suggestion and we'll investigate whether the host meets our requirements.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3481Installation:WebHosts2016-11-15T17:17:22Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This is in no way a <strong>full list</strong> of all hosts compatible with Prometheus. If you're wondering whether your host supports Prometheus before buying it, you can <a href="https://nmscripts.com/prometheusCheck.zip">download the requirement checker</a> to find out.</div><br />
<br />
In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**<br />
<br />
=== ADDITIONAL HOSTS ===<br />
If you're a web hosting service and are looking to be showcased on this list, please [https://tristanp.ca/index.php#contact contact TristanP13].<br />
<br />
If you're a Prometheus user with a suggestion of either a paid or free web host, please [http://nmscripts.com/prometheus/support contact us via our Support Panel] with the suggestion and we'll investigate whether the host meets our requirements.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3480Installation:WebHosts2016-11-15T17:10:19Z<p>Tristan: </p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**<br />
<br />
=== ADDITIONAL HOSTS ===<br />
If you're a web hosting service and are looking to be showcased on this list, please [https://tristanp.ca/index.php#contact contact TristanP13].<br />
<br />
If you're a Prometheus user with a suggestion of either a paid or free web host, please [http://nmscripts.com/prometheus/support contact us via our Support Panel] with the suggestion and we'll investigate whether the host meets our requirements.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=PrometheusIPN_Wiki:About&diff=3479PrometheusIPN Wiki:About2016-11-15T17:06:56Z<p>Tristan: </p>
<hr />
<div>This wiki is designed to provide an easy and quick way to setup, customise, configure and debug Prometheus for our clients. You can consider it a knowledgebase if you would like.<br />
<br />
Please note that while we do our best to make things as easy and straightforward during installation as possible, there are some instances in which your question is not solved, and you need further assistance. If this is the case, we offer support for free to all of our clients via our Support Center.<br />
<br />
It is managed and written by Marcuz and Newjorciks, with help from TristanP13. If you have a recommendation of what we should add or an article that you feel would benefit other users, please contact us via our Support Center.<br />
<br />
===CREDITS===<br />
====WIKI AUTHORS====<br />
* '''Marcuz''' - main wiki author and responsible for articles regarding web installation, debugging, MySQL and panel functionality.<br />
* '''Newjorciks''' - wiki author responsible for articles regarding Lua installation and troubleshooting.<br />
* '''TristanP13''' - wiki author in charge of general articles, panel functionality and web server articles.<br />
====WIKI CONTRIBUTORS====<br />
* '''J0sh0nat0r''' - security analyst for vulnerabilities in Prometheus.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3478Installation:WebHosts2016-11-15T17:06:34Z<p>Tristan: </p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3477Installation:WebHosts2016-11-15T17:05:42Z<p>Tristan: </p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**<br />
* [https://x10hosting.com/ x10Hosting]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Template:MainSidebar&diff=3476Template:MainSidebar2016-11-11T19:16:35Z<p>Tristan: </p>
<hr />
<div><div style="display:inline-block;float:right;width:232px;"><br />
{{CatStartNew|Main Menu}}<br />
{{CatItemExternalNew|shopping-cart|https://scriptfodder.com/scripts/view/565|Buy Prometheus|Buy the best donation system now!}}<br />
{{CatItemExternalNew|github|https://github.com/PrometheusIPN/Prometheus|Translate Prometheus|Prometheus is multi-lingual, and allows translating into nearly all languages.}}<br />
{{CatItemExternalNew|shopping-cart|https://scriptfodder.com/scripts/view/1399|Check out NeutronAdmin|If you like Prometheus, check out our admin panel, Neutron!}}<br />
{{CatItemExternalNew|life-ring|https://nmscripts.com/prometheus/support|Contact Support|Having trouble with Prometheus? Get support (for free) via our support center.}}<br />
|}<br />
</div></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3475Integration:api2016-11-11T00:55:05Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px; margin-bottom: 10px;"><i class="fa fa-exclamation-triangle"></i> Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This page is recommended only for <strong>advanced users</strong>. If you don't have any familiarity with PHP or APIs, consider getting a developer to look this over for you.</div><br />
<br><br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3474Integration:api2016-11-11T00:54:46Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px;"><i class="fa fa-exclamation-triangle"></i> Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<br><br />
<div style="background-color: #1fa67a; color: #fff; width: 100%; padding: 10px;"><i class="fa fa-info-circle"></i> This page is recommended only for <strong>advanced users</strong>. If you don't have any familiarity with PHP or APIs, consider getting a developer to look this over for you.</div><br />
<br><br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Main_Page&diff=3473Main Page2016-11-11T00:52:09Z<p>Tristan: </p>
<hr />
<div>{{MainSidebar}}<br />
{{CatStartNewMain|About PrometheusIPN}}<br />
<div><br />
PrometheusIPN is a Garry's Mod donation system. It is available for purchase on ScriptFodder. There's a link on the right hand side and below. PrometheusIPN is still work-in-progress which means it is not at a 'feature complete' state from a developer stand-point. <br><br>Prometheus IPN provides you, as a server owner, the tools you need to manage your donations in an easy and simple way. With Prometheus you no longer need to worry about manually giving your users the donator benefits they purchase, Prometheus does it for you!<br><br><br />
{{MainButtons|Buy Prometheus|Translate Prometheus}}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|General}}{{CatItemNew|life-ring|:Support:General|General FAQ|Learn about Prometheus including our refund policy and security}}{{CatItemNew|level-up|:Support:Version2|Version 2|The next generation of Prometheus}}{{CatItemNew|reply|:Support:Chargebacks|Chargebacks|How to deal with users charging back on Prometheus}}{{CatItemNew|th-list|:PrometheusIPN_Wiki:General_disclaimer|Standards of Service|The level of service we promise to provide for Prometheus}}{{CatItemNew|info-circle|:PrometheusIPN_Wiki:About|About This Wiki|Information about this wiki & credits}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Installation}}<br />
{{CatItemNew|check-circle|:Installation:requirements|Requirements|What you need in order to be able to run Prometheus}}<br />
{{CatItemNew|globe|:Installation:WebHosts|Compatible Hosts|Paid & free hosts guaranteed to work with Prometheus}}<br />
{{CatItemNew|html5|:Installation:website|Website|How to install the web part of Prometheus to your webserver}}<br />
{{CatItemNew|check-circle|:Installation:lua_prerequisites|Lua prerequisites|Things that you need to do in order to prepare Prometheus for installation on your gameserver}}<br />
{{CatItemNew|code|:Installation:lua|Lua|How to install the Lua part of Prometheus to your gameserver}}<br />
{{CatItemNew|search|:Installation:debugging|Debugging|If something is going wrong with Prometheus, read this}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Packages}}<br />
{{CatItemNew|server|:packages:servers|Servers|How to add a server to your Prometheus installation}}<br />
{{CatItemNew|cubes|:packages:adding|Packages|How to add and configure a package which users can buy for your gameserver}}<br />
{{CatItemNew|money|:packages:credit|Credits|How to add a credit package which users can buy to use on your store}}<br />
{{CatItemNew|cubes|:packages:assigning|Assigning|How to manually assign a user a package}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Actions}}<br />
{{CatItemNew|server|:actions:customjob|Custom job|Configuring custom jobs / how they work}}<br />
{{CatItemNew|server|:actions:sourcemod|SourceMod|Configuring SourceMod integratoin / how it works}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Dashboard}}<br />
{{CatItemNew|pie-chart|:dashboard:statistics|Statistics|How to learn more about your users and transactions on Prometheus, via your Dashboard Statistics}}<br />
{{CatItemNew|dollar|:dashboard:sales|Sales|How to create a sale on Prometheus so that packages are available at a discounted rate}}<br />
{{CatItemNew|users|:dashboard:users_transactions|Users/Transactions|How to manage the users whom are registered on your Prometheus installation, and view previous transactions made}}<br />
{{CatItemNew|map|:dashboard:updating|Updating|How to update Prometheus to its latest version, either using our automatic installer or manually}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Configuration}}<br />
{{CatItemNew|cogs|:settings:settings|Settings|Information about the settings that are available via Prometheus}}<br />
{{CatItemNew|sticky-note|:settings:notifications|Notifications|Ingame notifications}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Integration}}<br />
{{CatItemNew|money|:integration:gateways|Payment Gateways|Payment Gateways}}<br />
{{CatItemNew|microphone|:integration:teamspeak3|Teamspeak 3|Teamspeak 3 Integration}}<br />
{{CatItemNew|code|:integration:api|API|Prometheus API}}<br />
|}<br />
</div></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Main_Page&diff=3472Main Page2016-11-11T00:50:20Z<p>Tristan: </p>
<hr />
<div>{{MainSidebar}}<br />
{{CatStartNewMain|About PrometheusIPN}}<br />
<div><br />
PrometheusIPN is a Garry's Mod donation system. It is available for purchase on ScriptFodder. There's a link on the right hand side and below. PrometheusIPN is still work-in-progress which means it is not at a 'feature complete' state from a developer stand-point. <br><br>Prometheus IPN provides you, as a server owner, the tools you need to manage your donations in an easy and simple way. With Prometheus you no longer need to worry about manually giving your users the donator benefits they purchase, Prometheus does it for you!<br><br><br />
{{MainButtons|Buy Prometheus|Translate Prometheus}}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|General}}{{CatItemNew|life-ring|:Support:General|General FAQ|Learn about Prometheus including our refund policy and security}}{{CatItemNew|level-up|:Support:Version2|Version 2|The next generation of Prometheus}}{{CatItemNew|reply|:Support:Chargebacks|Chargebacks|How to deal with users charging back on Prometheus}}{{CatItemNew|th-list|:PrometheusIPN_Wiki:General_disclaimer|Standards of Service|The level of service we promise to provide for Prometheus}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Installation}}<br />
{{CatItemNew|check-circle|:Installation:requirements|Requirements|What you need in order to be able to run Prometheus}}<br />
{{CatItemNew|globe|:Installation:WebHosts|Compatible Hosts|Paid & free hosts guaranteed to work with Prometheus}}<br />
{{CatItemNew|html5|:Installation:website|Website|How to install the web part of Prometheus to your webserver}}<br />
{{CatItemNew|check-circle|:Installation:lua_prerequisites|Lua prerequisites|Things that you need to do in order to prepare Prometheus for installation on your gameserver}}<br />
{{CatItemNew|code|:Installation:lua|Lua|How to install the Lua part of Prometheus to your gameserver}}<br />
{{CatItemNew|search|:Installation:debugging|Debugging|If something is going wrong with Prometheus, read this}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Packages}}<br />
{{CatItemNew|server|:packages:servers|Servers|How to add a server to your Prometheus installation}}<br />
{{CatItemNew|cubes|:packages:adding|Packages|How to add and configure a package which users can buy for your gameserver}}<br />
{{CatItemNew|money|:packages:credit|Credits|How to add a credit package which users can buy to use on your store}}<br />
{{CatItemNew|cubes|:packages:assigning|Assigning|How to manually assign a user a package}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Actions}}<br />
{{CatItemNew|server|:actions:customjob|Custom job|Configuring custom jobs / how they work}}<br />
{{CatItemNew|server|:actions:sourcemod|SourceMod|Configuring SourceMod integratoin / how it works}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Dashboard}}<br />
{{CatItemNew|pie-chart|:dashboard:statistics|Statistics|How to learn more about your users and transactions on Prometheus, via your Dashboard Statistics}}<br />
{{CatItemNew|dollar|:dashboard:sales|Sales|How to create a sale on Prometheus so that packages are available at a discounted rate}}<br />
{{CatItemNew|users|:dashboard:users_transactions|Users/Transactions|How to manage the users whom are registered on your Prometheus installation, and view previous transactions made}}<br />
{{CatItemNew|map|:dashboard:updating|Updating|How to update Prometheus to its latest version, either using our automatic installer or manually}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Configuration}}<br />
{{CatItemNew|cogs|:settings:settings|Settings|Information about the settings that are available via Prometheus}}<br />
{{CatItemNew|sticky-note|:settings:notifications|Notifications|Ingame notifications}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Integration}}<br />
{{CatItemNew|money|:integration:gateways|Payment Gateways|Payment Gateways}}<br />
{{CatItemNew|microphone|:integration:teamspeak3|Teamspeak 3|Teamspeak 3 Integration}}<br />
{{CatItemNew|code|:integration:api|API|Prometheus API}}<br />
|}<br />
</div></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:requirements&diff=3471Installation:requirements2016-11-11T00:42:08Z<p>Tristan: </p>
<hr />
<div>=== WEBSITE REQUIREMENTS ===<br />
* PHP 5.4 or greater<br />
* A MySQL database<br />
* pdo_mysql extension enabled in your php.ini<br />
* cURL enabled in your php.ini<br />
* mbstring<br />
* php-xml<br />
* url_allow_fopen enabled in php.ini<br />
* OpenSSL ( With HTTPS wrapper )<br />
<br />
=== WEB HOSTS CONFIRMED TO BE COMPATIBLE WITH PROMETHEUS ===<br />
<br />
[http://wiki.prometheusipn.com/index.php?title=Installation:WebHosts Click here for a list of compatible hosts.]<br />
<br />
==== Linux Hosting ====<br />
If you have experience with Linux servers I'd suggest just getting a DigitalOcean droplet for $5 to run a webserver on. Though '''don't do this if you have no idea what you're doing.'''<br />
<br />
===== How to check if your webserver supports Prometheus =====<br />
Download [https://nmscripts.com/prometheusCheck.zip the requirement checker] and extract it on your webserver. Then visit the file called '''prometheus_check.php'''. It will now tell you if your PHP version can run Prometheus.<br />
<br />
==== How to Install Prometheus on your Website ====<br />
[[installation:website|Website installation instructions found here]]<br />
<br />
=== LUA REQUIREMENTS ===<br />
[[Installation:lua prerequisites|Lua prerequisites / requirements]]<br />
<br />
Nearly all Garry's Mod hosts will support Prometheus for in-game compatibility. So long as your host allows you to upload .dll files, you're good to go!<br />
<br />
You'll require the MySQLoo module from [http://facepunch.com/showthread.php?t=1357773 here] or the tMySQL module from [http://facepunch.com/showthread.php?t=1442438 here]. We highly recommend Tmysql for the speed, security and multi-connection support.<br />
<br />
==== How to Install Prometheus on your Gameserver ====<br />
[[installation:lua|Lua installation instructions found here]]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3470Installation:WebHosts2016-11-11T00:27:16Z<p>Tristan: </p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
=== PAID WEB HOSTS ===<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://avalanchehosting.co.uk/shared.php Avalanche hosting] - ''AvalanceHosting is confirmed to be 100% compatible with Prometheus. As of the time of writing, only UK hosting is available from Avalanche.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
=== FREE WEB HOSTS ===<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - **Only Johnny accounts work**<br />
* [https://x10hosting.com/ x10Hosting]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3469Installation:WebHosts2016-11-11T00:24:47Z<p>Tristan: </p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
==== Paid Web Hosts ====<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://avalanchehosting.co.uk/shared.php Avalanche hosting] - ''AvalanceHosting is confirmed to be 100% compatible with Prometheus. As of the time of writing, only UK hosting is available from Avalanche.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
==== Free Web Hosts ====<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Additionally, free hosts may occasionally place third-party advertisements on your content or limit the amount of bandwidth you have accessible.<br />
<br />
However, we've tried our very best to find the least-intrusive free hosts available. They are - as of now - confirmed to be compatible with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - ''Free and probably slow, but it works! Only US hosting is available. **Only Johnny accounts work**''</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:WebHosts&diff=3468Installation:WebHosts2016-11-11T00:22:39Z<p>Tristan: Created page with "In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can..."</p>
<hr />
<div>In order to be able to effectively run Prometheus, you need a compatible web host who supports the necessary features to make the panel functional. The exact requirements can be found [[http://wiki.prometheusipn.com/index.php?title=Installation:requirements here]]. '''A common missing feature on many web hosts is the ability to have remote database connections''', so be sure to ask your host about this before signing up with them.<br />
<br />
We've compiled a short list of compatible web hosts of Prometheus. While this is by no means inclusive, it should give you an idea of where to get started if you're not sure who to go with.<br />
<br />
==== Paid Web Hosts ====<br />
* [https://billing.gameswitchers.co.uk/aff.php?aff=12 GameSwitchers] - ''GameSwitchers is confirmed to be 100% compatible with Prometheus, with multiple locations available and plans available. Their plans start at '''$1.24/month'''.''<br />
* [https://www.nfoservers.com/order-webhosting.php NFOServers] - ''NFOServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$2.54/month''' when billed annually. Hosting is in the United States only.''<br />
* [https://uk.godaddy.com/hosting/web-hosting?isc=gofheny06 GoDaddy] - ''GoDaddy's Linux hosting is confirmed to be 100% compatible with Prometheus. Windows hosting works though may occasionally cause issues. Please contact us if you encounter any issues with Windows hosting. Their plans start at '''$1.49/month''' when billed yearly, and includes a free domain.''<br />
* [https://avalanchehosting.co.uk/shared.php Avalanche hosting] - ''AvalanceHosting is confirmed to be 100% compatible with Prometheus. As of the time of writing, only UK hosting is available from Avalanche.''<br />
* [https://www.serenityservers.net/webhosting/ Serenity Servers] - ''SerenityServers has been confirmed to be 100% compatible with Prometheus. Their plans start at '''$1.46/month'''.''<br />
<br />
==== Free Web Hosts ====<br />
Please note that free web hosts are not recommended with Prometheus as they often are slow and lack some recommended security features their paid counterparts offer. Regardless, the following two hosting providers have been confirmed - as of now - to be working with Prometheus:<br />
* [http://www.heliohost.org/home/ HelioHost] - ''Free and probably slow, but it works! Only US hosting is available. **Only Johnny accounts work**''</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=PrometheusIPN_Wiki:About&diff=3467PrometheusIPN Wiki:About2016-11-11T00:11:18Z<p>Tristan: </p>
<hr />
<div>This wiki is designed to provide an easy and quick way to setup, customise, configure and debug Prometheus for our clients. You can consider it a knowledgebase if you would like.<br />
<br />
Please note that while we do our best to make things as easy and straightforward during installation as possible, there are some instances in which your question is not solved, and you need further assistance. If this is the case, we offer support for free to all of our clients via our Support Center.<br />
<br />
It is managed and written by Marcuz and Newjorciks, with help from TristanP13. If you have a recommendation of what we should add or an article that you feel would benefit other users, please contact us via our Support Center.<br />
<br />
===CREDITS===<br />
====WIKI AUTHORS====<br />
* '''Marcuz''' - main wiki author and responsible for articles regarding web installation, debugging, MySQL and panel functionality.<br />
* '''Newjorciks''' - wiki author responsible for articles regarding Lua installation and troubleshooting.<br />
* '''TristanP13''' - wiki author in charge of general articles, panel functionality and web server articles.<br />
====WIKI CONTRIBUTORS====<br />
* '''J0sh0nat0r''' - security analyst for vulnerabilities in Prometheus.<br />
* '''GhettoMickeyMouse''' - suggested a free and compatible web host for Prometheus - x10Hosting.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=PrometheusIPN_Wiki:About&diff=3466PrometheusIPN Wiki:About2016-11-11T00:10:47Z<p>Tristan: Added GhettoMickeyMouse to list</p>
<hr />
<div>This wiki is designed to provide an easy and quick way to setup, customise, configure and debug Prometheus for our clients. You can consider it a knowledgebase if you would like.<br />
<br />
Please note that while we do our best to make things as easy and straightforward during installation as possible, there are some instances in which your question is not solved, and you need further assistance. If this is the case, we offer support for free to all of our clients via our Support Center.<br />
<br />
It is managed and written by Marcuz and Newjorciks, with help from TristanP13. If you have a recommendation of what we should add or an article that you feel would benefit other users, please contact us via our Support Center.<br />
<br />
===CREDITS===<br />
====WIKI AUTHORS====<br />
* '''Marcuz''' - main wiki author and responsible for articles regarding web installation, debugging, MySQL and panel functionality<br />
* '''Newjorciks''' - wiki author responsible for articles regarding Lua installation and troubleshooting<br />
* '''TristanP13''' - wiki author in charge of general articles, panel functionality and web server articles.<br />
====WIKI CONTRIBUTORS====<br />
* '''J0sh0nat0r''' - security analyst for vulnerabilities in Prometheus<br />
* '''GhettoMickeyMouse''' - suggested a free and compatible web host for Prometheus - x10Hosting.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:teamspeak3&diff=3460Integration:teamspeak32016-09-03T15:00:40Z<p>Tristan: Protected "Integration:teamspeak3" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>=== TEAMSPEAK 3 INTEGRATION ===<br />
Prometheus offers the capability of being able to assign a usergroup and a channel to a user on your own Teamspeak3 server provided that you configure it properly. Please note that our Teamspeak 3 Integration is more advanced than the other package types and as such is not recommended if you do not understand what this guide is detailing. <br />
<br />
==== Finding the necessary information ====<br />
Download [http://forum.teamspeak.com/showthread.php/73296-Release-Extended-Client-Info?highlight=default_extended this] theme for teamspeak 3 to be able to see some of the information you need later on.<br />
<br />
You will now have an extended view of channels and users like this:<br />
<br />
* User<br />
<br />
[[File:teamspeak1.png|300px]]<br />
<br />
* Channel<br />
<br />
[[File:teamspeak2.png|300px]]<br />
<br />
==== Setting up the integration ====<br />
<br />
The settings you need to set are the following:<br />
<br />
* Server query username This is usually "Serveradmin"<br />
* Server query password This is usually given to you when you first create your Teamspeak server<br />
* Query port This is by default 10011, but can differ. Ask your host if you did not set up your own Teamspeak server<br />
* Virtual server id If you set up your Teamspeak yourself, this is 1. If not ask your host<br />
* Server IP You know this one<br />
* Server Port By default 9987, if not it's after the : in your IP<br />
<br />
==== Finding server id ====<br />
<br />
Download the program called YaTQA (Yet another Teamspeak Query Admin)<br />
<br />
Sign in through YaTQA and go to "Servers". <br />
<br />
[[File:teamspeak3.png|300px]]<br />
<br />
==== Setting up your action ====<br />
<br />
[[File:teamspeak4.png|300px]]<br />
<br />
If you want to assign a server group to a user you could tick that action and input for example <code>Server Admin</code> <br />
<br />
If you want the user to be able to get one channel, you can enable that action and input the following:<br />
<br />
* Channel ID of parent channel e.g as shown above next to "Private Channels" there is a small number like 610. This is the channel ID<br />
* Group ID of server rank, as shown on the picture below:<br />
<br />
[[File:teamspeak5.png|300px]]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:gateways&diff=3459Integration:gateways2016-09-03T14:59:07Z<p>Tristan: Protected "Integration:gateways" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Payment Gateways ======<br />
Current payment gateways:<br />
* PayPal<br />
* Paymentwall<br />
* Credits (Purchased using any other Payment Gateway)<br />
* Stripe<br />
<br />
====== PayPal ======<br />
* Visit your Paypal account(Both sandbox and not sandbox) at [https://www.paypal.com/cgi-bin/customerprofileweb?cmd=_profile-ipn-notify this] link. Go to "My selling tools" and find "Instant Payment Notification". Set the URL to the same as your Prometheus' IPN URL(Admin->General Settings->Payment Gateways->PayPal) and activate IPN URL on Paypal.<br />
<br />
Like the following:<br />
<br />
[[File:paypal1.png|900px]]<br />
<br />
[[File:paypal2.png|900px]]<br />
<br />
* Test your system with PayPal Sandbox and if everything works fine turn off sandbox and you're good to go :)<br />
<br />
====== Paymentwall ======<br />
In order to use paymentwall you need to modify a few things on your PaymentWall controlpanel:<br />
<br />
[[File:paymentwall.png|800px]]<br />
<br />
'''You need to add four custom pingback parameters'''<br />
<br />
* goodstype -> own<br />
* price -> own<br />
* cur -> own<br />
* coupon -> own '''- THIS ONE IS NEW AS OF 1.6.2'''<br />
<br />
You also need to set your pingback url to <code>http://yourprometheus.com/donate/paymentwall.php</code><br />
<br />
The secret key and project keys are found on your Paymentwall "My projects" page. Review key should be left blank and widget key is by default p10<br />
<br />
Now submit your project for review and hope that they accept you and don't tell you that I haven't set up some user API bullshit they want to enforce.<br />
<br />
====== Credits ======<br />
Credits is a virtual currency within Prometheus. The only setting you'll be able to set in the credits options is the ability to only use credits as payment for packages / raffles.<br />
<br />
====== Stripe ======<br />
<br />
The first thing you need to do is sign in to your Stripe account.<br />
Now make sure your account is set to live, and properly set up. Then go to your user in the top right and click account settings.<br />
<br />
[[File:stripe1.png|800px]]<br />
<br />
You will now be greeted with this screen. Click "API Keys" and retrieve your live secret key and your live publishable key<br />
<br />
[[File:stripe2.png|800px]] <br />
<br />
They have to be copied and pasted into Prometheus' Payment Gateways -> Stripe settings.<br />
<br />
API Key is the secret key, publishable key is the publishable key<br />
<br />
[[File:stripe3.png|800px]]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Settings:notifications&diff=3458Settings:notifications2016-09-03T14:58:55Z<p>Tristan: Protected "Settings:notifications" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Ingame Notifications ======<br />
You can modify the messages displayed to the user ingame here. <br />
<br />
[[File:notifications.png|900px]]<br />
<br />
How it's done is explained on the Ingame Notifications page itself.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Settings:settings&diff=3457Settings:settings2016-09-03T14:58:43Z<p>Tristan: Protected "Settings:settings" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>Prometheus offers a wide variety of settings that allow you to modify anything from the site title to payment method. As of 1.6.3.8, the below settings are configured via your admin.php?a=gen&p=settings file. This page is to document what each of the settings available does and what value you should set it to.<br />
<br />
[[File:settings.png|800px]]<br />
<br />
=== GENERAL SETTINGS ===<br />
<br />
==== Site Title ====<br />
Fairly self-explanatory. This is the title that will appear in your visitor's browser.<br />
<br />
==== Banner URL ====<br />
The banner is the image which displays on top of the menu on every non-admin page. It is ideally supposed to be 354x100px. You can change it to an Imgur direct image or you can overwrite the file in the img directory called banner.png.<br />
<br />
==== Logo URL ====<br />
The logo appears on the left of your menu on every page. It should be 64x64px, but any larger size will be automatically resized for you so long as it is square.<br />
<br />
==== Theme ====<br />
You can change your theme of the site to be one you have created in the Theme Editor.<br />
<br />
=== STORE SETTINGS ===<br />
<br />
==== Featured pkg ====<br />
This is the package that will be listed at the top and most prominently when a user clicks on the Store link. This is recommended to be changed to your most popular option.<br />
<br />
==== Package Display ====<br />
When a user chooses a server from the Store page, how many store items should be displayed on one line? You are able to choose between 1, 2 and 3. If you have many packages, choosing a higher package display number is recommended.<br />
<br />
==== Enable Coupons ====<br />
Should coupons be enabled on your Prometheus install? If this is disabled, coupons will not appear when the user is checking out, and you will not have access to the coupon editor.<br />
<br />
==== Disable Terms of Service ====<br />
If you would like for the Terms of Service to not display in the footer of your Prometheus install, you can disable it here. When disabled, access to the ToS editor will be disabled.<br />
<br />
==== Disable buying for others ====<br />
Enabling this option means that users will no longer be able to complete any purchases for other users, and will disable the "Buying for someone else?" option during checkout.<br />
<br />
==== Disable sorting options ====<br />
By default, Prometheus shows various methods in which the user is able to filter the packages available on your server (eg. price low to high, most purchased, etc.), but if you would like to disable it, you can do so with this option.<br />
<br />
==== Disable custom job auto giving ====<br />
By default, Prometheus will give any users the custom jobs they've created instantly on the server. However, you can disable it with this option so that manual approval of jobs is required.<br />
<br />
==== Enable support tickets ====<br />
Prometheus has an integrated support ticket system in which users can ask for support. If this option is disabled, users will not see a support option and the support ticket center on the Admin panel will be removed.<br />
<br />
==== Enable raffle ====<br />
Fairly self explanatory. If this is enabled, you will have access to create raffles for packages and credits from the Admin panel and it will appear for users under the Store tab.<br />
<br />
==== Enable global packages ====<br />
If this is enabled, you will be able to create packages for all servers at once and there will be a new option on the Store page.<br />
<br />
==== Maintenance mode ====<br />
You can place your website in Maintenance mode in order to prevent users from having any access to your store. This is good when you are customizing or creating new packages or servers. Users attempting to visit the store will be greeted with a "Maintenance mode is active" error.<br />
<br />
=== MAIN PAGE SETTINGS ===<br />
<br />
===== Disable news =====<br />
If you disable news, it will no longer appear on your Prometheus' home page nor the ToS page. You also will not be able to create new news from the Admin panel.<br />
<br />
===== Display top donators =====<br />
If you enable this, Prometheus will display the top 3 donators of your store on the main page.<br />
<br />
===== Display recent donators =====<br />
If you enable this, the last 3 transactions from your store will be displayed on the main page. This includes credit purchases.<br />
<br />
===== Enable monthly goal =====<br />
If you enable the monthly goal, it will display a bar showing your progress to the donation goal that you specify. The goal resets every month on the day that you specify from the second box when the option is checked.<br />
<br />
=== USER PROFILE SETTINGS ===<br />
<br />
==== Don't show statistics on user profiles ====<br />
If this is enabled, users will no longer see any purchase history such as total amount spent, amount spent this week, etc. They will also not see their graphs of transaction history.<br />
<br />
==== Don't show non-permanent packages on users profiles & Don't show permanent packages on users profiles ====<br />
Self-explanatory. This will disable the displaying of packages associated with the user.<br />
<br />
=== OTHER SETTINGS ===<br />
<br />
==== Show copyright ====<br />
While we appreciate the support and awareness generated by the PrometheusIPN footer we include, we allow you to disable it if you would like. Disable this in order to stop the PrometheusIPN copyright displaying in the footer.<br />
<br />
==== Opt-out of stats tracking ====<br />
Prometheus collects and submits certain information back to the NMScripts servers so that we can better understand how our clients use our service. However, in the sake of transparency, we allow you to opt-out of all tracking. Enable this to stop any tracking.<br />
<br />
==== Clear cache ====<br />
This is a developer option that can be enabled when you are having issues with your site. Don't tick this unless you know what you're doing.<br />
<br />
=== SEASONAL SETTINGS ===<br />
<br />
==== Enable Christmas things ====<br />
When enabled, users to your Prometheus installation will be greeted with snowflakes flying across the screen thanks to the marvels of Javascript.<br />
<br />
==== Enable advent calendar ====<br />
By popular request, Prometheus now includes an advent calendar which allows you to give out packages and credits leading up to Christmas.<br />
<br />
=== WARNING SETTINGS ===<br />
Typically, you should keep these on as they will remind you to change settings so that your site is functional.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Dashboard:updating&diff=3456Dashboard:updating2016-09-03T14:57:56Z<p>Tristan: Protected "Dashboard:updating" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>=== WEBSITE ===<br />
==== Automatic Updating ====<br />
With Prometheus, web updates ''can'' be automatic, so long as you meet all of the requirements for being able to do so.<br><br><br />
[[File:updates.png|850px]] <br />
<br />
===== Requirements for Auto-Updating =====<br />
<br />
The only requirement for being able to auto-update Prometheus is having the right directory permissions. On Linux, execute the following in a terminal to allow for automatic updating:<br />
<br />
cd path/to/installdir<br />
sudo chown www-data:www-data *<br />
sudo chmod 775 updates<br />
<br />
On Windows, it should already be enabled. If it is not, set the Guests group to have read/write access to the updates folder in order to allow for automatic updating. If using IIS, grant the IUSR account read, write and execute access to the updates folder.<br />
<br />
==== Manual Updating ====<br />
<br />
Performing a manual update for the Web and MySQL portion of Prometheus is not hard! <br />
<br />
* Download the latest distribution from [https://scriptfodder.com/scripts/view/565 our Scriptfodder page].<br />
* Under 'Web Files' '''IN THE ZIP FILE YOU JUST DOWNLOADED''' delete the '''config.php''', '''img''' folder and '''install.php'''.<br />
* If using a customised theme port any changes in your Cascading Style Sheet over.<br />
* Upload the files to your web server.<br />
* Sign into the 'Admin' section of your donation page.<br />
* Click on the 'Updates' tab that is located in the 'Main Dashboard'.<br />
* Apply any new SQL updates. '''AS OF 1.5.1 SQL UPDATES NOW APPLY AUTOMATICALLY UPON VISITING THE ADMIN AREA.'''<br />
<br />
Congratulations you have successfully updated the website portion of Prometheus! If a lua update is necessary continue on below.<br />
<br />
=== LUA ===<br />
==== Manual Update ====<br />
<br />
Lua can currently only be updated manually however it is a simple process!<br />
<br />
* Download the Latest lua distribution from either [[https://scriptfodder.com/scripts/view/565/description/|Scriptfodder]] or the Update tab under "download latest lua" via your Prometheus installation.<br />
* Check to see if there is any changes between your current lua config file and the one included in the latest distribution.<br />
* If there are changes fill out the details require referring back to your old lua config file.<br />
* If there are no changes simply delete the config file included in the latest distribution.<br />
* Upload the latest distribution to your addons folder replacing any existing files.<br />
* Restart your server.<br />
<br />
Congratulations you just finished the final step in updating your Prometheus donation system! If you are unsure if any changes were made to the lua config it is best to follow 'Step 3.'.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Dashboard:users_transactions&diff=3455Dashboard:users transactions2016-09-03T14:57:42Z<p>Tristan: Protected "Dashboard:users transactions" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Users ======<br />
<br />
Here you can manage your users, and do things like assign credits and [[packages:assigning|assig a package]]. You can also view their user profile and activate/de-activate packages they have.<br />
<br />
<br><br><br />
[[File:users.png|900px]]<br />
<br><br><br />
<br />
====== Transactions ======<br />
<br />
Transactions allow you to see the following information:<br />
<br />
<br><br><br />
[[File:transactions.png|900px]]<br />
<br><br></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Dashboard:sales&diff=3454Dashboard:sales2016-09-03T14:57:20Z<p>Tristan: Protected "Dashboard:sales" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Sale ======<br />
<br />
Sales are made by selecting the package in which you want the sale to apply to, the sale percentage and message. You also need to make sure the date is set to a future date. Unfortunately for us who prefer the European standard for dates, this date is in the American standard. Month/Day/Year<br />
<br />
<br><br><br />
[[File:sale.png|900px]]<br />
<br><br></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Dashboard:statistics&diff=3453Dashboard:statistics2016-09-03T14:57:04Z<p>Tristan: Protected "Dashboard:statistics" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Statistics ======<br />
<br />
<br><br><br />
[[File:statistics.png|900px]]<br />
<br><br><br />
<br />
You can view statistics about your Prometheus panel here. The above image is an example</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Actions:customjob&diff=3452Actions:customjob2016-09-03T14:56:50Z<p>Tristan: Protected "Actions:customjob" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>== Custom jobs ==<br />
Custom jobs with Prometheus are really simple once you understand the principles of them:<br />
<br />
<br />
=== Adding the action ===<br />
When adding the custom job action there are a few things yo need to understand.<br />
<br />
These are the default values of the custom job action, if you do not choose to expand any of the checkboxes then the user will not be able to decide anything themself.<br />
<br />
[[File:5yG2.png|900px]]<br />
<br />
You can fill them out as described above if you don't want the users to be able to choose anything themself. The model paths is the path to the actual model starting from the root directory of your garrysmod server(The folder your addons folder, data folder, cfg folder, gamemodes folder, lua folder, etc is in). So the path to a model could be ''models/author/model.mdl''<br />
<br />
If you expand the weapons dropbox you will get something like this:<br />
<br />
[[File:UL7E.png|900px]]<br />
<br />
You can add more weapons by clicking the green '''+''' button and remove them by pressing the red '''-'''. The price is the amount in the packages currency that will be added to the final price of the package if the user chooses this weapon. Credits is the amount of final credits cost of the package if the user chooses this weapon. If you are not using the credits system there is no need to specify the credits value as the user can't pay using it if that's the case.<br />
<br />
The same process goes for models, license, friends and salary.<br />
<br />
=== The users view of things ===<br />
<br />
Depending on what you enabled or didn't enable the user will get something like this whenever they try to purchase a custom job package:<br />
<br />
[[File:Jobusersidepart1.png|900px]]<br />
<br />
[[File:Jobusersidepart2.png|900px]]<br />
<br />
The price at the bottom is a calculation of everything the user chooses to add to their package. Discounts still apply here, however they are listed on checkout. <br />
<br />
=== Editing an active custom job ===<br />
<br />
Since the job is automatically added to your server upon purchase there is only one place it can be stored, and that is MySQL. But fear not, there is an easy way to edit the code for custom jobs through Prometheus.<br />
Navigate to Dashboard -> Packages and then to View active custom jobs<br />
<br />
[[File:Customjobcode.png|900px]]<br />
<br />
In here you can actually edit the code of the custom job, incase you want to give the user a custom workshop model, or any other kind of special check as well.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Packages:assigning&diff=3451Packages:assigning2016-09-03T14:56:37Z<p>Tristan: Protected "Packages:assigning" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Assigning a package ======<br />
There are several ways to assign a package. It can be done either by buying it through [[other:sandbox|Paypal Sandbox]] or assigning it to a specific user in Dashboard -> Users -> Manage -> Assign package</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Packages:credit&diff=3450Packages:credit2016-09-03T14:56:24Z<p>Tristan: Protected "Packages:credit" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Credit packages ======<br />
Credit packages are not much different from normal Packages, the only difference being the fact you are defining the amount of credits the user gets when buying the credit package for a price. <br />
<br />
If you do not see the Credit packages link in your admin dashboards sidebar it is because you have not enabled credits in the [[settings:settings|Settings]]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Packages:adding&diff=3449Packages:adding2016-09-03T14:56:09Z<p>Tristan: Protected "Packages:adding" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Adding a package ======<br />
Before adding a package you need to [[packages:servers|Add a server]]<br />
<br />
===== Currencies =====<br />
You can add, edit or remove a currency through the "Currencies" tab. Adding a currency is just as easy as adding a server. You only need to define one thing: <br />
<br />
* CC - This is the Currency Code(Example: GBP) The CC code needs to be correct in order for paypal to accept the payment!<br />
<br />
===== Categories =====<br />
The last thing you need to specify before adding a package is additional categories, by default there's one category called "Other". <br />
<br />
* Category name - This is the category name, it can be anything like "Pointshop", "Weapons", "Ranks"<br />
<br />
===== Packages =====<br />
Packages are what you sell for each specific server. You are able to modify the following regarding packages: <br />
<br />
* Title<br />
* Display image - 138px x 240px<br />
* Category<br />
* Price and currency<br />
* Informative labels<br />
* Package description<br />
* Permanent - Choose whether or not the package is permanent<br />
* Actions - Performed after a certain packages is bought. This is modified after the package is added. This works on code located on your server. You can also add custom code snippets directly from the panel itself.<br />
<br />
<br><br><br />
[[File:packages1.png|900px]]<br />
<br><br><br />
<br />
After you have performed all of these steps, move on to the next page about defining actions. <br />
<br />
===== Assigning an action =====<br />
Actions are the core of the donation system. Without them the system would have no ingame automated features.<br />
<br />
Assign what action(s) a certain package perform after it is bought from our pre-defined actions or use custom code. You can also assign whether or not the package is compatible with certain other packages or not.<br />
Custom actions - You can add a custom action using lua, it is explained on the page how to do it. You need to have lua knowledge as this is an "Advanced feature".<br />
<br />
<br><br><br />
[[File:packages2.png|900px]]<br />
<br><br></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Packages:servers&diff=3448Packages:servers2016-09-03T14:55:56Z<p>Tristan: Protected "Packages:servers" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== Adding a server ======<br />
Adding a server is simple, just go to the Servers -> Add server tab in your prometheus dashboard, fill in the name and press submit. <br />
<br />
Remember your ''ServerID'' as you will need this later. The ServerID for your server '''MUST''' match the ServerID in the lua config for the corresponding server<br />
<br />
You can now move on to [[packages:adding|Adding a package]]</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:debugging&diff=3447Installation:debugging2016-09-03T14:55:42Z<p>Tristan: Protected "Installation:debugging" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>If you have any issues with Prometheus you should always read this article first:<br />
=== WEB AND LUA ERRORS ===<br />
<br />
==== MySQL not connecting / "Server has failed connecting to the database. Please contact the owner!" ====<br />
<br />
* Make sure you have MySQL remote connections enabled on your webhost's controlpanel, and your GMod server's IP whitelisted. In case you haven't done so already, you need to make sure that you have [[Installation:Lua|installed your Tmysql/MySQLOO module]] correctly.<br />
* You can see exactly what is going wrong by checking your console and seeing what happens when the first player joins after the server restarts. All Prometheus error messages will have ''[Prometheus] DB connection error'' before the error.<br />
* If issues persist after trying these troubleshooting options, please [http://nmscripts.com/prometheus/support contact support].<br />
<br />
==== "Access denied for user 'X'@'XXX.XXX.XXX.XXX' (using password: YES)" ====<br />
* You have either entered your MySQL username and password wrong in your config file, or permission is not allowed for the IP address that is connecting.<br />
* If this message appears, make sure that remote connections are allowed from your website's control panel.<br />
<br />
==== "MySQL Server has gone away" ====<br />
<br />
* Set your refreshrate in your lua config to 15 seconds or less. Your MySQL server does not allow any connections that last longer than 15 seconds most likely, so it's timing out before its hitting the default 40.<br />
* To fix this run these two commands in your MySQL (If you can't, get your host to do it):<br />
SET @@GLOBAL.wait_timeout=300;<br />
SET @@LOCAL.wait_timeout=300;<br />
<br />
==== I do not receive the test message on my server ====<br />
<br />
* Enable the launch parameter -condebug on your server unless you are using TCAdmin 2.0 already.<br />
* '''If you are using TCAdmin2''' (or any web-console), view your server console upon starting your server and look for anything that starts with ''[Prometheus]''. CTRL+F is your friend so that you can find it more quickly.<br />
* If you are using -condebug, search for the same thing as if you were using TCAdmin2, but instead search the console.log file within your GMod servers "Garrysmod" directory<br />
<br />
==== I do receive the test message, but don't get the items in my server ====<br />
This can mean one of two things:<br />
* Your IPN url in General Settings -> Payment Gateways -> PayPal is wrong. <br />
* Your ServerID in your prometheus lua config is wrong. Make sure it's correct(Edit a server to find out its ID)<br />
<br />
Check your server console for any errors that might give you a hint of what the error is.<br />
<br />
If there are no errors there, also check the ipn_errors.log file for errors and contact support.<br />
<br />
===== Not getting any items on my server, and nothing appearing in the transaction log of Prometheus =====<br />
<br />
* You have not set up your Prometheus properly following this [[installation:website|installation tutorial]]. Your PayPal is receiving the money, but is not sending a pingback message to your webserver.<br><br> [[File:pingback.png|400px]] <br><br><br />
<br />
Your system is failing at the red arrow (Inbetween PayPal and your installation). You need to set your IPN URL in PayPal itself. See the installation tutorial link above.<br />
<br />
===== Not getting any items on my server, but something appearing in the transaction log of Prometheus =====<br />
<br />
* Your serverID is most likely incorrect in your lua config. To find your actual serverID go to Admin-> Servers and edit a server to see the ID.<br />
=== WEB ISSUES ===<br />
==== Parse error unexpected '[' ====<br />
<br />
* You do not have the latest PHP 5.4 version or greater installed on your webserver. If this is the case, you need to update your PHP version from your website control panel. If 5.4+ is not available, contact your webhost's support team and request that they update it for you.<br />
<br />
==== When logging in, "An error occurred while processing your request. Reference #XX.XXXXXXXX.XXXXXXXXXX.XXXXXXX" ====<br />
* This is an issue with Steam. Please wait and it should resolve itself eventually. Please do not contact NMScripts support as there is nothing we can do about this.<br />
<br />
==== Permanent packages don't get assigned, the test message doesn't send either! Help! ====<br />
* This is due to your MySQL server not accepting invalid dates, this will only be an issue up until version 2.0. <br />
* To fix this, run the following MySQL query: <br />
* '''SET GLOBAL sql_mode ='TRADITIONAL,ALLOW_INVALID_DATES;'''<br />
* '''SET SESSION sql_mode = 'TRADITIONAL,ALLOW_INVALID_DATES;'''<br />
* Make sure to set this SQL_MODE in your MySQL config file too if you have access to it.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:lua&diff=3446Installation:lua2016-09-03T14:55:30Z<p>Tristan: Protected "Installation:lua" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== LUA INSTALLATION ======<br />
Install the [[Installation:lua_prerequisites|lua prerequisites]] first<br />
<br />
* Extract the "Lua files" folder to the root dir on your Garry's Mod server(Typically garrysmod/garrysmod)<br />
* Configure addons/prometheus/lua/prometheus_config.lua to your preference. Remember to give it the right ServerID! (This is explained how to get in the "Adding a package" tab)</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:lua_prerequisites&diff=3445Installation:lua prerequisites2016-09-03T14:55:11Z<p>Tristan: Protected "Installation:lua prerequisites" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>=== Installing prerequisites for Prometheus' lua portion ===<br />
Install the [[Installation:website|web files]] first<br />
<br />
You need to install either tMySQL or MySQLoo. We recommend tMySQL, but you can use MySQLoo as well.<br />
<br />
<br />
<br />
==== tMySQL ====<br />
<br />
[http://facepunch.com/showthread.php?t=1442438 Link to tMySQL]<br />
<br />
Download [https://github.com/blackawps/gm_tmysql4/releases/download/R1/gmsv_tmysql4_win32.dll this for Windows] or [https://github.com/blackawps/gm_tmysql4/releases/download/R1.01/gmsv_tmysql4_linux.dll this for Linux] and put it in ''garrysmod/garrysmod/lua/bin''<br />
<br />
[[File:Bin.png]]<br />
<br />
You need to create the lua/bin folder manually if you do not already have it.<br />
<br />
<br />
<br />
==== MySQLoo ====<br />
The MySQLoo 9 module from [https://facepunch.com/showthread.php?t=1515853 here]<br />
<br />
Download [https://github.com/syl0r/MySQLOO/raw/master/MySQL/lib/windows/libmysql.dll?raw=true this for windows] or [https://github.com/syl0r/MySQLOO/raw/master/MySQL/lib/linux/libmysqlclient.so.18?raw=true this for linux] and put it here:<br />
<br />
''(The image shows libMySQL.dll which is for windows, but if you're on linux libmysqlclient.so.18 goes here)''<br />
<br />
[[File:Libmysql.png]]<br />
<br />
<br />
Download [https://github.com/syl0r/MySQLOO/blob/master/out/windows/gmsv_mysqloo_win32.dll?raw=true this for Windows] or [https://github.com/syl0r/MySQLOO/blob/master/out/linux/gmsv_mysqloo_linux.dll?raw=true this for Linux] and put it here:<br />
<br />
[[File:Bin.png]]<br />
<br />
You need to create the lua/bin folder manually if you do not already have it.<br />
<br />
<br />
'''Done''' Continue with the [[Installation:lua|lua files]] installation</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Installation:website&diff=3444Installation:website2016-09-03T14:54:59Z<p>Tristan: Protected "Installation:website" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>=== VIDEO TUTORIAL ===<br />
GoldTrigger has created an installation walkthrough for Prometheus. It explains step-by-step how to install and is recommended for novice web hosters:<br />
<br />
<youtube>J_hrKtHqF9c</youtube><br />
<br />
'''''Please note''': the version of Prometheus being used for this tutorial is out of date, however, installation is still generally completed in a similar way.''<br />
=== WEBSITE INSTALLATION ===<br />
The web installation is pretty straight forward.<br />
<br />
* Extract the contents of the "Web files" folder to your web server<br />
* Create a MySQL database and user using your website's control panel. Make sure to give the user read/write/execute access to the database.<br />
* Edit the file config.php that you have uploaded and fill in the MySQL database and user information from step 2. (for the host, typically you can leave it as 'localhost' and port '3306')<br />
* After you have modified your config.php file, navigate to yourwebsite.com/install.php. Here, you will see something similar to this:<br />
<br><br />
[[File:Web1.png|900px]]<br />
<br><br />
<br />
The three last fields will be automatically filled in and the other ones are pretty self explanatory.<br />
<br />
===== Extra Steps for Linux Installations =====<br />
<br />
The next step is for Linux only. Make sure to set the right permissions for your files! This can be done by running these commands in a Linux terminal:<br />
<br />
cd path/to/installdir<br />
sudo chown www-data:www-data install.php img/pkgs updates themes<br />
sudo chmod 775 install.php cert/* ipn_errors.log img/pkgs updates<br />
sudo chmod 0777 cache/* themes<br />
<br />
=== BLANK PAGE / ERROR 500 ===<br />
If you are encountering an issue with the page being blank or your web browser stating an 'Internal Error 500', please follow the below guide in order to fix it:<br />
<br />
==== Windows ====<br />
The next step is for Windows only!<br />
* Right click on the cache folder -> Properties -> Security and make sure guests have access to write to the directory<br />
* If you are having error 500 and have already allowed IIS_USRS access, please make sure to also grant IUSR access.<br />
<br />
==== Linux ====<br />
* Right click on the cache folder in filezilla/WinSCP and give it 0777 chmod permissions ''recursively''<br />
* Alternatively, you can also just run the SSH command ''sudo chmod 0777 cache/* ''whilst in the Prometheus directory.<br />
<br />
'''Both'''<br />
<br />
If the blank page issue persists, please find a PHP error log and submit a ticket over at [[nmscripts.com]] with your host's PHP error log (found on your website's control panel typically). It's likely that you are missing a dependency.<br />
<br />
When you have completed the installation you can now visit yourwebsite.com and click 'Sign In' from the menu. The first user that signs in is the one that will get root admin permission, so please make sure to sign in quickly to make sure you don't get locked out.<br />
<br />
=== OPTIONAL INSTALLATION STEPS ===<br />
You may complete the following additional tasks to extend your Prometheus installation's capabilities:<br />
* You can set your /img folder to have read/write permissions (CHMOD 0777) to allow you to upload files directly when configuring packages and servers.<br />
* If you include a Steam API key in your config.php file, it will be used as a fallback in case Steam authorization fails. This is recommended.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Support:Chargebacks&diff=3443Support:Chargebacks2016-09-03T14:54:30Z<p>Tristan: Protected "Support:Chargebacks" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>Have you been charged back by a user on your panel? This page will tell you about how chargebacks happen and what you can do to deter - if not prevent - them.<br />
<br />
==== What is a chargeback? How does it happen? ====<br />
Chargebacks are quite simply the description of what happens when a user who has made a purchase on your Prometheus installation contacts PayPal or their bank in order to request that the funds they transferred was a transaction not done by them or was one that was never delivered. And while this is an excellent method for when you've been scammed on Craigslist or a with a shady iPhone case seller, it is a double edged sword as it means that you lose all of the funds for a service that was received.<br />
<br />
And while there is nothing that you can do to stop chargebacks from happening, there are methods you can take on Prometheus after a user has chargebacked in order to prevent them from being able to do it again.<br />
<br />
==== Why are chargebacks detrimental to my business/server? ====<br />
Every transaction made via PayPal incurs a 3.9% fee. This is why when a user makes a $2 transaction via PayPal, you only get $1.92 sent to your PayPal. However, when a user chargebacks, you lose any of the funds that were given to your account, plus the 3.9% transaction fee by PayPal. And there's nothing you can do to prevent it, even if they're using the PayPal Resolution Center.<br />
<br />
==== How do I detect a chargeback? ====<br />
You can find any chargebacks fairly easy on your PayPal activity dashboard. Prometheus also has a way to automatically detect when a chargeback has occured and will automatically remove the user's package from their account. You can find any records of chargebacks made on your Prometheus installation from the logs tab of your admin dashboard. You can find that typically a chargeback will look similar to this on PayPal:<br />
<br />
[[File:Chargeback.png]]<br />
<br />
==== I've been chargebacked! What do I do now? ====<br />
If you've been chargebacked for a purchase made on Prometheus, you have full control over what you can do with the user. Here's some common steps other administrators take when they've been chargebacked that we recommend:<br />
# '''Blacklist the user from being able to buy any more packages on your server.''' You can do this by visiting your Prometheus admin panel, clicking on the Users navigation tab, and then clicking on View Blacklist. Then, in the bar at the top, enter the chargebacking user's SteamID or Steam Community ID and click Submit. The user will no longer be able to buy any further packages.<br />
# '''Ban the user from your server(s).''' While this is optional, it helps deter users from wanting to do any more chargebacks for fear of being banned. You can clearly state on your Terms of Service page that if you chargeback you will be banned.<br />
# '''Contact PayPal support.''' If you believe that the same user is continuously charging back you in order to make you pay a large number of fees, you can contact PayPal support and tell them that Purchase Protection is not eligible as you are running a digital service and what the user is doing. With some experiences PayPal will even reimburse any fees you encountered.<br />
Obviously, your policy is entirely your policy, but these steps should give you an idea of what to do. While you may not be able to prevent chargebacks, you can at least remedy them.</div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3442Integration:api2016-08-30T03:09:07Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px;"><i class="fa fa-exclamation-triangle"></i> Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<br><br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3441Integration:api2016-08-30T03:08:38Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px;"><i class="fa fa-exclamation-triangle"></i> Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3440Integration:api2016-08-30T03:08:07Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding: 10px;">Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3439Integration:api2016-08-30T03:07:47Z<p>Tristan: </p>
<hr />
<div><div style="background-color: #FF0000; color: #000000; width: 100%; padding-top: 10px; padding-bottom: 10px;">Please note that our API is currently very limited. More functionality is coming in version 2.</div><br />
<br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3438Integration:api2016-08-30T03:07:02Z<p>Tristan: </p>
<hr />
<div><span style="background-color: #FF0000; color: #000000;">Please note that our API is currently very limited. More functionality is coming in version 2.</span><br />
<br />
===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3437Integration:api2016-08-30T03:04:19Z<p>Tristan: </p>
<hr />
<div>===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
<code>http://yourprometheus.com/api.php?hash=HASH&action=ACTION</code><br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3436Integration:api2016-08-30T03:02:57Z<p>Tristan: </p>
<hr />
<div>===WHAT IS THIS API? WHAT DOES IT DO?===<br />
An API (short for "Application Program Interface"), is a way of communication with a system both internally and externally. It allows you to perform actions or receive data from/to a system. Prometheus uses an API to allow you to perform various actions using a script remotely.<br />
<br />
===WHAT CAN I DO WITH THE API?===<br />
With Prometheus, you can do the following things currently:<br />
<br />
* Add a package to a user(Using Steam64 or SteamID)<br />
* Get donation goal info<br />
<br />
===API VARIABLES===<br />
The API has a few things you can designate:<br />
<br />
*''hash'' - The hash is the API key you created when enabling the API from your Prometheus admin dashboard. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
*''action'' - The performed action<br />
<br />
*''steamid'' - The users steamid<br />
<br />
*''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
http://yourprometheus.com/api.php?hash=HASH&action=ACTION<br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3435Integration:api2016-08-30T02:58:02Z<p>Tristan: Protected "Integration:api" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>====== The API ======<br />
===== What is this api? =====<br />
An API(Application Program Interface), is a way of communication with a system both internally and externally. With Prometheus this allows you to do the following things currently:<br />
<br />
Add a package to a user(Using Steam64 or SteamID)<br />
Get donation goal info<br />
<br />
The API has a few things you can designate:<br />
<br />
''hash'' - The hash you generate above if you enable API. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
''action'' - The performed action<br />
<br />
''steamid'' - The users steamid<br />
<br />
''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
http://yourprometheus.com/api.php?hash=HASH&action=ACTION<br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Integration:api&diff=3434Integration:api2016-08-30T02:57:40Z<p>Tristan: Reverted edits by 86.156.41.224 (talk) to last revision by Marcuz</p>
<hr />
<div>====== The API ======<br />
===== What is this api? =====<br />
An API(Application Program Interface), is a way of communication with a system both internally and externally. With Prometheus this allows you to do the following things currently:<br />
<br />
Add a package to a user(Using Steam64 or SteamID)<br />
Get donation goal info<br />
<br />
The API has a few things you can designate:<br />
<br />
''hash'' - The hash you generate above if you enable API. This has to be kept a secret. Do not give it to anyone else.<br />
<br />
''action'' - The performed action<br />
<br />
''steamid'' - The users steamid<br />
<br />
''package'' - The package<br />
<br />
===== How do I use it? =====<br />
The API is accessed by typing this into your browser:<br />
<br />
http://yourprometheus.com/api.php?hash=HASH&action=ACTION<br />
<br />
Not all actions require a hash, for instance the getGoal action does not require a hash and can be accessed directly. The API returns the response in **JSON**. It can be securely communicated with using **cURL**.<br />
<br />
===== List of actions ===== <br />
<br />
{| class="wikitable"<br />
|+Api calls<br />
|-<br />
!Action<br />
!getGoal<br />
!assignPackage<br />
!addCredits<br />
!getPackages<br />
|-<br />
!Hash<br />
|No<br />
|Yes<br />
|Yes<br />
|Yes<br />
|-<br />
!Properties<br />
|None<br />
|steamid, package<br />
|steamid, amount<br />
|None<br />
|-<br />
!Returns<br />
|error, cur, total, goal<br />
|error, msg<br />
|error, msg<br />
|error, packages<br />
|}<br />
<br />
===== Examples =====<br />
==== getGoal Example ====<br />
<br />
'''getGoalExample.php'''<br />
<?php<br />
<br />
$get = file_get_contents('http://marcuz.eu/ipn/api.php?action=getGoal');<br />
$array = json_decode($get, true);<br />
<br />
if($array['error'] == 0){<br />
$percentage = $array['perc'];<br />
$total = $array['total'];<br />
$goal = $array['goal'];<br />
$currency = $array['cur'];<br />
<br />
echo '<br />
<b>Goal:</b> '.$goal.' '.$currency.'<br><br />
<b>Received:</b> '.$total.' '.$currency.'<br><br />
<b>Percentage:</b> '.$percentage.'%<br />
';<br />
}<br />
<br />
?><br />
<br />
==== assignPackage Example ====<br />
<br />
'''assignPackageExample.php'''<br />
<?php<br />
<br />
// Replace everything in uppercase letters with your own information<br />
$source = 'http://yourprometheus.com/api.php?hash=YOUR_HASH&action=assignPackage&package=PACKAGE_ID&steamid=STEAM64_OR_STEAMID';<br />
<br />
$ch = curl_init();<br />
curl_setopt($ch, CURLOPT_URL, $source);<br />
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);<br />
curl_setopt($ch, CURLOPT_SSLVERSION,4);<br />
$data = curl_exec($ch);<br />
$error = curl_error($ch);<br />
curl_close ($ch);<br />
<br />
if($data === false) {<br />
// Display an error if there is any<br />
die('Curl error: ' . $error);<br />
}<br />
<br />
// Decode the data response<br />
$array = json_decode($data, true);<br />
<br />
// Display an error if there is any<br />
if($array['error'] == 1){<br />
die($array['msg']);<br />
}<br />
<br />
// Display success message<br />
if($array['error'] == 0){<br />
echo($array['msg']);<br />
}<br />
<br />
?></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=Main_Page&diff=3433Main Page2016-08-27T22:55:29Z<p>Tristan: </p>
<hr />
<div>{{MainSidebar}}<br />
{{CatStartNewMain|About PrometheusIPN}}<br />
<div><br />
PrometheusIPN is a Garry's Mod donation system. It is available for purchase on ScriptFodder. There's a link on the right hand side and below. PrometheusIPN is still work-in-progress which means it is not at a 'feature complete' state from a developer stand-point. <br><br>Prometheus IPN provides you, as a server owner, the tools you need to manage your donations in an easy and simple way. With Prometheus you no longer need to worry about manually giving your users the donator benefits they purchase, Prometheus does it for you!<br><br><br />
{{MainButtons|Buy Prometheus|Translate Prometheus}}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|General}}{{CatItemNew|life-ring|:Support:General|General FAQ|Learn about Prometheus including our refund policy and security}}{{CatItemNew|level-up|:Support:Version2|Version 2|The next generation of Prometheus}}{{CatItemNew|reply|:Support:Chargebacks|Chargebacks|How to deal with users charging back on Prometheus}}{{CatItemNew|th-list|:PrometheusIPN_Wiki:General_disclaimer|Standards of Service|The level of service we promise to provide for Prometheus}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Installation}}<br />
{{CatItemNew|check-circle|:Installation:requirements|Requirements|What you need in order to be able to run Prometheus & hosts that work with Prometheus}}<br />
{{CatItemNew|html5|:Installation:website|Website|How to install the web part of Prometheus to your webserver}}<br />
{{CatItemNew|check-circle|:Installation:lua_prerequisites|Lua prerequisites|Things that you need to do in order to prepare Prometheus for installation on your gameserver}}<br />
{{CatItemNew|code|:Installation:lua|Lua|How to install the Lua part of Prometheus to your gameserver}}<br />
{{CatItemNew|search|:Installation:debugging|Debugging|If something is going wrong with Prometheus, read this}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Packages}}<br />
{{CatItemNew|server|:packages:servers|Servers|How to add a server to your Prometheus installation}}<br />
{{CatItemNew|cubes|:packages:adding|Packages|How to add and configure a package which users can buy for your gameserver}}<br />
{{CatItemNew|money|:packages:credit|Credits|How to add a credit package which users can buy to use on your store}}<br />
{{CatItemNew|cubes|:packages:assigning|Assigning|How to manually assign a user a package}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Actions}}<br />
{{CatItemNew|server|:actions:customjob|Custom job|Configuring custom jobs / how they work}}<br />
{{CatItemNew|server|:actions:sourcemod|SourceMod|Configuring SourceMod integratoin / how it works}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Dashboard}}<br />
{{CatItemNew|pie-chart|:dashboard:statistics|Statistics|How to learn more about your users and transactions on Prometheus, via your Dashboard Statistics}}<br />
{{CatItemNew|dollar|:dashboard:sales|Sales|How to create a sale on Prometheus so that packages are available at a discounted rate}}<br />
{{CatItemNew|users|:dashboard:users_transactions|Users/Transactions|How to manage the users whom are registered on your Prometheus installation, and view previous transactions made}}<br />
{{CatItemNew|map|:dashboard:updating|Updating|How to update Prometheus to its latest version, either using our automatic installer or manually}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Configuration}}<br />
{{CatItemNew|cogs|:settings:settings|Settings|Information about the settings that are available via Prometheus}}<br />
{{CatItemNew|sticky-note|:settings:notifications|Notifications|Ingame notifications}}<br />
|}<br />
</div><br />
<br />
<div><br />
{{CatStartNewMoreCategory|Integration}}<br />
{{CatItemNew|money|:integration:gateways|Payment Gateways|Payment Gateways}}<br />
{{CatItemNew|microphone|:integration:teamspeak3|Teamspeak 3|Teamspeak 3 Integration}}<br />
{{CatItemNew|code|:integration:api|API|Prometheus API}}<br />
|}<br />
</div></div>Tristanhttp://wiki.prometheusipn.com/index.php?title=PrometheusIPN_Wiki:General_disclaimer&diff=3431PrometheusIPN Wiki:General disclaimer2016-08-27T22:27:31Z<p>Tristan: Protected "PrometheusIPN Wiki:General disclaimer" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>At Prometheus, we want to offer the very best service that we can to our customers. That's why we've created our Standards of Service, which details in depth how we manage to serve you and what you can expect us to support, and what to not support.<br />
<br />
===IN A NUTSHELL===<br />
Here's what we '''will''' provide support for:<br />
* Your licensed version of Prometheus, running on your own site.<br />
* Installation issues.<br />
* PHP errors which appear when you attempt to install or run Prometheus.<br />
* Licensing issues that occur when attempting to use Prometheus.<br />
* Questions about the functionality of Prometheus (example: how do I make a global package?)<br />
* Suggestions about future Prometheus features.<br />
* Any other issues related to Prometheus itself, including security questions.<br />
<br />
Here's what we '''will not''' provide support for:<br />
* Your cracked/non-licensed version of Prometheus.<br />
* MySQL issues (these must be resolved by your host).<br />
* Fixing your host to be able to use Prometheus.<br />
* Step-by-step installation of Prometheus by one of our technicians.<br />
* Modified versions of Prometheus (both code and theme).<br />
* Outdated versions of Prometheus.<br />
<br />
We will '''provide a response within 3 days''', but usually we respond '''within the hour'''.<br />
<br />
===IN DETAIL===<br />
Our average response time is less than two hours but, depending on the nature of your request, it may take up to five business days for your issue to be addressed. Our technicians will work to keep you updated on your request's progress.<br />
<br />
Prometheus requires you to be using the latest version of our software to be guaranteed support and compatibility. We refuse the right to provide support to previous versions of our software. This is to minimise diagnostic and support times that would require us to potentially address an issue that's already resolved in a later release. Keeping your Prometheus installation up-to-date is also in your best interest from a security and performance standpoint.<br />
<br />
Prometheus does not support modified versions of our software. Our only solution will be to revert to an unmodified state if a modification you have created is causing an issue.<br />
<br />
In some circumstances, your server's issues will impact our software's ability to run properly. Prometheus cannot make adjustments to your server hosting environment to bring it to acceptable standards. If it is discovered that your host is not compatible with Prometheus, our only solution would be to recommend an alternate host to you.<br />
<br />
Our technicians often need access to your community's MySQL database or FTP to diagnose a support issue. If you do not provide such access: support may be limited.<br />
<br />
Our technical support is designed to assist you with the built-in functionality of our software or to address problems running our software in a usual manner in a hosting environment that is the norm for the majority of web hosting providers. '''MySQL database management, code customizations, and web host assistance are not supported.'''</div>Tristan