Installation & Upgrading
Last updated
Last updated
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
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:
Keep the existing system/user/addons/ajw_datagrab folder, DO NOT delete it.
Copy the datagrab folder from the zip file into your system/user/addons folder.
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:
Click on the Install button for DataGrab 4.x.
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.
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 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 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
