## Overview

Creates a QR code from the URL of the embedding page.

The widget dynamically generates a QR code that encodes the absolute URL of the embedding cplace page. When users scan the QR code with a mobile device camera or QR code reader app, they are directed to that specific page. The widget uses the ZXing (Zebra Crossing) library for QR code generation with high error correction (Level H) to ensure readability even when a custom logo is overlaid.

## Use Cases

- **Mobile Access to Pages**: Enable quick access to cplace pages from mobile devices by scanning a QR code displayed on screen during presentations
- **Physical-Digital Integration**: Print QR codes for display in physical spaces (offices, warehouses, production floors) to link physical assets or locations to their corresponding digital pages
- **Meeting and Presentation Support**: Display QR codes during meetings so attendees can quickly access related pages without manually typing URLs
- **Asset and Inventory Tracking**: Generate QR codes for equipment, inventory items, or project assets; print and attach codes to physical items for quick lookups
- **Documentation and Reports**: Include QR codes in exported documents so readers can access the live, up-to-date page version

## Design Considerations

- **When to Use**: URLs are long/difficult to type, users need mobile access to pages on large screens, physical items need links to digital records, or quick touchless access is preferred
- **Visual Customization**: Adjustable size (larger for presentations, smaller for inline use), color customization for branding, optional logo overlay for brand recognition, frame/quiet zone control
- **Error Correction**: Uses Level H (highest, ~30% data recovery), ensuring the code remains scannable even with a centered logo overlay, partial damage, or reduced print quality

## Related Patterns/Alternatives

- **Link Widgets**: For simple URL sharing without QR codes, standard link or button widgets may suffice
- **Video Widget** (`cf.cplace.videoWidget`): Another utility widget from the same repository for embedding media content
- **External QR Generators**: For offline or static QR codes, external generators could be used, but this widget provides dynamic, always-current URLs
