module InvoicePrinter

Create PDF versions of invoices or receipts using Prawn

Example:

invoice = InvoicePrinter::Document.new(...)
InvoicePrinter.print(
  document: invoice,
  font: 'path-to-font-file.ttf',
  bold_font: 'path-to-font-file.ttf',
  stamp: 'stamp.jpg',
  logo: 'logo.jpg',
  file_name: 'invoice.pdf'
)

Constants

VERSION

Public Class Methods

labels() click to toggle source
# File lib/invoice_printer.rb, line 60
def self.labels
  PDFDocument.labels
end
labels=(labels) click to toggle source

Override default English labels with a given hash

Example:

InvoicePrinter.labels = {
  name: 'Invoice',
  number: '201604030001'
  provider: 'Provider',
  purchaser: 'Purchaser',
  payment: 'Payment',
  payment_by_transfer: 'Payment by bank transfer on the account below:',
  payment_in_cash: 'Payment in cash',
  account_number: 'Account NO:',
  swift: 'SWIFT:',
  iban: 'IBAN:',
  issue_date: 'Issue date:',
  due_date: 'Due date:',
  variable_symbol: 'Variable symbol:'
  item: 'Item',
  quantity: 'Quantity',
  unit: 'Unit',
  price_per_item: 'Price per item',
  amount: 'Amount'
}

You can denote the details or translations of labels by using sublabels. To set a sublabel for a label, just assign it under sublabels e.g.

InvoicePrinter.labels = {
  ...
  sublabels: { tax: 'Daň', amount: 'Celkem' }
}
# File lib/invoice_printer.rb, line 56
def self.labels=(labels)
  PDFDocument.labels = labels
end
print( document:, labels: {}, font: nil, bold_font: nil, stamp: nil, logo: nil, background: nil, page_size: :letter, file_name: ) click to toggle source

Print the given InvoicePrinter::Document to PDF file named file_name

document - InvoicePrinter::Document object labels - labels to override font - font file to use bold_font - bold font file to use stamp - stamp & signature (image) logo - logotype (image) background - background (image) page_size - :letter or :a4 file_name - output file

render( document:, labels: {}, font: nil, bold_font: nil, stamp: nil, logo: nil, background: nil, page_size: :letter ) click to toggle source

Render the PDF document InvoicePrinter::Document to PDF directly

document - InvoicePrinter::Document object labels - labels to override font - font file to use bold_font - bold font file to use stamp - stamp & signature (image) logo - logotype (image) background - background (image) page_size - :letter or :a4

# File lib/invoice_printer.rb, line 108
def self.render(
  document:,
  labels: {},
  font: nil,
  bold_font: nil,
  stamp: nil,
  logo: nil,
  background: nil,
  page_size: :letter
)
  PDFDocument.new(
    document: document,
    labels: labels,
    font: font,
    bold_font: bold_font,
    stamp: stamp,
    logo: logo,
    background: background,
    page_size: page_size
  ).render
end