Title: Custom Error Log Author: Dan Bahrami Published: 2014 年 10 月 22 日 Last modified: 2014 年 10 月 23 日 --- 搜尋外掛 ![](https://ps.w.org/custom-error-log/assets/banner-772x250.jpg?rev=1012102) 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://s.w.org/plugins/geopattern-icon/custom-error-log_d8d8d8.svg) # Custom Error Log 由 [Dan Bahrami](https://profiles.wordpress.org/danbahrami/) 開發 [下載](https://downloads.wordpress.org/plugin/custom-error-log.1.1.1.zip) * [詳細資料](https://tw.wordpress.org/plugins/custom-error-log/#description) * [使用者評論](https://tw.wordpress.org/plugins/custom-error-log/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/custom-error-log/#installation) * [開發資訊](https://tw.wordpress.org/plugins/custom-error-log/#developers) [技術支援](https://wordpress.org/support/plugin/custom-error-log/) ## 外掛說明 Custom Error Log allows you to create custom errors in your WordPress theme or plugin with a single function. Great for debugging those long and complex scripts. Each error can have its own error message making it a lot easier to pin down specific issues in your code. You can also log notices for less serious issues. All your errors and notices can be viewed conveniently in the WordPress admin area. ### Plugin Features: * **Easy Errors:** Create errors with a simple function. * **Useful Errors:** Define a custom error message for each error. * **Log notices:** Notices can be logged for less serious issues and viewed seperately in the admin area. * **Keep Track:** View and moderate all your errors in the WordPress admin area. * **Toolbar icon:** The admin toolbar displays how many new errors and notices have occurred on the current page. ### Getting Started: Install and activate the plugin then in the admin menu go to _Tools > Error Log_. This will eventually be the page that displays all your latest errors but if you’re just getting started it explains in detail how to start logging custom errors. In your theme use either of the two built in functions to log an error `log_error( $message);` or a notice `log_notice($message);`. When these functions are executed they will log whatever error or notice you want. ### Ongoing Development: I have only just started with this plugin and plan on bringing great improvements to it. If you have any ideas please suggest them in the support section. ### Translation: The plugin is translation ready but as of yet contains only an English translation file. If you would like to contribute any translations I would be very grateful. ### Please note: This plugin is aimed at developers who have at least a basic understanding of PHP. If this isn’t you then you may not find much use from this plugin however if you are unsure how to use any of the functions explained you can post a topic in the support section of the plugin directory and I will do my best to help you. ## 螢幕擷圖 [⌊The error log page.⌉⌊The error log page.⌉[ The error log page. ## 安裝方式 1. Upload `Custom Error Log` to the `/wp-content/plugins/` directory. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Place the function `log_error($message);` in your theme where you would like to log an error. Once the plugin is installed and activated you can find more detailed instructions under _Tools > Error Log_ in the WordPress admin menu. ## 常見問題集 What’s the point? As they say ‘Necessity is the mother of invention’… I was recently developing a WordPress site which imported data from a CRM in the background and used that data to create users, posts, taxonomies etc. I started using the standard PHP error log but quickly found that the errors didn’t have enough specific information to make them useful. I needed to know exactly what information wasn’t being imported properly and why so I created this plugin to allow me to customise the information stored in each error. There are other ways, like using full debugging tools but I think it’s easier to have a simple, WordPress native tool. How do I log an error? It’s simple, you place the following function in your theme/plugin where you want to log an error… ``` log_error( $message ); ``` Replace $message with whatever error message you want to log for example if you’re adding a new user you could do this… ``` $user_id = wp_create_user( $user_name, $password, $user_email ); if( is_wp_error( $user_id ) ) { $error_response = $user_id->get_error_message(); $mesage = "Unable to create user with username: " . $user_name; $message .= " password: " . $password; $message .= " The following error occurred: " . $error_response; log_error( $message ); } ``` ## 使用者評論 ![](https://secure.gravatar.com/avatar/41a9999580b17fc40168156ba8609f80f177043c2f2a655e51c2317848f3c66a? s=60&d=retro&r=g) ### 󠀁[Nice but has a little bug](https://wordpress.org/support/topic/nice-but-has-a-little-bug/)󠁿 [nubotz](https://profiles.wordpress.org/nubotz/) 2019 年 1 月 4 日 There’s a error after clicking “Clear Log” when wp_options ‘custom_error_log’ is empty. —- Illegal string offset ‘errors’ —- ![](https://secure.gravatar.com/avatar/36e867f4d3d891a95bdb9b129f7905c8e58cc1af802f99e73bc3503fd9b04f59? s=60&d=retro&r=g) ### 󠀁[Best Debugger Out There!](https://wordpress.org/support/topic/best-debugger-out-there/)󠁿 [tansandals](https://profiles.wordpress.org/tansandals/) 2018 年 7 月 21 日 This is the simplest and best custom error viewer and debugger out there in my opinion. Absolutely vital for developing plugins and themes in WordPress ![](https://secure.gravatar.com/avatar/07efa26edf96c50236eee4bcc18977d7e0b86d4e51b9ff981fd5fc91f8944813? s=60&d=retro&r=g) ### 󠀁[Really Useful](https://wordpress.org/support/topic/really-useful-83/)󠁿 [kendallinternet](https://profiles.wordpress.org/kendallinternet/) 2017 年 2 月 7 日 This plugin may not have been updated recently, but it’s still working well (at least on WP 4.7.2). It is super easy to use and provides an excellent audit trail of whatever events you need to record. ![](https://secure.gravatar.com/avatar/56426725c280afc84d2da3e357d6b9c9c4df6e98e287f99e1a2425430a020f9d? s=60&d=retro&r=g) ### 󠀁[Promising !](https://wordpress.org/support/topic/promising-8/)󠁿 [X-Raym](https://profiles.wordpress.org/x-raym/) 2016 年 9 月 3 日 Very promising plugin ! I was developing without debug log and my plugin started to get complicated, I needed a way to debug more easily. Infos are well presented, it is clear and userfriendly, there is even some infos in the admin toolbar. Thanks to the Dev for this nice tool ! [ 閱讀全部 5 則使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈Custom Error Log〉的開發相關工作。 參與者 * [ Dan Bahrami ](https://profiles.wordpress.org/danbahrami/) [將〈Custom Error Log〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/custom-error-log) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/custom-error-log/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/custom-error-log/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/custom-error-log/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/custom-error-log/)。 ## 變更記錄 #### 1.1 * Added toolbar icon for displaying new errors/notices that occur on the current page. * Added option to hide the new toolbar icon. * Added ability to track which errors/notices have not yet been viewed in the error log. * Added a nice animation to highlight which logs are new in the error log. * updated some non-internationalized strings. #### 1.0 * Hello world… ## 中繼資料 * 版本 **1.1.1** * 最後更新 **12 年前** * 啟用安裝數 **40+** * WordPress 版本需求 ** 3.0.1 或更新版本 ** * 已測試相容的 WordPress 版本 **4.0.0** * 語言 * [English (US)](https://wordpress.org/plugins/custom-error-log/) * 標籤: * [error](https://tw.wordpress.org/plugins/tags/error/)[error log](https://tw.wordpress.org/plugins/tags/error-log/) [errors](https://tw.wordpress.org/plugins/tags/errors/)[log](https://tw.wordpress.org/plugins/tags/log/) * [進階檢視](https://tw.wordpress.org/plugins/custom-error-log/advanced/) ## 評分 5 星，滿分為 5 星 * [ 5 個 5 星使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/custom-error-log/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/custom-error-log/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/custom-error-log/reviews/) ## 參與者 * [ Dan Bahrami ](https://profiles.wordpress.org/danbahrami/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/custom-error-log/)