WGS One Step Checkout Template

From WHMCS Global Services Module Documentation
Revision as of 13:31, 18 August 2020 by Manvinder (talk | contribs) (How to upgrade to V 1.0.8?)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

About WHMCS One Step Checkout Orderform Template

WHMCS One Step Checkout Template is basically the WHMCS One page order form, that is designed in a way to boost the checkout process of your WHMCS. With our one step checkout template, you can bypass the default 5 Steps of the WHMCS order form to just one.

Installation Guide

How to Download the Module Files?

Step 1 - Go to WHMCS main website i.e. https://whmcsglobalservices.com.

Step 2 - Next, login to your Client Area i.e. https://whmcsglobalservices.com/members/clientarea.php.

Step 3 - Now, Download the One Step Checkout Module depending on the WHMCS version you are using.

Step 4 - Once you have done that a zip file will start downloading.

Module files have been successfully downloaded.

How to install Module Files?

Step 1 - Extract the downloaded zip file.

Step 2 - Now, connect to your local FTP Client example: FileZilla, cPanel, etc.

Step 3 - Next, Put the address of your extracted (WHMCS) file in the Local Site bar.

Step 4 - Open the extracted WHMCS folder in your local FTP Client.

Step 5 - Further, put the address of root directory (/public_html) in the Remote Site bar.

FileZilla1.png

Step 6 - Once you have done that, upload the modules folder from the extracted files root directory (WHMCS/modules/addons/).

Step 7 - Similarly, upload the templates folder from the extracted files root directory (WHMCS/templates/orderforms/).

FileZilla2.png

Now your Installation process of One Step Checkout Module is complete.

Setting Up Language Variables

If you wish to customize the languages for your WHMCS Module. Follow this guide through.

We have used the default WHMCS language variable in our one-step checkout order form.

Step - 1 Check for Overrides directory in your (public_html/lang) root directory using your FTP client.

Language1.png

Step - 2 If you already have Overrides directory then skip next step otherwise keep following.

Step - 3 Now, create the Overrides directory in the lang directory using your FTP client.

Step - 4 Next, create a file 'english.php' in the Overrides directory.

Language2.png

Step - 5 Write the following code in english.php file.

<?php

if (!defined("WHMCS")) die("This file cannot be accessed directly");

$_LANG['locale'] = "en_GB";

Language3.png


Step - 6 Add the following code in english.php file below the above-given code.


  • $_LANG['wgsOnePageThisDoman'] = "this domain ";
  • $_LANG['wgsOnePageContactAdmin'] = " Please contact with whmcs administrator for same.";
  • $_LANG['wgsOnePageHaveDomain'] = "This product have domain required please add domain Or there is domain in cart will assign that domain. you can manage it later.";
  • $_LANG['wgsOnePageAllowDomainReg'] = " Please ask whmcs admin to allow domain registration.";
  • $_LANG['wgsOnePageRemovePromoCode'] = "Are you sure you want to remove promo code?";
  • $_LANG['wgsOnePageRegTransferDomain'] = "Register Domain/Transfer Domain";
  • $_LANG['wgsOnePageChooseProductGroup'] = "Choose Product Group";
  • $_LANG['wgsOnePageSelectProductGroup'] = " --Select Product Group-- ";
  • $_LANG['wgsOnePageChoosePlan'] = "Choose Your Plan";
  • $_LANG['wgsOnePageShowLess'] = "show less!";
  • $_LANG['wgsOnePagePrefferedTld'] = "Preffered tld is not available.";
  • $_LANG['wgsOnePageManageDomainProduct'] = "Manage Domain with Product";
  • $_LANG['wgsOnePageManageDomainOption1'] = "Choose Prefered Action For Domain";
  • $_LANG['wgsOnePageManageDomainOption2'] = "Remove Domain From Product";
  • $_LANG['wgsOnePageDomainRequired'] = "Domain Required";
  • $_LANG['wgsOnePageDomainAssignedAlready'] = "Domain Already assigned to this product. try to remove and then reassign.";
  • $_LANG['wgsOnePageSignSignup'] = "Sign In / Sign Up";
  • $_LANG['wgsOnePagePromoCode'] = "Promo Code";
  • $_LANG['wgsOnePageAssignDomainError'] = "Assign domain to your hosting services to complete the order";
  • $_LANG['wgsOnePageRemoveCart'] = "Remove";
  • $_LANG['wgsOnePageSelectProduct'] = "Select Product Addon";
  • $_LANG['wgsOnePageOwnDomainAdd'] = "Your domain is assigned to product. Check summary for same.";
  • $_LANG['wgsOnePageMoneyBackMainHeading'] = "30 days money back guarantee";
  • $_LANG['wgsOnePageMoneyBackTagLine'] = "You have 30 days to change your mind in case you are not satisfied.";
  • $_LANG['wgsOnePageMoneyBackNotes'] = "*refund does not apply to domain names";
  • $_LANG['wgsOnePageSaveCycle'] = "Save";
  • $_LANG['wgsOnePageCycleAt'] = "at";
  • $_LANG['wgsOnePageCycleChange'] = "Change Billing Cycle";
  • $_LANG['wgsOnePageCycleAlert'] = "You Must Select the billing cycle";
  • $_LANG['wgsOnePageCycleAlertTitle'] = "Choose Billing Cycle";
  • $_LANG['wgsOnePageCycleAlertBtnOk'] = "Ok";
  • $_LANG['wgsOnePagePromoAlertTitle'] = "Promo code error.";
  • $_LANG['wgsOnePageHavePromoCode'] = "Have a promo code ?";
  • $_LANG['wgsOnePageRemoveButton'] = "Remove";
  • $_LANG['wgsOnePageHostingPlan'] = "Select Hosting Plans";
  • $_LANG['wgsOnePageBuyHosting'] = "Buy Hosting +";
  • $_LANG['wgsOnePageBuyDomainHosting'] = "Domain";
  • $_LANG['wgsOnePageBillingCycle'] = "Billing Cycle";
  • $_LANG['pricingCycleLong']['onetime'] = "One Time";
  • $_LANG['wgsOnePageSubDomainAdd'] = "Your subdomain is assigned to product. Check summary for same.";
  • $_LANG['wgsOnePageSubDomainError'] = " is already assign try with another one.";
  • $_LANG['wgsOnePageButtonAdded'] = "Added";
  • $_LANG['wgsOnePageOnSale'] = "On Sale";
  • $_LANG['wgsOnePageBillMainHeading'] = "Select Term length";
  • $_LANG['wgsOnePageBillMainDescrp'] = "Lock in your saving with a multi year term.";


Language4.png

Step 7 - Next, Save the file.

The above-shared code was added under lang/overrides/english.php

In case you need to add in other languages, just follow the same above mentioned procedure and manually change the text fields on the right side in the second code that was added, according to your language. Make sure not to make any changes in the first code that was added to the english.php file.

How to activate WGS One Step Checkout with WHMCS?

Let's configure the addon module in your WHMCS.

Step 1 - First login to WHMCS Admin Area.

Step 2 - Next, go to Setup -> Addon Modules.

Step 3 - Now, find One Step Checkout and press the Activate button.

Step 4 - Enter your module license key.

Step 5 - Further, Enable/Disable to delete the DataBase module tables, when deactivating the module.

Step 6 - Once you have done that, Assign user(s), who can access this module like Full Administrator, Sale Operator, and Support Operator.

Step 7 - Click on Save Changes button.

Now your WGS One Step Checkout Addon has been successfully activated.

One Step Checkout WHMCS.png

How to Activate the One Page Cart Template?

After completion of the installation now you need to set one page orderform as your default cart template.

Let's start with the activation of One Page Cart Template guide.

Step 1 - First login to WHMCS Admin Area.

Step 2 - Next, go to Setup -> General Settings -> Ordering.

Step 3 - Select "WHMCS One Step Checkout" as the default ordering template.

Step 4 - Now, click on Save Changes button.

WHMCS - General Settings (1).png

How to upgrade to V 1.0.8?

You can easily upgrade the One Step Checkout Orderform with the new version. First take a backup of the complete WHMCS for security point of view.

Step 1 - Extract the downloaded zip file.

Step 2 - Now, connect to your local FTP Client example: FileZilla, cPanel, etc.

Step 3 - Next, Put the address of your extracted (WHMCS) file in the Local Site bar.

Step 4 - Open the extracted WHMCS folder in your local FTP Client.

Step 5 - Further, put the address of root directory (/public_html) in the Remote Site bar.


FileZilla1.png

Step 6 - Once you have done that, upload the modules folder from the extracted files root directory (WHMCS/modules/addons/).

Step 7 - Similarly, upload the templates folder from the extracted files root directory (WHMCS/templates/orderforms/).


FileZilla2.png


Step 8 - Add the following language variables under lang/overrides/english.php

  • $_LANG['wgsOnePageOnSale'] = "On Sale";
  • $_LANG['wgsOnePageBillMainHeading'] = "Select Term length";
  • $_LANG['wgsOnePageBillMainDescrp'] = "Lock in your saving with a multi year term.";

Step 9 - Click on the Upgrade Database in Admin menu

WHMCS WGS OPC (31).png
WHMCS WGS OPC (5).png

In case of any custom style changes, take a backup of your style.css. And add your custom code in the new Style.css file.

How to Set Payment Gateways for a Specific Country?

With one step checkout orderform template, WHMCS admin can define specific payment gateways for a specific country.

It auto detects IP via Geo location. Further, it gets that country's payment gateways according to that country. Moreover, it will automatically activate the orderform template in that country's language.

Step 1 - Login to WHMCS Admin Area.

Step 2 - Next, go to Addons -> One Step Checkout.

WHMCS One Step Checkout Orderform Admin Panel.png


Step 3 - Select the Gateway Switcher.

WHMCS - One Step Checkout.png


Step 4 - Next, select the Payment Gateway that you want to assign to that specific country.

WHMCS - One Step Checkout Payment Gateway.png


Step 5 - Click on Add Country.

Step 6 - Further, select the countries you want to set for that particular payment gateway.

Step 7 - Once you have done that, click on the Save Changes button.

WHMCS - One Step Checkout (1).png


Payment gateway for a specific country is now assigned successfully.

How to Set Payment Gateways Image?

It is quite easy to set payment gateway icons with our one step checkout template. And our give orderform gives a more appealing look to it.

Step 1 - Login to WHMCS Admin Area.

Step 2 - Next, go to Addons -> One Step Checkout.

WHMCS One Step Checkout Orderform Admin Panel.png



Step 3 - Select the Gateway Image Setting.

WHMCS - One Step Checkout Payment Gateway Icons Setup Area.png


Step 4 - Now, you can set an image for a specific payment gateway.

WHMCS - One Step Checkout Payment Gateway Icons Setup.png


Step 5 - Just in case, you wish to change an already assigned image for a payment gateway. Click on browse image under the payment gateway name.

WHMCS - One Step Checkout Payment Gateway Icons Selector.png


Step 6 - Next, select an image.

Step 7 - Save the settings.

Now, the Payment Gateway image has been successfully selected.

Image Directory in which you need to upload the image before assigning here: addons\WhmcsOneStepCheckout\assets\paymentgateway

Troubleshooting

Issue

One Page Checkout Product adds link redirecting to the Configure Product Page

Solution

Check for a license. If the license is already activated then please make sure you don't have given specific cart to that product group.

Follow the following screenshots to make product group order form default.

Step 1 - Login to WHMCS Admin Area.

Step 2 - Next, go to Setup -> Product/Services -> Product/Services.

OnePageProductImage1.png


Step 3 - Click on edit group icon.


OnePageProductImage3.png


Step 4 - On order form template choose Use System Default option.

Step 5 - Click on Save Changes button.

OnePageProductImage2.png

Now your issue is resolved.

Setting Up Stripe Payment Gateway

Good news for the users who used Stripe Payment Gateway in their WHMCS, our one-page order form is now fully compatible with Stripe Payment Gateway.

Here is the procedure you need to follow to make it work for you.

You need to create a hidden product with an amount greater than 0 and pass its Product ID in the "Static Product ID for Stripe Payment Gateway".

Step 1: Go to One Page Checkout Settings

Step 2: Select General Settings

Step 3: Add Product ID in "Static Product ID for Stripe Payment Gateway"

Step 4: Save Settings

WHMCS WGS OPC (2).png

How to change font family in one step checkout?

In case you want to change the font family of the one step checkout orderform, please follow this detailed procedure:

New Font Families added in one step checkout orderform:

/***** Lato Font available ******/
  • Lato Regular
  • Lato Italic
  • Lato Hairline
  • Lato Hairline Italic
  • Lato Light
  • Lato Light Italic
  • Lato Bold
  • Lato Bold Italic
  • Lato Black
  • Lato Black Italic
/***** Montserrat ******/
  • Montserrat Regular
  • Montserrat Italic
  • Montserrat Thin
  • Montserrat Thin Italic
  • Montserrat ExtraLight
  • Montserrat ExtraLight Italic
  • Montserrat Light
  • Montserrat Light Italic
  • Montserrat Medium
  • Montserrat Medium Italic
  • Montserrat SemiBold
  • Montserrat SemiBold Italic
  • Montserrat Bold
  • Montserrat Bold Italic
  • Montserrat ExtraBold
  • Montserrat ExtraBold Italic
  • Montserrat Black
  • Montserrat Black Italic
/***** Open Sans ******/
  • Open Sans Regular
  • Open Sans
  • Open Sans Italic
  • Open Sans Light
  • Open Sans Light Italic
  • Open Sans SemiBold
  • Open Sans SemiBold Italic
  • Open Sans Bold
  • Open Sans Bold Italic
  • Open Sans ExtraBold
  • Open Sans ExtraBold Italic
  • Open Sans Light Regular
  • Open Sans Condensed Bold
/***** Roboto ******/
  • Roboto Regular
  • Roboto Italic
  • Roboto Bold
  • Roboto Bold Italic
  • Roboto Thin
  • Roboto Thin Italic
  • Roboto Light
  • Roboto Light Italic
  • Roboto Medium
  • Roboto Medium Italic
  • Roboto Black
  • Roboto Black Italic


How to enable a font in one step checkout?


Step 1: Login FTP or Cpanel

Step 2: Go to /public_html/templates/orderforms/WhmcsOneStepCheckout/assets/css/overrides/

Step 3: You will find a file with the name of : overrides.css.new

Step 4: Edit the file name to overrides.css

Step 3: Now edit the files and add the font css like this:

.choose-plan-wrapper h2{
   font-family: ' Open Sans Condensed Bold';

}

This will change the H2 font to Open Sans Condensed Bold, similarly, you can define the CSS font rule for other sections of the one step checkout orderform.