April 19, 2024

DICOM Support Plugin

Adds DICOM (standard for medical image format) support to Wordpress!

The DICOM Support plugin adds the following functionalities to WordPress:

allows to upload DICOM (*.dcm) files in the media library,
adds a ‘Dicom’ block (wordpress 5 or above) that allows to select files from the media library (creates a ‘dcm’ shortcode)

For wordpress previous to version 5:
* allows to insert DICOM individual files to a blog post from the media library (by creating a ‘dcm’ shortcode)
* allows to insert DICOM galleries to a blog post from the media library (by overwritting the ‘gallery’ shortcode)

The display is done using the open source DICOM Web Viewer (DWV).

See it live at: dwvblog.

More details on how to add DICOM file(s) to your post can be found in the FAQ.

Installation

Upload the DICOM support plugin from the WordPress plugin directory to your blog and Activate it!

FAQ

DICOM?

DICOM is the standard medical image format, see DICOM on wikipedia or at NEMA.

Add a Dicom block (wordpress >= version 5)

Here are the steps needed to add a ‘Dicom’ block:

In the post editor, find and add a ‘Dicom’ block,
Click the Media Library button,
Upload files on the Upload Files tab or choose some from the Media Library tab,
Click ‘Select’,
This brings you back to the editor and adds the dcm shortcode to the post,
Click the Preview button to see it in action!

You can click back on the generated shortcode to make the ‘Dicom’ block reappear and modify your selection.

Add an individual file (wordpress < version 5)

The steps to add a DICOM file to a post are similar than adding an image except you do not have a preview in the editor.
They are:

In the post editor, click the Add Media button,
On the Insert Media page, choose the Upload Files tab,
Upload DICOM data,
It should be selected in the Media Library tab,
Click the Insert into post button,
This brings you back to the editor and adds the dcm shortcode to the post,
Click the Preview Changes button to see it in action!

Add a gallery (wordpress < version 5)

The gallery allows to load more than one slice and activates the scroll button.
The steps to add DICOM files to a gallery are similar than for images. They are:

In the post editor, click the Add Media button,
On the Create Gallery page, choose the Upload Files tab,
Upload DICOM data,
It should be selected in the Media Library tab,
Note: DICOM data may not show in the media list, in that case, choose the DICOM option in the first drop down on the search line,
Click the Create a new gallery button,
No need to change the DICOM files order in the Edit Gallery page, it will be set by the viewer; what you can do is choose the size in the Settings column,
Click the Insert gallery button,
This brings you back to the editor and adds the gallery shortcode to the post,
Click the Preview Changes button to see it in action!

Error loading data

DWV supports most of the DICOM standard but it can sometimes fail to load data. Please refer to the
conformance page on its doc to see what it supports.
You can test your data on the latest live version of DWV on its demo page.

Changelog

0.10.6

Fix full screen
Remove layerGroup background colour

0.10.5

Fix super small display div

0.10.4

Fix dwv build

0.10.3

Fix Image does not completely fill div

0.10.2

Really fix compressed data load…

0.10.1

Fix compressed data load

0.10.0

Update gui to look more like https://github.com/ivmartel/dwv-simplistic
- new toolbar with icons
- add toggle orientation
- add ruler
- add progress bar
Updated dwv to v0.32

0.9.0

Add the ‘Dicom’ block
Fix block theme support
Add support for ‘ids’ in the dcm shortcode

0.8.2

Updated dwv to v0.26.2:
- fix scroll

0.8.1

Updated dwv to v0.26.1:
- slow down scroll on trackpad
- add shift to scroll shortcuts

0.8.0

Updated dwv to v0.26.0:
- support for RLE compressed files
- support for non standard files

0.7.2

Sync select with the current tool.

0.7.1

Revert tool order to the one of the previous (v0.6) version.

0.7.0

Updated dwv to v0.25.2:
- support for DICOMDIR files (*.dcmdir)
- no more modernizr dependency
Real full screen (not opening the data in the simplistic viewer)
Allow for setting a special window/level preset in shortcode or gallery

0.6.1

Updated dwv to v0.22.1: fix MONOCHROME1 display
Use a modernizr.js that include the ‘mq’ tests to allow
compatibility with other theme/plugin

0.6.0

Updated dwv to v0.22.0:
- more locales
- updated decoders
- improved DICOM parsing

0.5.2

Updated dwv to v0.18.0:
- better slice sorting,
- allow for per slice window/level.

0.5.1

Better js script insertion using wp_register_script and wp_add_inline_script.

0.5.0

Updated dwv to v0.17.0:
- fix Internet Explorer support,
- added double click slice/frame play.
Added Full screen link (and supporting pages).

0.4.1

Add support for personnalised wordpress installation folder.
Avoid race condition between listeners.

0.4

Updated dwv to v0.16.0:
- better DICOM parsing,
- support for non encoded multi-frame data,
- internationalsation.

0.3

Added data decoders to support JPEG, JPEG LossLess and JPEG 2000.
Updated doc.

0.2

Added default values for width/height in dcm shortcode.
Using uniqid instead of a hash of the input files.

0.1.1

Updated readme file.

0.1.0

Initial version.