dfg_3dviewer_drupal_module/README.md
2026-06-25 09:09:16 +02:00

1.5 KiB

DFG 3D Viewer — Drupal Module

Drupal/WissKI integration for the DFG 3D Viewer JavaScript library.

This repository contains PHP/YAML only — no bundled JavaScript, no npm build step on the server.

Requirements

  1. JS library at web/libraries/dfg-3dviewer/:

    • Download dfg-3dviewer-library.zip from the library releases, or
    • Build from the js_library_dfg_3dviewer repo: npm run build:library and copy dist/library/* there
  2. This module at web/modules/custom/dfg_3dviewer/

Install

unzip dfg-3dviewer-library.zip -d web/libraries/dfg-3dviewer
# clone or unzip this module to web/modules/custom/dfg_3dviewer
drush en dfg_3dviewer -y
drush cr

Configure at /admin/config/dfg_3dviewer. Settings are passed to the browser as drupalSettings.dfg_3dviewer.

Package contents

Path Purpose
src/ Controllers, form, field formatters, queue worker
config/ Default config and schema
dfg_3dviewer.*.yml Routing, libraries, permissions
dfg_3dviewer.module Hooks, conversion workflow
scripts/ Model conversion shell/Python scripts

Library attachment

dfg_3dviewer.libraries.yml loads:

  • /libraries/dfg-3dviewer/dfg_3dviewer.min.js
  • /libraries/dfg-3dviewer/assets/css/viewer.css

Release zip (maintainers)

node scripts/pack-drupal-module.js

Produces dfg_3dviewer-drupal.zip.