[![Build Status](https://travis-ci.org/solidusio-contrib/solidus_print_invoice.svg?branch=master)](https://travis-ci.org/solidusio-contrib/solidus_print_invoice)

SUMMARY
=======

This extension provides a "Print Invoice" button on the Admin Orders view screen which generates a PDF of the order details.

This is meant to provide an example of how this can be done, and is easily extended by overriding the templates however you prefer.


INSTALLATION
============

1. The gem relies only on the prawn gem, to install you need to add the following lines to your Gemfile

  ```ruby
  gem 'solidus_print_invoice' , github: 'solidusio-contrib/solidus_print_invoice'
  ```

2. Run bundler

  ```shell
  $ bundle install
  ```

3. Install migrations

  ```shell
  $ rails g solidus_print_invoice:install
  ```

Configuration
==============

1. Set the logo path preference to include your store / company logo.

  ```ruby
  Spree::PrintInvoice::Config.set(print_invoice_logo_path: "/path/to/public/images/company-logo.png")
  ```

2. Add your own own footer texts to the locale. The current footer works with `:footer_left1` , `:footer_left2` and `:footer_right1`, `:footer_right2` where the 1 version is on the left in bold, and the 2 version the "value" on the right.

3. Override any of the partial templates. They are address, footer, totals, header, bye, and the line_items. In bye the text `:thanks` is printed. The `:extra_note` hook has been deprecated as Spree no longer supports hooks.

4. Set `:suppress_anonymous_address` option to get blank addresses for anonymous email addresses (as created by my spree_last_address extension for empty/unknown user info)

5. Many european countries requires numeric and sequential invoices numbers. To use invoices sequential number fill the specific field in "General Settings" or by set
  
  ```ruby
  Spree::PrintInvoice::Config.set(print_invoice_next_number: [1|{your current next invoice number}])
  ```

 The next invoice number will be the one that you specified. You will able to increase it in any moment, for example, to re-sync invoices number if you are making invoices also in other programs for the same business name.

6. Enable packaging slips, by setting

  ```ruby
  Spree::PrintInvoice::Config.set(print_buttons: "invoice,packaging_slip")  #comma separated list
  ```

 Use above feature for your own template if you want. For each button_name, define `button_name_print` text in your locale.

7. Set page/document options with

  ```ruby
  Spree::PrintInvoice::Config.set(prawn_options: { page_layout: :landscape, page_size: "A4", margin: [50, 100, 150, 200] })
  ```