Installing Pdf Customiser (M2)

Option 1: Preferred Installation Method (Fooman-Hosted Repository)

Fooman will host your extension and will automatically push new extension updates to your repository, ready for you to pull/update in the future. 

The advantages of this approach are:

  • Saves time installing 
  • Saves time on installing future extension updates (you don’t need to manually download these from the Fooman website and repeat the installation process each time)
  • Helps to avoid common errors some people make when using the manual installation method
  • It integrates better with a multi-stage deployment process

New extension updates will be pushed automatically to this repository for as long as your support/update period is valid.

1. Log into Your Account on the Fooman website, using your the login details you signed up with. On your account dashboard, you will see a custom command line. Copy the command line. 

2. From a command line in your Magento root folder run

1. [The custom command line you copied from your Fooman Account dashboard]
2. composer require fooman/pdfcustomiser-m2 
3. bin/magento module:enable --clear-static-content Fooman_PdfCustomiser Fooman_PdfDesign Fooman_PrintOrderPdf Fooman_PdfCore Fooman_EmailAttachments
4. bin/magento setup:upgrade

If you are using Production Mode please also run

5. bin/magento setup:static-content:deploy
6. bin/magento setup:di:compile

In the above example, line 1 would look like this: 

1. composer config repositories.fooman composer https://customer-repos.fooman.co.nz/www.example.com-1a5a588b88a32a6826080639160f153214628055

Option 2: Manual Installation Method (Self-Hosted Repository)

1. Unzip the zip file you downloaded from our store into the following folder (please create this folder if it’s not already present):

MAGENTO_ROOT/vendor/fooman/packages

2. From a command line in your Magento root folder run

1. composer config repositories.foomanartifacts artifact $(pwd)/vendor/fooman/packages
2. composer require fooman/pdfcustomiser-m2
3. bin/magento module:enable --clear-static-content Fooman_EmailAttachments Fooman_PdfCustomiser Fooman_PdfDesign Fooman_PrintOrderPdf Fooman_PdfCore
4. bin/magento setup:upgrade

If you are using Production Mode please also run

5. bin/magento setup:static-content:deploy
6. bin/magento setup:di:compile

Troubleshooting

The composer require command fails and is mentioning “bcmath”

The Php extension bcmath is needed by our extension (as well as Magento EE). Please get your system admin or webhost to enable this for you.

To install it yourself you would need root access to your server. From a command line run

For Debian Based Systems (more options under Ubuntu can be found  here):

sudo apt-get install php-bcmath

For Redhat Based Systems:

sudo yum install php-bcmath

The package name can differ by version of php and/or your package repository, for example it could be php70-bcmath

NEXT STEP: MAGENTO COMMON PDF SETTINGS

Still need help? Contact Us Contact Us