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. Keep the existing system/user/addons/ajw_datagrab folder, DO NOT delete it.

  2. Copy the datagrab folder from the zip file into your system/user/addons folder.

  3. Click on the Install button for DataGrab 4.x.

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

  5. 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}

Upgrading from DataGrab 3.x

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

Playa, Matrix, and Pixel & Tonic fieldtype Support

Playa, Matrix, and any Pixel & Tonic fieldtypes are deprecated. If you have a site with an import configured to use them, DataGrab may continue to work, but no future development will be performed on those fieldtypes, and support will not be provided for them if there is an issue importing values into those fields. Playa and Matrix are antiquated and should be switched to Relationship and Grid fields respectively. The specific files no longer supported are:

  • datagrab_matrix.php

  • datagrab_playa.php

  • datagrab_fieldpack_checkboxes.php

  • datagrab_pt_multiselect.php

Last updated