https://github.com/andreasbilke/s9y-to-drupal

S9Y to Drupal migration tool
https://github.com/andreasbilke/s9y-to-drupal

converter drupal migration-tool s9y

Last synced: about 1 month ago
JSON representation

S9Y to Drupal migration tool

• Host: GitHub
• URL: https://github.com/andreasbilke/s9y-to-drupal
• Owner: AndreasBilke
• License: gpl-3.0
• Created: 2023-07-27T07:41:16.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-03-18T20:13:37.000Z (11 months ago)
• Last Synced: 2024-11-14T15:21:11.858Z (3 months ago)
• Topics: converter, drupal, migration-tool, s9y
• Language: Python
• Homepage:
• Size: 35.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# S9Y to Drupal Exporter

This program helps in migrating a current s9y installation (as of writing: 2.5.0)

to a freshly created Drupal 10 instance.

It does the following jobs:

- Copy s9y articles (including s9y hosted images) to Drupal

- Assigning (and create) categories to articles

It does **not** migrate S9Y users to Drupal nor does it migrate any configuration

related things (like blog title, plugins, etc.)

## S9Y requirements

- Read access to Postgresql database of S9Y (MySQL should work completely the same but the python program uses psql driver)

- Read access to a copy of `/uploads` folder from S9Y

## Drupal requirements

The following modules needs to be activated

- Json API (activate create/delete/patch capabilities)

- HTTP Basic Auth (used user needs admin role to Drupal)

- Enable Full-HTML Support for article fields

  - See `/admin/structure/types/manage/article/fields/node.article.body`

- Enable unlimited number of images for article `field_image`

  - See `/admin/structure/types/manage/article/fields/node.article.field_image`

- If needed: Hide full `field_image` list at the beginning of the article (since you are embedding it on your own)

## Workflow

1. Extract articles (including author, assigned categories) from S9Y database

2. Extract image references from body/extended body of articles

   1. Double check for image existence in `uploads/` folder

   2. Mark images in body/extended body such that the URLs can be rewritten later

3. For each article (creation via API)

   1. Create article with title only (to obtain UUID of Drupal article)

   2. Upload embedded images. Link image with article. Rename image with `s9y-migration` prefix.

      Obtain image URL from API response

   3. (Local preprocessing) Rewrite image URLs in body/extended body to match Drupal URLs

   4. Update article body/extended body

   5. Assign (and create first) tags/categories

## Tool usage

- Install required Python dependencies (see `pyproject.toml`)

- Copy `.env.example` to `.env` and update parameters accordingly

- Run `python src/main.py`