Skip to content

Installing vQmod on OpenCart

qphoria edited this page Jan 13, 2020 · 18 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, 2.x, and 3.0

YES VQMOD CAN CO-EXIST WITH OCMOD. JUST KEEP IN MIND THAT VQMOD IS PROCESSED AFTER OCMOD SO YOUR SEARCH SHOULD MATCH ANY OCMOD MODIFICATIONS

###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/3.x) 5. FIND:

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

(1.5.x) 5. 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');
  1. 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 7. Edit your admin/index.php file

(2.x) 8. FIND:

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

(1.5.x) 8. 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');
  1. 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'));
  1. Load your store homepage and verify it works.

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

  3. 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