This documentation is designed to assist developers in implementing their preferred payment gateway in EasyStore.
The provided sample plugin, available for download, exemplifies the required structure and files necessary for successful implementation.
Download Sample Plugin
Prerequisites
Before proceeding, ensure that you have the following:
- Basic knowledge of PHP and Joomla CMS.
- EasyStore is installed and configured on your Joomla site.
Getting Started
- Download the provided sample plugin from the documentation.
- Extract the downloaded file and open it in your preferred code editor.
- Familiarize yourself with the structure of the plugin files.
File Structure
Upon downloading the sample plugin, open it in a code editor to explore the following file structure:
- assets/images:
- Folder for storing images, including the logo of your payment gateway (make sure to name your image file as
logo.svg
).
- Services:
- Inside the Services folder, you'll find
provider.php
.
- Src:
- Inside the Src folder, you'll find three subfolders:
- Extension
- Helper (Optional):
SampleHelper.php
can be defined here if needed.
- Utils
sample.xml
src Folder
a. Extension Subfolder
Inside the Extension subfolder, you'll find SamplePayment.php
. This file contains the logic and functions necessary for integrating your payment gateway.
b. Utils Subfolder
Inside the Utils subfolder, you'll find SampleConstants.php
. This file holds essential constants required for the proper functioning of the payment gateway integration.
sample.xml
This XML file provides configuration details and serves as a reference for the integration process.
Implementation Guide
We will now walk you through each file, highlighting areas where modifications are necessary to integrate your preferred payment gateway seamlessly.
- Upload the logo of your payment gateway as
logo.svg
format inside the assets
folder.
- Sample.xml
- Replace "Sample" with the name of your payment gateway in the
Provider.php
file.
- Define any helper class if needed in the
Helper.php
file.
- SamplePayment.php
- SampleConstant.php