{"id":23765803,"url":"https://github.com/solidusio-contrib/solidus_print_invoice","last_synced_at":"2025-09-05T09:33:04.675Z","repository":{"id":8321680,"uuid":"57235481","full_name":"solidusio-contrib/solidus_print_invoice","owner":"solidusio-contrib","description":"Provide your users with printable PDF invoices in Solidus.","archived":false,"fork":false,"pushed_at":"2024-01-29T03:52:34.000Z","size":149,"stargazers_count":18,"open_issues_count":2,"forks_count":30,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-12-20T14:33:03.431Z","etag":null,"topics":["ecommerce","extension","invoice","pdf","solidus","store"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/solidusio-contrib.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-04-27T18:12:24.000Z","updated_at":"2024-07-25T18:20:48.000Z","dependencies_parsed_at":"2022-09-15T23:40:40.414Z","dependency_job_id":null,"html_url":"https://github.com/solidusio-contrib/solidus_print_invoice","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_print_invoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_print_invoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_print_invoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/solidusio-contrib%2Fsolidus_print_invoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/solidusio-contrib","download_url":"https://codeload.github.com/solidusio-contrib/solidus_print_invoice/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232034910,"owners_count":18463362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ecommerce","extension","invoice","pdf","solidus","store"],"created_at":"2024-12-31T23:17:53.879Z","updated_at":"2024-12-31T23:17:54.647Z","avatar_url":"https://github.com/solidusio-contrib.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"SolidusPrintInvoice\n===================\n\n[![CircleCI](https://circleci.com/gh/solidusio-contrib/solidus_print_invoice.svg?style=svg)](https://circleci.com/gh/solidusio-contrib/solidus_print_invoice)\n\nThis extension provides a \"Print Invoice\" button on the Admin Orders view screen which generates a PDF of the order details.\n\nThis is meant to provide an example of how this can be done, and is easily extended by overriding the templates however you prefer.\n\nInstallation\n------------\n\nAdd solidus_print_invoice to your Gemfile:\n\n```ruby\ngem 'solidus_print_invoice' , github: 'solidusio-contrib/solidus_print_invoice'\n```\n\nBundle your dependencies and run the installation generator:\n\n```shell\n$ bundle install\n$ rails g solidus_print_invoice:install\n```\n\n[Configuration](http://example.com/)\n-------------\n\n1. Set the logo path preference to include your store / company logo.\n\n  ```ruby\n  Spree::PrintInvoice::Config.set(print_invoice_logo_path: \"/path/to/public/images/company-logo.png\")\n  ```\n\n2. 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.\n\n3. 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.\n\n4. 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)\n\n5. Many european countries requires numeric and sequential invoices numbers. To use invoices sequential number fill the specific field in \"General Settings\" or by set\n\n  ```ruby\n  Spree::PrintInvoice::Config.set(print_invoice_next_number: [1|{your current next invoice number}])\n  ```\n\n 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.\n\n6. Enable packaging slips, by setting\n\n  ```ruby\n  Spree::PrintInvoice::Config.set(print_buttons: \"invoice,packaging_slip\")  #comma separated list\n  ```\n\n Use above feature for your own template if you want. For each button_name, define `button_name_print` text in your locale.\n\n7. Set page/document options with\n\n  ```ruby\n  Spree::PrintInvoice::Config.set(prawn_options: { page_layout: :landscape, page_size: \"A4\", margin: [50, 100, 150, 200] })\n  ```\n\nTesting\n-------\n\nFirst bundle your dependencies, then run `rake`. `rake` will default to building the dummy app if it does not exist, then it will run specs, and [Rubocop](https://github.com/bbatsov/rubocop) static code analysis.\n\n```shell\nbundle\nbundle exec rake\n```\n\nWhen testing your application's integration with this extension you may use its factories.\nSimply add this require statement to your spec_helper:\n\n```ruby\nrequire 'solidus_print_invoice/factories'\n```\n\nReleasing\n---------\n\nYour new extension version can be released using `gem-release` like this:\n\n```shell\nbundle exec gem bump -v VERSION --tag --push --remote upstream \u0026\u0026 gem release\n```\n\nCopyright (c) 2020 Spree \u0026 Solidus Community, released under the New BSD License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio-contrib%2Fsolidus_print_invoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolidusio-contrib%2Fsolidus_print_invoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolidusio-contrib%2Fsolidus_print_invoice/lists"}