http://swiftmailer.org/wikidocs/ 2009-04-14T07:08:35+00:00 http://swiftmailer.org/wikidocs/ http://swiftmailer.org/wikidocs/lib/images/favicon.ico text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/beforecommandevent?rev=1236058883&do=diff A plugin which implements the Swift_Events_BeforeCommandListener interface will be invoked every time Swift is about to issue an SMTP command. The plugin will have access to the command being executed and any changes made to the command inside the plugin will be executed at the time when the command would normally execute. Plugins which implement either the CommandListener or BeforeCommandListener are most likely listening for those event by means of tracking the progress of sending an email r… text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/beforesendevent?rev=1236058883&do=diff The two event listeners in Swift which are likely to be the most heavily implemented are SendListener and BeforeSendListener. BeforeSendListener is run before the message gets sent. You will know who the recipients are and what the message is at this stage, but Swift will not yet have sent the message so you can change recipients and/or modify the message and then it will be sent. text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/commandevent?rev=1236058883&do=diff A plugin which implements the Swift_Events_CommandListener interface will be invoked whenever Swift has sent a command. The CommandEvent object which is passed is the same object as the one a plugin implementing BeforeCommandListener would have already seen. Therefore, any changes made before the command is issued will be also seen here after the command has been issued. More often than not, BeforeCommandListener will be more useful than CommandListener. We could use something like this to m… text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/connectevent?rev=1236058883&do=diff As the name suggests, a ConnectListener will be notified every time Swift connects to the SMTP server or other MTA. A plugin which implements the Swift_Events_ConnectListener interface will be passed an instance of Swift_Events_ConnectEvent when a connection is established. text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/disconnectevent?rev=1236058883&do=diff A DisconnectListener will be notified every time Swift disconnects from the SMTP server or local MTA. A plugin which implements the Swift_Events_DisconnectListener interface will be passed an instance of Swift_Events_DisconnectEvent when a disconnection occurs. text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/intro?rev=1236058883&do=diff Swift has come a leap forward from it's version 2 days where learning to use the plugin system was a confusing business unless you knew Swift's core inside-out. In Version 3, things are clearer and simpler. The entire basis of the plugin system is centered around the concept of event-driven programming. Observers (Event Listeners) are plugged into Swift's core class. Swift then dispatches Events (as objects) to these event listeners. text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/responseevent?rev=1236058883&do=diff A plugin which implements Swift_Events_ResponseListener will be invoked every time Swift receives a new response from the connection. This can come in useful if used in combination with a CommandListener because if you know what response codes to expect, you can “correct” problems by issuing the RSET command or whatever other action may be appropriate. It probably helps to know a little about the SMTP protocol before attempting such things however. text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/sendevent?rev=1236058883&do=diff A plugin which implements the Swift_Events_SendListener interface will be invoked every time Swift has sent a message to a recipient. The event passed is of type Swift_Events_SendEvent, just like the BeforeSendListener. In fact, the event you get passed is actually a reference to that same event you would have already seen if your plugin implements BeforeSendListener! So if you're plugin implements both SendListener and BeforeSendListener, you could change the SendEvent before the message is … text/html 2009-03-03T05:41:23+00:00 http://swiftmailer.org/wikidocs/v3/plugindev/start?rev=1236058883&do=diff Writing Plugins (advanced) * An introduction to the plugin API * Writing a ConnectListener plugin * Writing a DisconnectListener plugin * Writing a BeforeSendListener plugin * Writing a SendListener plugin * Writing a BeforeCommandListener plugin * Writing a CommandListener plugin * Writing a ResponseListener plugin