Skip to content

supertuxkart/stk-addons

Folders and files

NameName
Last commit message
Last commit date
Feb 21, 2023
Sep 15, 2021
Oct 31, 2017
Aug 28, 2020
Aug 7, 2014
Jul 20, 2018
Apr 14, 2023
Feb 21, 2023
Jul 12, 2018
Oct 13, 2016
Apr 15, 2019
Apr 16, 2019
Nov 10, 2017
Jul 14, 2018
Mar 10, 2021
Dec 27, 2022
Jan 5, 2019
Jul 20, 2018
Apr 14, 2019
Apr 15, 2019
Jul 12, 2018
Jan 30, 2010
Aug 18, 2014
Apr 14, 2019
Jan 5, 2019
Apr 14, 2019
Apr 14, 2019
Dec 29, 2016
Apr 14, 2023
Oct 25, 2016
Oct 25, 2016
Sep 11, 2021
Mar 30, 2023
Jan 5, 2019
Jan 5, 2019
Sep 22, 2020
Dec 18, 2014
Oct 25, 2016
Jun 17, 2015
Oct 30, 2017
Jul 12, 2018
Oct 31, 2017
Jul 12, 2018
Oct 25, 2016
Oct 25, 2016
Sep 15, 2021
Oct 25, 2016
Aug 17, 2014
Oct 25, 2016
Aug 28, 2020
Oct 25, 2016
Jul 12, 2018
Oct 25, 2016
May 24, 2018
Oct 25, 2016
Sep 15, 2021

Repository files navigation

STK Addons Website

This is the source code for the SuperTuxKart asset sharing and distribution platform. The official location of the production website is https://online.supertuxkart.net/.

Build Status

Build Status

Branches

The master branch contains the latest code, not stable or production ready.

The production branch contains stable code that is ready for production (the live addons server is based on this branch).

Installation

The whole installation procedure can be seen in the INSTALL.md file.

Common Problems

Permissions

A common problem on Linux are the permissions for the assets/cache and dl directories. There are several ways to solve this problem:

  • Change the permission of the directories with chmod 775 (not recommended)
  • Add yourself to the owner group of these directories and give the group read & write access, or change the owner of those directories to the user under which your webserver is running (usually www-data). The latter can be achieved using: sudo chown -R www-data:www-data <directory>

Class not found after creating a new class

Example:

Error: Class 'Debug' not found in /stk-addons/index.php on line 0

This is due to composer not knowing about it. To fix it update composer with composer dump-autoload.

Testing

The project uses PHPUnit for unit testing (it's installed automatically by composer if you have enabled the developer dependencies)

Run tests from the root of the project with (it will use the default phpunit.xml found in the root directory):

./vendor/bin/phpunit

If you want to give it a custom configuration use the --configuration flag, like this:

./vendor/bin/phpunit --configuration custom.xml

Translation and locales generation

To generate all locales supported (system wide), run the script in locale/locale-gen.sh.

After that, update the translations.pot files by running the locale/update-pot.sh script.

Then after getting the updated translate po files from https://www.transifex.com/supertuxkart/supertuxkart/ run the locale/generate-mo.sh script.

Contributing

All contributions are welcome: ideas, patches, documentation, bug reports, complaints, etc!

Git message conventions

Some messages include the prefix [tag] at the beginning of the commit message, if present these mean that you need to make manual modifications to your code/infrastructure for it to work with that commit.

  • [C] - modified the config file, update your config.php file accordingly
  • [D] - updated the composer/yarn dependencies, run the appropriate yarn/composer update commands
  • [S] - updated the SQL schema, modify your SQL schema accordingly

PHP

The PHP coding standard is heavily based on PSR-2, with some modifications:

  • The line limit is 120 characters.
  • Opening braces for control structures MUST go on the next line, and closing braces MUST go on the next line after the body.
if ($a === 42)
{
    bar();
}
else
{
    foo();
}

Other

For JavaScript, CSS, and SQL you should use 4 spaces, not tabs. The JavaScript coding standard is based on http://javascript.crockford.com/code.html and the CSS coding standard is based on http://make.wordpress.org/core/handbook/coding-standards/css/.

The JavaScript and CSS coding standards are modified to use the same line limit as PHP.

License

STK Addons Website is licensed under GPL version 3. See COPYING for the full license text.

Contact