Documentation

PayLoom 2 (DEPRECATED) plugin


General

Here are the PayLoom basics - things you need to understand to add items and work with a basic PayLoom page. When you add a PayLoom page to your site it's added with NO active products. To add a product, click the + symbol in the products column. Now that you've added a product you can drag in an image and define basic appearance and sale properties of this item. They are:

Detail Image
Specify the scaled or cropped size of the image that will be generated on the details page

Details Lightbox
This defines size specifications for the Details window that will be presented when users click on a product. Be sure this size accomodates the image (whose size you specified above) and detail text you'll enter about this item.

Item Name ( required )
Enter the name of the item or service you wish to sell

Item ID / Number
If you have an ID or tracking number for your item, enter it here. This field will be displayed to your customers at the time of payment, and will be shown in both the buyer’s and seller’s transaction details on the PayPal website - this may be a part number you or the product manufacturer use to designate this item. Use of this field may help your search engine ranking even if you don't necessarily need it, so consider using a part number.

Item Price ( required )
Enter the price of the item you wish to sell. If you would like to allow customers to specify their own price paid for an item, enable the Customize checkbox. This is also useful for donation amounts instead of goods or services.

Shipping
The cost to ship this item. If you use shipping amounts in PayLoom the shipping price for all products will be added up at checkout.
This will override what you have set in your PayPal account profile - do not use this field if you are using shipping rules in your PayPal profile.

Tax
The tax AMOUNT you would like to charge for this item. ( i.e. 2.25 )
By making the value 0.00, you could run a tax-free promotion on an item. This will override any tax rules set in your PayPal account profile - do not use this field if you are using tax rules in your PayPal profile.

Weight
Enter your product's weight if you use PayPal Shipping Rules based on weight. The weight type you enter here should correspond with the unit of weight specified in your PayPal account, ie, oz, lb, kg, etc.

Handling
If you wish to add a handling fee to this item, enter the handling charge amount here (ie, 5.50)


Describe

Brief Description
A short description of the item you are selling. This is generally used in list views so keep it short. Use our built in WYSIWYG tools to modify text styles or add links to other products.
HTML Allowed if checkbox enabled

Long Description
A Longer, more elaborate description of the item you are selling. This is used when user is viewing the detailed view. Use our built in WYSIWYG tools to modify text styles or add links to other products.
HTML Allowed if checkbox enabled


Options

Option fields let your customers specify options (such as size or color) for the items they purchase. Options can have price overrides - so you can have a product with a base price and then offer it with different configuration/price options

To Setup A Product Option:

  • Click the + symbol in the Product Options page (top pane) to add an option.
  • Provide a title for the option. For example, Size or Color.
  • Choose the type of input the customer will use to selection options, you can use Select Menu, Radio Buttons, Text field (for user supplied options - more on this later), Checkboxes or Hidden.
  • If this option will have Price Overrides, enable the checkbox.
  • Now you need to setup the choices that will appear in the Option you just created. In the lower Option Choices pane, click the + symbol.
  • Next you'll define the values of the choices for this option. Enter a Choice Value and (if enabled) Price Override. For example, if you are selling T-Shirts, your Choice Values might be Small, Medium, Large and X-Large. If you charge $9.95 for your shirts and $2 additional for X-Large, you would enter 0.00 as the Price Override value for S, M and L and 2.00 as the Price Override for X-L.
  • This option is now complete. You can now start from the first step and add an additional option, for example, Color, if you want users to be able to select a size AND color for this product.

Image Prefs

Thumb Image Settings
The crop/scale and size settings you specify here will be applied to ALL image thumbnails on THIS PayLoom page.

Background
Change the background color of your product image.

Padding
Add padding to your product image.

Rounded Corners
Use this slider to control the image corner shape, rounded to square

Borders
Add a border to your product. You can even adjust the thickness and color of it.

Reflection
Add reflections to every product image on your page with just one click.

Drop Shadow
Add a drop shadow to the entire product image - the X and Y values control the shadow's offset.


Misc

Image Alt Tags
These fields are primarily provide for search engine optimization - it's often beneficial to use Alt tags to describe images.

Linklok settings
Users of Vibralogix Linklok can use these settings to control distribution of digital goods.


Page Inspector Settings


There are a few VERY important bits of information you need to provide on the Page Inspector for EACH PayLoom page on your site. Click on the Inspector icon in the lower right hand corner of your PayLoom page to open the Page Inspector. All of the really important stuff is located on the PayPal tab of the Inspector:

PayPal Email Account
This is probably the single most important field you'll fill out to setup PayLoom! The email address you enter in this field should be the email account you've configured to RECEIVE PayPal payments. If you do not enter your PayPal verified email address here, PayLoom generated pages will not be associated with your account!

Currency
This setting should match the native currency of your PayPal account. This is the currency you will RECEIVE payments in and will also affect the currency symbol displayed on your PayLoom pages.

Language
This is the language that the PayPal Shopping Cart will be displayed in. Does not affect your PayLoom pages but affect language once the customer is transferred to PayPal for final checkout.

Payment Success URL
This is a page you'll create in RapidWeaver that will be the page that customers are returned to after a SUCCESSFUL PayPal checkout. This is often a simple "Thank You for your Order" type page. To create this page, add the desired page type (styled text, etc) to your site, enter your desired text and then go to the Page Inspector for that page. Look at the General settings. UNCHECK the SHOW IN MENU option. This way, only users directed to the page by PayPal Shopping Cart will ever see it - it will not be part of your navigation menu in your RapidWeaver page but will be published along with your site.

Payment Canceled URL
This is a page you'll create in RapidWeaver that will be the page that customers are directed to with an UNSUCCESSFUL PayPal checkout session - this can be the result of either an error or the customer canceling out of checkout. You might want to use this page to provide the customer with further information on contacting you to complete the order. Look at the General settings. UNCHECK the SHOW IN MENU option. This way, only users directed to the page by PayPal Shopping Cart will ever see it - it will not be part of your navigation menu in your RapidWeaver page but will be published along with your site.

Payment Notify (IPN) URL
This URL only needed for users utilizing the Vibralogix Linklok tool or those providing some other IPN based system of order followup. If you don't know what those are, you can probably leave this field empty.

Creating your own Template (version 2.0+)

Example Layout Template

<div id="template-code">
<span style="color: #777777;"> 1</span> <span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">li </span><span style="color: #7faac7;">id</span><span style="color: #b97a3c;">="%product-id%"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 2</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">a </span><span style="color: #7faac7;">name</span><span style="color: #b97a3c;">="%anchor-id%"</span><span style="color: #b97a3c;">></</span><span style="color: #b97a3c;">a</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 3</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">a </span><span style="color: #7faac7;">href</span><span style="color: #b97a3c;">="#%detail-id%"</span><span style="color: #7faac7;"> title</span><span style="color: #b97a3c;">="%product-name% Details"</span><span style="color: #7faac7;"> class</span><span style="color: #b97a3c;">="{frameWidth: %detail-box-width%, frameHeight: %detail-box-height%} payloom-show-details"</span><span style="color: #b97a3c;">><</span><span style="color: #b97a3c;">img </span><span style="color: #7faac7;">src</span><span style="color: #b97a3c;">="%product-image%"</span><span style="color: #7faac7;"> class</span><span style="color: #b97a3c;">="payloom-prod-img"</span><span style="color: #7faac7;"> data-thumbW</span><span style="color: #b97a3c;">="32"</span><span style="color: #7faac7;"> data-thumbH</span><span style="color: #b97a3c;">="32"</span><span style="color: #7faac7;"> alt</span><span style="color: #b97a3c;">="%product-alt%"</span><span style="color: #7faac7;"> </span><span style="color: #b97a3c;">/></</span><span style="color: #b97a3c;">a</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 4</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">div </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="payloom-prod-content"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 5</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">span class="payloom-product-name"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">%product-name%</span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">span</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">    
</span><span style="color: #777777;"> 6</span> <span style="color: #FFFFFF;">        </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">div </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="amount"</span><span style="color: #7faac7;"> id</span><span style="color: #b97a3c;">="amount_%amount-id%"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">%product-price%</span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">div</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 7</span> <span style="color: #FFFFFF;">        </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">p</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">%product-blurb%</span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">p</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;"> 8</span> <span style="color: #FFFFFF;">        %product-options%
</span><span style="color: #777777;"> 9</span> <span style="color: #FFFFFF;">        %add-to-cart-button%        
</span><span style="color: #777777;">10</span> <span style="color: #FFFFFF;">        </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">p </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="payloom-show-details-link"</span><span style="color: #b97a3c;">><</span><span style="color: #b97a3c;">a </span><span style="color: #7faac7;">href</span><span style="color: #b97a3c;">="#%detail-id%"</span><span style="color: #7faac7;"> title</span><span style="color: #b97a3c;">="%product-name% Details"</span><span style="color: #7faac7;"> class</span><span style="color: #b97a3c;">="{frameWidth: %detail-box-width%, frameHeight: %detail-box-height%} payloom-show-details"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">%more-details-link-text%</span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">a</span><span style="color: #b97a3c;">></</span><span style="color: #b97a3c;">p</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">11</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">div</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">12</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">div </span><span style="color: #7faac7;">id</span><span style="color: #b97a3c;">="%detail-id%"</span><span style="color: #7faac7;"> class</span><span style="color: #b97a3c;">="details"</span><span style="color: #7faac7;"> style</span><span style="color: #b97a3c;">="display:none;"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">        
</span><span style="color: #777777;">13</span> <span style="color: #FFFFFF;">        </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">div </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="payloom-detail-contents"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">14</span> <span style="color: #FFFFFF;">            </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">img </span><span style="color: #7faac7;">src</span><span style="color: #b97a3c;">="%detail-image%"</span><span style="color: #7faac7;"> class</span><span style="color: #b97a3c;">="detail-image"</span><span style="color: #7faac7;"> style</span><span style="color: #b97a3c;">="width:%detail-image-width%px; height:%detail-image-height%px;"</span><span style="color: #7faac7;"> alt</span><span style="color: #b97a3c;">="%detail-alt%"</span><span style="color: #7faac7;"> </span><span style="color: #b97a3c;">/><</span><span style="color: #b97a3c;">br </span><span style="color: #b97a3c;">/></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">15</span> <span style="color: #FFFFFF;">            </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">div </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="detail-info"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">16</span> <span style="color: #FFFFFF;">                </span><span style="color: #b97a3c;"><</span><span style="color: #b97a3c;">p </span><span style="color: #7faac7;">class</span><span style="color: #b97a3c;">="description"</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">%product-description%</span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">p</span><span style="color: #b97a3c;">></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">17</span> <span style="color: #FFFFFF;">            </span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">div</span><span style="color: #b97a3c;">></span><span style="color: #777777;"><!--</span><span style="color: #777777;"> detail-info </span><span style="color: #777777;">--></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">18</span> <span style="color: #FFFFFF;">        </span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">div</span><span style="color: #b97a3c;">></span><span style="color: #777777;"><!--</span><span style="color: #777777;"> payloom-detail-contents </span><span style="color: #777777;">--></span><span style="color: #FFFFFF;">                
</span><span style="color: #777777;">19</span> <span style="color: #FFFFFF;">    </span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">div</span><span style="color: #b97a3c;">></span><span style="color: #777777;"><!--</span><span style="color: #777777;"> %detailid% </span><span style="color: #777777;">--></span><span style="color: #FFFFFF;">
</span><span style="color: #777777;">20</span> <span style="color: #FFFFFF;"></span><span style="color: #b97a3c;"></</span><span style="color: #b97a3c;">li</span><span style="color: #b97a3c;">></span></div>

Last Update: 2016-02-19T21:45:02Z