{"id":5252,"date":"2009-04-08T16:01:26","date_gmt":"2009-04-08T16:01:26","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/timber\/"},"modified":"2009-04-08T18:36:16","modified_gmt":"2009-04-08T18:36:16","slug":"timber","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/timber\/","author":2354631,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.8 beta","stable_tag":"0.8","tested":"2.7.1","requires":"2.7","requires_php":"","requires_plugins":"","header_name":"Timber","header_author":"Blurbia","header_description":"","assets_banners_color":"","last_updated":"2009-04-08 18:36:16","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/www.blurbia.com\/plugins\/timber\/","header_author_uri":"http:\/\/www.blurbia.com\/","rating":0,"author_block_rating":0,"active_installs":40,"downloads":4281,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.8"],"block_files":[],"assets_screenshots":{"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":"1538910","resolution":"2","location":"plugin","width":530,"height":400},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":"1538910","resolution":"3","location":"plugin","width":530,"height":400},"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":"1538910","resolution":"1","location":"plugin","width":530,"height":400}},"screenshots":{"1":"The errors list view.","2":"Timber displays an alert in the Wordpress sidebar. Unread error count is maintained per-user.","3":"Detailed error information rolls down -- pulled via AJAX when requested."}},"plugin_section":[],"plugin_tags":[93,1522,662],"plugin_category":[],"plugin_contributors":[84044],"plugin_business_model":[],"class_list":["post-5252","plugin","type-plugin","status-closed","hentry","plugin_tags-errors","plugin_tags-logging","plugin_tags-php","plugin_contributors-jeffsmith-1","plugin_committers-jeffsmith-1"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/timber.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/timber\/trunk\/screenshot-1.jpg?rev=1538910","caption":"The errors list view."},{"src":"https:\/\/ps.w.org\/timber\/trunk\/screenshot-2.jpg?rev=1538910","caption":"Timber displays an alert in the Wordpress sidebar. Unread error count is maintained per-user."},{"src":"https:\/\/ps.w.org\/timber\/trunk\/screenshot-3.jpg?rev=1538910","caption":"Detailed error information rolls down -- pulled via AJAX when requested."}],"raw_content":"\n

Timber is a general-purpose error-logging and alert system for Wordpress. It traps and catalogues PHP \nerrors at multiple levels, and provides detailed stack trace and debug information. It integrates with \nthe Role Manager<\/a> plugin to allow user \n& role specific permissions to be set to view and\/or clear errors.<\/p>\n\n

Timber is intended primarily as a developer's tool, to be enabled in a sandbox environment while debugging \nplugins or themes in-progress. However, it also has potential in a production setting, as a way to hide \nerrors from the end-user while still logging them for administrator review. The configuration settings \nallow for precise control of what type of errors and what error information is logged, so it can be deployed \nin varying scenarios without runaway logs filling the database.<\/p>\n\n

Several additional features are planned, and a good deal of real-world testing is still required. Timber \nis currently in beta.<\/p>\n\n\n

Installing Timber is simple and straightforward.<\/p>\n\n

    \n
  1. Upload the plugin files to a folder named timber<\/code> in the \/wp-content\/plugins\/<\/code> directory. (If the folder does not exist, create it.)<\/li>\n
  2. Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n
  3. (Optional) Follow the full configuration guide<\/a> detailing all of Timber's options.<\/li>\n<\/ol>\n\n\n
    \n
    Is Timber safe to install on my public blog?<\/dt>\n

    Maybe. There are several things that could wreak havoc when installing Timber on a live Wordpress site, \nand it's important to understand what they are. As a start, follow these two steps:<\/p><\/dd>\n

    1) Don't log Notices or Strict messages.<\/dt>\n

    The average PHP script, even the well-written ones, commits several \"minor infractions\" on every execution. \nThis includes many of the scripts in the Wordpress core. If Notices or Strict messages are enabled for \nlogging, it will result in many multiple errors logged each and every time any user loads any page of your site.<\/p><\/dd>\n

    2) Keep an eye on your logs for awhile.<\/dt>\n

    Even with Notices and Strict messages disabled, some themes or plugins may generate a number of Warnings \nor other error types. Since these will be logged every time the offending page is loaded, the logs may still \nfill quickly depending on your site traffic. If this starts to happen, you'll want to disable logging entirely, \nor clear the logs regularly.<\/p>\n\n

    Clearly, the main concern is the logs filling too much or too fast. Why is this a problem? Timber logs errors \nto a custom table in your Wordpress database. Your database very likely has a space limit on it, the size \nvarying dependent on your web host. This available space is already partially filled by your posts, comments, \nand other Wordpress data, as well as any custom data stored by other plugins. If the space runs out, your site \nmay become inaccessible. In addition to the space limit, many database configurations have a limit on the number \nof connections or data operations. If a single page generates several errors, that multiplies the number of \ndatabase calls for that page across every user. And if the limit is reached, again, the site may become \nunreachable.<\/p>\n\n

    Timber works best on a development server, as a tool for programmers to track down the bugs in their plugins \nor themes. It can be useful on a live blog, but make sure you understand the uses and potential hazards.<\/p><\/dd>\n

    Does Timber log non-PHP Wordpress errors?<\/dt>\n

    Not at this time. Timber is primarily a debugging tool for developers, meant to trace programming errors to \ntheir source. There are several types of \"expected\" errors that Wordpress handles, including those managed by \nthe WP_Error class, that Timber does not monitor. Many of these are not solvable, in the permanent sense - such \nas an error message that occurs when a user attempts to login with an incorrect password. As such, they would \nonly clutter the error logs.<\/p>\n\n

    That being said, there are certain error types, such as 404s, that future versions of Timber would benefit from \nlogging. Feel free to request features and let us know how you're using Timber.<\/p><\/dd>\n

    Why is Wordpress 2.7 required?<\/dt>\n

    Timber has been developed and tested only on Wordpress 2.7. In all likelihood, it will work fine on previous \nversions of Wordpress, although the admin screens may not match the formatting well. One of the goals of the \nupcoming 1.0 release is to be tested and fully compatible with versions at least as early as 2.5.<\/p><\/dd>\n\n<\/dl>","raw_excerpt":"Timber is a general-purpose error-logging and alert system for Wordpress.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/5252","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=5252"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jeffsmith-1"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=5252"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=5252"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=5252"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=5252"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=5252"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=5252"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}