Bridge API DocsBridge API Docs
Bridge API Docs
Woocommerce plugin

Installation Guide

Step-by-step installation instructions for the Bridge WooCommerce Plugin

Installation Guide

Follow this step-by-step guide to install the Bridge WooCommerce Plugin on your WordPress site.

Prerequisites

Before installing the plugin, ensure you have:

  • WordPress 5.0 or higher
  • WooCommerce 3.0 or higher
  • PHP 7.4 or higher
  • Bridge API credentials
  • SSL certificate (for production)

Installation Steps

Step 1: Download the Plugin

  1. Download the plugin from our download page
  2. Save the ZIP file to your computer

Step 2: Access WordPress Admin

  1. Log in to your WordPress admin dashboard
  2. Navigate to Plugins > Add New

Step 3: Upload the Plugin

  1. Click Upload Plugin at the top of the page
  2. Click Choose File and select the downloaded ZIP file
  3. Click Install Now

Step 4: Activate the Plugin

  1. After installation, click Activate Plugin
  2. You should see a success message

Step 5: Verify Installation

  1. Go to WooCommerce > Settings > Payments
  2. Look for "Bridge" in the payment methods list
  3. The plugin should be listed and ready for configuration

Alternative Installation Methods

Method 1: FTP Upload

If you can't upload through WordPress admin:

  1. Extract the downloaded ZIP file
  2. Upload the bridge-woocommerce folder to /wp-content/plugins/
  3. Go to Plugins in WordPress admin
  4. Find "Bridge WooCommerce Plugin" and click Activate

Method 2: WP-CLI

If you have WP-CLI access:

# Navigate to your WordPress directory
cd /path/to/wordpress

# Install the plugin
wp plugin install bridge-woocommerce-plugin-1.0.0.zip --activate

Method 3: cPanel File Manager

  1. Log in to your cPanel
  2. Open File Manager
  3. Navigate to /public_html/wp-content/plugins/
  4. Upload the extracted plugin folder
  5. Activate through WordPress admin

Post-Installation Configuration

Step 1: Configure API Settings

  1. Go to WooCommerce > Settings > Payments
  2. Find "Bridge" and click Set up
  3. Enter your API credentials:
    • API Username: Your Bridge API username
    • API Password: Your Bridge API password
    • Service ID: Your service identifier

Step 2: Configure Payment Methods

  1. Enable Mobile Money: Check to enable mobile money payments
  2. Enable Card Payments: Check to enable card payments
  3. Enable Bank Transfers: Check to enable bank transfers

Step 3: Set Up Callbacks

  1. Callback URL: Set your callback URL (usually your site URL + /wc-api/thebridge_callback)
  2. Test Callback: Use our test endpoint to verify callbacks work

Step 4: Configure SMS Settings

  1. Enable SMS: Check to enable SMS notifications
  2. Sender ID: Enter your approved sender ID
  3. SMS Template: Customize SMS message templates

Testing the Installation

Test 1: Plugin Activation

  1. Go to Plugins in WordPress admin
  2. Verify "Bridge WooCommerce Plugin" is active
  3. Check for any error messages

Test 2: Payment Method Visibility

  1. Go to WooCommerce > Settings > Payments
  2. Verify "Bridge" appears in the list
  3. Check that it can be enabled/disabled

Test 3: Checkout Integration

  1. Add a product to cart
  2. Go to checkout
  3. Verify Bridge payment option appears
  4. Test the payment flow (use test mode)

Troubleshooting

Common Installation Issues

Issue: Plugin won't activate

Symptoms: Error message when trying to activate the plugin

Solutions:

  1. Check PHP version (must be 7.4 or higher)
  2. Check WordPress version (must be 5.0 or higher)
  3. Check WooCommerce is installed and active
  4. Check for plugin conflicts

Issue: Fatal error on activation

Symptoms: White screen or fatal error message

Solutions:

  1. Check error logs in /wp-content/debug.log
  2. Increase PHP memory limit to 256MB
  3. Disable other plugins temporarily
  4. Contact support with error details

Issue: Payment method not visible

Symptoms: Bridge doesn't appear in payment methods

Solutions:

  1. Ensure WooCommerce is active
  2. Check if payment method is enabled
  3. Verify plugin is properly activated
  4. Clear any caching plugins

Issue: Configuration page not loading

Symptoms: Can't access plugin settings

Solutions:

  1. Check user permissions
  2. Clear browser cache
  3. Disable security plugins temporarily
  4. Check for JavaScript errors

Debug Mode

Enable debug mode to troubleshoot issues:

  1. Add to wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
  1. Check logs in /wp-content/debug.log

Getting Help

If you're still experiencing issues:

  1. Check Documentation: Review our configuration guide
  2. Contact Support: Email support@thebridgesolutions.com
  3. Include Details: Provide error messages, PHP version, and WordPress version

Security Considerations

SSL Certificate

  • Required for Production: SSL certificate is mandatory
  • Test SSL: Verify SSL is working properly
  • Mixed Content: Ensure all resources load over HTTPS

API Credentials

  • Secure Storage: Credentials are encrypted in the database
  • Regular Rotation: Rotate API credentials regularly
  • Access Control: Limit admin access to payment settings

File Permissions

  • Plugin Files: 644 for files, 755 for directories
  • Upload Directory: 755 with proper ownership
  • Config Files: 600 for sensitive configuration files

Next Steps

After successful installation:

  1. Configure the Plugin: Follow our configuration guide
  2. Test Payments: Test all payment methods in sandbox mode
  3. Go Live: Switch to production mode when ready
  4. Monitor: Set up monitoring and logging

Uninstallation

To uninstall the plugin:

  1. Go to Plugins in WordPress admin
  2. Find "Bridge WooCommerce Plugin"
  3. Click Deactivate
  4. Click Delete to remove completely

Note: This will remove all plugin data and settings. Make sure to backup your site first.

Download Plugin

Get the latest version of the Bridge WooCommerce Plugin