How to install Invoice
Add-on On Orangescrum

Craft beautiful Invoices with simple-to-use interface that helps in making professional looking invoices a very pleasant experience.

If you have purchased any add-on before, then contact us support@orangescrum.org. We highly recommend this before installing Invoice add-on.

Steps below will guide you to install and integrate Invoice Add-on to your Orangescrum.

Last Updated: 5th July, 2016
Print Print this page

    1. Step 1

      Make Sure to keep a backup of your existing app folder
    2. Step 2

      Extract the "Invoice-V1.0.zip" file (Buy Invoice Add-on) to your desktop which will give you following files,
      • app folder
      • invoice.sql
      • README.txt
    3. Step 3

      Remove the existing "app" folder from your working directory and copy and paste the extracted "app" folder to your working directory.
    4. Step 4

      If you are using local machine as storage (excluding Amazon S3), please replace the folder, named "files" inside the "app/webroot" folder from the back up to the downloaded (i.e., the Add-on folder) "app/webroot" folder.
    5. Step 5

      Give proper write permission (0777) to "app/Config", "app/tmp" and "app/webroot" folders. For Example: chmod -R 0777 app/Config
      chmod -R 0777 app/tmp
      chmod -R 0777 app/webroot
    6. Step 6

      Get the "invoice.sql" file from the moved directory and import that to your working/active database.
    7. Step 7

      Do the necessary changes to "constants.php" and "database.php" inside "app/Config" folder again as you have done earlier. For Example SMTP email credentials in "constants.php" page and database credentials in "database.php" page.
    8. Step 8

      Run the website once. For example: http://localhost/orangescrum-master/
    9. Step 9

      Replace "Configure::write('debug',2);" with "Configure::write('debug',0);" in the app/Config/core.php.
    10. Step 10

      Once you have completed all the process, you will be able to see the new invoice feature in below pages,
      • Invoice Link in left menu panel
    11. Step 11

      In order to generate Invoice PDF files ,you have to install "wkhtmltopdf" extension in your system.Go to the following URL to download "wkhtmltopdf" extension and select the installation file based on your system architecture similar as shown in the image below.
    12. Step 12

      For Windows based systems ,install the "wkhtmltopdf" extension in your system drive in a folder different than the "Program Files" folder.
    13. Step 13

      Define the full path of "wkhtmltopdf.exe" file in constant.php file.For example ,If the path of wkhtmltopdf.exe in your windows sytem is "C:\wkhtmltopdf\bin\wkhtmltopdf.exe" , the Global variable in constants.php would be define( "PDF_LIB_PATH" , "C:\wkhtmltopdf\bin\wkhtmltopdf.exe" );
      For Linux/Unix based systems the Global variable in constants.php would be define( "PDF_LIB_PATH" , "/usr/local/bin/wkhtmltopdf" );
    14. If there is any issue in installing the invoice V1.0 add-on, please contact the orangescrum support team at support@orangescrum.org. We would be happy to help.

    Last Updated: 5th July, 2016