FreeSTAR-Status-Engine/README.md

52 lines
3.8 KiB
Markdown
Raw Normal View History

2017-11-23 18:24:40 -05:00
# Server status page
2018-04-18 11:28:45 -04:00
![License](https://img.shields.io/github/license/Pryx/server-status.svg) ![Current release](https://img.shields.io/github/release/Pryx/server-status.svg) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/b82d62fa6d8b41119f68fd9eca3c3a08)](https://www.codacy.com/app/sajdl.vojtech/server-status?utm_source=github.com&utm_medium=referral&utm_content=Pryx/server-status&utm_campaign=Badge_Grade)
2018-01-02 17:31:34 -05:00
![screenshot](https://status.trucksbook.eu/img/screenshot.png)
2018-04-14 05:08:55 -04:00
Very simple server status page written in PHP that can run on **PHP 5.4+** - even on **shared webhosting**. Because why waste your money on another server (or host on a server that you might want to do maintenance on), when you can use cheap webhosting? And as a cherry on top - it works even without javascript!
2017-11-23 18:24:40 -05:00
2018-01-13 18:10:20 -05:00
## How do I install this thing?
Simply put the files on your server and access it from your browser. There will be a simple install dialog waiting for you.
You can find more info on [our wiki page](https://github.com/Pryx/server-status/wiki)
## Contributing
2018-01-30 12:02:31 -05:00
Anyone is welcome to make pull request with new features or security patches / bug fixes. You can find some ideas [here](https://github.com/Pryx/server-status/labels/help%20wanted).
2018-01-30 12:02:31 -05:00
### Translations
2018-01-13 18:10:20 -05:00
Any help with translations is much welcome! You can join us at https://poeditor.com/join/project/37SpmJtyOm. You can even add your own language. Just let me know when you're done and I'm going to include the language in the next release.
2018-01-02 17:31:34 -05:00
2018-01-30 12:02:31 -05:00
[List of contributors](https://github.com/Pryx/server-status/wiki/contributors)
2017-11-23 18:24:40 -05:00
## FAQ
### Does it actually run somewhere?
2018-01-13 18:10:20 -05:00
Yes it does! This is basically debranded version of https://status.trucksbook.eu/.
2018-01-30 12:02:31 -05:00
### Do you have a demo page?
Yes we have! Head over to https://demo.status.sajdl.com/admin and try the admin interface for yourself.
2018-01-13 18:12:46 -05:00
Login details:
```
email: sysadmin@example.com
password: Ss123456
```
2018-01-30 12:02:31 -05:00
Please note that changes are reverted every hour.
2017-11-23 18:24:40 -05:00
2018-04-20 10:30:20 -04:00
### I noticed there is a new release. How do I update?
Updating server status is fairly straightforward. Simply copy over the new files (with exception of `install.php`). Please double check that `config.php` didn't change - if it did, you will need to update it accordingly. This is also pretty straightforward - copy over the old `define()` statements and fill out any new ones (this should be fairly easy as the names are usually pretty self explanatory). This should not be required in future as it is planned to move most settings to database.
2018-04-13 15:48:18 -04:00
### Can I somehow pull status info from Server status programatically?
Yes you can! As of [9f7e15f](https://github.com/Pryx/server-status/commit/9f7e15fcd1d900108cbb0b3cad4bdc5ecf8b741b) we added API to pull status data... And more APIs are coming! Results are encoded in JSON format which should be pretty easy to use in any common programming language.
2017-11-23 18:24:40 -05:00
### Why does this project exist?
It was written as a school project where we had to create a website. I went with this because I found the lack of good looking, easy to install and use status page rather weird. Therefore my goal (as stated above) was to create a simplistic status page that could run almost anywhere. The code is not the nicest or cleanest and it definitely doesn't have that many features, but hey, it works!
### I want feature XY!
You can write an issue and I will try to take a look when I get some time *OR* you can actually make a fork as the code it GNU licensed. Pull requests are most welcome!
2018-01-30 13:59:16 -05:00
___
If you like this project, buy us a coffee!
<a href="https://www.buymeacoffee.com/Pryx"><img src="https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png" alt="Buy Me A Coffee" style="height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;" target="_blank"></a>