Installing Padloper

This guide will help you set up Padloper for an existing site. Here we are using the freshly installed default profile (intermediate) from ProcessWire 2.5.15, but with very simple changes you can use this guide for any website you have.

This is step by step guide for adding Padloper into existing ProcessWire site. When you buy Padloper, it comes with very minimal shop profile, that you can install like any other profile in ProcessWire - that is preferred route if you want to do some quick testing.

1. Installing the modules

Just like ProcessWire, Padloper is very modular - you can cherry pick any parts you like. In this tutorial we are taking the shortest route for simple, but fully functional store.

Please note that you need versions from PW3 branch of payment modules if you use ProcessWire 3.0.

2. PadCart settings

There are very little configuration when using Padloper. PadCart is responsible for most common store and products settings, like currency and stock management.


3. Setting up your product template

Any template you have in your ProcessWire installation can be product in your store. This way the store frontend and product management is 100% in your hands - you can build it just like you build all other PW websites. All Padloper requires is that you have at least one float or integer field in that template, that Padloper can use for price.

$sidebar .= $modules->get("PadRender")->addToCart();‚Äč

NOTE: If you are NOT using delayed output in your template files, then the required code is:

echo $modules->get("PadRender")->addToCart();


4. Adding "edit cart" page

Sometimes you have dedicated view / edit cart page, sometimes you allow editing your cart from all pages. Padloper doesn't assume anything how you want to display your cart. Here we are taking the shortest route to happiness, by using our home template as "edit cart" page.

$content .= $modules->get("PadRender")->editCart();

Again, depending how you output your markup, you might want to echo the line directly.


5. Adding checkout process

If you have gotten this far without sacrifing your mental health, I am pretty sure you will make it to the end of this guide! This is last step before you have full store setup. Now we create checkout template and configure the payment & shipping methods used. To keep things fast and simple, we are using invoice as a payment method, so all orders will be unpaid and receive an invoice.

$checkout = $modules->get("PadOnePageCheckout");
// $checkout = $modules->get("PadCheckout"); // This is the old one, use above for most streamlined checkout
$checkout->setShippingModule("ShippingFixed"); // This means that all orders will use this specific shipping module
$content = $checkout->render(); // Again, just echo this if you are not using delayed output


6. Customizing the markup

Your store looks and works very barebones now. Most parts of Padloper are very easy to customize - and let's start with the simplest thing: templates. Take a look at /site/modules/Padloper/templates/. All the markup that Padloper generates are included there. You can view those files, but don't edit them directly. Instead you should copy the templates you need to modify with the same name into /site/templates/padloper/* and modify them there. Whenever Padloper renders markup, it will first look from that directory.


7. Customizing the customer information

When you tested the checkout process, you noticed that we asked quite a many details from customer. Sometimes only email address is required, sometimes we need tons of information. Sometimes all the fields are required, sometime just the name is. Customizing this is as easy as editing the templates and fields in processwire.

Go into templates => padorder. Now all the fields that are inside pad_customer and pad_customer_END are fields that we are asking from customer. You can move and edit those things freely by clicking their name in the list. Feel free to add some totally custom fields into the mix also and removing the things you don't need. But please, do keep the email address, so that your store can send emails to your customers about the order process. Please note that if you use some of the more exotic fieldtypes, you might need their css&js files in your checkout template.

After you get everything working as intended, you go and start your next adventure with product variations.

Padloper newsletter

To get occasional updates about new features and discounts