Open-Source General Billing Manager
CSBill is an open-source application that allows you to manage clients and contacts and send invoices and quotes.
CSBill is built on Symfony2 which is only supported on PHP 5.3.3 and up.
Be warned that PHP versions before 5.3.8 are known to be buggy and might not work for you:
-
before PHP 5.3.4, if you get "Notice: Trying to get property of non-object", you've hit a known PHP bug (see https://bugs.php.net/bug.php?id=52083 and https://bugs.php.net/bug.php?id=50027);
-
before PHP 5.3.8, if you get an error involving annotations, you've hit a known PHP bug (see https://bugs.php.net/bug.php?id=55156).
Note: The latest version of PHP is always recommended
To install the from source, you first need to clone the repository, then you need composer in order to install all the dependencies.
To clone the repository, issue the following command. Remember to clone the repository to the path you want, that is accessible from Apache.
https://github.com/smallBiz/CSBill.git
Then go into the repository directory
cd CSBill
Now you need to get composer
curl -s http://getcomposer.org/installer | php
When composer is finished downloading, you can install the optional dependencies:
php composer.phar install
After all the depencies has been installed, the last step is to install all the web assets
php app/console assets:install --symlink web
Now you have a fully working copy of CSBill, which you can use to modify or dig around in the code.
Note: This is not the recommended way to install and use CSBill. This is only for developers who wish to look through the code, submit patches, customise the code etc. or for anybody that wish to poke through the source code.
The stylesheets is built using lesscss, and uses LessPHP to compile the stylesheets to plain CSS.
Some of the basic features included in CSBill is:
- Clients & Contacts management
- Send Quotes
- Send Invoices
- More to come
Note: This list is only the planned features so far. Some (or all) of the mentioned features may not be complete or even started. As the features grow, the list will be updated to include the actual features available.
See CONTRIBUTING
CSBill is open-sourced software licensed under the MIT license
Please see the LICENSE file for the full license.