Inkress Commerce WordPress Plugin

Method 1: Manual Upload (Recommended)

1. Download the Plugin

   Download the inkress-commerce folder or ZIP file

2. Upload to WordPress
   • Log in to your WordPress admin panel
   • Navigate to Plugins → Add New → Upload Plugin
   • Click "Choose File" and select the ZIP file
   • Click "Install Now"
   • Click "Activate Plugin"
3. Configure Settings
   • Go to Inkress in the WordPress admin menu
   • Enter your API Key (from your Inkress dashboard)
   • Enter your Store ID (your Inkress merchant username)
   • Select Environment:
     • Sandbox - For testing (uses api-dev.inkress.com)
     • Production - For live site (uses api.inkress.com)
   • Click Save Changes
4. Verify Connection
   • Go to Inkress → Products
   • If you see your products, you're connected!
   • If you see errors, double-check your API credentials

Method 2: FTP Upload

1. Unzip the plugin files
2. Upload the inkress-commerce folder to /wp-content/plugins/
3. Go to Plugins in WordPress admin
4. Find "Inkress Commerce" and click Activate
5. Follow configuration steps above

API Key

1. Log in to your Inkress merchant dashboard
2. Navigate to Settings → API Keys
3. Click Generate New Key
4. Copy the key and paste into WordPress plugin settings
5. Important: Save this key securely - it won't be shown again

Store ID

Your Store ID is your Inkress merchant username. Find it in:

• Inkress dashboard URL: dashboard.inkress.com/merchants/{your-username}
• Account Settings page
• Use just the username part (without m- prefix)

Managing Products

Viewing Orders

Go to Inkress → Orders to view all orders with:

• Order ID
• Customer name
• Total amount
• Status
• Date

Use pagination to browse multiple pages

Displaying Products on Your Site

[inkress_products]

[inkress_products limit="12"]

[inkress_product id="123"]

<?php echo do_shortcode('[inkress_products limit="6"]'); ?>

Styling

/* Override product grid */
.inkress-product-grid {
    grid-template-columns: repeat(4, 1fr);
    gap: 30px;
}

/* Style product cards */
.inkress-product-card {
    background: #f9f9f9;
    border: 2px solid #ddd;
}

/* Customize buy button */
.inkress-buy-button {
    background: #ff6b6b;
    font-size: 1.2em;
}

Currency Display

To change currency from USD:

Edit includes/class-inkress-frontend.php line ~89:

$currency = 'JMD'; // Change to your currency

Product Template

To completely customize product display, create a filter in your theme's functions.php:

add_filter('inkress_product_html', 'my_custom_product_template', 10, 1);
function my_custom_product_template($product) {
    // Return your custom HTML
    return '<div class="my-product">...</div>';
}

1. Use Sandbox Environment

• Set environment to "Sandbox" in settings
• Test all features with fake data
• No real transactions will occur

2. Test Checklist

• Products load in admin
• Can create test product
• Can edit test product
• Can delete test product
• Orders display correctly
• Shortcode shows products on frontend
• Product grid is responsive
• Buy buttons link correctly

3. Go Live

• Switch environment to "Production"
• Save changes
• Verify real products appear
• Test complete purchase flow

For Developers

// Modify API request
add_filter('inkress_api_request_args', function($args) {
    $args['timeout'] = 60;
    return $args;
});

// Customize product display
add_filter('inkress_product_html', function($html, $product) {
    // Return custom HTML
    return $html;
}, 10, 2);

// Change API endpoint
add_filter('inkress_api_endpoint', function($url) {
    return 'https://custom-api.inkress.com';
});