Wallos: Open-source, self-hostable personal subscription tracker. Visualize your recurring expenses, manage your budget, and save money.
Contributing to wallos
We welcome contributions from the community and look forward to working with you to improve this project!
How to Contribute
Fork the repository: Start by forking the wallos repository to your own GitHub account.
Clone your fork: Clone the forked repository to your local machine (replace with your actual github username):
git clone https://github.com/<YOUR_USERNAME>/wallos.git cd wallosCreate a branch: Create a new branch for your changes:
git checkout -b feature/your-feature-nameor
git checkout -b fix/your-bug-fix-nameMake your changes: Implement your feature or bug fix.
Test your changes: Ensure that your changes work as expected.
Wallos has a small test suite in
tests/. It needs no Composer or local PHP installation — it runs in a throwaway container:dev/test.sh # all cases dev/test.sh currency # only cases matching "currency"Use
CONTAINER_ENGINE=docker dev/test.shif you prefer Docker over Podman. Tests build the real schema by runningcreatedatabase.phpand the migration chain, so they exercise the schema the application produces.Commit your changes: Commit your changes with a clear and concise message:
git add . git commit -m "Add your feature or fix"Push your changes: Push your branch to your forked repository:
git push origin feature/your-feature-nameCreate a Pull Request: Go to the wallos repository on GitHub (https://github.com/ellite/wallos) and create a pull request from your branch to the
mainbranch.
Pull Request Guidelines
- One feature/fix per pull request: Please keep pull requests focused on a single feature or bug fix.
- Clear and descriptive title and description: Provide a clear title and description of your changes.
- Include relevant tests: If possible, include tests for your changes.
- Follow the project's coding style: Adhere to the project's coding style and conventions.
- Keep your pull request up to date: If changes are requested, please update your pull request accordingly.
Issues
- Bug Reports: If you find a bug, please open an issue with a clear description of the problem and steps to reproduce it.
- Feature Requests: If you have a feature request, please open an issue with a clear description of the feature and its benefits.
- Priority: Bug fixes will take priority over feature requests.
Translations
If you want to contribute with a translation of wallos:
Add your language code:
- Open
includes/i18n/languages.php. - Add your language code in the format:
"<language_code>" => ["name" => "<Language Name>", "dir" => "<ltr or rtl>"],. - Please use the original language name and not the English translation.
- Example:
"pt" => ["name" => "Português", "dir" => "ltr"],.
- Open
Create language files:
- Copy
includes/i18n/en.phpand rename it to your language code (e.g.,pt.php). - Translate all the values in the new language file.
- Copy
scripts/i18n/en.jsand rename it to your language code (e.g.,pt.js). - Translate all the values in the new javascript language file.
- Note: Incomplete translations will not be accepted.
- Copy
Create a Pull Request: Follow the Pull Request Guidelines above.
Contributors
Thank you for your contributions!