(PureBasic) Send HTML Email with Image to iPhone

Demonstrates how to compose an HTML email with an embedded image that will display correctly on an iPhone. This example produces an email that looks like this on the iPhone:

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkStringBuilder.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    ; This example requires the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    ; The mailman object is used for sending and receiving email.
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Use your SMTP server hostname.  This example uses office365, but it could be any SMTP server..
    CkMailMan::setCkSmtpHost(mailman, "outlook.office365.com")
    CkMailMan::setCkSmtpPort(mailman, 587)
    CkMailMan::setCkStartTLS(mailman, 1)

    ; Set the SMTP login/password
    CkMailMan::setCkSmtpUsername(mailman, "OFFICE365-SMTP-LOGIN")
    CkMailMan::setCkSmtpPassword(mailman, "OFFICE365-SMTP-PASSWORD")

    ; Create a new email object
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Testing for Chilkat SMTP API...")
    CkEmail::setCkBody(email, "Testing for Chilkat SMTP API...")
    CkEmail::setCkFrom(email, "Chilkat Support <my-office365-user@mydomain.com>")
    CkEmail::ckAddTo(email,"Chilkat Support","support@chilkatsoft.com")

    ; For whatever reason, the iPhone's email program requires
    ; images in HTML to be referenced by Content-ID.  Therefore,
    ; we must add the image like this:
    contentIdStarfish.s = CkEmail::ckAddRelatedFile(email,"qa_data/jpg/starfish.jpg")
    If CkEmail::ckLastMethodSuccess(email) <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; The src attribute for the image tag is set to the contentIdStarfish:
    sbHtml.i = CkStringBuilder::ckCreate()
    If sbHtml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppend(sbHtml,"<html><body><p>This is an HTML email with an embedded image.</p>")
    CkStringBuilder::ckAppend(sbHtml,"<p><img src=" + Chr(34) + "cid:CONTENT_ID_STARFISH" + Chr(34) + " /></p></body></html>")
    numReplacements.i = CkStringBuilder::ckReplace(sbHtml,"CONTENT_ID_STARFISH",contentIdStarfish)

    CkEmail::ckSetHtmlBody(email,CkStringBuilder::ckGetAsString(sbHtml))

    success.i = CkMailMan::ckSendEmail(mailman,email)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mailman)
    Else
        Debug "Mail Sent!"
    EndIf



    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)
    CkStringBuilder::ckDispose(sbHtml)


    ProcedureReturn
EndProcedure