Skip to content

help.md

Latest commit

 

History

History
130 lines (88 loc) · 3.23 KB

help.md

File metadata and controls

130 lines (88 loc) · 3.23 KB
Raw

🐛 Troubleshooting

Common issues and solutions for the current FE CSV Import & Export implementation.

Quick Checks

  1. Enable WP_DEBUG and WP_DEBUG_LOG
  2. Check the browser console for JavaScript errors
  3. Test with a small CSV first
  4. Confirm your CSV headers match the expected format
  5. Confirm you are using Tools → FE CSV Import & Export

Common Issues

Import Fails Immediately

Check the following:

  • The CSV includes an ID column
  • The first row contains headers
  • The file is a valid CSV
  • The selected post type is correct
  • Nonce or capability checks are not being blocked by custom code

New Posts Are Not Created

If you are creating new posts:

  • Keep the ID column present
  • Leave the ID value empty for new rows
  • Do not use dummy numeric IDs for new posts

Existing Posts Are Not Updated

For updates:

  • Use a real existing WordPress post ID
  • Enable the update-existing option in the import UI
  • Confirm the selected post type matches the existing post

Custom Fields Do Not Import

Check the following:

  • Custom field headers start with cf_
  • Multi-value custom fields use |
  • CSV values are quoted correctly when they contain commas

Taxonomy Values Do Not Import Correctly

Check the following:

  • Hierarchical taxonomy values use >
  • Multiple taxonomy values use |
  • The taxonomy exists for the selected post type

Progress UI Does Not Update

Check the following:

  • Admin JavaScript loaded correctly
  • Browser console has no fatal errors
  • AJAX requests are completing successfully (check browser developer tools > Network tab > admin-ajax.php for errors)
  • Do not navigate away from the page before export/import processing completes

Large Files Feel Slow

FE CSV Import & Export already uses automatic batch processing.

If processing is still slow:

  • Test with a smaller dataset first
  • Check server memory and execution limits (PHP's max_execution_time and memory_limit)
  • Reduce the export limit if you only need a subset
  • Use dry run to validate import files before full processing

Text Looks Garbled

Check the following:

  • Save the CSV as UTF-8
  • Confirm mbstring is enabled
  • Confirm WordPress/database charset is utf8mb4
  • Confirm translation files are present if localized UI text is expected

Pro License UI Looks Incorrect

Check the following:

  • Both Free and Pro versions are installed (Free and Pro versions work together)
  • FE CSV Import & Export Pro is installed/activated
  • Pro version license authentication is complete (license keys can be obtained from the sales site's my account page)

Debug Logging

Add to wp-config.php if needed:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Useful checks:

wp core version
php -v
wp plugin status fe-csv-import-export
tail -f wp-content/debug.log | grep "FE CSV Import & Export"

When Reporting an Issue

Include:

  • WordPress version
  • PHP version
  • FE CSV Import & Export version
  • Browser and version
  • Exact error messages
  • A small sample CSV when possible
  • Whether the issue occurs on import, export, or both

Related Pages