OnePageCheckoutPS

Complete documentation to install, configure, and use the OnePageCheckoutPS module in your PrestaShop store.

What is OnePageCheckoutPS?

OnePageCheckoutPS is a one-page checkout module for PrestaShop that optimizes the purchase process by consolidating all steps into a single page. The module provides a fast and efficient shopping experience, allowing customers to complete their orders without distractions, with support for multiple customizable layouts, social authentication, configurable additional fields, and diverse payment methods.

5.3.1
Version
PS 1.7.6+
PS 8.x
PS 9.x
Multistore
Multi-language

Main Features

Optimized one-page checkout

Consolidates all steps of the purchase process into a single page, allowing customers to complete their orders without distractions.

Flexible authentication

OTP (One-Time Password) authentication system via email and guest checkout with automatic temporary email generation, eliminating barriers in the purchase process.

Multiple customizable layouts

Four available designs (vertical, steps, three_columns, shopify) that adapt to different store styles and user preferences.

Address autofill with Google Maps

Integration with Google Maps to automatically complete addresses, facilitating the registration process and reducing errors in shipping data.

Side cart across the whole store

Slide-out panel available on any store page, where the customer reviews products, changes quantities, applies coupons and moves straight to payment without leaving the page they are on.

System Requirements

Requirement Minimum Recommended
PrestaShop 1.7.6 9.x
PHP 7.2 8.1+

Installation

There are two methods to install the module in your PrestaShop store, depending on your server characteristics.

Method 1: Installation from Back Office

1
Access the Back Office

Log in to your PrestaShop store administration panel.

2
Navigate to Modules

Go to Modules → Module Manager in the sidebar menu.

3
Upload the module

Click "Upload a module" and select the downloaded ZIP file.

4
Install and activate

Once uploaded, the module will install automatically. Click "Configure" to begin.

Method 2: Installation via FTP

1
Extract the ZIP file

Extract the contents of the ZIP file on your local computer.

2
Connect via FTP

Use an FTP client (such as FileZilla) to connect to your server.

3
Upload the module folder

Upload the module folder to /modules/ in your PrestaShop installation.

4
Install from Back Office

Go to Modules → Module Manager, find the module and click "Install".

Possible Installation Issues

If you experience override errors when installing or activating the module, do not attempt to resolve it yourself if you lack technical experience. Contact our support team to receive personalized help and resolve the conflict safely.

Contact Support

Settings

This main section groups module configurations, organized into subsections that control different aspects of the checkout process.

Module configuration panel
Configuration Panel - Settings

General

In this configuration section you will find the parameterization options that will define the general behavior of the module.

Sandbox

Enable this option to allow testing the module in your store before enabling it for customers. When activated, the module will only be visible and functional from the IP addresses you specify in the "IP" field, allowing controlled testing without affecting other visitors.

IP

Lists the IP addresses from which the module will be visible when Sandbox mode is activated. Only visitors accessing from these IPs will see and be able to use the module's checkout. You can automatically add your current IP by clicking the "+" button next to the field.

Customer ID

Internal customer used to calculate and display real prices to visitors without requiring registration or login.

Enable persistent debug logs

When this option is enabled, the module stores a history of checkout actions and values. This information is useful for the development team to analyse and resolve any issue that may have occurred in your store.

Enable guest checkout

When this option is active, it allows unregistered visitors to make purchases without needing to create an account, completing the checkout as guests.

Confirm delivery address before checkout

When this option is active, it displays a confirmation checkbox with the selected shipping address, allowing the customer to confirm their address before finalizing the order.

Choose the carrier you use for in-store pickup

When the "Confirm delivery address before checkout" option is activated, this option allows you to select the carriers you use for in-store pickup service (Click & Collect, Local Pickup, etc.). Customers who select one of these carriers in the checkout process will not see the delivery address confirmation checkbox in the payment step, allowing a faster checkout for this type of shipping.

Redirect directly to checkout page

When this option is active, when proceeding with the purchase the customer is directed directly to the checkout page, without going through the traditional cart page.

Hide the tax label when no tax applies (0%)

Enable this option so the "tax included" label disappears when the applicable tax rate is 0%. PrestaShop ignores the province tax rule and shows that label even when no tax is actually being applied, which can confuse the customer.

Replace registration and login form with checkout form

When activated, this option replaces the native PrestaShop authentication form (login and registration) with the module's custom form.

Separate login and registration pages

This sub-option appears when "Replace registration and login form with checkout form" is enabled. When activated, the login page shows only the login form and the registration page shows only the registration form. If you disable it, both forms are shown together.

Show checkout registration form in: My Addresses

When activated, this option replaces PrestaShop's "My Addresses" section with the module's custom address form, allowing customers to manage their shipping and billing addresses with the checkout style.

Show checkout registration form in: My Personal Information

When activated, this option replaces the customer account personal data form with the module's custom form.

Registration

In this configuration section you will find options related to the customer registration and authentication process.

Force customer registration or login

When this option is enabled, customers who are not logged in are redirected to the authentication page before they can access the checkout. It is useful for stores that only sell to registered customers.

Enable privacy policies

When this option is active, a checkbox will be displayed for customers to accept the privacy policies in order to complete the registration process on the checkout page.

Additionally, a sub-option in the configuration will be activated that allows you to select which CMS page of your store will be displayed when the customer clicks on the privacy policy link.

Enable registration without email

Allows customers to complete checkout without providing an email address, automatically generating a temporary email for the account.

Mark account creation by default

When this option is active, the account creation checkbox is checked by default in the checkout registration form.

This configuration only applies on the checkout page. If the customer accesses the login or registration pages directly (authentication), creating an account will be mandatory and guest registration is not allowed.

Show password policy recommendations

Enable this option to show security recommendations and suggestions to customers while creating their passwords, helping them comply with the established password policy and create more secure passwords.

Request password confirmation

Controls whether the registration form includes the password confirmation field. Disable this option to ask for the password only once and shorten the form.

OTP Login

In this configuration section you will find options to enable and configure the One-Time Password (OTP) authentication system, including expiration time, allowed attempts, and expired code management.

Configure CRON task

This section displays a URL that you can copy to configure a scheduled task (CRON) on your server. The CRON task will automatically execute the deletion of expired OTP codes periodically. It is recommended to configure this task to run every hour, thus keeping the database clean without manual intervention.

Enable OTP login

When this option is active, registered customers can log in using a one-time code (OTP) sent to their email, instead of the traditional password, facilitating access to their account without needing to remember passwords.

OTP expiration time (minutes)

Defines the time in minutes during which an OTP code is valid after being generated. Once the specified time expires, the customer must request a new code to log in.

Maximum verification attempts

Defines the maximum number of failed attempts allowed when entering the OTP code. Once this limit is reached, the code is blocked and the customer must request a new one to continue.

Delete expired OTP codes now

This button executes the immediate deletion of all expired OTP codes. Use it when you need to manually clean expired codes without waiting for the scheduled task (cron) to run. When clicked, all expired codes will be removed from the database.

OTP Statistics

This section displays a panel with metrics of OTP system usage in the last 30 days, including:

  • Total Requests (30 days): Total number of OTP codes generated and sent to customers in the last 30 days
  • Successful Logins: Number of OTP verifications completed successfully
  • Failed Attempts: Number of failed OTP code verification attempts
  • Success Rate: Calculated percentage of successful verifications relative to total requests

These statistics help you monitor the effectiveness of the OTP authentication system among your customers.

Addresses

In this section you will find options to manage shipping and billing addresses, including validations, automatic autocomplete, phone mask, and other advanced functionalities that optimize the customer experience when entering their address data.

Configure CRON task

This section displays a URL that you can copy to configure a scheduled task (CRON) on your server. The CRON task will automatically execute the deletion of empty addresses created by the module during the checkout process. This helps keep the database clean of incomplete addresses that customers did not finish.

Request billing address

When activating this option, a checkbox is displayed in the checkout address step that allows the customer to decide whether they want to enter a billing address different from the shipping address. When checked, the corresponding form is enabled to enter the billing address data.

Invoice address position

This sub-option appears when "Request billing address" is enabled and defines the order in which addresses are requested during checkout. You can choose "After delivery address" (the usual behaviour) or "Before delivery address", which is useful in stores where billing details are the starting point of the purchase.

Required

This sub-option is only available when the billing address is shown after the delivery address. When activated, customers must complete the billing address to be able to finalize the order.

Request invoice

When this option is enabled, an "Individual / Company" selector is added to the address form, requesting the tax details for each case: an ID number for individuals, or a company name and VAT number for companies. For customers in Italy, companies must also provide an SDI code or a PEC email.

Show request invoice in

This sub-option determines which form displays the invoice selector. You can show it in the invoice address form, in the delivery address form, or in both forms.

Only allow company invoices

Enabling this option hides the "Individual" tab, so the customer can only request the invoice as a company. It is intended for stores that do not issue invoices to private individuals.

Mandatory (request invoice)

When activated, the switch that lets the customer opt out of the invoice disappears: the invoice type selector and its fields are always shown and required. Use it in stores that issue an invoice for every order.

Show city list using Geonames.org

Enables a dropdown list of cities based on the free Geonames.org database. When this option is active, cities are automatically displayed according to the selected province, facilitating correct selection by the customer.

Use Geonames.org autocomplete from postal code

When enabling this option, the postal code is used as a basis to show automatic city suggestions while the customer is entering it, using the free Geonames.org service. By selecting one of the suggested options, the postal code and city fields are automatically completed.

Use Google address autocomplete

When enabling this option, the Google API is integrated to show address suggestions in the address field while the customer types. By selecting a suggestion, the address, city, and postal code fields are automatically completed, provided the information is available.

This functionality applies to both the shipping address and the billing address, improving data accuracy.

Google API KEY

This field is displayed when enabling the "Use Google address autocomplete" option. Here you must enter the Google API Key necessary to activate the address autocomplete functionality.

The key must be generated from the Google Cloud Console, so it is necessary to have a Google account and log in.

For security and to control usage, it is recommended to apply a restriction to the key: restrict its use by domain (application restriction using "HTTP referrers" with your store's domain) and limit the key to the Places API (New) only (API restriction).

You can consult the API Key creation process and its configuration at the following official Google links:

Validate unique ID number

When checking this option, the system will validate that the entered ID number is not already registered in addresses of other customers, avoiding duplicates.

Validate identification for Spain, Chile, Italy and Portugal

Activate this option to enable automatic format validation of identification for customers from these countries. The system will verify that the ID number or identity document complies with the correct format for each country.

Show phone mask

When activating this option, the mask functionality is enabled in phone fields, allowing you to select the country and automatically add its international prefix when entering the landline or mobile phone number.

Automatically show international prefix when selecting country

This sub-option is enabled when "Show phone mask" is active. When checked, the international prefix of the selected country (for example, +34 for Spain) is automatically displayed in the phone fields.

Enable phone number format validation

This sub-option also depends on "Show phone mask". When activated, the system validates that the phone number has the correct length and format for the selected country.

Show shipping address for virtual product purchases

Activate this option if you want a shipping address to be requested even when the products in the cart are virtual (downloads, services, etc.).

Delete empty addresses

This button executes the immediate deletion of all empty addresses created by the module. Use it when you need to manually clean incomplete addresses without waiting for the scheduled task (CRON) to run. When clicked, all empty addresses will be removed from the database.

Shipping

This section allows you to configure options related to shipping methods.

Progressive display of shipping cost

When activating this option, the shipping cost is displayed progressively according to the customer's progress in the checkout. Outside the checkout, the cart will show "To be calculated" until the customer enters their address. Once the customer completes their shipping address during checkout, the actual cost is calculated and displayed automatically.

This functionality improves the customer experience by avoiding showing incorrect shipping costs when the address is not yet complete, and then shows the precise cost once all necessary information is available.

Show carrier description

When activating this option, the description of each carrier is displayed in the shipping step of the checkout, providing additional information that can help the customer choose the most suitable shipping method.

Show carrier image

Enable this option to display the image or logo of each carrier in the shipping step. Images help visually identify available shipping options.

Choose a default carrier

Allows you to select which carrier will appear preselected by default when the customer accesses the shipping step. You can choose a specific carrier, or use the automatic options "Best price" (selects the cheapest) or "Best rating" (selects the best rated).

Show text box for order message

If you activate this option, a text field will be displayed in the shipping step where customers can leave a message or comment related to their order (for example, delivery instructions, time preferences, etc.).

Required

This sub-option appears when "Show text box for order message" is activated. When enabled, the customer must write a message before being able to continue with the purchase process.

Force state/province requirement

When you enable this option, the state or province becomes required in order to show the shipping options. If you disable it, the state is not required even in countries that have states configured, which is practical for stores where the state does not affect carrier rates or taxes.

Carrier modules that require state/province

This field appears when "Force state/province requirement" is disabled. Here you can list, separated by commas, the technical names of the carrier modules that do need a state or province. When any of them is active, the state becomes required again.

Force postal code requirement

When you enable this option, the postal code is required in every country. If it stays disabled, the requirement is determined by each country's configuration in PrestaShop or by the carrier modules that need it.

Carrier modules that require postal code

This field appears when "Force postal code requirement" is disabled. List, separated by commas, the technical names of the carrier modules that need a postal code (for example: envialacarrier, packlink). With any of them active, the postal code becomes required.

Force city requirement

Enable this option so the city is required in every country. With the option disabled, the requirement is determined only by the carrier modules that need it.

Carrier modules that require city

This field appears when "Force city requirement" is disabled. List, separated by commas, the technical names of the carrier modules that need a city (for example: shippingconfiguratorpro, chilexpress_oficial, seur). With any of them active, the city becomes required.

Payment - General

In this section you will find the general configuration options related to payment methods in the checkout process.

Show payment method images

Activate this option to show the logos or images of each available payment method, facilitating visual identification of payment options by the customer.

Show detailed payment method description

When enabling this option, detailed information about each payment method is displayed. This helps customers better understand how each option works before selecting it.

Require acceptance of terms and conditions before purchase

When you activate this option, a mandatory checkbox will appear that the customer must check to accept the terms and conditions before completing the purchase.

Terms and conditions CMS ID

This sub-option appears when "Require acceptance of terms and conditions before purchase" is activated. Here you select the CMS page of your store that contains the terms and conditions that customers must accept.

Show delivery message in payment step

If you activate this option, the delivery message will also be displayed in the payment step, allowing the customer to view and update their delivery instructions before completing the order.

Show discount box in mobile payment step

Enable this option so that the discount box (coupons) is displayed in the payment step when customers access from mobile devices, facilitating the use of promotional codes on small screens.

Payment methods that require a deferred page

Some payment gateways need to display their own form or load their SDK on an extra page after the customer clicks "Buy now" (for example Stripe, PayPal or Redsys). In this field you can list, separated by commas, the technical names of those payment modules. All other methods will process the order directly with one click.

Payment - Configuration

This section allows you to customize in an advanced way each payment method installed in your store, including titles, descriptions, logos, among others.

Select payment module

Dropdown that allows you to choose which payment method you want to configure. Once selected, all customization options available for the payment method will be displayed.

Customization options
Option Description
Debug mode Activates debug mode to test the configuration of a specific payment method before making it visible to all customers. When activated, the payment method will only be visible from the IP addresses you specify.
IP restrictions This field appears when "Debug mode" is activated for a payment method. Here you can list the IP addresses from which the payment method will be visible during testing. You can add your current IP by clicking the "+" button.
Active This switch allows you to enable the customizations that are applied and displayed on each payment method. When disabled, the payment method is displayed with its default configuration and behavior, without applying the customizations defined in the module.
Title Multi-language text field where you can customize the name that will be displayed to the customer for the payment method. You can set the title for each language available in your store.
Description Multi-language text field where you can customize the description that will be displayed to the customer for the payment method. You can set the description for each language available in your store.
Additional information Multi-language text field to add complementary information about the payment method, such as special conditions, processing times, commissions, etc.
Default When activating this option, the payment method will be automatically preselected when the customer reaches the payment step, speeding up the purchase process.
Logo Allows you to upload a custom image (logo) for the payment method. You can upload files in GIF, PNG, JPG, JPEG or SVG format. It also includes the option to delete the existing logo.
Reset payment method configuration This button resets all custom configuration of the selected payment method to its default values, including title, description, logo and other options.

Reset all configuration

Button located at the top of the section, allows you to reset the configuration of all payment methods simultaneously to their default values.

Cart

This section groups all options related to the display and behavior of the shopping cart within the checkout, including product information, totals, discounts and additional functionalities.

Show coupon box

When activating this option, a field is displayed where customers can enter discount coupon codes during the checkout process.

Show remaining amount to qualify for free shipping

Enable this option to show the customer how much money they need to add to the cart to qualify for free shipping, encouraging the purchase of additional products.

Show expanded cart on mobile devices

When activating this option, the cart summary will be displayed expanded by default on mobile devices, allowing the customer to see all products without needing an additional click.

Enable shopping cart link

This option controls the execution of hooks from other modules in the shopping cart.

Allow editing products in cart

Enable this option so customers can modify product quantities directly from the cart during the checkout process, without needing to go back.

Show weight

Activate this option to show the weight of each product in the cart listing, useful information for shipments that depend on total weight.

Show availability

When enabling this option, the availability status of each product (in stock, available, etc.) is displayed in the cart.

Show reference

Activate this option to show the reference or SKU code of each product in the checkout cart listing.

Show unit price

When enabling this option, the unit price of the product is displayed when the quantity is greater than 1. This makes it easier for the customer to clearly understand the total price calculation based on the selected quantity.

Show empty cart button

When activating this option, a button appears that allows the customer to remove all products from the cart at once.

Show zoom on product image

Enable this option so that when hovering over a product image in the cart, an enlarged version of it is displayed.

Show product delivery time

Activate this option to show the estimated delivery time for each product in the cart.

Remove product link

When enabling this option, product images and names in the cart stop being clickable links to product pages, preventing the customer from leaving the checkout.

Show product subtotal

Activate this option to show the product subtotal in the cart summary.

Show total discount

Enable this option to show the total discount applied in the cart summary.

Show shipping total

When activating this option, the cost of the selected shipping is displayed in the cart totals summary.

Show gift wrapping total

Activate this option to show the cost of gift wrapping (if available and the customer has selected it) in the cart summary.

Show total

Enable this option to show the final total amount in the cart summary.

Show total without taxes

When activating this option, the order total excluding taxes is displayed in the cart summary.

Show total taxes

Activate this option to show the total taxes applied in the cart summary.

Social Networks

This section allows you to configure integration with social networks to facilitate customer login through their Google, Facebook, PayPal, Apple and TikTok accounts.

Social networks configuration
Social networks configuration

Return URL configuration

This section displays a URL that you must configure in each social network you wish to integrate. This return URL is necessary so that social networks can redirect users back to your store after authenticating.

Information about hook usage

If you want to use social login buttons elsewhere on your page, you can use the following code in your template:

{hook h='displayOpcSocialNetwork' mod='onepagecheckoutps'}

Information about Apple Key File

If you are going to use Apple as a social network, you must upload the key file to your store's root directory via FTP in the folder /upload/apple_key/FILE_NAME. Then, you must configure the file name in the Key_file field of the social network.

Add social network

To add a new social network, click the "+" icon button at the top of the configured social networks table. A form will open where you can select the social network and configure its credentials.

Social network

Dropdown that allows you to select which social network you want to configure (Google, Facebook, PayPal, Apple, TikTok). Each social network has its own specific configuration fields.

Enabled

This switch allows you to activate or deactivate the selected social network. When disabled, customers will not see the option to log in with that social network.

Configuration fields by social network

Depending on the selected social network, different fields will appear to configure authentication credentials:

  • Google: ID, Secret
  • Facebook: ID, Secret
  • PayPal: ID, Secret
  • Apple: ID, Team ID, Key ID, Key_file
  • TikTok: ID, Secret

These fields are provided by each platform when you create an application for OAuth authentication.

Social network statistics

The section displays usage statistics for each configured social network:

  • Total connections made
  • Last data update
  • Status of each social network (active/inactive)

Social network management

In the main table you can:

  • View all configured social networks
  • Activate or deactivate social networks
  • Delete social networks you no longer need

reCAPTCHA

In this section you can configure Google reCAPTCHA v3 to protect your store against automated access and prevent spam.

reCAPTCHA validation is applied on login and registration pages. Additionally, you can enable it on the contact page.

Google reCAPTCHA v3 configuration
Google reCAPTCHA v3 configuration

Enable reCAPTCHA v3

When activating this option, Google reCAPTCHA v3 protection is enabled on login and registration forms. reCAPTCHA v3 works invisibly, analyzing user behavior without interrupting their experience.

Enable reCAPTCHA on contact page

This sub-option appears when "Enable reCAPTCHA v3" is activated. When enabled, reCAPTCHA will also protect your store's contact form against spam.

Minimum score to accept

reCAPTCHA v3 scores each submission from 0.0 (very likely a bot) to 1.0 (very likely a human). Submissions below the score you set here are rejected. Google recommends the value 0.5: raise it to block more spam, bearing in mind that it may reject some genuine customers, or lower it if you notice legitimate users being blocked.

Site key

Text field where you must enter the site key (Site Key) provided by Google when registering your site in reCAPTCHA.

Secret key

Text field where you must enter the secret key (Secret Key) provided by Google.

Theme

This section allows you to customize the visual appearance of the checkout, including theme, styles, font sizes and design elements such as header and footer.

Checkout theme customization
Checkout theme customization

General

Select checkout design theme

Dropdown that allows you to choose the color template that will be applied to the checkout. Each theme defines a specific color palette that controls the visual appearance of the checkout.

Select checkout design style

Dropdown that allows you to select the layout or structure of the checkout in desktop version. The different available styles (Vertical, Steps, 3 Columns, Shopify) define the arrangement and organization of elements within the checkout.

Select mobile checkout design style

Dropdown that allows you to select the specific layout or structure for mobile devices. The different available styles (Vertical, Steps, 3 Columns, Shopify) define the arrangement and organization of elements within the checkout.

Shopify style variant

This dropdown appears when you have chosen the Shopify style for desktop or for mobile, and lets you pick its visual variant. The Classic option keeps the original look, while V2 presents a more modern version with rounded cards, floating label fields and a collapsible cart summary.

Three columns style variant

This dropdown appears when you have chosen the 3 Columns style for desktop or for mobile. As with the Shopify style, you can select between the Classic variant and the V2 variant, which refreshes the visual presentation of the layout.

Show floating label on form fields

When activated, this option displays form field labels as floating labels, providing a more modern and compact interface. Labels appear floating above the field when the user interacts with it.

Font size (rem)

Text field that allows you to define the base font size, expressed in rem units (for example: 1, 1.2, 0.9). This value will be applied in different sections of the checkout, as well as on the login, registration, personal data and addresses pages.

Use checkout design

When activating this option, it displays the module's custom header and footer on the checkout page.

Show native header

Enable this option to display the native header of your PrestaShop theme on the checkout page.

Show "Continue shopping" link

This sub-option appears when "Show native header" is disabled. When enabled, it displays a link that allows the customer to return to the store's homepage so they can continue shopping.

Custom URL for "Continue shopping" button

This sub-option appears when "Show 'Continue shopping' link" is activated. It allows you to specify a custom URL to which the customer will be redirected when clicking the "Continue shopping" icon.

Show native footer

Enable this option to display the native footer of your PrestaShop theme on the checkout page.

Show personal information form directly

When this option is enabled, visitors see the full registration form from the start. If you disable it, they must first enter their email address and the rest of the form appears afterwards.

Theme Configuration

Visual theme editor
Visual design variables editor

This subsection provides a visual editor to customize in detail the design variables of each available theme, allowing you to fully adapt the checkout appearance to your store's visual identity.

Theme selection

The left panel displays the list of all themes available in your installation. The default theme is identified with a star icon. Click on any theme to edit its design variables.

Variables panel

The right panel shows all editable variables of the selected theme, organized in individual cards. Each variable includes:

  • Description: Descriptive name of the variable
  • Technical name: Variable identifier
  • Color picker: For color variables, a visual picker is displayed that allows you to easily choose colors
  • Text field: Allows you to manually enter the color value in hexadecimal format
  • Color preview: Preview of the selected color
  • RGB value: Shows the equivalent in RGB format

Value validation

The system automatically validates entered values. If a value is not valid (for example, a malformed hexadecimal color), a red border will be displayed.

Action buttons

  • Reset: Click the button with the icon (↻) to undo unsaved changes and return to previous values in case of selecting incorrect colors. This action only affects unsaved changes and resets all modified variables, so if you want to adjust only a specific variable, it is recommended to make the change manually to avoid losing other pending customizations.
  • Save: Saves the modifications made to the selected theme.

Fields

In this section you can manage the fields that are displayed in the module and that allow collecting customer information. From here it is possible to create and configure custom fields at different points in the checkout process, adapting the information collection to your business needs.

Custom fields management
Custom fields management

Fields

This subsection groups the options to manage checkout form fields.

Fields table

The main interface displays a table with all fields registered in your checkout. Fields are displayed with different background colors depending on the object they belong to, facilitating quick identification:

Color Description
Light blue Customer fields (customer)
Light green Shipping address fields (delivery)
Medium green Fields before/after shipping address content (checkoutAddressDeliveryBeforeContent / checkoutAddressDeliveryAfterContent)
Light yellow Billing address fields (invoice)
Medium yellow Fields after billing address content (checkoutAddressInvoiceAfterContent)
Cyan Fields before/after shipping content (checkoutShippingBeforeContent / checkoutShippingAfterContent)
Light purple Fields before payment methods list (checkoutPaymentBeforePaymentList)
Dark purple Fields after payment methods list (checkoutPaymentAfterPaymentList)

Payment fields (before and after the methods list) appear in the "Payment Methods" panel during field reorganization.

Each row in the table shows field information and available actions: activate/deactivate, make required, edit and delete.

Create custom field

Click the "+" button to open the form to create a new custom field. The available fields are:

Field Description
Object Select in which checkout section the field will appear. Available options are:
  • customer: Customer information (registration)
  • delivery: Shipping address
  • invoice: Billing address
  • checkoutAddressDeliveryBeforeContent: Custom field that will appear before the shipping address form
  • checkoutAddressDeliveryAfterContent: Custom field that will appear after the shipping address form
  • checkoutAddressInvoiceAfterContent: Custom field that will appear after the billing address form
  • checkoutShippingBeforeContent: Custom field that will appear before the shipping method selection
  • checkoutShippingAfterContent: Custom field that will appear after the shipping method selection
  • checkoutPaymentBeforePaymentList: Custom field that will appear before the payment methods list
  • checkoutPaymentAfterPaymentList: Custom field that will appear after the payment methods list (e.g.: invoice information, debit authorization, etc.)

Each payment field option allows customizing the payment experience by adding additional information or confirmations at the most relevant moment of the process.

Name Technical field identifier. Only alphanumeric characters, hyphens and underscores are allowed.
Description Descriptive text of the field, visible to the customer. This field is multi-language, so you must provide a description in all active languages of your store.
Label Text that will be displayed to the customer below the field. This field is multi-language and optional.
Type Defines the type of validation that will be applied to the field. Available options:
  • isAddress: Address validation
  • isBirthDate: Birth date validation
  • isDate: Generic date validation
  • isBool: Boolean value (true/false)
  • isCityName: City name validation
  • isDniLite: Identity document validation (light)
  • isEmail: Email validation
  • isGenericName: Generic name validation
  • isMessage: Message or long text validation
  • isName: Name validation
  • isCustomerName: Customer name validation
  • isPasswd: Password validation
  • isPostCode: Postal code validation
  • isPhoneNumber: Phone number validation
  • isVatNumber: VAT number validation
  • number: Numeric validation
  • url: URL validation
  • isValidRUTChile: Chilean RUT validation
  • isValidRUCEcuador: Ecuadorian RUC validation
  • isValidNIFSpain: Spanish NIF validation (CIF, NIE or NIF)
  • isValidNIFSpainOnly: Strict Spanish NIF validation
  • confirmation: Confirmation field
Size Maximum allowed length for the field value (number of characters).
Type control Select which type of HTML element will be used to display the field:
  • List: Single selection dropdown menu (select)
  • Text field: Single-line text field (textbox)
  • Text area: Multi-line text field (textarea)
  • Radio button: Single selection options with circular buttons (radio)
  • Checkbox: Multiple selection options (checkbox)
Default value Initial value that the field will have when displayed in the checkout (optional).
Required Activate this switch to make the field mandatory to fill. Customers will not be able to continue with checkout without completing this field.
Active Controls whether the field is visible and functional in checkout. Deactivate this switch to temporarily hide the field without deleting it.

Manage field options

This button opens a special dialog that allows configuring the available options for "List" or "Radio button" type fields. The functionality includes:

Field selection

First you must select:

  1. Object: The context where the field is located (customer, delivery, invoice, etc.)
  2. Field: The specific field to which you want to add options

Once the field is selected, existing options will be loaded into an editable table.

Options table

The table displays all configured options for the selected field:

  • Def.: Radio button to mark which option will be the default (initially selected)
  • Value: Technical value of the option that will be saved in the database
  • Description: Text that the customer will see. This field is multi-language, use the language selector to provide translations
  • Action: Delete button (trash icon) to remove the option
Add new option

Click the "+ Add" button to create a new row in the options table. Complete the value and descriptions in all languages before saving.

Save options

You have two options to save:

  • Save and stay: Saves changes and keeps the dialog open for continued editing
  • Save: Saves changes and closes the dialog

Position

This subsection allows you to visually organize the order in which fields appear in checkout through an intuitive drag and drop interface. Fields are grouped into three categories according to their context, each represented by a different panel.

Field organization via drag & drop
Field organization via drag & drop

Group panels

Fields are organized into independent panels, identified by colors:

Customer Panel (Green)

Groups fields related to customer information during registration or login. Here fields such as name, surname, email, password and any custom field associated with the "customer" object are ordered.

Shipping Address Panel (Blue)

Contains the shipping address form fields. Includes standard fields such as address, city, postal code, phone, and all custom fields associated with "delivery" or shipping address hooks.

Billing Address Panel (Orange)

Shows the billing address form fields, including the same types of fields as the shipping address but applied to the billing context ("invoice" object).

Payment Methods Panel (Purple)

Groups custom fields related to the checkout payment section. Includes custom fields that will be displayed before or after the list of available payment methods, allowing to collect additional information in the payment step.

Reorganize fields

To change the order of fields within a panel:

  1. Select the field: Click and hold on the field card you want to move
  2. Drag: Move the field up or down within the same panel
  3. Drop: Release when the field is in the desired position
  4. Save: Changes are saved automatically when releasing the field, showing a confirmation message

Field information

Each field card displays:

  • Description: Descriptive name of the field
  • Visual indicator: Background color according to the group it belongs to

Behavior

  • Fields can only be reordered within their own panel (they cannot be moved between panels)
  • The established order determines how fields will appear in the frontend checkout
  • Changes are immediate and reflected in checkout once saved
  • Each panel works independently

Side cart

This section configures the side cart: a slide-out panel the customer can open from any page of the store, except the module checkout. From that panel they can review the products they have added, change quantities, apply coupons and continue to payment without leaving the page they were on.

Side cart configuration
Side cart configuration

Activation and access

Enable the side cart

Enable this option to show the slide-out cart panel on every store page, except the module checkout. While it stays disabled, the rest of the options in this section have no effect.

Open automatically when a product is added

When this option is active, the panel opens by itself as soon as the customer adds a product to the cart, visually confirming that the action was completed.

Show a floating cart button

When enabled, a permanent floating button appears that opens the side cart from anywhere on the page.

Floating button position

Defines which corner or side of the screen the floating button sits on. You can choose bottom right, bottom left, middle right or middle left.

Suppress other floating carts

Many themes and third-party modules include their own cart drawer. Enabling this option disables those panels to avoid showing two carts at the same time.

Panel content

Show express checkout

Adds the express payment buttons to the panel, allowing the customer to complete the purchase directly from the side cart.

Show the free shipping progress bar

Displays a bar inside the panel showing how much the customer still needs to spend to reach free shipping, encouraging them to add more products.

Show the voucher form

When enabled, the customer can enter discount codes without leaving the cart panel.

Show the product counter

Shows the number of items in the cart in the panel header.

Show the subtotal

Includes the subtotal line with the amount of the added products.

Show the shipping row

Adds a shipping row under the subtotal.

Show the taxes note

Displays the explanatory note about taxes next to the panel totals.

Show the continue shopping link

Adds a link that closes the panel and returns the customer to browsing the store.

Show the "view cart" button

Adds access to the full cart page next to the continue shopping link.

Allow editing quantities

Lets the customer increase or decrease the units of each product directly from the panel.

Allow removing products

Adds a button on each line to remove the product from the cart.

Show product image

Includes the thumbnail of each product in the panel listing.

Show product reference

Shows the product reference or code on each line of the side cart.

Show product attributes

Shows the selected combinations (size, colour, etc.) below the name of each product.

Show product unit price

Adds the price per unit on each line, which helps the customer understand the calculation when they have several units of the same item.

Custom texts

The following fields are multi-language and let you replace the panel texts with your own. If you leave any of them empty, the module uses its default translated text.

Custom title

Text shown as the heading of the side cart panel.

Custom free shipping remaining text

Message indicating how much the customer still needs to spend for free shipping. You can use {amount} as a placeholder so the module inserts the remaining amount there.

Custom free shipping reached text

Message shown once the customer has reached the amount required for free shipping.

Custom checkout button text

Text of the button that takes the customer from the panel to the payment process.

Custom empty cart text

Message displayed in the panel when the customer has not added any product yet.

Custom subtotal note

Explanatory text accompanying the subtotal, useful for example to clarify which amounts are calculated later on.

Appearance and behaviour

Drawer position

Defines which side of the screen the side cart slides out from: right or left.

Drawer width (px)

Sets the width of the panel in pixels, so you can adapt it to your store design.

Full screen on mobile

When this option is enabled, the panel takes up the whole screen on mobile devices instead of being shown as a narrow side panel.

Show background overlay

Dims the rest of the page while the panel is open, focusing the customer's attention on the cart.

Opening animation

Select how the panel appears: Slide makes it slide in from the side, while Fade shows it with a fade-in effect.

Translations

This section allows you to edit and customize all labels, messages and texts of the module in the different languages available in your store. It is useful to adapt the module to specific terminology of your business or apply translations according to your needs.

Integrated translations editor
Integrated translations editor

Edit Translations

The module includes a translations editor that allows you to customize all texts in any language installed in your store.

  1. Access the "Translations" section in the module configuration
  2. Select the language you want to edit
  3. Modify text strings as needed
  4. Click "Save" to apply changes

Available Actions

The translations editor includes several actions to manage your translations:

  • Save: Saves changes made to translations.
  • Save and download: Saves changes and downloads the translations file for backup.
  • Share with us: Sends your translations to our PresTeamShop team to include them in future module versions.
  • Expand all: Shows all translation sections expanded.
  • Collapse all: Hides the content of all sections.

Code Editors

Code Editors section
Code Editors section

Allows adding custom CSS and JavaScript code directly from the configuration panel, without needing to access server files.

Available editors:

  • Custom CSS: Add styles to customize the appearance.
  • Custom JavaScript: Add scripts to customize behavior.

Backups

The backup system allows you to protect the module configuration and restore it when needed.

Backups management panel
Backups management panel

Generate

To create a new backup, click the "Generate new backup" button. The system will create a backup of the current module configuration.

Upload

If you have a previously downloaded backup, you can upload it by clicking the "Upload backup" button. A dialog will open where you can select the backup ZIP file.

Available

The list shows all created backups. You can filter by date using the date selector and update the list with the "Update list" button.

Actions

Each backup in the list has the following available actions:

Restore backup

Restores module configuration

Download backup

Downloads the ZIP file

Delete backup

Deletes the backup

To restore, click the "Restore backup" button of the backup you want to recover and confirm the action in the dialog.

Troubleshooting

Common Issues

Verify that the module is correctly installed and activated. If the module has the debug mode option and it is active, make sure your IP is in the list of allowed IPs. Also clear the PrestaShop cache from Advanced Parameters → Performance.

Verify that your PHP version is compatible (7.2 or higher). Check PHP and PrestaShop error logs. If the problem persists, contact technical support providing the error messages.

If you receive an override error during installation, it means another module is already using the same files. Do not attempt to resolve it manually. Contact our support team to receive personalized help.

If you activated the "Autocomplete addresses with Google Maps" option in the Addresses section, but autocomplete does not work when filling in addresses in checkout, verify that you have correctly configured the API Key in the "Google API KEY" field and that the Places API (New) is enabled in your Google Cloud project. Without that API enabled or without the key, the autocomplete functionality will not be able to connect to the Google service and will remain inactive.

If you activated reCAPTCHA v3 in the corresponding section and receive errors when trying to log in, register or send the contact form, make sure you have configured both the "Site Key" and the "Secret Key" of reCAPTCHA. Both keys are mandatory and must be obtained from the Google reCAPTCHA console. If either of the two keys is missing or incorrect, the module will block these actions.

If you configured login with social networks (Facebook, Google, Apple, TikTok, etc.) and when clicking the social login button a connection error or invalid credentials appears, verify that the credentials (Client ID, Client Secret, etc.) are correctly configured in the Social Networks section. Each provider requires its own credentials that must be obtained from their respective developer consoles. Also, make sure that callback URLs are correctly configured in the social provider.

Frequently Asked Questions

Licenses and Purchase

The license includes updates and technical support for a determined period (6, 12 or 24 months depending on the chosen plan). Once finished, you can optionally renew to continue receiving updates and support.
The license includes installation on a production domain, access to all updates and technical support during the active license period.
You can view the live demo available on our website to learn about all the module features. We do not offer trial versions to install on your site.
The module will continue to work normally, but you will not receive new updates nor have access to technical support.

Installation and Compatibility

The module is designed to work with any theme that follows PrestaShop standards. If you experience any conflict with your theme, contact our support team.
Yes, your license includes installation in two environments: production and development/staging. This allows you to test updates and changes before applying them to your live store.
Yes, the module is designed to be compatible with other modules. In case of conflict with a specific module, our support team can help you resolve it.
No, the installation is very simple and is done from the PrestaShop Back Office. If you have any problem during installation, our support team is available to help you.

Updates

No, updates preserve all your configuration and data. You would only lose the configuration if you uninstall and reinstall the module, which is not necessary to update.
You can check new versions by visiting our website or accessing your account in our store. Soon we will add the option to check updates directly from the module panel.
It is not mandatory, but it is recommended to update to enjoy the latest improvements, new features and security fixes.

Technical Support

We normally respond in less than 24-48 business hours.
Yes, as long as you have active support within your license period, you have full access to technical support.
You can request help with installation, configuration, error resolution and general questions about the module's operation.
Yes, our support team assists in both Spanish and English.

Refunds and Warranty

We only apply a refund in the case that the module fails to work in your store after receiving technical support. Keep in mind that before purchase you have a demo to try the module.
We guarantee that the module works as described in the documentation. If you find any bug, we fix it at no additional cost.

Customization

Yes, we offer custom development services. Contact our support team to request a personalized quote.
It is not recommended to modify the module code on your own, as you would lose technical support and when updating the module you would lose the changes made. If you need additional features, we recommend requesting a custom development quote so that the changes are included in the module and maintained in future versions.

Support

If you need additional help or have any questions about the module, we are here to help you.

Email Support

Send us an email and we will respond as soon as possible.

support@presteamshop.com

Help Center

Visit our help center for more resources.

Visit Help Center