Title: Object Oriented Plugin Template Solution Author: Daniel Convissor Published: 2012 年 11 月 5 日 Last modified: 2016 年 8 月 13 日 --- 搜尋外掛 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://s.w.org/plugins/geopattern-icon/oop-plugin-template-solution.svg) # Object Oriented Plugin Template Solution 由 [Daniel Convissor](https://profiles.wordpress.org/convissor/) 開發 [下載](https://downloads.wordpress.org/plugin/oop-plugin-template-solution.zip) * [詳細資料](https://tw.wordpress.org/plugins/oop-plugin-template-solution/#description) * [使用者評論](https://tw.wordpress.org/plugins/oop-plugin-template-solution/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/oop-plugin-template-solution/#installation) * [開發資訊](https://tw.wordpress.org/plugins/oop-plugin-template-solution/#developers) [技術支援](https://wordpress.org/support/plugin/oop-plugin-template-solution/) ## 外掛說明 Gives authors of new plugins a leg up on creating a great, easy to maintain plugin by providing a carefully designed plugin skeleton to build on. Authors of existing plugins can extract individual components and concepts for transplantation into their own projects. * Clean, object-oriented design * PHPUnit tests * Admin screen uses the Settings API * Multisite support * Creates a table during activation * Drops the table and settings during deactivation * Uses WordPress’ i18n and provides scripts for generating the gettext files * Installation instructions have a script for renaming files, classes and IDs See the FAQ section for more details about this plugin’s features. Development of this plugin template happens on [GitHub](https://github.com/convissor/oop-plugin-template-solution). Please submit [bug and feature requests](https://github.com/convissor/oop-plugin-template-solution/issues), [pull requests](https://github.com/convissor/oop-plugin-template-solution/pulls), [wiki entries](https://github.com/convissor/oop-plugin-template-solution/wiki) there. Releases are then squashed and pushed to WordPress’ [Plugins SVN repository](https://plugins.svn.wordpress.org/oop-plugin-template-solution/). This division is necessary due having being chastised that “the Plugins SVN repository is a release system, not a development system.” #### Explanations If you want an explanation of how this “plugin” works, please see the “PHPUnit Tests for WordPress Plugins” series on my blog. * [Global Variables](http://www.analysisandsolutions.com/blog/html/writing-phpunit-tests-for-wordpress-plugins-global-variables.htm) * [wp_mail()](http://www.analysisandsolutions.com/blog/html/writing-phpunit-tests-for-wordpress-plugins-wp-mail.htm) * [wp_redirect() and Expected PHP Errors](http://www.analysisandsolutions.com/blog/html/writing-phpunit-tests-for-wordpress-plugins-wp-redirect-and-continuing-after-php-errors.htm) * [Auto-increment ID Records](http://www.analysisandsolutions.com/blog/html/writing-phpunit-tests-for-wordpress-plugins-auto-increment-id-records.htm) ## 安裝方式 1. Download the zip file from WordPress’ plugin site: `https://wordpress.org/extend/ plugins/oop-plugin-template-solution/` 2. Unzip the file 3. Here are some semi-automated steps to copy this plugin and rename the files, class names, and identifiers. The commands are in Bash, adjust them as needed for your environment. Replace the three mentions of “My Plugin” in the settings section with the name of your plugin. 4. ``` # Settings ----- # Plugin identifier / directory (hyphen separated). old_id=oop-plugin-template-solution new_id=my-plugin # Class name (underscore separated). old_class=oop_plugin_template_solution new_class=my_plugin # Plugin Name (space separated). old_name="Object Oriented Plugin Template Solution" new_name="My Plugin" # -------------- # Copy and rename the files. cp -R $old_id $new_id cd $new_id mv $old_id.php $new_id.php # Replace strings in the files. find . -type f -exec sed "s/$old_id/$new_id/g" -i {} \; find . -type f -exec sed "s/$old_class/$new_class/g" -i {} \; find . -type f -exec sed "s/$old_name/$new_name/g" -i {} \; find . -type f -exec sed -E "s/^ \* (Author:|Author URI:|@author|@copyright) (.*)$/ * \1/g" -i {} \; find . -type f -exec sed "s@REPLACE_PLUGIN_URI@https://wordpress.org/extend/plugins/oop-plugin-template-solution/@g" -i {} \; sed -E "s/^(Contributors|Donate link|Tags): (.*)$/\1:/g" -i readme.txt ``` 5. Now get down to making the plugin do what you want. See the FAQ for instructions about particular aspects. 6. Upload your plugin directory to your server’s `/wp-content/plugins/` directory 7. Activate the plugin using WordPress’ admin interface: 8. * Regular sites: Plugins * Sites using multisite networks: My Sites | Network Admin | Plugins #### Removal 1. This plugin offers the ability to remove all of this plugin’s settings from your database. Go to WordPress’ “Plugins” admin interface and click the “Settings” link for this plugin. In the “Deactivate” entry, click the “Yes, delete the damn data” button and save the form. 2. Use WordPress’ “Plugins” admin interface to click the “Deactivate” link 3. Remove the plugins directory from the server ## 常見問題集 #### Multisite Networks This plugin is coded to be installed in either a regular, single WordPress installation or as a network plugin for multisite installations. So, by default, multisite networks can only activate this plugin via the Network Admin panel. If you want your plugin to be configurable for each site in a multisite network, follow the instructions in the docblock at the top of `admin.php`. #### Settings API We add some abstraction around WordPress’ [Settings API](https://codex.wordpress.org/Settings_API). All you need to do is add some elements to two arrays and maybe create a section header if you want. This is way better than having to write out `add_settings_field()` calls and creating display and validation callbacks for each and every field. 1. Open `admin.php` in your favorite text editor 2. Read the docblock at the top of the file #### Unit Tests This framework uses PHPUnit, so standard PHPUnit file, class, and method naming practices apply. Our framework requires that your test files and classes: * Have a `require_once` call for `TestCase.php` at the top of the script. That obtains the PHPUnit and other items needed. It’s the only file you need to include. * Classes must extend `TestCase` * If you add a `setUpBeforeClass()` method, it must call `parent::setUpBeforeClass()` * If you add a `setUp()` method, it must call `parent::setUp()` * If you add a `tearDown()` method, it must call `parent::tearDown()` * If you add a `tearDownAfterClass()` method, it must call `parent::tearDownAfterClass()` Take a look at the `TestLogin.php` script for examples of how to handle calls to` wp_mail()` (and translations of mail messages) and `wp_redirect()`, the use of database savepoints, and manipulating user metadata. Please note that the tests make extensive use of database transactions. Many tests will be skipped if your `wp_options` and `wp_usermeta` tables are not using the ` InnoDB` storage engine. To execute the tests, install and activate the plugin, then use a shell to `cd` into this plugin’s directory and call `phpunit tests` While it is possible to test plugins using [WordPress’ Automated Testing](https://codex.wordpress.org/Automated_Testing) PHPUnit framework, it is a complex system, is another dependency, and runs in its own environment. The benefit of using my plugin’s PHPUnit is that it ships with the plugin and executes in the users actual WordPress installation. This means any end user can easily test how the plugin interacts with their site. #### Translations To produce the machine readable translations used by WordPress’ gettext implementation, use the scripts I made for generating all of the `.pot`, `.po` and `.mo` files: * `cd languages` * `./makepot.sh` * Update the headers, version number, etc in the `.pot` file as desired. * To add a new language: `touch -_.mo` Substitutions: plugin- id: the plugin’s identifier ($new_id from above) lc: language code CC: country code * `./updatepos.sh` * Fill the translated text in the `.po` files. * `./makemos.sh` ## 使用者評論 這個外掛目前沒有任何使用者評論。 ## 參與者及開發者 以下人員參與了開源軟體〈Object Oriented Plugin Template Solution〉的開發相關工作。 參與者 * [ Daniel Convissor ](https://profiles.wordpress.org/convissor/) [將〈Object Oriented Plugin Template Solution〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/oop-plugin-template-solution) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/oop-plugin-template-solution/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/oop-plugin-template-solution/)， 或透過 [RSS](https://plugins.trac.wordpress.org/log/oop-plugin-template-solution/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/oop-plugin-template-solution/)。 ## 變更記錄 #### 1.1.2 (2016-08-13) * Change translation domain from constant to string for integration with translate. wordpress.org #### 1.1.1 (2012-11-28) * Tell folks where explanations can be found. #### 1.1.0 (2012-11-08) * Move the `wp_logout()` and `wp_redirect()` calls from direct calls in the test method to a method in the tested class instead. #### 1.0.2 (2012-11-05) * Explain why can’t use PHPUnit’s @expectedException functionality. #### 1.0.1 (2012-11-05) * Clarify instructions and descriptions. #### 1.0.0 (2012-11-05) * Initial release. ## 中繼資料 * 版本 **1.1.2** * 最後更新 **10 年前** * 啟用安裝數 **少於 10 次** * WordPress 版本需求 ** 3.3 或更新版本 ** * 已測試相容的 WordPress 版本 **4.4.34** * 語言 * [English (US)](https://wordpress.org/plugins/oop-plugin-template-solution/) * 標籤: * [i18n](https://tw.wordpress.org/plugins/tags/i18n/)[multisite](https://tw.wordpress.org/plugins/tags/multisite/) [object oriented](https://tw.wordpress.org/plugins/tags/object-oriented/)[phpunit](https://tw.wordpress.org/plugins/tags/phpunit/) [settings api](https://tw.wordpress.org/plugins/tags/settings-api/)[skeleton](https://tw.wordpress.org/plugins/tags/skeleton/) [template](https://tw.wordpress.org/plugins/tags/template/)[translation](https://tw.wordpress.org/plugins/tags/translation/) * [進階檢視](https://tw.wordpress.org/plugins/oop-plugin-template-solution/advanced/) ## 評分 5 星，滿分為 5 星 * [ 2 個 5 星使用者評論 ](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/oop-plugin-template-solution/reviews/) ## 參與者 * [ Daniel Convissor ](https://profiles.wordpress.org/convissor/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/oop-plugin-template-solution/) ## 贊助 想要支援這個外掛的發展嗎？ [ 贊助這個外掛 ](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=danielc%40analysisandsolutions%2ecom&lc=US&item_name=Donate%3a%20Object%20Oriented%20Plugin%20Template%20Solution¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHosted)