pickPack Quickstart - M2

From Moogento How-to Guides
Jump to navigation Jump to search

PickPack Magento Advanced PDFs.pngGet pickPack today

Aims & Preparation

Most of this is included if you get the Installation & Setup Service

pickPack for Magento 2 will produce good-looking output from install, but there are some quick things you can do to step these up a level and brand the Magento Packing Slip PDFs & Magento Invoice PDFs to your business, we'll cover those here.


Design Basics

Sizes, Resolutions, and Nudges

Let's say right away that we will be working with points not pixels. As we are creating PDFs, these count as printed paper, which are measured by points, versus screens which are measured in pixels. An average screen display resolution is 72dpi, whereas an average printed resolution is 300dpi.

If you measure your logos in pixels or less-than-300dpi, your PDF logos will print blurry.

  • Ie. save your image approx 4x bigger than print size: (intended display size) x (300/72)

More tips:

  • In the pickPack settings, when we nudge or move items, a positive number moves the item up or right on the page, and a negative number moves the item left or down.
  • If you are changing an actual position, bottom left of the final PDF is 0,0 - eg, 100,200 will move that item 100 points right, and 200 points up.
  • To get an idea of page sizes in points, this guy has a great summary.
  • If you want to precisely move elements in the PDF, and don't want to do the trial-and-error method, you can load the output PDF into Photoshop, and set the page units to points. If you resize the PDF in that page to match what you see printed, then you can directly see X and Y point positions on the page.

  1. Load, into Photoshop or equivalent, the logo image template which came with your extension zipfile > _sample_images/Template-for-header-logo.psd
    If you're making your own (instead of using the template), make sure you set :
    • the dimensions in points, not pixels
    • the dpi at 300dpi
    • the color mode as 'CMYK' (this one is not so important, but is the correct setting to get the best printed color matches).
    • you can set these both in the 'File > New' and the 'Image > Image Size..' sections of Photoshop.
    photoshop logo setup.png
  2. Grab a high-res version of your logo, ideally a vector image.
  3. Copy that and paste into the template file.
  4. Resize your logo to fit in the template.
    If you need to resize that logo image larger then it will print blurry - find a bigger image if possible.
    The standard page-top logo size is 269 points x 41 points, at 300dpi - pickPack will easily work with images the same width but with more height, if that suits your logo better.
  5. Save this as a non-interlaced non-transparent png-8 file.
    This is important or you'll generate errors when you produce PDFs.

Brand Colors

  1. Go back to your logo image, and use the eyedropper tool in Photoshop.
    If you don't have Photoshop there are a few free options - eg. imagecolorpicker.com.
  2. The aim here is to get the dominant color, so that we can use that in your PDFs. We're aiming at the HEX figure, eg. for grey it'll be about #CCCCCC
  3. If you have 2 dominant colors, great, grab them both.
    We'll make the darker one the subtitle text color, and the lighter one the horizontal bar background color.
    - By subtitle/horizontal bar, I mean the line which has eg. Sku, Product Name, Qty

Initial Settings

pickPack has 2 main sections that you'll want to check.

  1. Config. (general settings for all pages)
  2. PDF Templates (page-specific design)

Look for the Moogento logo on the left of your admin screen. This is your easy access to the different settings pages.

moogento-easy-access.png

Config. (general config.)

Let's go ahead and check the general config options - Click 'Config.' and we'll be redirected to the general settings.

We'll look at these in more detail in the Setup guide, but for now just have a quick check that the date format matches your local format.

The rest, have a quick glance but leave changing them for later.

PDF Templates (page-specific config.)

Set the address format to match your locale

PickPack uses the default Magento system for rendering address formats.

In:

Configuration -> Customer -> Customer Configuration -> Address Templates -> PickPack PDF

magento-address-format.png

You can edit the format of the address rendering - eg to include all street lines on one line, just remove the
between those lines.

You can save also a version per scope.

Here's the default, you can edit as needed:

{{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend firstname}}<br />{{/depend}}
{{depend company}}{{var company}}<br />{{/depend}}
{{if street1}}{{var street1}}<br />{{/if}}
{{depend street2}}{{var street2}}<br />{{/depend}}
{{depend street3}}{{var street3}}<br />{{/depend}}
{{depend street4}}{{var street4}}<br />{{/depend}}
{{if city}}{{var city}},  {{/if}}{{if region}}{{var region}}, {{/if}}{{if postcode}}{{var postcode}}{{/if}}<br />
{{var country}}

eg. For Holland:

{{depend prefix}}{{var prefix}} {{/depend}}{{var firstname}} {{depend middlename}}{{var middlename}} {{/depend}}{{var lastname}}{{depend firstname}}<br />{{/depend}}
{{depend company}}{{var company}}<br />{{/depend}}
{{if street1}}{{var street1}} {{/if}}
{{depend street2}}{{var street2}} {{/depend}}
{{depend street3}}{{var street3}} {{/depend}}
{{depend street4}}{{var street4}} {{/depend}}<br />
{{if postcode}}{{var postcode}}{{/if}} {{if city}}{{var city}}{{/if}}<br />
{{if region}}{{var region}}<br />{{/if}}
{{var country}}

Make the Page Framework

Let's see some magic! (You're welcome :) )

What we have here is a list of templates (ie. designs for each PDF output).

You can assign any one design to the specific output for that type.

Eg. you can have 2 different designs for Invoices, and can assign one of those to be used when creating the output.

We've started you off with some designs for each. You can edit/duplicate/delete these:

edit-pdf-templates-magento2.png

You'll notice a thumbnail on the left - this is to make it easier to see which design you're going to edit.

thumbnail-detail.png

Pretty easy ey!

While we're in this templates page, note the 'Create New Template' top-right.

create-new-magento-2-pdf-template.png

This will load you up a blank template for the specific output.

So you can either start with one of our pre-made template designs, or start with a blank slate.

Edit the Page Design

Ok, let's get into the fun bit!

Let's start by editing our Packing Sheet template.

  1. Duplicate our default design
    duplicate-packingsheet-magento2-pdf.png
  2. Click 'Edit' on the new duplicate design
  3. You'll enter our visual editor (give it a minute to load)
  4. Check the top-left. Here you can set the template name, save your changes, or cancel
    pdf-editor-admin.png
  5. Check the left column. Here's where you can select individual blocks to edit in the page.
  6. Check the middle page view - you can click on an element to edit it.

Try it, let's edit our logo!

  1. Click the logo; you'll see it gets a red outline to indicate we're editing it
    edit-magento-2-pdf-logo.png
  2. On the right column you'll now see editable options for this page block
  3. Let's say we want to move the logo from the left of the header to the right:
    • Select 'Right' in the 'Place' section
    edit-magento-2-pdf-logo-right-side.png
    • Check the look (it's instantly updated in the viewer)
  4. Click 'Save'

Ok let's now assign our funky new Packing Sheet template to the 'PDF Packing Sheet' command.

Let's head back to our General Config. Settings via the admin sidebar.

  1. Expand the section for the relevant page.
    eg. Here we're editing the Packing Sheet, so expand that.
  2. Expand the 'Template' dropdown menu
  3. Choose the new template you've just created
    select-new-template-design.png
  4. Click 'Save Config.'

All set! Let's see how we did.

Printing PDFs

Head to the SalesOrders page.

  1. Select an order to print
    1-select-order-print.png
  2. Select the PDF type in the Actions menu
    2-choose-pdf-type.png
  3. PDF download should automatically start!

You should now have great-looking, customised PDFs in Magento!

One More Thing

There are loads of config options for pickPack, but the ones above are the most important to get done first. You can now happily print get-your-customer-excited PDFs, while also getting some appreciative glances from your packing crew. Whether that's a team of 20, or your other half, they'll be happy at the improved packing clarity and time saved - and if it's just you, congrats, give yourself a knowing smile :) ).

  1. Let's add another important one, your company address. Find the Add company address to header? section, and set to yes.
    • Add in your company address.
    • Save and check the result.
  2. Before we celebrate and get a cuppa on the go, let's just check our paper size is set correctly. In PDF Packing Sheet PDF Invoice and General, you'll find a paper-size option. Set the correct one for your country.magento pdf paper size.png