Installation & Upgrading

New installation

To install DataGrab, unzip the zip file and place the user/addons/datagrab folder into your system/user/addons folder. Then login to the Control Panel and go to the Add-ons page and click the Install button next to DataGrab

Upgrading from version 3 to version 4

It is suggested to upgrade to DataGrab 3.0.4 before upgrading to 4.0. If you can't get a copy of 3.0.4, read the instructions at the bottom of this page.
If you have version of DataGrab prior to 4, probably version 3.0.3 or 3.0.4 so, then do the following:
  1. 1.
    Keep the existing system/user/addons/ajw_datagrab folder, DO NOT delete it.
  2. 2.
    Copy the datagrab folder from the zip file into your system/user/addons folder.
  3. 3.
    Yes you will have 2 DataGrab add-ons displaying in your ExpressionEngine control panel. You will see the following uninstalled DataGrab 4.x version that has an icon:
    And the currently installed 3.x version that does not have an icon:
  4. 4.
    Click on the Install button for DataGrab 4.x.
  5. 5.
    Once the install is complete, click the gear icon on the DataGrab 3.x version, and click Uninstall, and then you can remove theaddons/ajw_datagrab folder. All your previously saved imports and Import URLs will remain the same.
  6. 6.
    If you were using the {exp:ajw_datagrab:run_action} or {exp:ajw_datagrab:run_saved_import} template tags you will need to rename them to {exp:datagrab:run_action} and {exp:datagrab:run_action}
If you DataGrab 3.0.3 is the latest version you have, you may experience a database SQL error on step #5 above. To avoid the error you will need to edit the upd.ajw_datagrab.php file. Go to line 121 of the file and you will see: ee()->db->delete('module_member_groups'); You can choose to comment out this line and the one above it, then uninstall, or change 'module_member_groups' to 'module_member_roles', then uninstall.