Wordpress/WooCommerce

Manual Installation Guide

Since JeelPay for WooCommerce is not yet available in the WordPress Plugin Directory, you'll need to install it manually. This guide will walk you through the process step by step.

Prerequisites

Before installing the plugin, ensure you have:

  • WordPress 5.8 or higher installed

  • WooCommerce 5.0 or higher activated

  • PHP 7.4 or higher running on your server

  • SSL Certificate (HTTPS required for secure payments)

  • Access to your WordPress admin dashboard

Download the Plugin

First, you need to obtain the plugin files:

  1. Download the latest version: jeelpay-for-woocommerce-1.0.0.zip

  2. Save the file to your computer

Installation Methods

This is the easiest method for most users.

  1. Log in to your WordPress admin dashboard

    • Navigate to https://yourdomain.com/wp-admin

    • Enter your username and password

  2. Navigate to Plugins > Add New

    • In the left sidebar, click on Plugins

    • Then click Add New

  3. Upload the Plugin

    • At the top of the page, click the Upload Plugin button

    • Click Choose File and select the jeelpay-for-woocommerce-1.0.0.zip file you downloaded

    • Click Install Now

  4. Activate the Plugin

    • Once installation is complete, click Activate Plugin

    • You'll be redirected to the plugins page where you should see "JeelPay for WooCommerce" listed as active

Method 2: Upload via FTP/SFTP

Use this method if you have file access to your server or if the WordPress upload method doesn't work.

  1. Extract the Plugin Files

    • Unzip the jeelpay-for-woocommerce-1.0.0.zip file on your computer

    • You should now have a folder named jeelpay-for-woocommerce

  2. Connect to Your Server

    • Use an FTP client (FileZilla, Cyberduck, etc.) or your hosting control panel's file manager

    • Connect using your FTP/SFTP credentials

  3. Upload to WordPress

    • Navigate to /wp-content/plugins/ directory

    • Upload the entire jeelpay-for-woocommerce folder to this directory

  4. Activate the Plugin

    • Return to your WordPress admin dashboard

    • Go to Plugins > Installed Plugins

    • Find "JeelPay for WooCommerce" in the list

    • Click Activate

Method 3: Upload via Hosting Control Panel

If your hosting provider offers a file manager:

  1. Access File Manager

    • Log in to your hosting control panel (cPanel, Plesk, etc.)

    • Open the File Manager tool

  2. Navigate to Plugins Directory

    • Go to public_html/wp-content/plugins/ (or your WordPress installation directory)

  3. Upload the Zip File

    • Click Upload and select jeelpay-for-woocommerce-1.0.0.zip

    • Once uploaded, select the file and click Extract

    • Extract to the current directory (/wp-content/plugins/)

  4. Activate

    • Go to your WordPress admin

    • Navigate to Plugins > Installed Plugins

    • Activate "JeelPay for WooCommerce"

Verify Installation

After installation, verify that the plugin is working:

  1. Check Plugin Status

    • Go to Plugins > Installed Plugins

    • Ensure "JeelPay for WooCommerce" is listed and active

  2. Check WooCommerce Integration

    • Navigate to WooCommerce > Settings > Payments

    • You should see "JeelPay" listed as a payment method

    • Click on it to access the configuration settings

  3. Check for Conflicts

    • Visit your site's frontend and test the checkout page

    • Ensure no JavaScript errors appear in the browser console

Troubleshooting

Common Issues

"The uploaded file exceeds the upload_max_filesize directive"

Solution: The plugin zip file is too large for your server's upload limit.

  • Use FTP method instead (Method 2)

  • Or contact your hosting provider to increase the upload limit

"Plugin folder already exists"

Solution: A previous installation exists.

  • Delete the existing jeelpay-for-woocommerce folder from /wp-content/plugins/

  • Re-upload the new version

"Missing required plugins: woocommerce"

Solution: WooCommerce is not installed or activated.

  • Install WooCommerce first: Plugins > Add New > Search "WooCommerce"

  • Activate WooCommerce, then activate JeelPay

"HTTP Error" during upload

Solution: Server timeout or memory issue.

  • Try uploading via FTP instead

  • Or increase PHP memory limit in wp-config.php:

Getting Help

If you encounter issues not covered here:

  1. Check your server meets all prerequisites

  2. Contact JeelPay support at [email protected]envelope

  3. Include any error messages and your WordPress/WooCommerce versions

Next Steps

Once installed, you'll need to:

  1. Configure the Plugin

    • Go to WooCommerce > Settings > Payments > JeelPay

    • Enter your API credentials (obtained from your JeelPay account)

  2. Test in Sandbox Mode

    • Enable "Sandbox Mode" in settings

    • Complete a test transaction

  3. Go Live

    • Switch to production credentials

    • Disable sandbox mode

    • Start accepting payments!


Quick Reference

Requirement
Minimum Version

WordPress

5.8+

WooCommerce

5.0+

PHP

7.4+

SSL Certificate

Required

Plugin File: jeelpay-for-woocommerce-1.0.0.zip

Installation Directory: /wp-content/plugins/jeelpay-for-woocommerce/

Last updated