PHP Mail

config/_init.php

$GLOBALS['domain_emailmode']=0; //0=mail by server, 1=PHPMailer $GLOBALS['domain_testemail']="<this email can be used several times>"; $GLOBALS['domain_email']=array( "activate"=>array( // activation email "subject"=>"activate your account", "content"=>"Dear member,<br>please activate your account: <a href=\"{{activation_link}}\">activation link</a><br>Greetings<br>{{domain_name}}" ), "sendPwd"=>array( // send password "subject"=>"new password", "content"=>"Dear member,<br>your new password: {{password}}<br>Greetings<br>{{domain_name}}" ), "template"=>array( "subject"=>"template", "content"=>"Dear member,<br>{{content}}<br>Greetings<br>{{domain_name}}" ) );

The default domain_emailmode is set to "1: email by PHPmailer". Please fill out your email configuration in the _init.php.

If the domain_emailmode is set to "0: email by server": please look to your Server Email Configuration and check the configuration.

The default domain_testemail can be used for several user as test. Please regard that "Send Password" is not working well in this case.

domain_email allows to configure:

• activate, Activation email
• sendPwd, Send password email

For both:

• subject
• content

can be declared. The content supports HTML-emails.

The template can be used for further necessary emails.

config/_init.php

$GLOBALS['domain_PHPMailer']=array( "from"=>"<email address>", // sender email address "fromname"=>"Jane Doe", // sender name "host"=>"smtp.gmail.com", // Outgoing mail server (SMTP) "SMTPAuth"=>true, // SMTP Authentication activated "username"=>"<email address>", // SMTP username "password"=>"<password>", // SMTP password "SMTPSecure"=>"ssl", // 'ssl' or 'tls' (465 or 587) "port"=>465 // Port of Outgoing mail server (SMTP) );

The default domain_emailmode is set to "1: PHPMailer". Please continue with the configuration for your email server. For example for a google email server it is important to configure an App-Password for third party access (description of App Password configuration).

More information to:

• PHPMailer

<projectpath>/_init.json

"domain_PHPMailer":{ "from":"<email address>", "fromname":"Jane Doe", "host":"smtp.gmail.com", "SMTPAuth":true, "username":"<email address>", "password":"<password>", "SMTPSecure":"ssl", "port":465 }

This is the same definitiion written in JSON format.

// configure email let dat_email={}; dat_email['to']="eisert.klaus@gmail.com"; dat_email['subject']="Test"; dat_email['content']="This is a test email." dat_email['url']=GLOBALS_hostpath+'masterdata/ProcessMethod.php?process_action=sendEmail'; // action postData(dat_email['url'],dat_email).then((oJson) => { if(oJson.bok){ k8.message(getl('send!'),'saved'); console.log("send"); }else{ k8.message(getl("not send: ")+oJson.error,'alert'); console.log("not send: "+oJson.error); } }).catch(function (err) { k8.message(err,'alert'); console.warn('fetch error ', err); });

domain_emailrights

• 0: no emails
• 1: to logged in user only (default)
• 2: logged in to every one
• 3: role: 32
• 4: own email configuration (future)

Parameters:

• to
• cc
• bcc
• subject
• message: this is the whole email body
• content: uses the template

$to="<recipients email>"; $dat=array( "cc"=>"emails, separated by komma, for copy", "bcc"=>"emails, separated by komma, for blind copy", "subject"=>"<your subject>", "content"=>"<your content> (template is used)", "message"=>"or <your message>", "PHPMailer"=>array( // customer email access data "from"=>"<email address>", // sender email address ... ) ); $email=new eMailbyPHPMailer($to,$dat); $file="<your file with path>"; if($email->bprepareAttachment($file,1)){ if($email->bsend()){ return 1; }else{ $this->error=$email->getError(); return 0; } }else{ $this->error=$email->getError(); return 0; }

If you want to use PHPMailer for own emails even by your customer, you can declare PHPMailer like this and transfer the customer mail server access data.

Email templates allow you to conveniently create and format templates.

Action

The name for the email, should be the action, which it's used for.

Language

You can define different languages for one action.

Bcc

if necessary send the email to blind copy.

Content

The Content can be formated with this editor (tinymce). Placeholders can be used like this {{placeholder}}. By sending the email, they are exchanged for the value of the data record. The content is inserted in the global email template.

Message

The message is equivalent to the content. This message is send as email body. It should have also a signature.

Images

Images can be uploaded by the image icon, "Upload". The image can be resized by the image handler. It's saved in the upload folder and the complete url is linked in the image tag.

The ediors above use absolut path with (datadefinition.masterdata.seofriendly: true).

Your datadefintion :

{ "head_include": [ "{{projectpath}}/{{datadefID}}/{{datadefID}}_head_include.php" ], }

The file: {{datadefID}}_head_include.php is included. This includes the email templates into your web site.

the include for php:

<script> <?php $data_emailtemplates=array(); $clause=""; $mydatadefID='k8emailtemplates';$error=''; $o_emailtemplates=getDatadefinition($mydatadefID,$error,"",0,"",1,false,-1); if($o_emailtemplates->getentries($clause))$data_emailtemplates=$o_emailtemplates->data; $bdefault=true; echo 'var data_emailtemplates='.json_encode($data_emailtemplates); ?> </script>

The variable data_emailtemplates is declared in JavaScript. It's an array with all defined templates.

JavaScript excerp of callback cbmenuleft of reclamationapprovals:

// dat: object reclamationapprovals // dat_emailtemplate: object emailtemplates // dat_reclamations: object reclamations // dat_email: object for the email, which is send dat['statustext']=""; if(Number(dat.status)==0){ dat['statustext']=getl('Your reclamation is pending.'); }else if(Number(dat.status)==1){ dat['statustext']=getl('Your reclamation is approved.'); }else if(Number(dat.status)==2){ dat['statustext']=getl('Your reclamation is rejected.'); } let dat_emailtemplate = data_emailtemplates.find(col => col.action === "reclamation_approval"); if(!dat_emailtemplate){ k8.message("email template: reclamation_approval is not defined",'alert'); return; } let dat_email={}; dat_email['to']=dat_reclamations.email; dat_email['bcc']=dat_emailtemplate['bcc']; dat['title']=dat_reclamations.title; dat_email['subject']=ReplacePlaceholder(dat_emailtemplate.subject,dat,2); dat_email['message']=ReplacePlaceholder(dat_emailtemplate.message,dat,2); dat_email['url']=GLOBALS_hostpath+'masterdata/ProcessMethod.php?process_action=sendEmail'; // action postData(dat_email['url'],dat_email).then((oJson) => { if(oJson.bok){ k8.message(getl('send!'),'saved'); row_actual.update({'emailsend':true}); // save url=GLOBALS_hostpath+settings.masterdata.url_save; dat={'approvalID':dat.approvalID,'emailsend':1}; postData(url,dat).then((obj) => { //console.log(obj); if(obj.bok){ //k8.message(getl('Saved'),'saved'); }else{ k8.message(obj.error,'alert'); } }); }else{ k8.message(getl("not send: ")+oJson.error,'alert'); //console.log("not send: "+oJson.error); } }).catch(function (err) { k8.message(err,'alert'); console.warn('fetch error ', err); });

Process

• statustext: prepare the status text
• dat_emailtemplates: filter the template reclamation_approval from array
• prepare the data for the email, dat_email:
  • to
  • bcc
  • subject
  • message
• command PHP to send the email
• set emailsend in the recclamationapprovals
• set recclamationapprovals