Drupal2WP_Toolkit/README.md
2025-07-20 20:30:14 +00:00

2.4 KiB

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:

    git clone https://git.bikeshopi.dev/bike/drupal2wp_toolkit.git wp-content/plugins/drupal2wp_toolkit
    
  2. Activate the plugin:

    wp plugin activate drupal2wp_toolkit
    
  3. Run the import command:

    wp drupal2wp_toolkit --type=story,hidden_content,vidcast,news_article,resources
    

📁 Repo Structure

  drupal2wp_toolkit/
  ├── page-taxonomy/
  │   └── page-taxonomy.php
  ├── drupal2wp_toolkit.php
  └── README.md

🙌 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