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 four tabs:
| Tab | Purpose |
|---|---|
| General | Default viewer height, download button visibility, info overlay, protected file serving |
| Series | How series are displayed, layout modes, grid columns, reference lines |
| Anonymization | DICOM tag redaction levels in the info overlay |
| License | License key activation and status |
All settings are stored in WordPress as a single serialized option under the key dv_settings.
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 option 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.
Allow Download
Should visitors be able to download the original DICOM files?
- Off (default): A download button appears below the viewer
- On: No download button — users can only view, not download
Use this to prevent people from downloading your medical images if they shouldn’t have them.
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.
Restrict Who Can Download
Only advanced users with private images need this option. Leave it off unless you’re using per-file access controls.
Saving Changes
Click Save Settings at the bottom of the tab. Changes take effect immediately across your site.
Next Steps
- See Series Settings to control how multiple series are displayed
- See Anonymization to redact sensitive DICOM tags
Series Settings
These settings control how multiple images appear when you upload a ZIP file with many scans.
How to Show Series Selection
When someone opens a ZIP with multiple series (like different angles or types of scans), how should they switch between them?
- Automatic — Smart: Shows buttons for a few series, then switches to a dropdown menu for many
- Always buttons — Show clickable buttons for each series
- Always dropdown — Show a menu to choose series
- Hide selector — Only show the first series (hide the others)
How to Arrange Multiple Series
When showing multiple series at once:
- Single view — Show one image at a time (full screen)
- Grid — Show multiple images side-by-side
- Smart — Automatically choose based on how many series there are
Grid Options
If using grid view:
- Columns: How many columns in the grid (1–4)
- When to use grid: Automatically switch to grid if there are 2 or more series (you can change this number)
- Reference lines: Show crosshairs that help compare the same spot in different images
Save Your Changes
Click Save Settings at the bottom to apply these settings across your site.
Next Steps
- See Multi-Series for details on how series navigation works
- See Grid Layout for details on grid view
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.
Next Steps
- See General Settings to control whether the Info button is shown at all
- See File Management for information on handling Protected Health Information (PHI)
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 (
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.