Term Importer for WordPress

Term Importer simplifies term management by allowing you to bulk import terms into any WordPress custom taxonomy with just a few clicks. Upload a CSV file, select your target taxonomy, and let the plugin handle the rest — no manual data entry required!

Effortless Term Management – Import, Organize, and Simplify!

🚀 Features

• Import terms from a CSV file into any custom taxonomy.
• Automatically detects all registered taxonomies in WordPress.
• Supports CSV fields: name, slug, description.
• Secure import process using nonce validation and capability checks.
• WordPress admin menu integration for easy access.
• Detailed error handling and debugging support.

🔧 Installation

Install via WordPress Plugin Upload

1. Download the Term Importer plugin as a .zip file.
2. Go to WordPress Dashboard → Plugins → Add New.
3. Click Upload Plugin, then select the .zip file and click Install Now.
4. Activate the plugin.

Install via FTP

1. Extract the .zip file and upload the term-importer folder to your /wp-content/plugins/ directory.
2. Go to WordPress Dashboard → Plugins.
3. Find Term Importer in the list and click Activate.

Install via Composer (Advanced Users)

Run the following command in your WordPress project root:

composer require rafyco/term-importer

After installation, run:

composer dump-autoload

This ensures that all classes are properly loaded.

📥 Importing Terms from CSV

Prepare Your CSV File

Ensure your CSV file follows this structure:

name,slug,description
Category One,category-one,This is the first category.
Category Two,category-two,This is the second category.

📌 Notes:

• The name field is required.
• The slug is optional (auto-generated if missing).
• The description is optional.

Upload CSV File

1. Go to WordPress Dashboard → Term Importer.
2. Select the taxonomy where the terms should be imported.
3. Upload the CSV file and click Import Terms.
4. The plugin will process the CSV and insert the terms into WordPress.

🛠 Debugging & Logging

If something goes wrong, enable debugging in wp-config.php:

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

Logs will be saved in wp-content/debug.log. Errors related to Term Importer will be prefixed with [TermImporter].

❓ FAQ

What happens if I upload duplicate terms?

The plugin checks for existing terms in the selected taxonomy before inserting new ones.

Does it work with WooCommerce product categories?

Yes! WooCommerce product categories (product_cat) are taxonomies, so they will appear in the dropdown.

Can I import terms into built-in taxonomies (like post categories)?

Yes! The plugin detects all public taxonomies, including category and post_tag.

📜 License

This plugin is licensed under the GPL-2.0-or-later. See LICENSE for details.

📬 Support

For support and feature requests, visit:
🔗 https://rafy.com.br/ti

🎉 Credits

Developed and maintained by Rafy Co.
🔗 https://rafy.com.br/