zen_mail - How does it work?

[cmessa]

I am trying to customize a module and it uses Zen_mail. For some reason it is not sending the email, but also not throwing an error. So I am stumped as to what is wrong. I think I have the zen_mail configured wrong, but I can't find all the parameters that I am supposed to have and what ones are optional. Is there some documentation on this? What about documents on other Zen Cart functions?

Thanks,
Corbett

[MeltDown]

There is some pretty good emain documentation in:
/shop/docs/4.readme_html_email_templates.html

I don't know off-hand if it applies to your situation.

Good luck!

Tim

[DrByte]

You could also look up the function in the functions_email.php file to see what the various parameters do.

[cmessa]

Thanks for all the input. I am going to check out both docs and see if I can get this thing working.

Corbett

[cmessa]

I thought I had the info that I needed from the .php file above, but it still will not send this email. Does anyone have a working line of code that does not use any constants? Do you know what parameters I can leave out? I think I am having problems with the array, but not sure. I get no email and not error....

If I could try another working line of code, then I could add my code in one parameter at a time until it breaks.

thanks,
Cmessa

[DrByte]

From the inline documentation:

 * @param string $to_name           The name of the recipient, e.g. "Jim Johanssen"
 * @param string $to_email_address  The eMail address of the recipient, e.g. [email protected]
 *                                  (used as $to_email_address after validation)
 * @param string $email_subject     The subject of the eMail
 * @param string $email_text        The text of the eMail, may contain HTML entities
 * @param string $from_email_name   The name of the sender, e.g. Shop Administration
 * @param string $from_email_adrdess The eMail address of the sender, e.g. [email protected]
 * @param array  $block             Array containing values to be inserted into HTML-based email template
 * @param string $module            The module name of the routine calling zen_mail. Used for html template selection and email archiving.
 *                                  This is passed to the archive function denoting what module initiated the sending of the email
 * @param array  $attachments_list  Array of attachment names/mime-types to be included  (this portion still in testing, and not fully reliable)
**/
zen_mail($to_name, $to_address, $email_subject, $email_text, $from_email_name, $from_email_address, $block=array(), $module='default', $attachments_list='' )

So, the example then becomes:

zen_mail( Name-of-recipient, 
Email-of-recipient, 
Email-subject, 
Text-Only-Content, 
Name-of-Sender, 
Email-of-sender,
Array-of-HTML-content-variables-to-be-replaced-by-HTML-Email-templates
)

The $module and $attachments_list are optional.
Actually, the HTML array $block is also optional if you're sending text-only emails.