Troubleshooting Plugins

Use this checklist when your plugin is not behaving as expected.

Plugin Option Is Missing

If Dev Plugins does not appear:

• Confirm you are logged in as an admin
• Verify Development Mode is enabled in Admin Area -> Settings
• Reload the panel session after enabling Development Mode

Injection Point Not Rendering

If your widget/custom item does not show:

• Check that you are targeting a valid injection point
• Verify your plugin is enabled
• Confirm the panel location supports that type of render
• Re-check docs at /icanhasfeatherpanel/index.html

Permission-Related Failures

If plugin actions fail unexpectedly:

• Review declared permissions
• Ensure required permissions are enabled/granted
• Remove unused permissions to reduce conflicts

Event Hook Not Triggering

If event logic does not run:

• Confirm the event/hook name matches documentation exactly
• Validate the event actually fires in your test flow
• Add temporary logging around handler execution

Docs Do Not Match Recent Changes

If docs appear outdated after changes:

• Refresh your panel docs page
• Re-check endpoint/integration sections
• If plugin data is cached, allow time for cache refresh before retesting

Final Sanity Checks

Before deep debugging:

• Test on a clean panel/dev environment
• Disable unrelated plugins temporarily
• Validate one feature at a time to isolate root cause