Collaboration diagram for ilMimeMail:

Public Member Functions
	__construct ()
	ilMimeMail constructor. More...

	Subject ($subject, $a_add_prefix=false)

	getSubject ()

	From (ilMailMimeSender $sender)

	To ($to)
	Set the mail recipient. More...

	Cc ($cc)
	Set the cc mail recipient. More...

	Bcc ($bcc)
	Set the bcc mail recipient. More...

	getTo ()

	getCc ()

	getBcc ()

	Body ($body)

	getFinalBody ()

	getFinalBodyAlt ()

	getFrom ()

	Attach ($filename, $file_type='', $disposition='inline', $display_name=null)
	Attach a file to the mail. More...

	getAttachments ()

	getImages ()

	Send ($transport=null)

Static Public Member Functions
static	setDefaultTransport ($transport)

static	getDefaultTransport ()

Protected Member Functions
	build ()
	Build the relevant email data. More...

	buildBodyParts ($skin)

	getHtmlEnvelope ($skin)

	buildHtmlInlineImages ($skin)

Protected Attributes
	$subject = ''

	$body = ''

	$finalBody = ''

	$finalBodyAlt = ''

	$sendto = array()

	$acc = array()

	$abcc = array()

	$images = array()

	$aattach = array()

	$actype = array()

	$adispo = array()

	$adisplay = array()

	$sender

Static Protected Attributes
static	$defaultTransport

Detailed Description

Class ilMimeMail.

Definition at line 7 of file class.ilMimeMail.php.

Constructor & Destructor Documentation

◆ __construct()

ilMimeMail::__construct ( )

ilMimeMail constructor.

Definition at line 84 of file class.ilMimeMail.php.

    {
        global $DIC;
 
        if (!(self::getDefaultTransport() instanceof \ilMailMimeTransport)) {
            $factory = $DIC["mail.mime.transport.factory"];
            self::setDefaultTransport($factory->getTransport());
        }
    }

References $DIC, $factory, and setDefaultTransport().

Here is the call graph for this function:

Member Function Documentation

◆ Attach()

ilMimeMail::Attach	(	$filename,
		$file_type = `''`,
		$disposition = `'inline'`,
		$display_name = `null`
	)

Attach a file to the mail.

Parameters

string	$filename	Path of the file to attach
string	$file_type	MIME-type of the file. default to 'application/x-unknown-content-type'
string	$disposition	Instruct the Mailclient to display the file if possible ("inline") or always as a link ("attachment") possible values are "inline", "attachment"
string	$display_name	Filename to use in email (if different from source file)

Definition at line 254 of file class.ilMimeMail.php.

    {
        if ($file_type == '') {
            $file_type = 'application/octet-stream';
        }
 
        $this->aattach[]  = $filename;
        $this->actype[]   = $file_type;
        $this->adispo[]   = $disposition;
        $this->adisplay[] = $display_name;
    }

References $filename.

◆ Bcc()

ilMimeMail::Bcc ( $bcc )

Set the bcc mail recipient.

Parameters

string|array BCC email address, accept both a single address or an array of addresses

Definition at line 182 of file class.ilMimeMail.php.

    {
        if (is_array($bcc)) {
            $this->abcc = $bcc;
        } else {
            $this->abcc[] = $bcc;
        }
    }

◆ Body()

ilMimeMail::Body ( $body )

Parameters

string $body

Definition at line 218 of file class.ilMimeMail.php.

    {
        $this->body = $body;
    }

References $body.

◆ build()

ilMimeMail::build ( )

protected

Build the relevant email data.

Definition at line 301 of file class.ilMimeMail.php.

    {
        global $DIC;
 
        $this->finalBodyAlt = '';
        $this->finalBody    = '';
        $this->images       = array();
 
        if ($DIC->settings()->get('mail_send_html', 0)) {
            $skin = $DIC['ilClientIniFile']->readVariable('layout', 'skin');
 
            $this->buildBodyParts($skin);
            $this->buildHtmlInlineImages($skin);
        } else {
            $this->finalBody = $this->body;
        }
    }

References $body, $DIC, buildBodyParts(), and buildHtmlInlineImages().

Referenced by Send().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildBodyParts()

ilMimeMail::buildBodyParts ( $skin )

protected

Parameters

string $skin

Definition at line 322 of file class.ilMimeMail.php.

    {
        if (0 == strlen($this->body)) {
            $this->body = ' ';
        }
 
        if (strip_tags($this->body, '<b><u><i><a>') == $this->body) {
            // Let's assume(!) that there is no HTML (except certain tags, e.g. used for object title formatting, where the consumer is not aware of this), so convert "\n" to "<br>"
            $this->finalBodyAlt = $this->body;
            $this->body         = \ilUtil::makeClickable(nl2br($this->body));
        } else {
            // if there is HTML, convert "<br>" to "\n" and strip tags for plain text alternative
            $this->finalBodyAlt = strip_tags(str_ireplace(array("<br />", "<br>", "<br/>"), "\n", $this->body));
        }
 
        $this->finalBody = str_replace('{PLACEHOLDER}', $this->body, $this->getHtmlEnvelope($skin));
    }

References $body, getHtmlEnvelope(), and ilUtil\makeClickable().

Referenced by build().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ buildHtmlInlineImages()

ilMimeMail::buildHtmlInlineImages ( $skin )

protected

Parameters

string $skin

Definition at line 362 of file class.ilMimeMail.php.

    {
        $this->gatherImagesFromDirectory('./Services/Mail/templates/default/img');
 
        if ($skin != 'default') {
            $skinDirectory = './Customizing/global/skin/' . $skin . '/Services/Mail/img';
            if (is_dir($skinDirectory) && is_readable($skinDirectory)) {
                $this->gatherImagesFromDirectory($skinDirectory, true);
            }
        }
    }

Referenced by build().

Here is the caller graph for this function:

◆ Cc()

ilMimeMail::Cc ( $cc )

Set the cc mail recipient.

Parameters

string|array CC email address, accept both a single address or an array of addresses

Definition at line 169 of file class.ilMimeMail.php.

    {
        if (is_array($cc)) {
            $this->acc = $cc;
        } else {
            $this->acc[] = $cc;
        }
    }

◆ From()

ilMimeMail::From ( ilMailMimeSender $sender )

Parameters

ilMailMimeSender $sender

Definition at line 147 of file class.ilMimeMail.php.

    {
        $this->sender = $sender;
    }

References $sender.

◆ getAttachments()

ilMimeMail::getAttachments ( )

Returns: array An array of attachments. Each element must container to associative keys, 'path' and 'name'

Definition at line 269 of file class.ilMimeMail.php.

    {
        $attachments = array();
 
        $i = 0;
        foreach ($this->aattach as $attachment) {
            $name = '';
            if (isset($this->adisplay[$i]) && strlen($this->adisplay[$i]) > 0) {
                $name = $this->adisplay[$i];
            }
 
            $attachments[] = array(
                'path' => $attachment,
                'name' => $name
            );
            ++$i;
        }
 
        return $attachments;
    }

References $i, and $name.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getBcc()

ilMimeMail::getBcc ( )

Returns: array

Definition at line 210 of file class.ilMimeMail.php.

    {
        return $this->abcc;
    }

References $abcc.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getCc()

ilMimeMail::getCc ( )

Returns: array

Definition at line 202 of file class.ilMimeMail.php.

    {
        return $this->acc;
    }

References $acc.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getDefaultTransport()

static ilMimeMail::getDefaultTransport ( )

static

Returns: \ilMailMimeTransport|null

Definition at line 113 of file class.ilMimeMail.php.

    {
        return self::$defaultTransport;
    }

References $defaultTransport.

Referenced by Send().

Here is the caller graph for this function:

◆ getFinalBody()

ilMimeMail::getFinalBody ( )

Returns: string

Definition at line 226 of file class.ilMimeMail.php.

    {
        return $this->finalBody;
    }

References $finalBody.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getFinalBodyAlt()

ilMimeMail::getFinalBodyAlt ( )

Returns: string

Definition at line 234 of file class.ilMimeMail.php.

    {
        return $this->finalBodyAlt;
    }

References $finalBodyAlt.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getFrom()

ilMimeMail::getFrom ( )

Returns: ilMailMimeSender

Definition at line 242 of file class.ilMimeMail.php.

    {
        return $this->sender;
    }

References $sender.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getHtmlEnvelope()

ilMimeMail::getHtmlEnvelope ( $skin )

protected

Parameters

string $skin

Returns: string

Definition at line 344 of file class.ilMimeMail.php.

    {
        $bracket_path = './Services/Mail/templates/default/tpl.html_mail_template.html';
 
        if ($skin != 'default') {
            $tplpath = './Customizing/global/skin/' . $skin . '/Services/Mail/tpl.html_mail_template.html';
 
            if (file_exists($tplpath)) {
                $bracket_path = './Customizing/global/skin/' . $skin . '/Services/Mail/tpl.html_mail_template.html';
            }
        }
 
        return file_get_contents($bracket_path);
    }

Referenced by buildBodyParts().

Here is the caller graph for this function:

◆ getImages()

ilMimeMail::getImages ( )

Returns: array An array of images. Each element must container to associative keys, 'path', 'cid' and 'name'

Definition at line 293 of file class.ilMimeMail.php.

    {
        return array_values($this->images);
    }

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getSubject()

ilMimeMail::getSubject ( )

Returns: string

Definition at line 139 of file class.ilMimeMail.php.

    {
        return $this->subject;
    }

References $subject.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ getTo()

ilMimeMail::getTo ( )

Returns: array

Definition at line 194 of file class.ilMimeMail.php.

    {
        return $this->sendto;
    }

References $sendto.

Referenced by ilMailMimeTransportBase\send().

Here is the caller graph for this function:

◆ Send()

ilMimeMail::Send ( $transport = null )

Parameters

$transport \ilMailMimeTransport|null

Returns: bool A boolean flag whether or not the transport might be successful

Definition at line 402 of file class.ilMimeMail.php.

    {
        if (!($transport instanceof \ilMailMimeTransport)) {
            $transport = self::getDefaultTransport();
        }
 
        $this->build();
 
        return $transport->send($this);
    }

References build(), and getDefaultTransport().

Here is the call graph for this function:

◆ setDefaultTransport()

static ilMimeMail::setDefaultTransport ( $transport )

static

Parameters

\ilMailMimeTransport | null $transport

Exceptions

InvalidArgumentException

Definition at line 98 of file class.ilMimeMail.php.

    {
        if (!is_null($transport) && !($transport instanceof \ilMailMimeTransport)) {
            throw new \InvalidArgumentException(\sprintf(
                "The passed argument must be null or of type 'ilMailMimeTransport', %s given!",
                gettype($transport)
            ));
        }
 
        self::$defaultTransport = $transport;
    }

References sprintf.

Referenced by __construct(), and ilMailMimeTest\setUp().

Here is the caller graph for this function:

◆ Subject()

ilMimeMail::Subject	(	$subject,
		$a_add_prefix = `false`
	)

Parameters

string	$subject	Define the subject line of the email
bool	$a_add_prefix

Definition at line 122 of file class.ilMimeMail.php.

    {
        if ($a_add_prefix) {
            // #9096
            require_once 'Services/Mail/classes/class.ilMail.php';
            $prefix = ilMail::getSubjectPrefix();
            if (trim($prefix)) {
                $subject = trim($prefix) . ' ' . $subject;
            }
        }
 
        $this->subject = $subject;
    }

References $subject, and ilMail\getSubjectPrefix().

Here is the call graph for this function:

◆ To()

ilMimeMail::To ( $to )

Set the mail recipient.

Parameters

string|array To email address, accept both a single address or an array of addresses

Definition at line 156 of file class.ilMimeMail.php.

    {
        if (is_array($to)) {
            $this->sendto = $to;
        } else {
            $this->sendto[] = $to;
        }
    }

Field Documentation

◆ $aattach

ilMimeMail::$aattach = array()

protected

Definition at line 59 of file class.ilMimeMail.php.

◆ $abcc

ilMimeMail::$abcc = array()

protected

Definition at line 48 of file class.ilMimeMail.php.

Referenced by getBcc().

◆ $acc

ilMimeMail::$acc = array()

protected

Definition at line 43 of file class.ilMimeMail.php.

Referenced by getCc().

◆ $actype

ilMimeMail::$actype = array()

protected

Definition at line 64 of file class.ilMimeMail.php.

◆ $adisplay

ilMimeMail::$adisplay = array()

protected

Definition at line 74 of file class.ilMimeMail.php.

◆ $adispo

ilMimeMail::$adispo = array()

protected

Definition at line 69 of file class.ilMimeMail.php.

◆ $body

ilMimeMail::$body = ''

protected

Definition at line 22 of file class.ilMimeMail.php.

Referenced by Body(), build(), and buildBodyParts().

◆ $defaultTransport

ilMimeMail::$defaultTransport

staticprotected

Definition at line 12 of file class.ilMimeMail.php.

Referenced by getDefaultTransport().

◆ $finalBody

ilMimeMail::$finalBody = ''

protected

Definition at line 27 of file class.ilMimeMail.php.

Referenced by getFinalBody().

◆ $finalBodyAlt

ilMimeMail::$finalBodyAlt = ''

protected

Definition at line 32 of file class.ilMimeMail.php.

Referenced by getFinalBodyAlt().

◆ $images

ilMimeMail::$images = array()

protected

Definition at line 53 of file class.ilMimeMail.php.

◆ $sender

ilMimeMail::$sender

protected

Definition at line 79 of file class.ilMimeMail.php.

Referenced by From(), and getFrom().

◆ $sendto

ilMimeMail::$sendto = array()

protected

Definition at line 38 of file class.ilMimeMail.php.

Referenced by getTo().

◆ $subject

ilMimeMail::$subject = ''

protected

Definition at line 17 of file class.ilMimeMail.php.

Referenced by getSubject(), and Subject().

The documentation for this class was generated from the following file:

Services/Mail/classes/class.ilMimeMail.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ Attach()

◆ Bcc()

◆ Body()

◆ build()

◆ buildBodyParts()

◆ buildHtmlInlineImages()

◆ Cc()

◆ From()

◆ getAttachments()

◆ getBcc()

◆ getCc()

◆ getDefaultTransport()

◆ getFinalBody()

◆ getFinalBodyAlt()

◆ getFrom()

◆ getHtmlEnvelope()

◆ getImages()

◆ getSubject()

◆ getTo()

◆ Send()

◆ setDefaultTransport()

◆ Subject()

◆ To()

Field Documentation

◆ $aattach

◆ $abcc

◆ $acc

◆ $actype

◆ $adisplay

◆ $adispo

◆ $body

◆ $defaultTransport

◆ $finalBody

◆ $finalBodyAlt

◆ $images

◆ $sender

◆ $sendto

◆ $subject