creylopez
/
k8s-cluster-projects



								   API docs

								   ¯¯¯¯¯¯¯¯


								Only public methods are documented. All properties are considered private except for

								is_built, which is a boolean and determines whether the message is built or not. This

								can be reset after sending to false, to force rebuilding if sending multiple times.

								If the content of the message doesn't change, rebuilding shouldn't be necessary.


								void htmlMimeMail()


								  Constructor. Simply sets up some defaults. In particular the smtp parameters

								  are initialised to:


								    host -> localhost

								    port -> 25

								    helo -> Either HTTP_HOST, SERVER_NAME, or localhost in that order

								    auth -> false

								    user -> blank

								    pass -> blank


								  Also, the build parameters are initialised to:


								    html_encoding -> quoted-printable

								    text_encoding -> 7bit

								    html_charset  -> ISO-8859-1

								    text_charset  -> ISO-8859-1

								    head_charset  -> ISO-8859-1

								    text_wrap     -> 998


								void setCrlf(string CRLF style)


								  Sets the type of CRLF to use. Usually either \r\n, \n or \r. Don't normally

								  need to call this as the send() function will set it according to what method

								  of sending you're using (SMTP versus PHP mail()).


								void setSMTPParams(string host, integer port, string helo, boolean auth, string user, string pass)


								  Use this if you need to alter the SMTP details. All arguments default to NULL so you

								  if you only need to set one thing you can set the rest to NULL.


								void setTextEncoding(string encoding)


								  Use this method to set the style of encoding for the text part of the message. Can be

								  one of 7bit, 8bit, quoted-printable, and base64. Defaults to 7bit.


								void setHTMLEncoding(string encoding)


								  As above except it applies to the HTML part of the message. Defaults to quoted-printable.


								void setTextCharset(string charset)


								  The character set to use for the text part of the message. Defaults ISO-8859-1.


								void setHTMLCharset(string charset)


								  The character set to use for the HTML part of the message. Defaults ISO-8859-1.


								void setHeadCharset(string charset)


								  The characer set to use when headers are encoded (RFC2047). Defaults to ISO-8859-1.


								void setSubject(string subject)


								  Sets the Subject: header.


								void setFrom(string from)


								  Sets the From: header. This is also used if the return path is not set when sending via

								  SMTP.


								void setCc(string Cc)


								  Sets the Cc: header. This can be multiple addresses.


								void setBcc(string bcc)


								  Sets the Bcc: header. This can be multiple addresses.


								void setText(string text)


								  Sets the text part of the message. Should ONLY be used if you're sending a TEXT ONLY

								  email. See the setHTML() method  for setting the text alternative to a HTML/text email.


								void setHTML(string html, string text, string images_path)


								  Use this method to set the HTML part of your message. The 2nd and 3rd arguments are

								  optional. The second sets the alternative text to the HTML in your message. The third

								  sets a path for the class to look in for any image references it finds in the HTML. If

								  you want to avoid multiple calls to addHTMLImage() you can use this third argument to

								  get the class to look for and auto add images referenced by the HTML. It has restrictions

								  in that the image refs must be quoted (eg. <img src="foo.gif" and not <img src=foo.gif).

								  The extension/content-type mappings are set in the constructor in the property image_types.

								  This property can be added to if necessary, and is not restricted to mere images.


								void addHTMLImage(string filedata, string name, string content_type)


								  Use this method to add an embedded image to your message. The first argument is the file

								  itself (you can use the getFile() method if you have a filename). The second the name of

								  the file, commonly the filename (eg foo.gif). This name must match precisely the name it

								  is referenced by in the HTML. The third argument is the content-type of the file, eg.

								  image/gif.


								void addAttachment(string filedata, string filename, string content_type, string encoding)


								  Use this method to add an attachment to the message. The first three arguments are the

								  same as the method above. The fourth can be used to specify an alternate encoding to

								  base64. This is useful when you're adding attached messages which are better encoded as

								  7bit, (an example of this is in example.5.php).


								boolean buildMessage(array params)


								  Usually you don't need to call this method as it's automatically called by the send()

								  method. However, if you're using the send() method in a loop sending to multiple recipients

								  AND changing the HTML/text/headers each time, then you will need to call this method before

								  calling the send() method to force the email to be rebuilt. The argument is an associative

								  array containing the following options to alter the way the email is built:


								    Array key       Purpose

								    =========       =======

								    html_encoding   Sets the encoding type for HTML. See setHTMLEncoding()

								    text_encoding   Sets the encoding type for text. See setTextEncoding()

								    text_wrap       Sets the default wrap for text parts. Defaults to 998.

								    html_charset    Sets the charset for the HTML part. See setHTMLCharset().

								    text_charset    Sets the charset for the text part. See setTextCharset().

								    head_charset    Sets the charset for encoded headers. See setHeadCharset().


								boolean send(array recipients, string type)


								  This method sends the message. The recipients array is what becomes the To: header. This

								  can be simply an empty array if you've set Cc: or Bcc: headers instead. The second argument

								  determines what method to send the mail via. This can be 'mail' (the default) or 'smtp' to

								  send direct via an SMTP server. In this case the smtp parameters are used to connect to the

								  server. The return value is true or false indicating a successful send or not. With SMTP if

								  there are errors they will be set in the errors property (an array) ie. $obj->errors.


								string getRFC822(array recipients)


								  This method can be used to return a message as a string suitable for adding to another mail

								  object using addAttachment(). The recipients argument is as with the send() method.


								string getFile(string filename)


								  Reads the given filename in and returns it. Use this to read files and add them

								  as attachments or embedded images/objects. See the examples for usages.