StoreMigrate - Product Migration PHP SaaS Script

A complete PHP SaaS application for migrating product catalogs between major e-commerce platforms. Supports WooCommerce, Shopify, OpenCart 4, and ikas out of the box — covering all 16 platform-to-platform combinations. Built with a clean adapter pattern, so additional platforms can be added with a single file.

System Requirements

Installation

chmod 755 config/
chmod 755 uploads/
chmod 755 uploads/payment_proofs/

sudo a2enmod rewrite
sudo service apache2 restart

First Login

Navigate to https://yourdomain.com/login and sign in with the admin email and password you created during installation.

The admin panel is accessible via the left sidebar under the Admin section (only visible to admin accounts).

Admin Settings

Go to Admin → Settings to configure:

Managing Plans

Go to Admin → Plans to create and manage subscription plans.

• Product Limit: Number of products the user can migrate. Set to -1 for unlimited.
• Store Limit: Number of stores the user can connect. Set to -1 for unlimited.
• Features: One feature per line — shown as bullet points on the plans page.
• Sort Order: Lower numbers appear first.

Email Configuration

StoreMigrate can send emails for:

• Password reset links
• Subscription approved/rejected notifications
• New subscription request alerts (to admin)

Without SMTP configuration, emails are sent via PHP's built-in mail() function. For reliable delivery, configure SMTP in Admin → Settings → Email Settings.

PHPMailer Setup (Recommended)

lib/phpmailer/PHPMailer.php
lib/phpmailer/SMTP.php
lib/phpmailer/Exception.php

WooCommerce API Setup

Shopify API Setup

OpenCart 4 Setup

opencart-root/
├── index.php          ← OpenCart entry point
├── sm_oc4_bridge.php  ← Upload here
├── admin/
├── catalog/
└── system/

define('SM_API_KEY', 'your-long-random-secret-key-here');

https://yourstore.com/sm_oc4_bridge.php?action=test&sm_key=YOUR_KEY

{"success":true,"message":"StoreMigrate bridge connected","total_products":142}

ikas Setup

Background Migration & Cron Job Setup

How the Migration System Works

When you click Run Migration:

1. The migration is immediately added to a queue (takes <1 second)
2. A background PHP process is spawned automatically
3. The migration runs in the background — you can navigate freely
4. The migration page polls for status updates every 2.5 seconds
5. The cron job acts as a safety net to pick up any missed jobs

This architecture means your browser never waits for a migration to finish. 10,000 products or 100 — the behavior is the same.

Cron Job Setup

Add this cron job in your hosting control panel (cPanel, Plesk, DirectAdmin):

1. Log in to your hosting control panel
2. Go to Advanced → Cron Jobs (cPanel) or Scheduled Tasks (Plesk)
3. Set frequency to Every Minute (* * * * *)
4. Command: php /home/YOUR_USER/htdocs/YOUR_DOMAIN/cron.php >> /dev/null 2>&1
5. Replace the path with your actual file path
6. Save

Cancelling a Migration

Click the Cancel button on the migration detail page. The system:

• If queued (not yet started): cancels immediately
• If running: requests a graceful stop. The worker stops after the current batch (~10 products)
• If the worker appears stuck (no activity for 5+ minutes): cancels immediately

All products successfully migrated before cancellation are kept on the target store.

Abuse Prevention & Limit Enforcement

• Only one migration per user can run at a time
• Product limits are checked before starting and during migration (every 10 products)
• If a user's plan limit is reached mid-migration, the migration stops gracefully with a log message
• Admin can adjust user limits in real time from the Users section — changes take effect within ~10 products

Stuck Migration Recovery

If a migration gets stuck in Running state (e.g., server crash, PHP memory exhaustion), the cron job automatically marks it as Failed after 15 minutes of inactivity. Users can then restart it.

Running a Migration

1. Go to Migrations → New Migration
2. Select a Source Store (products will be fetched from here)
3. Select a Target Store (products will be created here)
4. Choose which data to transfer: images, categories, prices, attributes, stock, descriptions
5. Optionally set a product limit for this run
6. Click Start Migration

The migration progress is shown in real-time with a progress bar and activity log. You can navigate away and return to the migration detail page — it will continue running and update automatically.

Subscription Management

For Users

1. Go to Plans & Pricing
2. Click Subscribe on the desired plan
3. Upload your bank transfer receipt/dekont
4. Click Submit Request
5. Wait for admin approval (you'll receive an email if SMTP is configured)

For Admin

1. Go to Admin → Subscriptions
2. Click Activate on a pending request
3. Review the confirmation dialog (shows current limits and what will be added)
4. Confirm activation

Adding a New Platform

See ADDING_PLATFORMS.md in the package root for the full developer guide. Summary:

1. Create platforms/YourPlatform.php implementing PlatformInterface
2. Register in platforms/PlatformFactory.php $registry array

That's it — the platform will automatically appear in the store connection form.

Nginx Configuration

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/storemigrate;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    # Block access to sensitive directories
    location ~ ^/(core|models|controllers|platforms|config|lib)/ {
        deny all; return 404;
    }

    # Block PHP execution in uploads
    location ~ ^/uploads/.*\.php$ {
        deny all; return 404;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }
}

Security Notes

Frequently Asked Questions

Migration is stuck at 0% — what's wrong?

Check that: (1) Both stores are connected and the test passes. (2) Your server allows outbound cURL requests. (3) WooCommerce has pretty permalinks enabled. (4) The API key has Read/Write permissions.

Images are not being copied

Enable the Product Images option when creating the migration. Images are downloaded from the source store and re-uploaded to the target. Ensure both servers can reach each other.

Categories are showing as flat (no hierarchy)

Enable the Categories option when creating the migration. The engine fetches the full category tree from the source and re-creates the parent→child relationships on the target.

Can a user buy the same plan twice?

Yes. When a new subscription is activated while the user has remaining quota, the unused products are carried over as a bonus. Example: 300 remaining + new 1000 plan = 1300 total available.

How do I reset a user's migration count?

Activate a new subscription for the user via Admin → Subscriptions. The counter resets from the activation moment.

Password reset emails are not arriving

Configure SMTP settings in Admin → Settings. Without SMTP, emails rely on PHP's mail() which many hosting providers block.

Payment System

StoreMigrate supports three payment methods, all configurable from Admin → Settings → Payment Methods:

Stripe Setup

PayPal Setup

Bank Transfer

Bank transfer requires manual admin approval:

1. User selects "Bank Transfer" and uploads their payment receipt
2. Admin sees the pending subscription in Admin → Subscriptions
3. Admin views the uploaded receipt and clicks Activate
4. User receives an email notification (if SMTP is configured)

Configure your bank account details in Admin → Settings → Bank Transfer Details.

The bank info text is shown to users in the payment modal when they select bank transfer.

Credits & Licenses

All other code is original and licensed under the Codester Regular & Extended License.

© 2026 StoreMigrate - Product Migration PHP SaaS Script. All rights reserved.