Drupal2WP_Toolkit/README.md

69 lines
2.2 KiB
Markdown

# Drupal2WP Toolkit
Flexible content migration and taxonomy structuring for modern WordPress sites.
Drupal2WP Toolkit provides an extensible command-line and plugin-based bridge between Drupal 8 and WordPress 6, optimized for developers handling structured content migration. It includes taxonomy mapping, sortable categories, UI enhancements, and future-ready plans for block-based template integration.
---
## ⚙️ Features
- **Drupal → WordPress Migration**
- Imports all Drupal nodes as WordPress **Pages** by default
- Vocabulary terms are converted into **top-level categories**
- Associated Drupal terms become **sub-categories** under their vocabularies
- Drupal content types are added as **top-level categories** for structural clarity
- **Admin UI Enhancements**
- Adds a sortable **Last Modified** column to Pages view
- Top-level categories are also **sortable**
- Category filters available directly in admin for Pages
- **WP-CLI Utilities**
- Run `wp drupal2wp_toolkit import` to initiate Drupal content ingestion
- Easily convert migrated Pages into **Posts**, retaining taxonomy mapping
---
## 🚀 Future Plans
- **Block Theme Editor Integration**
- Assign categories to custom templates or reusable block layouts
- Enable GUI-based taxonomy-driven theming inside WordPress's Site Editor
- **Advanced Taxonomy Mapping**
- Support for custom post types and multi-taxonomy assignment
- **Content Blueprinting**
- Define reusable structures based on imported vocabularies and content types
---
## 🧰 Installation
1. Clone the repository into your WordPress plugins directory:
```bash
git clone https://git.bikeshopi.dev/bike/drupal2wp_toolkit.git wp-content/plugins/drupal2wp_toolkit
```
2. Activate the plugin:
```bash
wp plugin activate drupal2wp_toolkit
```
3. Run the import command:
```bash
wp drupal2wp_toolkit --type=story,hidden_content,vidcast,news_article,resources
```
## 🙌 Credits
Created and maintained by developers at BikeShopi Dev. Contributions and feedback welcome — this is a toolkit built for extensibility.
## 📄 License
MIT License. See LICENSE.md for details.
Let me know if you want version badges, contributor guidelines, or sample config