Widgets, Permissions, and Events

FeatherPanel plugin power comes from three core systems: widget injection points, permissions, and events/hooks.

Source of Truth

Always use your panel docs at:

/icanhasfeatherpanel/index.html

That page is generated for your specific panel and includes available integration points.

Widget Injection Points

Widget injection points let you render custom UI in supported panel areas.

Common usage patterns:

• Add information cards to existing dashboards
• Render custom controls in supported sections
• Show plugin-specific status or actions near related panel features

Permissions

Permissions define what your plugin can access or execute.

Best practices:

• Request only what your plugin actually needs
• Keep privileged operations explicit and auditable
• Document why each permission is required

Events and Hooks

Events/hooks allow your plugin to react to panel lifecycle and actions.

Examples of what this enables:

• Triggering logic after a panel action
• Synchronizing plugin state with panel updates
• Running custom tasks on specific plugin or panel events

Recommended Implementation Strategy

1. Pick one integration point (widget, permissioned action, or event handler)
2. Implement minimal logic
3. Test behavior in panel
4. Expand feature scope only after validation

This approach reduces regressions and makes plugin behavior predictable.