Installing vQmod on OpenCart

JAY6390 edited this page Mar 3, 2016 · 15 revisions

How to install vQmod on OpenCart

New Install Video Tutorial (OpenCart) - click image below to watch

IMAGE ALT TEXT HERE

Installing on OpenCart

vQmod works with OpenCart 1.4.x, 1.5.x, and OpenCart 2.x

YES VQMOD CAN CO-EXIST WITH OCMOD. VQMOD WILL ALWAYS BE PREFERRED!

How to install using Autoinstaller

1 Download the latest version that has "opencart" in the title from the releases page.

  1. Using FTP, upload the "vqmod" folder from the zip to the root of your opencart store.

  2. Be sure the vqmod folder and the vqmod/vqcache folders are writable (either 755 or 777).

    • Also be sure index.php and admin/index.php are writable.
      • If not sure which you need, first try 755.
      • If you get errors about permissions, then try 777.

NOTE: 777 permissions are dangerous and should only be used as a last resort. If your hosting requires this, consult your hosting to let them know this shouldn't be necessary

  1. Goto http://www.yoursite.com/vqmod/install

  2. You should get a success message. If not, check permissions above and try again

  3. Load your store homepage and verify it works.

  4. Using FTP, verify that there are new "vq" files in the "vqmod/vqcache" folder.

  5. If yes, then you are ready to start downloading or creating vQmod scripts, otherwise ask for assistance.

Done!

  • DO NOT DELETE THE INSTALL FOLDER!
  • YOU MUST RUN THE INSTALLER EVERY TIME YOU UPGRADE OPENCART!!
  • THERE IS NO DANGER OF RE-RUNNING THE INSTALLER!

How to install Manually

1 Download the latest version that has "opencart" in the title from

  1. Using FTP, upload the "vqmod" folder from the zip to the root of your opencart store.

  2. Be sure the vqmod folder and the vqmod/vqcache folders are writable (either 755 or 777).

    • Also be sure index.php and admin/index.php are writable.
      • If not sure which you need, first try 755.
      • If you get errors about permissions, then try 777.
  3. Edit your index.php file

    (2.x)

  4. FIND:

      // Startup
      require_once(DIR_SYSTEM . 'startup.php');
    
  5. REPLACE WITH:

      // vQmod
      require_once('./vqmod/vqmod.php');
      VQMod::bootup();
    
      // VQMODDED Startup
      require_once(VQMod::modCheck(DIR_SYSTEM . 'startup.php'));
    

    (1.5.x)

  6. FIND:

      // Startup
      require_once(DIR_SYSTEM . 'startup.php');
    
      // Application Classes
      require_once(DIR_SYSTEM . 'library/customer.php');
      require_once(DIR_SYSTEM . 'library/currency.php');
      require_once(DIR_SYSTEM . 'library/tax.php');
      require_once(DIR_SYSTEM . 'library/weight.php');
      require_once(DIR_SYSTEM . 'library/length.php');
      require_once(DIR_SYSTEM . 'library/cart.php');
      require_once(DIR_SYSTEM . 'library/affiliate.php');
    
  7. REPLACE WITH:

      // vQmod
      require_once('./vqmod/vqmod.php');
      VQMod::bootup();
    
      // VQMODDED Startup
      require_once(VQMod::modCheck(DIR_SYSTEM . 'startup.php'));
    
      // Application Classes
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/customer.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/currency.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/tax.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/weight.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/length.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/cart.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/affiliate.php'));
    

Note the affiliate library file may not exist on older systems. Basically any require_once(DIR_SYSTEM . 'library/xxxxxxxx.php'); needs to be changed to use the VQMod::modCheck above in the same format. This also applies to any additional require_once files in the next step

  1. Edit your admin/index.php file

    (2.x)

  2. FIND:

      // Startup
      require_once(DIR_SYSTEM . 'startup.php');
    
  3. REPLACE WITH:

      // vQmod
      require_once('../vqmod/vqmod.php');
      VQMod::bootup();
    
      // VQMODDED Startup
      require_once(VQMod::modCheck(DIR_SYSTEM . 'startup.php'));
    

    (1.5.x)

  4. FIND:

      // Startup
      require_once(DIR_SYSTEM . 'startup.php');
    
      // Application Classes
      require_once(DIR_SYSTEM . 'library/currency.php');
      require_once(DIR_SYSTEM . 'library/user.php'));
      require_once(DIR_SYSTEM . 'library/weight.php');
      require_once(DIR_SYSTEM . 'library/length.php');
    
  5. REPLACE WITH:

      // vQmod
      require_once('../vqmod/vqmod.php');
      VQMod::bootup();
    
      // VQMODDED Startup
      require_once(VQMod::modCheck(DIR_SYSTEM . 'startup.php'));
    
      // Application Classes
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/currency.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/user.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/weight.php'));
      require_once(VQMod::modCheck(DIR_SYSTEM . 'library/length.php'));
    
  6. Load your store homepage and verify it works.

  7. Using FTP, verify that there are new "vq" files in the "vqmod/vqcache" folder.

  8. If yes, then you are ready to start downloading or creating vQmod scripts.

Done!

How to install manually (pre 2.4.0)

https://code.google.com/p/vqmod/source/browse/wiki/Install_OpenCart.wiki?r=104