When a WordPress site hits a fatal error, you usually get a stack trace and nothing about what led up to it. Sanctuary Ranger keeps a short rolling log of recent activity and freezes a snapshot the moment a fatal error happens.<\/p>\n\n
What it records (cheap events only):<\/strong><\/p>\n\n What it never records:<\/strong> cookies, authentication headers, POST bodies, query-string values, email contents or recipients.<\/p>\n\n Optional features (all off by default):<\/strong><\/p>\n\n Sanctuary Ranger does not prevent crashes or fix them. It helps you find the cause faster.<\/p>\n\n Optional Pro add-on<\/strong><\/p>\n\n Everything described above is free and fully working. A separate add-on, Sanctuary Ranger Pro, is sold on rachel-m-harrison.com and adds crash grouping, Slack, Discord and Microsoft Teams alert formats, and a weekly digest email. It is installed as its own plugin and needs a license key ($39 per year for one site). This plugin contains no locked features and works the same with or without it.<\/p>\n\n This plugin contacts no external service by default. If you click \"Open in Playground\" on a snapshot, your browser opens https:\/\/playground.wordpress.net with a blueprint in the link. The blueprint contains the PHP version and the WordPress.org slugs of your active plugins, and it stays in the part of the address after \"#\", which browsers do not send to servers. Playground then downloads those plugins from WordPress.org. This plugin itself sends nothing, and nothing happens until you click. Playground terms and privacy policy: https:\/\/wordpress.org\/about\/privacy\/<\/p>\n\n The \"Go Pro\" button on the Tools > Sanctuary Ranger screen is a plain link to https:\/\/rachel-m-harrison.com\/rmh-shop\/?buy=sanctuary-ranger-pro. Nothing is sent to that address unless you click it.<\/p>\n\n If you enter a webhook URL in Tools > Sanctuary Ranger, the plugin sends a POST request containing a one-line error summary and your site URL to that address when a fatal error occurs. You choose the destination; the plugin does not use any third-party service of its own.<\/p>\n\n\n In a protected folder inside your uploads directory. By default events are kept in two rotating files of about 512 KB each, and the 20 newest crash snapshots are kept. Both sizes can be changed in the settings. Uninstalling the plugin deletes everything.<\/p><\/dd>\n Yes. Recording, snapshots, the crash screen box and quarantine all work in Playground. Email cannot be sent from Playground, webhooks may be blocked by the browser, and recorded data lasts only for the Playground session.<\/p><\/dd>\n No. It rebuilds the PHP version and the active plugins that can be installed from WordPress.org, at their latest versions. Your content, settings, custom or paid plugins and the request that crashed are not copied, so the crash may not reproduce. It is a quick throwaway place to experiment.<\/p><\/dd>\n Only if you click \"Install early recorder\" does it add one small file, wp-content\/mu-plugins\/sanctuary-ranger-early.php, which starts this plugin before other plugins. It does nothing while this plugin is deactivated. \"Remove early recorder\" or deleting this plugin removes it.<\/p><\/dd>\n Yes. The No. Every feature in this plugin is included and free. The only limits are the storage settings above, which control disk space. Sanctuary Ranger Pro is a separate paid add-on with additional features (crash grouping, Slack\/Discord\/Teams alert formats and a weekly digest); it does not unlock or remove anything here.<\/p><\/dd>\n Crash grouping (identical errors counted together with first seen and last seen), Slack, Discord and Microsoft Teams formats for the webhook alert, and a weekly digest email. It is a separate plugin that needs this one and a license key.<\/p><\/dd>\n It only deactivates plugins you tick, and only after repeated fatal errors. Do not tick plugins that must stay running, such as payment or checkout plugins.<\/p><\/dd>\n It records fatal errors from any code that runs after Sanctuary Ranger loads, including earlier-loading plugins' fatals at shutdown, but it cannot log events from before it was loaded.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
\n
External services<\/h3>\n\n
\n
\/wp-content\/plugins\/<\/code> or install it from the Plugins screen.<\/li>\n\n
Where is the data stored?<\/h3><\/dt>\n
Can I try it in WordPress Playground?<\/h3><\/dt>\n
Does Replay copy my site?<\/h3><\/dt>\n
What does the early recorder change?<\/h3><\/dt>\n
Are there hooks for developers?<\/h3><\/dt>\n
bbcr_snapshot_saved<\/code> action fires after a snapshot is saved (arguments: snapshot ID, snapshot data). The bbcr_webhook_body<\/code> filter changes the webhook payload before it is sent. Others: bbcr_max_snapshots<\/code>, bbcr_buffer_max_bytes<\/code>, bbcr_max_events<\/code>, bbcr_alert_throttle<\/code>.<\/p><\/dd>\nAre any features limited or locked?<\/h3><\/dt>\n
What does Sanctuary Ranger Pro add?<\/h3><\/dt>\n
Can auto-quarantine break my site?<\/h3><\/dt>\n
Does it catch errors from plugins that load before it?<\/h3><\/dt>\n
0.3.1<\/h4>\n\n
\n
0.3.0<\/h4>\n\n
\n
0.2.1<\/h4>\n\n
\n
0.2.0<\/h4>\n\n
\n
0.1.8<\/h4>\n\n
\n
0.1.7<\/h4>\n\n
\n
0.1.6<\/h4>\n\n
\n
0.1.5<\/h4>\n\n
\n
0.1.4<\/h4>\n\n
\n
0.1.3<\/h4>\n\n
\n
0.1.2<\/h4>\n\n
\n
0.1.1<\/h4>\n\n
\n
0.1.0<\/h4>\n\n
\n