Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ivmartel/dwv-wordpress

DWV plugin for wordpress
https://github.com/ivmartel/dwv-wordpress

Last synced: about 1 month ago
JSON representation

DWV plugin for wordpress

Awesome Lists containing this project

README 

        
=== DICOM Support ===

Contributors: ivmartel

Tags: dicom, html5, javascript

Requires at least: 4.5

Stable tag: 0.10.6

Tested up to: 6.5

License: GPLv2

License URI: http://www.gnu.org/licenses/gpl-2.0.html



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



== Description ==



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](https://github.com/ivmartel/dwv)).



See it live at: [dwvblog](https://tyarcaouen.synology.me/wordpress/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!



== Frequently Asked Questions ==



= DICOM? =

DICOM is the standard medical image format, see [DICOM](https://en.wikipedia.org/wiki/DICOM) on wikipedia or at [NEMA](http://dicom.nema.org/).



= Add a Dicom block (wordpress >= version 5) =



Here are the steps needed to add a 'Dicom' block:



1. In the post editor, find and add a 'Dicom' block,

1. Click the `Media Library` button,

1. Upload files on the `Upload Files` tab or choose some from the `Media Library` tab,

1. Click 'Select',

1. This brings you back to the editor and adds the dcm shortcode to the post,

1. 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:



1. In the post editor, click the `Add Media` button,

1. On the `Insert Media` page, choose the `Upload Files` tab,

1. Upload DICOM data,

1. It should be selected in the `Media Library` tab,

1. Click the `Insert into post` button,

1. This brings you back to the editor and adds the dcm shortcode to the post,

1. 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:



1. In the post editor, click the `Add Media` button,

1. On the `Create Gallery` page, choose the `Upload Files` tab,

1. Upload DICOM data,

1. It should be selected in the `Media Library` tab,

1. **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,

1. Click the `Create a new gallery` button,

1. 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,

1. Click the `Insert gallery` button,

1. This brings you back to the editor and adds the gallery shortcode to the post,

1. 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](https://ivmartel.github.io/dwv/doc/stable/tutorial-conformance.html) page on its doc to see what it supports.

You can test your data on the latest live version of DWV on its [demo](https://ivmartel.github.io/dwv/demo/stable/viewer.html) 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.



== Upgrade Notice ==

No upgrades yet...