Siwapp

Online Invoice Management

Installation

The following will ask you to setup the database info, so make sure you have one ready.

$ composer create-project --stability=dev siwapp/siwapp-sf3 my_siwapp; cd my_siwapp

You will need to have Java installed and available in your path (for yuicompressor). On Debian/Ubuntu-based systems you can install it using the following:

$ sudo apt-get install default-jre-headless

Then you can dump the assets:

$ php bin/console assetic:dump --env=prod

Creating the database schema:

$ php bin/console doctrine:schema:create

Creating the first (admin) user:

$ php bin/console fos:user:create admin mail@example.com 1234 --super-admin

Make sure that the var/ and web/uploads folders are writable by the webserver:

$ sudo chown www-data:www-data -R var/
$ sudo chown www-data:www-data -R web/uploads

or check this.

Finally, you need wkhtmltopdf installed for PDF generation to work. On Debian/Ubuntu-based systems you can install it using the following:

$ sudo apt-get install wkhtmltopdf

Although the above should work, sometimes the alpha version of wkhtmltopdf produces better results. You can download and try it.

Thats it! The siwapp installation should be reachable and working now. Check /config.php or /web/config.php to make sure that everything in your enviroment is ok.

Upgrading from v0.4.x

Replace the DB_* values with the one of your old database and then run:

$ php bin/console siwapp:upgrade-db:0.4-1.0 DB_DRIVER DB_USER DB_PASSWORD DB_NAME

Loading demo data

$ php bin/console doctrine:fixtures:load

Overriding templates

To override templates, eg. the invoice print one, copy src/Siwapp/InvoiceBundle/Resources/views/Invoice/print.html.twig to app/Resources/SiwappInvoiceBundle/views/Invoice/print.html.twig and clear the cache:

$ php bin/console cache:clear

The above applies to any template, (probably the print and email ones are those that you are more insterested to).

Automating recurring invoices generation