Skip to content

Configuring the Plugin

lat9 edited this page May 15, 2024 · 2 revisions

Once you have installed Printable Price List, you will see four new items in the admin's Configuration menu:

  1. Printable Price-List
  2. Price-list Profile 1
  3. Price-list Profile 2
  4. Price-list Profile 3

Printable Price-List Settings

These settings apply to PPL's display of the pricelist page and control its addition of a link to that page in a site's "Information" sidebox:

  • Default Profile. Choose the default profile to use. This identifies the PPL profile initially displayed on the pricelist page.
  • Show Profile Links? Choose "true" to display links to the currently-enabled profiles on the pricelist page.
  • Show Information Sidebox Link? Choose whether ("true", the default) or not a 'Price List' link should be shown in the Information sidebox.
  • Information Sidebox Link Position. If the 'Price List' link is to be shown in the Information sidebox, identify the numeric position at which that link is inserted. Enter 1 for the first position in the list, 2 for the second and so on. To position as the last entry, enter a number larger than the number of items currently in the sidebox's list.
  • Information Sidebox Link New Page? If the 'Price List' link is to be shown in the Information sidebox, indicate whether ("true", the default) or not a click of the link should open in a new page.
  • Include currency symbol in pricelist header? Choose whether ("true", the default) or not the currently-selected currency's symbol should be included in the pricelist print-out.

Price-list Profile 1-3 Settings

These settings apply to a specific "profile" for the pricelist page's display.

  • Enable Profile? Choose "true" (the default) to enable this price-list profile to be displayed on the pricelist page.
  • Group Name. Set this field to a Group Name (see Customers :: Group Pricing) to enable this profile only for customers in that group. Leave the field empty for the profile to apply to all customers.
  • Profile Name. Give this profile a name
  • Products to include? Choose the products to be included in this price-list:
    • all: Displays all products
    • featured: Displays all currently-featured products only.
    • specials: Displays all products on special
    • category: Displays products associated with the category identified in the Starting Category setting, below.
  • Starting Category. If including only products from a specific category, identify that categories_id here. Default: 0.
  • Display Linked Products? Should products be listed under all linked categories ("false", the default) or only under their master-category?
  • Show Selections? Set this value to "true", the default, to display language and currency selections as well as a categories dropdown menu at the top of the page.
  • Categories Dropdown: Main Only?Should the categories dropdown menu contain only the main categories? If set to "false", then all categories are displayed; the default is "true". Note: This setting is ignored if Show Selections is set to "false".
  • Main Categories: New Page. If "true", main categories on the printed price-list will start on a new page; the default is "false".
  • Include attributes pricing? Should any attribute-related pricing be listed for the products? Default: "false".
  • No Wrap. To enable or disable wrapping on screen (nowrap, "true", is easier for debugging). Default: "false".
  • Columns: Model. Display each product's model number in a separate column? Default: "true".
  • Columns: Manufacturer. Display each product's manufacturer in a separate column? Default: "true".
  • Columns: Weight. Display each product's weight in a separate column? Default: "false".
  • Columns: Stock-on-Hand. Display each product's stock-on-hand in a separate column? Default: "false".
  • Columns: Notes (A). Display an empty column for each product, allowing the customer to make notes? Default: "false".
  • Columns: Notes (B). Display another empty column for each product, allowing the customer to make notes? Default: "false".
  • Columns: Price. Display each product's price, including or excluding tax based on your shop's tax-configuration settings? Default: "true".
  • Columns: Price (ex). Display each product's tax-free price in a separate column? Default: "false".
  • Show Specials Prices? Display each product's "special" price? If "true" (the default), the script will execute 4 extra queries per product!
  • Show Specials Expiry? Show special price expiry date? This works only for specials (not for pricing by attributes and sales). Executes one extra query per special if enabled. Default: "false".
  • Columns: Add-to-Cart. Display an add-to-cart button for each product? If the product has attributes, a "More info" link displays instead. Default: "false".
  • Add-to-Cart Button Target. How to react to an Add-to-Cart button click: Cartpage (the default) sends all results to the same web page, _self sends result to the current page and _blank sends each result to a new page.
  • Show Product Images? Display each product's image? Default: "false".
  • Image Height. If the product images are to be displayed, what is the height of each image? Default: 80.
  • Image Width. If the product images are to be displayed, what is the width of each image? Default: 100.
  • Show Descriptions? Display each product's description? Default: "false".
  • Truncate Descriptions? If Show Descriptions? is set to "true" and this field is a value other than 0 or blank, product descriptions will be truncated to this length — HTML will be stripped. Default: 300.
  • Show Inactive Products and Categories? Set this value to "true" to include disabled products and categories in the list. Default: "false".
  • Sort By: Field. How products are sorted within a category? Choose either 'products_name', 'products_price' (the default) or 'products_model'.
  • Sort By: Asc/Desc. Sort ascending (the default) or descending.
  • Enable Debug? If "true", debug info is shown. Default: "false".
  • Show Store Logo On-Screen? Display the store's logo at the top of the screen? Default: "true".
  • Show Page Headers? If "true", the page headers on each page are shown (screen and print). Default: "false".
  • Show Page Footers? If "true" the page footers on each page are shown (screen and print). Default: "false".

Clone this wiki locally