Woo Commerce 3.3.0+

WooCommerce is an open-source e-commerce plugin for WordPress. Koalafi has built a custom plugin to easily enable your customers to use Koalafi as a payment option. The Koalafi Payment Gateway gives you the ability to add "Apply Now" buttons throughout your site to support our Approval First flow and seamlessly integrates with the existing payment options on the checkout screen.

10201020

Apply Now button to allow customers to access approval first flow

12721272

Koalafi as a payment option at checkout

Clicking any of these buttons pops up the Koalafi modal and walks the customer through the application process. We are currently building out a demo site so that you can interact with this functionality directly.

We are working to add the Koalafi Payment Gateway to the plugin store. For now, please follow the manual installation steps below:

Manual Installation

  1. Please reach out to the Koalafi team to get the latest version of the plugin. The plugin will be in .zip format.
  2. On your WP admin page, navigate to the plugin page. It will be an option on the left nav bar

  1. On the plugin page, click the "Add New" button at the top left of the page

  1. On the following page, click the "Upload Plugin" button at the top left of the page

  1. Using the "Choose File" button, select the .zip of the Koalafi plugin you received in Step 1 of these directions.

  1. Click "Install Now"

  1. Once installation is complete click "Activate Plugin"
  2. Now your plugin is installed and activated, but it still needs to be configured

Configuring Your Plugin

Once the plugin has been installed and activated it needs to be configured so that you can start using it. If you haven't already, make sure your store is onboarded with Koalafi. Once we onboard your store, we can provide you with your public dealer id and private API key to complete the configuration. Checkout out our Getting Started page for more information on the onboarding process.

  1. On the WP admin, navigate to Payments Setting Page

  1. Click "All Payment Methods" A list of all available payment methods for your store will appear

  1. Find Koalafi in the list of methods. Immediately after activation, it will be toggled off. Leave it off for now

  1. Click "Manage" - it will load the Koalafi settings page

  1. Add your public dealer ID and Private API Key to the appropriate fields. Make sure you use your sandbox values for sandbox and your live values for live
  2. Select the Transaction mode - Sandbox is for testing, Live is for customer interactions. Turning your plugin to Live will direct the plugin to production and applications will be live.

  1. Select your Apply Button Type
    1. "Apply Now right align button" display a button on the right side of the product screen
    2. "Apply Now left align button" display a button on the left side of the product screen
    3. "Text with Loan and Lease" displays a clickable loan and lease promotional text
    4. "Text with Lease Only" displays a clickable lease only promotional text
  2. Enter your loan deferred interest promotion period. Leaving it blank will automatically default to a 12 month promotional period.
  3. Hit "Save Changes" and on the payments screen, toggle Koalafi On

  1. You are ready to start using Koalafi throughout your site!

Marking Items as Non-leasable

Specifying whether a product is leasable is required when offering a lease-to-own financing option with Koalafi. Non-leasable products generally include weapons and non-physical goods such as gift cards, service fees, warranties or installation fees. Our WooCommerce plugin treats all products as leasable by default, so you'll need to update any product that falls into the non-leasable category.

Follow these steps to mark a product as non-leasable:

  1. From the WP admin site go to Products > All Products

  2. From the list of products, find the one you want to mark as non-leasable and click edit

  3. Scroll to the bottom of the page and check the non-leasable box as seen in the image below:

  4. The product is now marked as non-leasable. On the upper right hand side of the page click Update


Custom Button Configuration

You might want to add additional buttons on your site to direct customers to Apply for financing ahead of checkout. You have a few ways to add these buttons

WordPress Template Files

  • Add the below code snippet to the template file and add your styling
[koalafi_approve_first_button]<button>Apply Now</button>[/koalafi_approve_first_button]

Custom Page Builder

  • On your custom page, enable shortcode to be placed
  • Add the below code snippet to the template file and add your styling
[koalafi_approve_first_button]<button>Apply Now</button>[/koalafi_approve_first_button]

Styling

All the styling changes will be made through the Wordpress admin page. To make styling changes to the plugin you will need to use the theme customizer or the theme style.css

All the plugin classes are defined within the plugin. If you unzip the plugin, you can look in koalafi_plugin > css > koalafi.css to find the defined classes. You can also use the developer tools to find the class names we are using for specific elements on the screen. If you are not familiar with developer tools we’ve included a quick how to below.

Customize with the Theme Customizer

  1. On the WP-admin page click appearance >> Customize

  2. This takes you to a new screen with your site on the right and a toolbar on the left. In the left toolbar click Additional CSS. In theme customizer you can navigate to your page on the right side of your screen and make CSS changes on the left. The changes should propagate immediately so you can quickly and easily make changes.

  3. To make changes, you’ll need to know the class name for the style you want to override. The easiest way to get that is through using developer tools and inspecting the element you want to change. If you aren’t familiar with developer tools we’ve included a short how-to below. Note - it is helpful to leave the dev tools open as some of the plugin styles might be overwritten by the theme style and it’s easier to see that with the dev tools open.

  4. In order to see your changes on the site as you make them, use the right side of the screen to navigate to the page that is displaying the element you want to change such as a product screen or the checkout page. You don't need to have the element you're changing open on the screen but it makes adjusting the styling faster and easier. If you don't have it open as you go, remember to review the screen once you're done to make sure everything looks like you'd expect.

  5. In the text box add the class name you grabbed either from our plugin or using developer tools in the following format

    
    <your class name> {
      <your-attribute>: <your-value>;
    }
    /*EX. with the Koalafi ApplyNow Button Class */ 
    
    .koalafi-right-align {
      background-color: #a6bfd5;
      color: #314054;
      width: 100px;
      text-align: center;
      font-weight: bold;
      padding: 5px 10px;
      font-size: 14px;
      border-radius: 5px;
      float: right;
      cursor: pointer;
    }
    
  6. Within the brackets add the different attributes with the values you want to change. Below we’ve included the class names and attributes for the Apply Now and Checkout Buttons

  7. To save your changes your changes click publish at the top of the toolbar.

  8. Note some of the styling might also be controlled by the theme and you won’t be able to overwrite it here. Instead you’ll need to edit the style.css of the theme directly.

Customize with theme style.css

  1. To make changes, you’ll need to know the class name for the style you want to override. The easiest way to get that is through using developer tools and inspecting the element you want to change. If you aren’t familiar with developer tools we’ve included a short how-to below.

  2. From this page you won't be able to see your site as you make changes, so be sure to copy down the class names you are trying to override. We've included the class names and attributes for our common Koalafi classes below, but you may also need to override some of the classes in the theme to get your desired style.

  3. Once you have your class names login into the wp-admin page for your site

  4. On the WP-admin page click appearance > Theme File Editor. Using the right toolbar, select the theme you want to adjust from the dropdown. Once you're on the theme you want to change, use the left toolbar to make sure you are in the stylesheet which has the filename style.css

  5. More than likely, there will be some class names in the file, if you see one of the classes you want to adjust you can make changes to it in this file by adding, removing or changing attribute values.

  6. If the class you're interested in changing isn't in this file, then you need to add it. You can add it in the following format:

    
    <your class name> {
      <your-attribute>: <your-value>;
    }
    /*EX. with the Koalafi ApplyNow Button Class */ 
    
    .koalafi-right-align {
      background-color: #a6bfd5;
      color: #314054;
      width: 100px;
      text-align: center;
      font-weight: bold;
      padding: 5px 10px;
      font-size: 14px;
      border-radius: 5px;
      float: right;
      cursor: pointer;
    }
    
  7. To save your changes, click Update File at the bottom of the page.

  8. Navigate to the pages that have the classes you updated to review your changes and make sure you're happy with the new style.

Apply Now Button on the Product screens

The styling for this button is controlled by the .koalafi-right-align class. To change the appearance of that button you can change the different elements in this class:

  1. Background color - this refers to the color of the button itself
  2. Color - this is the color of the text on the button
  3. Width - this is the actual width of the button
  4. Text-align - how the text is aligned within the button
  5. Font-weight - the thickness of the font for the text in the button
  6. Padding - height and width of the text box within the actual button. The larger these numbers, the smaller the space for the text within the button becomes
  7. Font-size - the size of the text in the button
  8. Border-radius - controls the shape of the button. The higher the radius, the more curved the edges of the button become
  9. Cursor - this changes what the cursor looks like when someone hovers over the button. We recommend leaving the cursor set as is so that the button appears “clickable” to users
.koalafi-right-align {
  background-color: #a6bfd5;
  color: #314054;
  width: 100px;
  text-align: center;
  font-weight: bold;
  padding: 5px 10px;
  font-size: 14px;
  border-radius: 5px;
  float: right;
  cursor: pointer;
}

Checkout Button

  1. The id for this button is koalafi-shop-first and the styling is controlled by the Koalafi-shop-first class. Most of the styling for this button is controlled by the Wordpress theme on your site, but this class currently controls:
    1. Text-align - how the text is aligned within the button
    2. Cursor - this changes what the cursor looks like when someone hovers over the button. We recommend leaving the cursor set as is so that the button appears “clickable” to users
  2. You can overwrite any particular fields by adding them to this class.
#koalafi-shop-first {
  text-align: center;
  /* width: 100%;
  border: 1px solid #cfcfcf;
  background-color: #d9d5d5;
  color: black;
  font-weight: bold;
  padding: 10px; */
  cursor: pointer;
}

Using developer tools:

  1. In Chrome, right click > inspect. This opens a panel for developer tools. You can choose to display the panel on either the bottom or right of your screen. In our screen shots below we have it on the right.

  2. In the developer tools window, make sure your are on the first tab which is named Elements (red box in the image below). This will show you the entire HTML for the page you’re currently on.

  3. Next to the tab at the top of the window, there will be two icons. Choose the icon that looks like a pointer on the screen (yellow box in image above). This will allow you to click on any element on the screen and have the corresponding HTML selected. This saves you the time of needing to hunt through all of the HTML to find the specific class you’re interested in. In our example, we have clicked the Apply now button and are looking at the Koalafi-right-align class.

  4. If you are planning to use the theme customizer, copy the class name because you will need that to make your changes. If using, we recommend switching over to the theme customizer at this time because it will show your changes on the screen and allow you to save your changes as you go. I find it helpful to keep the developer tools open even while using the theme customizer because some styles are controlled by the WP theme and it’s helpful to see what’s actually rendering on the page.

  5. Once you have selected the element you want to edit, on the right of the developer console a second panel will open. Make sure you are on the styles tab (yellow box in next 2 images below).

Developer Tools with Style panel on the bottomDeveloper Tools with Style panel on the bottom

Developer Tools with Style panel on the bottom

Developer Tools with Style panel on the sideDeveloper Tools with Style panel on the side

Developer Tools with Style panel on the side

  1. On this panel you should see all the classes on this element. Look for the specific koalafi class (should be at the top or near the top / red box in images above) and then you can tweak any value in the brackets. Some values are numeric, others are text based and some are from a predefined list. If you change a value that only accepts values from the predefined list, the browser should provide you with a list of acceptable values.
  2. If you refresh the page, it will return to all the defaults so if you like something be sure to capture the changes in the theme customizer, style.css or locally!