Documentation 2019-03-14T11:01:40+00:00

Documentation

Setup and Configuration

  1. Go to: Settings > Print Flyers
  2. Enter your license key to register your purchase. This will enable you to get updates and technical support for 12 months from date of purchase.
  3. Go to: WooCommerce > Settings and click on the tab labelled Print Flyers.
  4. Make any changes that you want to the settings, as described in the documentation. If you make no changes, the default settings will be used.
  5. Click one of the ‘Save Changes’ buttons to save your new settings.

Settings

Print button

Here you can control the appearance and position of the print button that will be displayed on your store’s single product pages.

Position on the page

By default, the print button will appear on the single product page below the name of the product. There are 10 positions to choose from which correspond to the WooCommerce action hooks for the single product page (see https://docs.woocommerce.com/wc-apidocs/hook-docs.html).

Generally, the positions lower down on the drop-down menu appear lower down on the single product page, but bear in mind that this is theme-dependent. Experiment to see which works best for your store.

Alternatively, you can select ‘Use shortcode [printflyers]‘. This will prevent the print button appearing at all unless you add the shortcode to a product description or short description. You’ll need to add it to every product for which you wish to have the option of printing. Just insert the word printflyers in square brackets.

[printflyers]

Label

The wording on the button.

Margins

Add a value here to add space around the button. Add ‘px’ or ‘%’. Example: 5px will add 5 pixels of space; 10% will add a margin equal to 10% of the width of the column.

Printer icon

You can upload your own icon to replace the default printer icon.

If you don’t want any printer icon to show, leave the field blank and click Save Changes.

Should you wish to set it back to the default icon, here’s what to enter:

<your-website-url>/wp-content/plugins/printflyers/assets/default-printer-icon.png

Replace <your-website-url> with the full URL of your store.

Header image

You can upload an image to appear full width across the top of the flyer. The same image will appear on every flyer your customers print. This is ideal for your store branding. The default image is a pair of gray horizontal stripes.

Your header image should be of a high quality as printers use more pixels than screens. Use an image with a width of at least 1500 pixels for good results.

Header text

You can add text here which will appear full width below the header image. The same text will appear on every flyer your customers print. Typical use is for your store details such as address and telephone, strapline, and store URL. You can format this how you like, and you can also include images if you wish.

General display options

The first of these control the elements that appear in the flyer. Select Yes or No for each element.

Strip shortcodes?

If you are using a plug-in that adds shortcodes to the product description, the shortcodes themselves may appear in the printed output. This is undesirable, so select this option to filter them out. It will not remove content between shortcodes themselves. If you are using the [printflyers] shortcode, this will automatically be stripped out from the description without you needing to select ‘strip shortcodes’.

Fixed footer?

If your product information fits easily onto a single sheet, it can look more presentable to have the footer appear along the bottom of the sheet. If your flyers run onto a second page, deselect this option and the footer will float, printing directly after the last element, wherever this happens to fall on the page.  If you are unsure, it is best to leave this deselected.

Cache-friendly button URL?

Leave this set to ‘No’ unless you are seeing errors (see Troubleshooting).

Featured Image

You can decide whether the featured image is displayed or not.

You can choose whether the featured image is positioned to the left with product description text flowed to the right, or positioned to the right with text flowed to the left. Or choose ‘None’ if you prefer there to be no text to either side.

Width

You can control how much space the featured image takes up. Example: 50% for the image to be 50% of the page width. You can also enter a value in pixels e.g. 100px. The height will scale in proportion.

Margins

Enter values as a percentage (%) or in pixels (px) if you want to add some space around the featured image.

Show border?

Choose ‘Yes’ to add a thin gray border around the featured image.

Gallery

If you select ‘Show gallery?’, gallery images will display in a horizontal grid across the page below the product description.

Width

You can control how much space each gallery image takes up. Example: 10% for each image to be 10% of the page width. You can also enter a value in pixels e.g. 100px. Heights will scale in proportion.

Show borders?

Choose ‘Yes’ to add a thin gray border around each gallery image.

Printer font

Select the font that will be used for the product descriptions and other text.

The font size governs the size of the text in the product short description and product description.

Enable Google fonts?

If you select this, you can override the selected printer font.

Google font family

Enter the name of your chosen Google font family. For example: Montserrat or Open Sans. You can find more of these by visiting fonts.google.com

Footer text

You can add text here which will appear full-width directly above the footer image. The same text will appear on every flyer that your customers print. Typical use is for your store details, such as address and telephone, strapline, and store URL, if not included in the header. You might also include your terms and conditions, a returns policy, a discount coupon, a purchase approval form… there are any number of uses. You can format this how you like, and you can also include images if you wish.

Footer image

You can upload an image to appear full width after all of the other information. The same image will appear on every flyer that your customers print. This is ideal for additional store branding. The default image is a pair of gray horizontal stripes.

Your footer image should be of a high quality as printers use more pixels than screens. Use an image with a width of at least 1500 pixels, for good results.

The footer text and footer image always appear together as a unit. The footer can be fixed or floating. See the notes under General display options for positioning information.


Usage

When you visit any single product page with Print Flyers enabled, you should see the print button. The position depends upon the value you have chosen in the Print Button Settings. Some themes may not be able to display the print button in every position so if you do not see the button, experiment with other settings.

When you click the print button, you will see a new window or tab open in your browser. It will show a preview of the printed page. The browser will open a print dialog, allowing you to choose the various options before you print. Most browsers will give you the option to print to pdf. This can be very useful as you can then save the page to your computer. This is also handy for testing, as it saves you having to print each time you make a change.


Translating the plugin

The headings that appear in the printed output will be translated into the language that your site is set to in the WordPress Settings > General, provided that there is a corresponding translation file in the WooCommerce plugin.

The text that appears in the Print Flyers admin settings will be translated into the language that your site is set to in the WordPress Settings > General, provided that there is a corresponding translation in the Print Flyers plugin.  Currently the only languages available are English (US), English (UK) and French (FR).

The label that appears on the Print button can be changed in the Print Flyers print button settings (see above).


Troubleshooting

• Customers are seeing an error message: ‘Failed security check’. Why is this?

If your store uses a cache and is caching the single product pages, the print button may contain an expired link. Clicking it will throw a ‘failed security check’ error message. Select ‘cache-friendly button URL’ in the General display options to alleviate this problem by overriding the security check.

What’s the risk? By changing the product id which is encoded into the URL of the print preview window, it would be possible to print flyers for products without having first visited the single product page. Though undesirable, this is not considered to be a high security risk.

I am using WP Bakery Page Builder  (or another plug-in that inserts shortcodes in descriptions) and shortcodes are appearing in the printed output. What can I do?

These shortcodes cannot be parsed by the Print Flyers extension. Select the ‘Strip shortcodes’ option in the General display options to filter them out. The information between the bracketing shortcodes will remain. Example:

Without ‘strip shortcodes’, you may see this:

[vc_row][vc_column][vc_column_text]Here is some text. [/vc_column_text] [/vc_column][/vc_row]

With ‘strip shortcodes enabled, this will print as:

Here is some text.

• The print preview window does not match the printed version.

There will be some slight differences because the Print Flyers does not know anything about the printer you are using or the paper you wish to print on. Treat the print preview window as just a rough guide. To save paper while experimenting with different settings, choose to print to pdf instead of sending to your printer. Most browsers offer this as an option.

• The print button always appears on a line by itself. I prefer to have other items display to either side.

Perhaps you would like the price to appear to one side of the print button, for example. Add the following css code to your theme’s css:


#printflyers_button_id {
display: inline!important;
}

Beware, if you do this the top and bottom margin settings may not function as expected.