Разрботка расширений для CMS Joomla

Седова Яна Анатольевна

Для чего используется класс JHTMLForm?

Код каких элементов генерируют методы класса JHTMLGrid?

В чем преимущество использования класса JHTMLImage?

Для чего используются классы JHTMLList и JHTMLSelect?

Упражнения

Адаптируйте код из раздела " Практика" для своего варианта (см. список вариантов в дополнительных материалах).

Иерархия пунктов меню. Отправка писем. Классы ядра JEditor, JURI, JError, JDate

Рассмотрен принцип хранения иерархии пунктов меню, использующийся

в Joomla. Рассмотрены классы для отправки электронной почты, отображения кода визуального редактора, работы с URI, ошибками и датами.

Цель лекции:Ознакомиться со способом программного добавления пунктов меню в Joomla, а также с некоторыми методами классов JMail, JEditor, JURI, JError, JDate.

Организация иерархии пунктов меню в Joomla

Для хранения иерархии пунктов меню в Joomla используются вложенные множества (ссылка: http://en.wikipedia.org/wiki/Nested_set_model). Например, на рис. 4.1 представлена эта иерархия для случая, если бы в ней было всего восемь пунктов: корневой пункт меню Menu_Item_Root, com_bannersс подпунктами com_banners, com_banners_categories, com_banners_clientsи com_messagesс подпунктами com_messages_add, com_messages_read:

(есть увеличенное изображение)

Рис. 4.1. Пример использования вложенных множеств для организации иерархии пунктов меню

Каждому элементу иерархии соответствуют два числа - левый и правый ключи.

Для каждого пункта в таблице #__menuхранится idродителя parent_id, уровень levelи левый и правый ключи lftи rgt. На рис. 4.2 оранжевым цветом показаны id, синим - уровни, красным - левые и правые ключи.

(есть увеличенное изображение)

Рис. 4.2. Данные, хранящиеся для каждого пункта меню как элемента иерархии

Отправка писем (класс JMail)

Класс JMail предназначен для создания и отправки электронных писем. JMail поддерживает три механизма отправки почты: функцию PHP mail, Sendmail и SMTP.

Доступ к глобальному объекту JMail можно получить через метод getMailer класса JFactory:

$mailer =& JFactory::getMailer;

Отправитель письма

Для задания отправителя письма используется метод

JMail setSender(mixed $from)

где $from - либо строка, содержащая e-mail отправителя, либо массив, который содержит e-mail и имя отправителя.

Примеры:

//

Первый вариант $mailer =& JFactory::getMailer; $mailer->setSender('[e-mail]'); // Второй вариант $sender = array('[e-mail]', 'Вася') $mailer->setSender($sender);

Правильнее будет не задавать эти значения вручную, а получать их из настроек отправки почты, заданных в панели управления ( "Сайт" - "Общие настройки" - "Сервер"):

$config =& JFactory::getConfig; $sender = array( $config->getValue('config.mailfrom'), $config->getValue('config.fromname')); $mailer->setSender($sender);

Адреса для ответа

Адреса для ответа задаются методом

JMail addReplyTo(array $replyto)

где $replyto - пара e-mail-имя или массив таких пар.

Например:

// Первый вариант $reply = array('[e-mail]', 'Вася'); $mailer->addReplyTo($reply); // Второй вариант $reply0 = array('[e-mail]', 'Вася'); $reply1 = array('[e-mail]', 'Ваня'); $replies = array($reply0, $reply1); $mailer->addReplyTo($replies);

Получатель

Для задания получателя, получателя копии (Carbon Copy) и получателя скрытой копии (Blind Carbon Copy), используются методы

JMail addRecipient(mixed $recipient, mixed name = '') JMail addCC(mixed $cc, mixed name = '') JMail addBCC(mixed $bcc, mixed name = '')

где

$recipient, $cc, $bcc - e-mail или массив, состоящий из e-mail; $name - имя получателя или массив, состоящий из имен.

Для примера зададим в качестве адреса получателя адрес текущего пользователя:

$user =& JFactory::getUser; $mailer->addRecipient($user->email);

Задание нескольких получателей:

$recipient = array('[e-mail]', '[e-mail]'); $mailer->addRecipient($recipient);

Тема, текст, вложения

Тема, текст и вложения письма задаются методами

JMail setSubject(string $subject) JMail setBody(string $content) JMail addAttachment(mixed $attachment, mixed $name = '', mixed $encoding = 'base64', mixed $type = 'application/octet-stream')

где

$subject - строка, содержащая тему письма; $content - строка, содержащая текст письма; $attachment - строка, содержащая путь к файлу, или массив таких строк; $name - строка, содержащая имя файла, или массив таких строк; $encoding - кодировка сообщения: 8bit, 7bit, binary, base64, quoted-printable; $type - MIME-тип файла.

Например:

$mailer->setSubject('Тема письма'); $mailer->setBody("Текст письма"); $mailer->addAttachment(JPATH_COMPONENT.DS.'files'.DS.'document.pdf');

По умолчанию содержимое письма имеет формат plain text. Если вам нужно отправить письмо в формате HTML, используйте метод IsHTML, задающий MIME-тип содержимого письма как text/html:

$mailer->IsHTML(true); $mailer->setBody("Текст письма, содержащий <b>HTML-теги</b>");