🌍
English
Differences
This shows you the differences between two versions of the page.
|
dev:extensions:plugin_tutorial2 [2011/07/09 15:51] j.commelin Syntax error in the code tags |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Tutorial: Copyrights plugin ====== | ||
| - | In this tutorial you will learn more about the basics of plugin development for Piwigo. This tutorial is a follow up on [[tutorial1|Tutorial: Hello World!]]. The entire plugin can be | ||
| - | installed from the extension gallery under the name [[http://piwigo.org/ext/extension_view.php?eid=537|'Copyrights']]. | ||
| - | Note that this tutorial follows the v1.0 revision of this plugin. | ||
| - | |||
| - | ===== Introduction ===== | ||
| - | First of all, download the source code of the [[http://piwigo.org/ext/extension_view.php?eid=543|Skeleton plugin]]. We will use that as basis for this plugin. | ||
| - | |||
| - | ==== Outline ==== | ||
| - | With this plugin we want to achieve the following: | ||
| - | - Somewhere we want to manage our copyrights. | ||
| - | - Somehow copyrights must be added to photos. | ||
| - | - Somehow the copyright must be displayed when visitors view a photo. | ||
| - | Therefore, we will write code for: | ||
| - | - An administration panel, where the admin can create and edit plugins | ||
| - | - An extension to the Batch manager (using events) so that copyrights can be added to photos. | ||
| - | - Another event-hook that will display the copyright when a photo is viewed. | ||
| - | |||
| - | ===== The admin panel ===== | ||
| - | |||
| - | For the admin panel we need to do two things. First add a link to the plugins menu, second create an admin page. | ||
| - | |||
| - | ==== The link in the menu ==== | ||
| - | |||
| - | To add a link to the menu of plugins we put the following code in main.inc.php | ||
| - | <code> | ||
| - | // In main.inc.php | ||
| - | |||
| - | /* +-----------------------------------------------------------------------+ | ||
| - | * | Plugin admin | | ||
| - | * +-----------------------------------------------------------------------+ */ | ||
| - | |||
| - | // Add an entry to the plugins menu | ||
| - | add_event_handler('get_admin_plugin_menu_links', 'copyrights_admin_menu'); | ||
| - | function copyrights_admin_menu($menu) { | ||
| - | array_push( | ||
| - | $menu, | ||
| - | array( | ||
| - | 'NAME' => 'Copyrights', | ||
| - | 'URL' => get_admin_plugin_menu_link(dirname(__FILE__)).'/admin.php' | ||
| - | ) | ||
| - | ); | ||
| - | return $menu; | ||
| - | } | ||
| - | </code> | ||
| - | This add an event handler to the event 'get_admin_plugin_menu_links'. The added handler is the function 'copyrights_admin_menu' that we define right below it. It consists of a simple array_push() to add our link to the plugins menu. | ||
| - | |||
| - | Lets move on to the content of admin.php, since that is what we are linking to. | ||
| - | |||
| - | ==== The admin page ==== | ||
| - | We would like to do several things on the admin page. First of all, we want to be able to create plugins. Next we should be able to view them, and lastly, we want to be able to edit existing copyrights. | ||
| - | |||
| - | === Creating copyrights === | ||
| - | |||
| - | === Viewing copyrights === | ||
| - | |||
| - | === Editing copyrights === | ||
| - | |||
| - | ===== Extending the Batch manager ===== | ||
| - | The Batch manager comes with two modes, so we will have to write extensions to both. | ||
| - | |||
| - | ==== Batch Mode ==== | ||
| - | |||
| - | ==== Single Mode ==== | ||
| - | |||
| - | ===== Showing the copyrights to visitors ===== | ||