http://swiftmailer.org/wikidocs/ 2009-04-15T15:58:17+00:00 http://swiftmailer.org/wikidocs/ http://swiftmailer.org/wikidocs/lib/images/favicon.ico text/html 2009-03-03T05:41:24+00:00 http://swiftmailer.org/wikidocs/v3/sending/basics?rev=1236058884&do=diff Sending messages in Swift is extremely simple. You call the send() method, which only has 3 parameters. One is the message, one is the recipient, and the other is the sender. $swift =& new Swift(new Swift_Connection_SMTP("host.tld")); $message =& new Swift_Message("My subject", "My body"); $sent = $swift->send($message, "recipient@address.tld", "sender@address.tld"); echo "Sent to $sent recipients"; text/html 2007-05-18T18:04:16+00:00 http://swiftmailer.org/wikidocs/v3/sending/batch?rev=1179511456&do=diff When you send out an email marketing campaign, newsletter or any other type of batch email you don't particularly want to reveal everybody's address to the recipients. One nasty hack is to Bcc all the recipients and leave the To: field undisclosed. However, Swift provides a method specially for the purpose of sending out batch emails. text/html 2009-03-03T05:41:24+00:00 http://swiftmailer.org/wikidocs/v3/sending/bounce_address?rev=1236058884&do=diff When using SMTP, you don't always know if the message is going to reach the recipient. If something goes wrong and you're really lucky you'll know about it at SMTP time if the server reports an error; if you're not so lucky, but not completely in the dark, you'll receive an email from a different server saying that something went wrong; and if you're completely unlucky, you'll just be left wondering why you never got a response from the recipient. text/html 2007-05-17T14:19:34+00:00 http://swiftmailer.org/wikidocs/v3/sending/failed_recipients?rev=1179411574&do=diff SMTP does occassionally reject recipient addresses due to malformity, domain conflicts, DNS issues and other problems. If you want to track who got rejected you should enable Swift's logging facility so that these failures can be collected. The failed addresses will be stored in $swift->log->getFailedRecipients() as an array. text/html 2007-05-17T17:20:17+00:00 http://swiftmailer.org/wikidocs/v3/sending/iterators?rev=1179422417&do=diff As you have seen, you can make use of Swift_RecipientList to send a message to multiple recipients. Up until now you've only seen the usage of addTo(), addCc() and addBcc(). You can completely by-pass these methods however. Swift is provided with an iterator to loop over those addresses you have added and calling addTo() for example is simply pushing addresses onto an array. By default Swift_RecipientList will provide an Array iterator so that the values added with addTo(), addCc() and addBc… text/html 2009-03-03T05:41:24+00:00 http://swiftmailer.org/wikidocs/v3/sending/message_ids?rev=1236058884&do=diff Emails can contain a unique ID known as a message ID. As of Swift version 3.1.4, Swift will generate this ID for you on a per-send basis (i.e. when you send a message an ID is created for it). If you want to get the message ID yourself then you should override what Swift does and call the generateId() method of Swift_Message: text/html 2007-12-10T23:37:23+00:00 http://swiftmailer.org/wikidocs/v3/sending/message_priority?rev=1197329843&do=diff The message priority does little more than flag the message in the recipients INBOX as being important or not. To set the priority, you make a change to the message itself. You can provide an integer ranging from 1 (High) to 5 (Low) to indicate the priority. By default, no priority is indicated which equates to a priority of 3 (Normal). The class constants used in the example below map to the relevant integer values of the priority. text/html 2007-03-22T16:17:22+00:00 http://swiftmailer.org/wikidocs/v3/sending/multiple?rev=1174580242&do=diff Sending to multiple recipients, or including Cc and Bcc recipients is handled by passing an instance of Swift_RecipientList as the recipient parameter in send(). Swift_RecipientList() contains the methods addTo(), addCc() and addBcc() along with removeTo(), removeCc() etc. text/html 2009-03-03T05:41:24+00:00 http://swiftmailer.org/wikidocs/v3/sending/read_receipts?rev=1236058884&do=diff Read-Receipts are not very reliable since most emails clients will either prompt, or block them. However, if you do desire to request a read-receipt you should set this in the message itself, before sending: $message =& new Swift_Message("My subject", "My body"); $message->requestReadReceipt("your@address.tld"); text/html 2007-09-11T22:47:49+00:00 http://swiftmailer.org/wikidocs/v3/sending/start?rev=1189550869&do=diff