Admin Settings
Accessing Settings
All plugin settings are found under DICOM Viewer in the WordPress admin sidebar. You’ll need the manage_options capability (Administrator role) to access these settings.
Settings Tabs
The settings panel is divided into five tabs:
| Tab | Purpose |
|---|---|
| General | Default viewer height, cine speed, download button visibility, info overlay, and front-end control toggles |
| Series | Layout modes, auto-grid threshold, grid columns, reference lines, and selector toggles |
| Anonymization | DICOM tag redaction levels in the info overlay |
| Support | Documentation link, support email, system info, and shortcode examples |
| License | License key activation and status |
The plugin registers its settings under the dv_settings settings group, but stores them as individual WordPress options such as dv_default_height, dv_cine_speed, dv_layout, and dv_grid_min_series.
Reset to Defaults
There’s no built-in reset button in the UI. If you need to reset settings to defaults, you can delete the relevant options from the database via the WordPress command line or a database management plugin.
Warning: Resetting settings affects all viewers on your site. Make sure you intend this before proceeding.
General Settings
The General tab controls basic viewer behavior across all viewers on your site.
Default Height
How tall should the viewer be on the page?
- Default: 480 pixels
- Examples:
480px,600px,70vh(70% of window height)
You can always override this on specific viewers using the block or shortcode settings.
Show Download Button
Should visitors see a download button below the viewer?
- On (default): A download button appears below the viewer
- Off: The download button is hidden
You can still override this on specific viewers with the block or shortcode settings.
Show Image Information
Should visitors see a button to view image metadata?
- Off (default): No info button
- On: Shows an info button with image details
⚠️ Note: The image details may contain patient information. Only enable this if your visitors are allowed to see that data. You can hide sensitive details using the Anonymization settings.
Autoplay Speed
Controls cine playback speed for multi-slice studies.
- Default: 3 slides per second
- Range: 0.1 to 60
This is the global default used when the Play button runs through slices.
Front-End Controls
These toggles control which viewer tools are shown by default:
- Pan Control — shows the Pan tool and drag-to-pan interaction
- Zoom Control — shows the Zoom tool and zoom buttons
- W/L Control — shows the window/level tool and adjustment buttons
- Next / Prev Buttons — shows the slice navigation arrows
- Slice Slider — shows the vertical slice slider
Each of these defaults can also be overridden per block or shortcode.
Saving Changes
Click Save Settings at the bottom of the tab. Changes take effect immediately across your site.
Series Settings
These settings control how multiple-series studies behave, especially when you upload a ZIP file with several series.
How to Arrange Multiple Series
When showing multiple series at once:
- Auto — switches to grid when the study reaches the auto-grid threshold
- Single — always show one pane at a time
- Grid — always show multiple panes side-by-side
Grid Options
If using grid view:
- Columns: How many columns in the grid (1–4)
- When to use grid: Automatically switch to grid once the study reaches the Auto-Grid Threshold
- Reference lines: Show crosshairs that help compare the same spot in different images
Selector Visibility
These settings control the multi-series UI on the front end:
- Series Selector — lets visitors switch between available series
- Pane Number Selector — lets visitors change how many panes are visible in grid mode
Save Your Changes
Click Save Settings at the bottom to apply these settings across your site.
Anonymization
If you enable the info button (see General Settings), this controls what information gets hidden from visitors.
⚠️ Important: This only hides information in the info button display. The actual file download is NOT changed. If you need to permanently remove patient data, use a DICOM anonymization tool before uploading.
Privacy Levels
Choose how much patient information to hide:
- Off: Show everything
- Basic: Hide patient name, ID, birth date
- Standard: Hide patient info + hospital names and details
- Strict: Hide almost everything except the image itself
Examples
- Public website or research: Use "Strict" to hide patient names and dates
- Internal use only: Use "Basic" or "Off" depending on your privacy policy
- Patient-facing: Use "Standard" to hide hospital details but show medical info
Save Your Changes
Click Save Settings at the bottom to apply these settings across your site.
License
The License tab is where you enter and manage your DICOM Viewer license key.
License Key Field
Enter your license key in the License Key text field and click Activate License to validate it against the license server.
Where to find your key: Check your purchase confirmation email or log in to your account at webdevelop.hu to retrieve your license key.
License Status
Below the key field, you’ll see the current license status with one of these badges:
| Badge | Meaning | Action |
|---|---|---|
| Active (green) | License is valid and the plugin is fully functional | None needed |
| Expired (red) | License has passed its expiration date | Renew your license at webdevelop.hu |
| Revoked (red) | License has been revoked | Contact support at webdevelop.hu |
| Inactive (gray) | No license key entered or license was deactivated | Enter and activate a license key |
| Grace Period (yellow) | License server unreachable for up to 7 days | Check your server’s internet connection |
Deactivating a License
Click Deactivate License to release your license from this domain so you can use it on another site.
Important: Always deactivate before moving your site to a new domain. If the old site becomes inaccessible and you need to deactivate remotely, contact support at webdevelop.hu.
Validation Behavior
- Initial validation happens when you click Activate License
- Cached validation — results are cached for 24 hours to avoid excessive server calls
- Grace period — if the license server is temporarily unreachable, the plugin continues to function for up to 7 days
- Explicit rejection — if the server explicitly rejects the license (expired, revoked), the plugin disables the viewer immediately without waiting for the grace period
Troubleshooting
"License server unreachable" error:
- Check your server can reach
https://webdevelop.hu(your hosting provider’s firewall may be blocking outbound HTTPS) - Wait a few moments and try again
- The plugin will continue to work for 7 days even if the server remains unreachable
"Invalid license key" error:
- Double-check you’ve copied the entire key correctly (keys are case-sensitive)
- Make sure you’re using the right key (not a different product’s key)
- Contact support if you’ve lost your key
License worked on old domain, not on new domain:
- You need to deactivate the license on the old domain first
- Then activate it on the new domain
- If the old site is no longer accessible, contact support to release the license
What’s Protected by License?
When your license is inactive, these features are disabled:
- Gutenberg block insertion (block doesn’t appear in inserter)
- Shortcode processing (
[dicom_viewer]shortcode is ignored) - File serving (viewer won’t display on the frontend)
These features always work, even without a license:
- File uploads to the media library
- Admin settings configuration
- License activation page
Support
For license questions or issues, contact support at webdevelop.hu.