If our servers have problems connecting to polling endpoints for plugins, we'll automatically retry again later, because sometimes websites temporarily become unavailable on the internet; however, if this happens too frequently, we will stop trying and provide a message on the plugin's settings page stating that refreshing has been stopped.
That error message offers a button for resetting the plugin health once you've resolved the problem.
Before you get to that state, such as if the issue was intermittent, you'll instead see a warning similar to this:
Example reasons:
invalid URLunable to fetch data from URL.
Resetting Plugin Health and Removing Warning Message
If you've resolved the issues or they have resolved themselves, and the warning message does not clear itself automatically over time, you can manually clear the message using the following method.
This is the format of the URL when viewing your plugin's settings.
https://usetrmnl.com/plugin_settings/{{pluginId}}/edit
Example: https://usetrmnl.com/plugin_settings/987654321/edit
Replace edit with reset_health to clear the warning message:
https://usetrmnl.com/plugin_settings/{{pluginId}}/reset_health
Example: https://usetrmnl.com/plugin_settings/987654321/reset_health
Why Do You Degrade Plugins?
TRMNL promises to provide screen rendering for devices for the life of the device, with a one-time fee (BYOD) or built-in to the cost of the TRMNL device purchase. We don't require a subscription.
This means we must maintain a healthy plugin ecosystem, for the benefit of all users and sustainability of the platform itself. To do that, if a plugin is not working as expected, we inform users and limit waste by degrading the plugin and eventually disabling refreshing a plugin until it is resolved.