BoldMinded Docs
  • Overview
  • Advanced Categories
    • Docs
      • Installation
      • Requirements
      • Setup & Configuration
        • Hidden Config Options
        • Multi-Site Manager
      • Template Tags
      • FAQs
  • Ansel
    • Docs
      • Installation
      • Upgrading
      • Requirements
      • Settings
      • Usage
        • Channel:Form
      • Troubleshooting
      • Template Tags
    • FAQs
  • Bloqs
    • Docs
      • Why Bloqs?
      • Features
        • Add Bloq Menu
        • Nesting
        • Cloning
        • Drafts
        • Bloq Usage
        • Deprecated Bloqs
        • Caching
        • Profiling
        • Bloq Components
        • Bloq Groups
      • Installation
      • Requirements & Compatibility
      • Setup & Configuration
        • Hidden Config Options
      • Creating Bloqs
      • Template Tags
        • Twig
        • Examples
      • Context Variables
      • Add-on Developers
    • FAQs
  • Carson
    • Docs
      • Installation
      • Requirements
      • Fields
        • Omni
          • Hidden Config
        • Assistant
        • SEO
      • Troubleshooting
  • Custom System Messages
    • Docs
      • Installation
      • Requirements
      • Variables
      • Template Tags
  • DataGrab
    • Docs
      • Installation & Upgrading
      • Requirements
      • Troubleshooting
      • Configuring Imports
      • Running Imports
      • Automatic Imports
        • Importing with cron
        • Importing with cron (Deprecated)
      • Endpoints
      • Configuration Options
        • Config File Options
        • Increasing PHP memory limit
      • Import Types
        • CSV
          • Importing into Grid or Matrix field
        • JSON
          • Example file
        • WordPress
        • XML
          • Example file
        • Creating your own import type
      • Assigning Authors
      • Field Types
        • Assets
        • Ansel
        • Bloqs
        • Calendar
        • Channel Images
        • Date
        • File
        • File Grid
        • Fluid
        • Grid
        • Low Events
        • Relationships
        • Simple Grids & Tables
        • Tag & Tagger
        • Matrix (Deprecated)
        • Creating your own fieldtype
      • Publisher
      • Version 5.0
      • Version 6.0
    • FAQs
  • Feature Flags
    • Docs
      • Installation & Upgrading
      • Requirements
      • Configuration
      • Template Tags
      • A/B Testing
    • FAQs
  • Fluidity
    • Docs
      • Installation & Upgrading
      • Requirements
      • Configuration
      • Demos
    • FAQs
  • Logit
    • Docs
      • Installation
      • Requirements
      • Configuration
    • FAQs
  • Publisher
    • Docs
      • Installation
      • Requirements
      • Issues & Tips
      • Languages
      • Template Tags
        • Forms
        • Email Notification Templates
        • Channel:Form
        • Twig
      • URL Translations
      • Auto Translations
      • Diffs
      • Drafts
      • Categories
      • Phrases
      • Persistence
      • Performance
      • Add-ons
        • First Party
        • Third Party
      • Hidden Config
      • Extending Publisher
    • FAQs
  • Reading Time PRo
    • Docs
      • Installation
      • Requirements
      • Configuration
      • Template Tags
  • Reel
    • Docs
      • Installation
      • Requirements
      • Settings
      • Field Tags
    • FAQs
  • Simple Grids & Tables
    • Docs
      • Installation
      • Requirements
      • Template Tags
      • CSV File Imports
      • Field Settings
      • GraphQL
      • Advanced Configuration (deprecated)
    • FAQs
  • Sitemap
    • Docs
      • Installation
      • Requirements
      • Configuration & Usage
    • FAQs
  • Snaptcha
    • Docs
      • Installation
      • Requirements
      • Configuration
      • Template Tags
      • Developers
    • FAQs
  • Speedy
    • Docs
      • Installation & Updating
      • Requirements
      • Configuration
      • Template Tags
      • Static Caching
        • Real World Example
      • Frontedit Support
      • Control Panel
      • Migrating from CE Cache
      • Diagnostics
      • CLI Commands
      • Reverse Proxy Purging
    • FAQs
  • Trek (unreleased)
    • Docs
      • Configuration
    • FAQs
  • Queue
    • Docs
Powered by GitBook
On this page
  • New installation
  • Upgrading from version 3 to version 4
  • Playa, Matrix, and Pixel & Tonic fieldtype Support

Was this helpful?

  1. DataGrab
  2. Docs

Installation & Upgrading

Last updated 1 year ago

Was this helpful?

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. 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. Click on the Install button for DataGrab 4.x.

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