Skip to main content

​
Prerequisites

Before installing Paga con ZIGI, verify that your WordPress site meets the minimum requirements:

WordPress 5.2+

Tested up to WordPress 6.6

WooCommerce Active

Tested up to WooCommerce 9.3

PHP 7.4+

Minimum PHP version required

ZIGI Account

Active account with QR code
WooCommerce is required! This plugin will not work without WooCommerce installed and activated. Install WooCommerce first before proceeding.

​
Installation Methods

You can install Paga con ZIGI using either of these methods:

​
Method 1: Manual Upload via WordPress Admin

1

Download the Plugin

Download the plugin ZIP file from the repository or source location
2

Access WordPress Admin

Log in to your WordPress admin dashboardNavigate to: Plugins → Add New → Upload Plugin
3

Upload ZIP File

Click Choose File and select the paga-con-zigi.zip fileClick Install Now
The upload may take a few moments depending on your server speed
4

Activate the Plugin

After installation completes, click Activate PluginYou’ll be redirected to the Plugins page with a success message

​
Verify Installation

After activating the plugin, verify that it’s installed correctly:
1

Check Plugin Status

Navigate to Plugins → Installed PluginsConfirm “Paga con ZIGI” shows as ActivePlugin details should display:
  • Version: 2.0.0
  • Author: Andrés Turcios
  • Description: Método de pago para WooCommerce que permite realizar pagos escaneando un código QR
2

Verify WooCommerce Integration

Go to WooCommerce → Settings → PaymentsYou should see “Paga con ZIGI” listed as an available payment method
The payment method will be disabled by default. You’ll need to configure and enable it before use.
3

Check for Errors

If you don’t see the plugin in WooCommerce payments:
  1. Verify WooCommerce is installed and active
  2. Check for PHP errors in Tools → Site Health → Info → Server
  3. Ensure PHP version is 7.4 or higher
  4. Review error logs in /wp-content/debug.log (if debugging enabled)

​
File Structure

Once installed, the plugin structure should look like this: 
/wp-content/plugins/paga-con-zigi/
├── assets/
│   ├── woopro.js              # Admin JavaScript
│   ├── woopro.css             # Admin styles
│   ├── woopro-front.js        # Frontend JavaScript
│   ├── woopro-front.css       # Frontend styles
│   └── loader.gif             # Loading animation
├── functions.php              # Core functionality
├── paga-con-zigi.php          # Main plugin file
└── README.md                  # Documentation

​
Plugin Registration

The plugin registers itself with WooCommerce through these key hooks: 
// Register as WooCommerce payment gateway
add_filter('woocommerce_payment_gateways', 'zigi_payment_add_gateway_class');

// Declare HPOS compatibility
add_action('before_woocommerce_init', 'zigi_payment_hpos_compatibility');

// Initialize gateway class
add_action('plugins_loaded', 'zigi_payment_init_gateway_class', 11);
The gateway class extends WooCommerce’s base payment gateway: 
class Zigi_Payment_WC_Gateway extends WC_Payment_Gateway
{
    public function __construct()
    {
        $this->id = 'zigi_payment';
        $this->method_title = __('Paga con ZIGI', 'paga-con-zigi');
        $this->method_description = __('Método de pago QR ZIGI.', 'paga-con-zigi');
        $this->supports = array('products');
        
        $this->init_form_fields();
        $this->init_settings();
    }
}

​
Troubleshooting Installation

Solution:
  1. Confirm WooCommerce is installed and activated
  2. Deactivate and reactivate Paga con ZIGI
  3. Clear WordPress cache (if using a caching plugin)
  4. Check that the main plugin file is named paga-con-zigi.php
Solution:This usually means the plugin files are in the wrong location.Ensure the structure is:
/wp-content/plugins/paga-con-zigi/paga-con-zigi.php
Not:
/wp-content/plugins/paga-con-zigi/paga-con-zigi/paga-con-zigi.php
Solution:
  1. Install WooCommerce from Plugins → Add New
  2. Activate WooCommerce
  3. Complete WooCommerce setup wizard
  4. Then activate Paga con ZIGI
Solution:Set proper permissions on the plugin directory:
chmod -R 755 /wp-content/plugins/paga-con-zigi
chown -R www-data:www-data /wp-content/plugins/paga-con-zigi
Replace www-data with your server’s actual web user
Solution:The plugin requires PHP 7.4 or higher. Check your PHP version:
php -v
Or in WordPress: Tools → Site Health → Info → ServerContact your hosting provider to upgrade PHP if needed.

​
Upload Directory Creation

The plugin automatically creates a custom upload directory for payment receipts: 
function zigi_payment_qr_code_upload_dir($dirs)
{
    $custom_subdir = '/zigi-payment-qrcode';
    $new_path = $dirs['basedir'] . $custom_subdir;
    $new_url  = $dirs['baseurl'] . $custom_subdir;
    
    // Creates folder if it doesn't exist
    if (! $wp_filesystem->is_dir($new_path)) {
        $wp_filesystem->mkdir($new_path);
        $wp_filesystem->put_contents($new_path . '/index.html', '', FS_CHMOD_FILE);
    }
    
    return array_merge($dirs, array(
        'path'   => $new_path,
        'url'    => $new_url,
        'subdir' => $custom_subdir,
    ));
}
This directory is located at: 
/wp-content/uploads/zigi-payment-qrcode/
The plugin creates an index.html file in the upload directory to prevent direct directory listing for security.

​
Next Steps

Now that the plugin is installed, you’re ready to configure it:

Quick Start Guide

Learn how to configure Paga con ZIGI and accept your first payment

​
Support

If you encounter issues during installation:

Build docs developers (and LLMs) love

Get started for freeTalk to us