qr_code
The QR Code Generator module provides a flexible and user-friendly solution for creating and displaying QR codes directly within your Drupal site. Whether you need to encode URLs, contact information, or any text content, this module offers both field formatters and a standalone generation tool with extensive customization options powered by the bitjson/qr-code JavaScript library.
Features
This module enables QR code generation with comprehensive styling and display options:
Field Formatter Integration: Transform any text, string, or link field into a scannable QR code directly within your content display. Simply select the QR Code formatter for compatible field types (string, text, text with summary, and link fields) and customize the appearance through the field display settings.
Standalone QR Code Generator: Access a dedicated form interface at `/qrcode/generate` to create QR codes on-demand without needing to attach them to content entities.
Extensive Customization: Control every visual aspect of your QR codes including module color (dark squares), position ring color, position center color, background color, dimensions (width and height), and aspect ratio. Each QR code can be uniquely styled to match your brand or design requirements.
Animation Support: Apply visual effects to QR codes with built-in animation presets including Fade In Top Down, Fade In Center Out, Materialize In, Radial Ripple, and Radial Ripple In to create engaging user experiences.
Custom Icons: Display custom icons in the center of QR codes by specifying an icon path, allowing for branded QR codes that maintain scannability while incorporating your visual identity.
Shurly Integration (optional sub-module): Enable the included qrcode_shurly sub-module to add a Views field plugin that generates QR codes directly from Shurly short URLs. The sub-module is located at modules/qrcode_shurly/, must be enabled separately, and requires both Views and Shurly to be installed.
Use this module when you need to provide quick access to content through scannable codes, share URLs in print materials, create contactless information sharing solutions, or integrate QR functionality seamlessly into your content workflow without managing separate QR code entities.
Post-Installation
After enabling the module, configure global default settings at `/admin/config/media/qrcode`. These defaults will apply to all QR codes unless overridden at the field formatter level.
To add QR codes to existing content:
1. Navigate to your content type's display settings at `/admin/structure/types/manage/[content-type]/display`
2. Find the field you want to display as a QR code (must be a compatible field type)
3. Change the Format dropdown to "QR Code"
4. Click the settings gear icon to customize colors, dimensions, animation, and other display options
5. Save the display configuration
To generate standalone QR codes:
1. Visit `/qrcode/generate` (requires "Generate QR codes" permission)
2. Enter the content to encode in the Contents field
3. Optionally customize styling, sizing, animation, and icon options
4. Click "Generate QR Code" to see a live preview
5. Right-click the generated QR code to save it as an image
The module automatically loads the required bitjson/qr-code JavaScript library from the unpkg.com CDN, so no additional library installation is needed.
Additional Requirements
Drupal Core: Version 10.0 or higher (also compatible with Drupal 11)
Core Modules: Field and Text modules (included with standard Drupal installations)
JavaScript Library: The bitjson/qr-code library is automatically loaded from the unpkg.com CDN. No manual library installation is required, though you can optionally install it locally via npm if preferred.
Internet Access: CDN access is required for the JavaScript library unless you install it locally.
Recommended modules/libraries
Link Field: While the core Link module is included with Drupal, enabling it allows you to use the QR Code formatter on link fields for easy URL encoding.
Views + Shurly: Enable the included qrcode_shurly sub-module to add a Views field plugin that generates QR codes from Shurly short URLs. Requires both the Views and Shurly modules to be installed and enabled.
Token: Use with token integration to dynamically generate QR code content based on node or user data.
Similar projects
The [QR-Code module](https://www.drupal.org/project/qrcode) provides QR code functionality through a dedicated entity type system with tracking capabilities. It focuses on creating and managing QR code entities with features like scan counting and dynamic URL updates after generation.
This QR Code Generator module differs by providing field formatter integration, allowing you to convert existing field data into QR codes without creating separate entities. It emphasizes display flexibility and visual customization through extensive styling options and animation presets. Choose this module if you need to display field content as QR codes within your existing content architecture, want advanced styling capabilities, or prefer a lightweight solution without entity overhead. Choose the QR-Code module if you need dedicated QR code entity management, scan tracking, or dynamic URL updates.
Supporting this Module
If you find it useful, consider contributing bug reports, feature requests, or patches through the issue queue.
Community Documentation
For detailed information about the underlying bitjson/qr-code JavaScript library, including advanced configuration options and technical specifications, visit the [bitjson/qr-code GitHub repository](https://github.com/bitjson/qr-code).
The module's README.md file includes comprehensive setup instructions, field configuration examples, troubleshooting tips, and performance considerations for production deployments.