Little Software Stats is a web application developed by Little Apps which provides a open source runtime intelligence solution.
PHP JavaScript CSS C Java HTML Shell
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
build
css
geoipdb
images
inc
install
js/jquery
min
pages
tests
.gitignore
.travis.yml
ERD.mwb
ERD.mwb.bak
LICENSE
README.md
_.htaccess
_httpd.ini
_iis_rewrite_setup.txt
_lighttpd.conf
_nginx.conf
api.php
dbschema.sql
index.php
login.php
travis.phpunit.xml.dist

README.md

Little Software Stats

Build Status

Little Software Stats is a web application developed by Little Apps which provides a open source runtime intelligence solution.

Little Software Stats is the first free and open source application that allows software developers to monitor how their software is being used. It is developed using PHP & MySQL which allows it to be ran on most web servers.

Requirements

The following is required to run Little Software Stats properly:

Notes

  1. URL rewrite support with the web server is recommended, but not required
  2. MySQL Improved will be used if it is installed (as the original MySQL API is deprecated). If it is not installed, the original MySQL API will be used instead.
  3. The appropriate web server and memory needed will depend on the scale of your software. For example, if your using Little Software Stats with a highly used software program then you may want to consider running Nginx or Lighttpd with lots of RAM. You should consider using something like suPHP which runs PHP at the user-level instead of the root user or the default PHP user.
  4. The FreeType and LibPNG libraries need to be included with the GD installation

Installation

  1. Upload and extract Little Software Stats to your web server
  2. Create a MySQL database with a user that has full privileges to access and modify it
  3. Go to http://example.com/install/ and follow the steps
  4. Remove or rename the install directory
  5. Integrate Little Software Stats with your software and track your users

Updating

  1. Make backup from web server of Little Software Stats directory and database
  2. Upload and extract the updated Little Software Stats archive to your web server
  3. Go to http://example.com/install/update.php and follow the steps
  4. Remove or rename the install directory
  5. Little Software Stats should now be updated

Example

If you would like to see Little Software Stats in action, please check out demo.little-software-stats.com. This website is in sync with every update that is pushed to this Git and there is only read-only access.

Release Notes

  • 0.1

  • First public release

  • 0.2

  • Split events table into multiple tables, improving query performance

  • Added LSS_API define to check if Little Software Stats was called via the API

  • Sessions are no longer created if called via the API

  • Outputs error in JSON or XML if unable to connect to database in API

  • Fixed bug causing script not to exit properly if unable to connect database

  • Fixed get_error() function from outputting error in wrong format

  • URL returned by get_file_url() and get_page_url() is encoded with htmlspecialchars() (by default)

  • If rewrite is disabled, query values return in get_page_url() are encoded with urlencode()

  • Updated GeekMail to PHPMailer

  • Fixed check for SMTP username and password options

  • Added update script

  • If page needs redirecting, URL returned by get_page_url() is not encoded

  • Added Session class for storing and getting session data

  • Login information is stored in one array instead of different keys in Session data

  • Added Config class for reading config.php file

  • Configuration is now returned as array by config.php file instead of defines

  • If $_SERVER['REMOTE_ADDR'] is not set (because running in command line), a random IP address is set

  • Fixed documentation for API::start_app() to show megabytes instead of bytes

  • Added PHPUnit tests (which are executed with Travis CI)

  • RewriteBase in _.htaccess is commented out by default

  • Classes are called via static method instead of global variables

  • Added support in API for IPv6 addresses

  • Uses built-in (in PHP v5.5+) or user-defined (in PHP v5.3.7+ and v5.4.x) password_hash() and password_verify() for password hashing

  • Fixed cross-site scripting (XSS) vulnerabilities

  • Fixed vulnerability allowing an attacking with the the username to reset the password

  • Uses CDN instead of local web server for HighCharts

  • Various other bug fixes and improvements

  • 0.2.1

  • Fixed up README.md

  • Fixed bug causing username not to be displayed properly in PHP v5.3

  • Fixed syntax error when trying create persistent connection with mysqli

  • Updated minimum PHP version in inc/version.php to v5.3.7

  • A few other minor bug changes

  • 0.2.2

  • Fixed data types created in install

  • Changed pages/settings.php to use builtin password hash functions

  • GeoIP database paths are specified by the user during installs

  • Various other fixes and updates

  • 0.2.3

  • Fixed data types in sessions and uniqueusers tables

To Do

  • Remove unneeded JavaScript files
  • Translations for various languages
  • Composer support
  • Update PHPMailer
  • SQLite support (through PDO)
  • Smarty integration
  • Pluggable (support for plugins)
  • Multiple logins
  • Login permissions
  • Mobile version
  • Better website template
  • Data export
  • Data export API
  • Automated reports
  • Two factor authentication support (Google Authenticator, Authy, etc)
  • Send notification via e-mail when someone logs in
  • Add TLS and SSL support to SMTP configuration options

License

Little Software Stats itself is licensed under the GNU General Public License v3 and the Little Software Stats libraries are licensed under the GNU Lesser General Public License.

Show Your Support

Little Apps relies on people like you to keep our software running. If you would like to show your support for Little Software Stats, then you can make a donation using PayPal, Payza or credit card (via Stripe). Please note that any amount helps (even just $1).

Credits

Little Apps would like to thank the following for helping Little Software Stats:

More Info

For more information, please visit http://www.little-software-stats.com