Changes between Version 4 and Version 5 of TracDev/PluginDevelopment/ExtensionPoints/trac.attachment.IAttachmentChangeListener

Timestamp:

Jul 30, 2017, 9:24:34 AM (7 years ago)

Author:

anonymous

Comment:

Added method attachment_moved (#12870)

TracDev/PluginDevelopment/ExtensionPoints/trac.attachment.IAttachmentChangeListener

@@ -8 +8 @@
 == Purpose ==
 
-Trac allows users to attach arbitrary files to e.g. tickets or wiki pages. Plugins can hook into the attachment module to trigger their own actions when attachments are added, deleted or reparented (i.e. moved to another parent resource or with a renamed parent resource).
+Trac allows users to attach arbitrary files to e.g. tickets or wiki pages. Plugins can hook into the attachment module to trigger their own actions when attachments are added, deleted or moved (i.e. moved to another parent resource and / or renamed).
 
 The main purpose for this interface is to allow plugins to stay informed about the existing attachments and trigger appropriate actions elsewhere (e.g. sending notifications, starting indexing services, updating supplementary data structures etc.)
@@ -18 +18 @@
 Implementing the interface follows the standard guidelines found in [wiki:TracDev/ComponentArchitecture] and of course [wiki:TracDev/PluginDevelopment].
 
-When a user adds a new attachment the `attachment_added` method is called. Similarly `attachment_deleted` is called when a user deletes an attachment or its parent resource, and `attachment_reparented` is called when a user moves an attachment to a new parent resource or renames the parent resource.
+When a user adds a new attachment the `attachment_added` method is called. Similarly `attachment_deleted` is called when a user deletes an attachment or its parent resource, and `attachment_moved` is called when a user moves an attachment to a new parent resource or renames the attachment or the parent resource.
 
 == Examples ==
@@ -46 +46 @@
         pass
 
-    def attachment_reparented(self, attachment, old_parent_realm, old_parent_id):
+    def attachment_moved(attachment, old_parent_realm, old_parent_id, old_filename):
         pass
 }}}
@@ -74 +74 @@
  * 0.10 introduced the interface (changeset:3399)
  * 0.12 added method `attachment_reparented` (#1106, changeset:9362)
+ * 1.3.2 added method `attachment_moved` (#12870, changeset:16160)
+ * 1.5.1 will remove method `attachment_reparented` (deprecated since #12870)