{"id":258986,"date":"2025-11-20T00:57:44","date_gmt":"2025-11-20T00:57:44","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ssp-debugging\/"},"modified":"2025-11-20T00:57:16","modified_gmt":"2025-11-20T00:57:16","slug":"ssp-debugging","status":"closed","type":"plugin","link":"https:\/\/jv.wordpress.org\/plugins\/ssp-debugging\/","author":23284141,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"SSP Debug","header_author":"Stupid Simple Plugins","header_description":"Logs PHP errors with selectable levels, uncaught exceptions, shutdown fatals, size limits, filters, and a download option; includes an admin page for viewing, clearing, and managing logs. Includes a modern, image-based showcase panel for other products.","assets_banners_color":"373e48","last_updated":"2025-11-20 00:57:16","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.stupidsimpleplugins.com\/","header_plugin_uri":"https:\/\/www.stupidsimpleplugins.com\/ssp-debugging","header_author_uri":"https:\/\/www.stupidsimpleplugins.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":89,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"jimmyredline80","date":"2025-11-20 00:57:16"}},"upgrade_notice":{"1.0.0":"<p>Initial public release.<\/p>"},"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3399319,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":3399319,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Dashboard and settings page","2":"Log viewer with download\/clear options","3":"Showcase tab (static, text-only links)"}},"plugin_section":[],"plugin_tags":[94,14925,5789,1522,8541],"plugin_category":[59],"plugin_contributors":[246580],"plugin_business_model":[],"class_list":["post-258986","plugin","type-plugin","status-closed","hentry","plugin_tags-debug","plugin_tags-error-log","plugin_tags-exceptions","plugin_tags-logging","plugin_tags-troubleshooting","plugin_category-utilities-and-tools","plugin_contributors-jimmyredline80","plugin_committers-jimmyredline80"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/ssp-debugging_373e48.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p><strong>SSP Debug<\/strong> provides a complete error logging system built directly into WordPress, helping site owners and developers identify problems without needing access to server error logs.<\/p>\n\n<h4>Key points<\/h4>\n\n<ul>\n<li>Toggle logging on\/off.<\/li>\n<li>Choose <strong>All<\/strong> or <strong>Fatal-only<\/strong> (E_ERROR\/E_PARSE\/etc.).<\/li>\n<li>Capture <strong>uncaught exceptions<\/strong> and <strong>shutdown fatals<\/strong>.<\/li>\n<li>Append contextual details (URL, IP, User Agent, User ID) when using <strong>Detailed<\/strong> format.<\/li>\n<li>Select a <strong>timezone<\/strong> for timestamps (site default, UTC, or friendly region names).<\/li>\n<li>Limit log size (MB) with automatic truncation when the limit is exceeded.<\/li>\n<li>Maintain a custom <strong>ignore list<\/strong> (substrings or regex) to filter noise.<\/li>\n<li>Include\/exclude sources by scope: <strong>MU-plugins<\/strong>, <strong>Plugins<\/strong>, <strong>Themes<\/strong>, <strong>Core\/Other<\/strong>.<\/li>\n<li><strong>Download<\/strong> the current log as a file.<\/li>\n<li><strong>Clear<\/strong> the log from the admin screen.<\/li>\n<li>Optional <strong>Showcase<\/strong> tab that includes static links to related plugins.<\/li>\n<\/ul>\n\n<p>Logs are stored in <code>wp-content\/ssp-debug.log<\/code>.<br \/>\nThe admin interface is located under <strong>SSP Debug<\/strong> in your WordPress dashboard.<\/p>\n\n<p>This plugin follows WordPress coding standards (escaping, nonces, WP_Filesystem, <code>wp_date()<\/code>), is internationalization-ready, and stores everything locally.<\/p>\n\n<h3>Features<\/h3>\n\n<ul>\n<li>Enable\/disable logging  <\/li>\n<li>All vs. Fatal-only levels  <\/li>\n<li>Exception &amp; shutdown fatal capture  <\/li>\n<li>Detailed context mode  <\/li>\n<li>Timezone selection  <\/li>\n<li>Size limit with auto-truncate  <\/li>\n<li>Scope filtering (MU\/Plugins\/Themes\/Core)  <\/li>\n<li>Ignore list (substring or regex)  <\/li>\n<li>Download log  <\/li>\n<li>Clear log  <\/li>\n<li>Translation ready  <\/li>\n<li>Admin UI<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin includes an optional <strong>About\/Showcase tab<\/strong> containing standard hyperlinks to pages on <strong>stupidsimpleplugins.com<\/strong>.<br \/>\n- No data is transmitted automatically.<br \/>\n- No background connections are made by the plugin.<br \/>\n- When a user clicks one of these links, the browser opens the destination page on StupidSimplePlugins.com.<br \/>\n- These links are provided solely for informational and navigational purposes.<\/p>\n\n<p>For transparency, here are the relevant policies for that website:<br \/>\n- Terms of Service: https:\/\/www.stupidsimpleplugins.com\/terms-and-conditions\/<br \/>\n- Privacy Policy: https:\/\/www.stupidsimpleplugins.com\/privacy-policy\/<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>When <strong>Detailed<\/strong> format is enabled, requests may log the current request\u2019s URL, IP address, User Agent, and (if logged in) User ID.<br \/>\nThis information is written only to the local file <code>wp-content\/ssp-debug.log<\/code> and never transmitted externally.<br \/>\nThe log can be cleared or downloaded at any time from the plugin\u2019s admin page.<\/p>\n\n<h3>Localization<\/h3>\n\n<ul>\n<li>Text domain: <code>ssp-debugging<\/code>  <\/li>\n<li>Domain path: <code>\/languages<\/code>  <\/li>\n<li>Load translations from <code>languages\/ssp-debugging-{locale}.mo<\/code><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to:<br \/>\n   wp-content\/plugins\/ssp-debug\/<\/li>\n<li>Ensure the main file is:<br \/>\n   wp-content\/plugins\/ssp-debug\/ssp-debug.php<\/li>\n<li>Activate <strong>SSP Debug<\/strong> from <strong>Plugins \u2192 Installed Plugins<\/strong>.<\/li>\n<li>Go to <strong>SSP Debug<\/strong> in the left admin menu to configure settings and view logs.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id='where%20is%20the%20log%20file%20located%3F'><h3>Where is the log file located?<\/h3><\/dt>\n<dd><p>wp-content\/ssp-debug.log<\/p><\/dd>\n<dt id='does%20it%20replace%20php%E2%80%99s%20native%20error_log%3F'><h3>Does it replace PHP\u2019s native error_log?<\/h3><\/dt>\n<dd><p>No. It registers handlers for PHP errors, uncaught exceptions, and shutdown fatals and writes them to its own file.<\/p><\/dd>\n<dt id='what%E2%80%99s%20%E2%80%9Cdetailed%E2%80%9D%20format%3F'><h3>What\u2019s \u201cDetailed\u201d format?<\/h3><\/dt>\n<dd><p>It appends context (URL, IP, User Agent, User ID) to each entry.<\/p><\/dd>\n<dt id='will%20this%20slow%20down%20my%20site%3F'><h3>Will this slow down my site?<\/h3><\/dt>\n<dd><p>Logging is lightweight, but <strong>All<\/strong> mode can increase disk writes. Use <strong>Fatal-only<\/strong> in production.<\/p><\/dd>\n<dt id='how%20does%20size%20limiting%20work%3F'><h3>How does size limiting work?<\/h3><\/dt>\n<dd><p>When the log exceeds your MB limit, it truncates to about 70% of that size, keeping the most recent entries.<\/p><\/dd>\n<dt id='can%20i%20ignore%20noisy%20messages%3F'><h3>Can I ignore noisy messages?<\/h3><\/dt>\n<dd><p>Yes. Add substrings or regex (e.g., <code>\/deprecated\/i<\/code>) to the <strong>Ignore list<\/strong>; matching entries are filtered out.<\/p><\/dd>\n<dt id='is%20multisite%20supported%3F'><h3>Is multisite supported?<\/h3><\/dt>\n<dd><p>Yes. Logs are saved in <code>wp-content\/ssp-debug.log<\/code>; settings are per-site.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Logging for PHP errors, exceptions, and shutdown fatals.<\/li>\n<li>Options for all\/fatal level, detailed context, timezone selection, size limit with truncation, scopes, and ignore list.<\/li>\n<li>Download and clear controls.<\/li>\n<li>Optional showcase tab with external link disclosure.<\/li>\n<li>Translation-ready; no external updaters.<\/li>\n<\/ul>","raw_excerpt":"Log PHP errors, exceptions, and shutdown fatals with size limits, timezone options, ignore list, download &amp; clear controls, and an admin log viewer.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/258986","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=258986"}],"author":[{"embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jimmyredline80"}],"wp:attachment":[{"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=258986"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=258986"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=258986"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=258986"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=258986"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/jv.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=258986"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}