## Overview

Widget available only on the personal dashboard that displays all pages that have a relation to the current user. The My Elements widget displays incoming references for Person entities, showing all cplace pages that reference or are associated with a specific user. It is the Person-specific variant of the Incoming References widget (`cf.platform.incomingReferences`), designed exclusively for Person pages and type definitions that apply to Person.

This widget automatically scans and presents all pages where the Person is referenced through formal reference attributes, providing users with a complete picture of their involvement across the system. The standard Incoming References widget explicitly forbids embedding in Person pages with the message "Not embeddable in person; use myElements widget instead."

## Use Cases

### Personal Dashboard
Display all pages and entities that reference a specific user on their profile page, giving users immediate visibility into their associations.

### User Activity Overview
Show projects, tasks, documents, and other entities associated with a person, helping them understand their scope of involvement.

### Accountability Tracking
Identify all items where a person is mentioned, assigned, or referenced, useful for workload assessment and responsibility mapping.

### Relationship Visualization
Help users understand their connections across the cplace system, revealing how they relate to various entities and workflows.

## Design Considerations

### When to Use This Widget

- On Person profile pages to show user involvement across the system
- On type definitions that apply to Person entities
- When building personal dashboards or user-centric views
- To provide accountability and relationship visibility for users
- As the standard (and only) way to display incoming references on Person entities

### When NOT to Use This Widget

- On non-Person entities (the widget enforces Person entity restrictions)
- If you need to customize how references are displayed (this widget has no configuration options)
- When you need to show hyperlinks from rich text fields rather than formal reference attributes (use Incoming Links widget)

### Technical Constraints

- **Single Instance Only**: Cannot be embedded multiple times on the same Person page
- **Person Entities Only**: Enforced at the widget definition level; only embeddable in Person or applicable type definitions
- **No Configuration**: Works out-of-the-box without user-configurable options
- **Read-Only**: Displays references but does not provide editing capabilities
- **Widget Embedding Only**: Cannot be embedded in other embedding contexts

## Related Widgets

### Incoming References Widget (`cf.platform.incomingReferences`)
The standard incoming references widget for non-Person entities. It explicitly prohibits embedding in Person pages. Both widgets share the same underlying rendering mechanism (`incomingReferences()` template function).

**Key Differences**:
- **My Elements**: Person-specific, no configuration options
- **Incoming References**: General-purpose for non-Person entities, more configuration options available

### Incoming Links Widget (`cf.platform.incomingLinks`)
Tracks hyperlinks in rich text content rather than formal reference attributes. Can be used alongside My Elements on a Person page to show both types of relationships - formal references (My Elements) and informal hyperlinks (Incoming Links).

### Wiki Widget (`cf.platform.wiki`)
Often used alongside My Elements on Person pages to display descriptive content. While My Elements shows references, Wiki provides rich text content.

## Common Pitfalls

### Using Incoming References Instead
The standard Incoming References widget explicitly blocks embedding on Person pages. If you need to show incoming references for a Person, you must use My Elements.

### Expecting Configuration Options
This widget has no configurable attributes. It automatically displays all incoming references to the Person entity without filtering or customization.

### Multiple Widget Instances
Attempting to add the widget multiple times to the same page will fail. The widget enforces single-instance embedding.