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

Автор книги: Яна Седова

сообщить о нарушении

Текущая страница: 3 (всего у книги 10 страниц)

Проверив, что код вызван из Joomla, мы используем выражение require_once(JApplicationHelper::getPath('admin_html')) для подключения файла admin.myquestions.html.php.

Затем с помощью JTable::addIncludePath() папка tables добавляется к списку директорий, в которых следует искать классы таблиц.

Переключатель switch() вызывает функцию, соответствующую значению переменной $task.

В функции replyToQuestion() создается экземпляр класса TableQuestion для управления записью таблицы. С помощью JRequest::getVar() из переменных запроса извлекается массив cid, хранящий идентификаторы записей. Так как эксперт будет отвечать только на один вопрос за раз, то мы выбираем первый идентификатор и загружаем соответствующую запись. Затем она передается в функцию вывода HTML_questions::replyToQuestion().

Теперь создайте файл /administrator/components/com_myquestions/admin.myquestions.html.php:

:
:	date,JText::_('DATE_FORMAT_LC3'));?>
:	display('question', $row->question, '100%', '250', '40', '10');?>
:
:
:	IP;?>
:
:	published == '1') echo JText::_('JYES'); else echo JText::_('JNO');?>
:	expiration_date, 'expiration_date', 'expiration_date', '%Y-%m-%d');?>
:	senttoexpert == '1') echo JText::_('JYES'); else echo JText::_('JNO');?>
:	display('answer', $row->answer,'100%', '250', '40', '10');?>
:	senttoauthor == '1') echo JText::_('JYES'); else echo JText::_('JNO');?>

Листинг .

Функция HTML_questions::replyToQuestion() выводит на экран уже заполненную форму, значения элементов которой берутся из объекта $row. Форме присвоено название adminForm, чтобы к ней можно было обращаться из JavaScript.

Классы JHTML и JEditor будут рассмотрены позже. Сейчас поясним только те выражения, в которых используются методы этих классов:

echo JHTML::_('date', $row->date,JText::_('DATE_FORMAT_LC3')); выводит дату $row->date в формате DATE_FORMAT_LC3 (один из стандартных форматов, заданных в Joomla).

$editor =& JFactory::getEditor(); echo $editor->display('question', $row->question, '100%', '250', '40', '10'); отображает выбранный администратором HTML-редактор. Если не выбран ни один редактор, то будет отображено поле . В редакторе или поле <textarea> будет выведено значение $row->question.</p> <p>echo JHTML::_('calendar', $row->expiration_date, 'expiration_date', 'expiration_date', '%Y-%m-%d'); выводит текстовое поле со значением $row->expiration_date и пиктограмму календаря, при нажатии на которую появляется календарь для выбора даты.</p> <p>Перед закрывающим тегом </form> выводятся три скрытые элемента. Первый из них хранит значение id записи, т.к. оно необходимо для дальнейшего сохранения отредактированного вопроса. Элемент option хранит название текущего компонента для правильного редиректа в дальнейшем. Третьему скрытому элементу, task, не присвоено значения, чтобы JavaScript-код панели инструментов мог изменять его до отправки формы.</p> <p>Осталось добавить перевод ключей COM_MYQUESTIONS_AUTHOR, COM_MYQUESTIONS_DATE и др. Откройте файл <b>/administrator/language/ru-RU/ru-RU.com_myquestions.ini</b>и добавьте к его содержимому следующий код:</p> <p>COM_MYQUESTIONS_AUTHOR="Автор" COM_MYQUESTIONS_DATE="Дата вопроса" COM_MYQUESTIONS_QUESTION="Текст вопроса" COM_MYQUESTIONS_CITY="Город" COM_MYQUESTIONS_EMAIL="e-mail" COM_MYQUESTIONS_IP="IP-адрес" COM_MYQUESTIONS_CATEGORY="Категория" COM_MYQUESTIONS_PUBLISHED="Отображать ли вопрос на сайте" COM_MYQUESTIONS_EXPIRATION_DATE="Дата снятия вопроса с публикации" COM_MYQUESTIONS_SENTTOEXPERT="Отправлен ли вопрос эксперту" COM_MYQUESTIONS_ANSWER="Ответ" COM_MYQUESTIONS_SENTTOAUTHOR="Отправлен ли ответ автору вопроса"</p> <p>Обратите внимание, что мы не задали перевод для слов "Да" и "Нет", а использовали ключи JYES и JNO, т.к. подобные распространенные слова уже переведены в файле <b>/administrator/language/ru-RU/ru-RU.ini</b>.</p> <p>Наберите в адресной строке браузера ссылку ссылка: <b>http://localhost/joomla/administrator/index.php?option=com_myquestions&task=reply&cid[]=1</b>. Должна появиться следующая страница (рис. 2.1).</p> <p><img alt="" src="_11.jpg"/></p> <p>(есть увеличенное изображение)</p> <p><b>Рис. 2.1.</b>  Фрагмент формы для ответа на вопрос</p> <p><b>Сохранение введенных данных</b></p> <p>После того, как эксперт напечатал ответ на заданный вопрос и нажал кнопку " <b>Сохранить</b>", необходимо сохранить информацию в базе данных. Прежде всего, создайте две функции – save() и saveQuestion() – в файле <b>admin.myquestions.php</b>:</p> <p>function save() { $row =& JTable::getInstance('question', 'Table'); if (!$row->bind(JRequest::get('post'))) { echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n"; exit(); } $row->question = JRequest::getVar('question', '', 'post', 'string', JREQUEST_ALLOWRAW); $row->answer = JRequest::getVar('answer', '', 'post', 'string', JREQUEST_ALLOWRAW); if (!$row->store()) { echo "<script> alert('".$row->getError()."'); window.history.go(-1); </script>n"; exit(); } return $row; } function saveQuestion($option, $task) { $row = save(); global $app; if ($task == 'save') $app->redirect('index.php?option='.$option, JText::_('COM_MYQUESTIONS_REPLY_SAVED')); else if ($task == 'apply') $app->redirect('index.php?option='.$option.'&task= reply&cid[]='.$row->id, JText::_('COM_MYQUESTIONS_REPLY_SAVED')); }</p> <p>Переменной $row присваивается значение экземпляра класса TableQuestion и вызывается функция bind() для связывания переменных, полученных из формы, с полями этого класса.</p> <p>Для тех значений, которые вводились с помощью редактора Joomla, стандартный способ получения значений из массива JRequest::get('post') не подходит, т.к. функция bind() автоматически удаляет HTML-код, что приведет, в частности, к потере разрывов строк и тегов абзаца. Поэтому для получения значений question и answer в том виде, в котором они были введены в редакторе, используется функция getVar() класса JRequest. Данной функции передается имя переменной формы, значение по умолчанию, метод запроса, с помощью которого мы хотим получить данные (get/post), ожидаемый формат и флаг JREQUEST_ALLOWRAW, означающий, что данные не должны быть отфильтрованы.</p> <p>Наконец, вызывается функция store() для сохранения вопроса в базе данных.</p> <p>В функции saveQuestion() происходит вызов функции save(), а затем в зависимости от задачи, т.е. от того, какая кнопка была нажата, – " <b>Сохранить</b>" или " <b>Сохранить и закрыть</b>", – мы перенаправляем пользователя либо к той же странице редактирования вопроса, на которой он находится, но уже с сохраненными данными, либо к главной странице нашего компонента. В обоих случаях выводится сообщение о том, что данные были сохранены. Для перенаправления и вывода сообщения используется функция redirect() глобального объекта JApplication.</p> <p>Добавьте задачу сохранения записи в переключатель switch() в файле <b>admin.myquestions.php</b>(выделенный код):</p> <p><img alt="" src="_12.jpg"/></p> <p>Добавьте перевод для ключа COM_MYQUESTIONS_REPLY_SAVED в файл <b>/administrator/language/ru-RU/ru-RU.com_myquestions.ini</b>:</p> <p>COM_MYQUESTIONS_REPLY_SAVED="Данные сохранены"</p> <p>Сохраните все ваши файлы и перейдите по ссылке ссылка: <b>http://localhost/joomla/administrator/index.php?option=com_myquestions&task=reply&cid[]=1</b>. Напишите что-нибудь в поле для ответа и нажмите кнопку " <b>Сохранить и закрыть</b>". Вы должны увидеть следующую страницу (рис. 2.2).</p> <p><img alt="" src="_13.jpg"/></p> <p>(есть увеличенное изображение)</p> <p><b>Рис. 2.2.</b>  Результат сохранения ответа на вопрос</p> <p>С помощью phpMyAdmin вы можете проверить, что данные были сохранены в таблице базы данных jos_myquestions (рис. 2.3).</p> <p><img alt="" src="_14.jpg"/></p> <p>(есть увеличенное изображение)</p> <p><b>Рис. 2.3.</b>  Ответ на вопрос сохранен в базе данных</p> <p><b>Вывод списка записей</b></p> <p>Прежде всего, добавьте в файл <b>admin.myquestions.php</b>следующую функцию:</p> <p>function showQuestions($option) { $db =& JFactory::getDbo(); $query = "SELECT * FROM #__myquestions"; $db->setQuery($query); $rows = $db->loadObjectList(); if ($db->getErrorNum()) { echo $db->stderr(); return false; } HTML_questions::showQuestions($option, $rows); }</p> <p>Эта функция загружает все записи из таблицы #__myquestions и передает их в виде массива $rows в следующую функцию, которую необходимо добавить в файл <b>admin.myquestions.html.php</b>в класс HTML_questions:</p> <p>function showQuestions($option, &$rows) { $maxlen = 100; ?> <form action="index.php" method="post" name="adminForm"> <table class="adminlist"> <thead> <tr> <th width="20"> <input type="checkbox" name="toggle" value="" onclick="checkAll(<?php echo count($rows);?>);"/> </th> <th class="title"><?php echo JText::_('COM_MYQUESTIONS_AUTHOR');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_DATE');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_QUESTION');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_EMAIL');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_PUBLISHED');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_EXPIRATION_DATE');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_SENTTOEXPERT');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_ANSWER');?></th> <th><?php echo JText::_('COM_MYQUESTIONS_SENTTOAUTHOR');?></th> </tr> </thead> <?php jimport('joomla.filter.output'); $k = 0; for ($i = 0, $n = count($rows); $i < $n; $i ++) { $row = &$rows[$i]; $checked = JHTML::_('grid.id', $i, $row->id); $link = JFilterOutput::ampReplace('index.php?option=' .$option . '&task=reply&cid[]='. $row->id); ?> <tr class="<?php echo "row$k";?>"> <td><?=$checked?></td> <td><?=$row->name?></td> <td><?=JHTML::_('date', $row->date, JText::_('DATE_FORMAT_LC3'))?></td> <td><?=''.substr(strip_tags($row->question), 0,$maxlen-1).''?></td> <td><?=$row->email?></td> <td align="center"> <?php if ($row->published == '1') echo JText::_('JYES'); else echo JText::_('JNO');?> </td> <td> <?php if ($row->expiration_date == '0000-00-00 00:00:00') echo JText::_('COM_MYQUESTIONS_DATE_NOT_DEFINED'); else echo JHTML::_('date', $row->expiration_date, JText::_('DATE_FORMAT_LC3'));?> </td> <td align="center"> <?php if ($row->senttoexpert == '1') echo JText::_('JYES'); else echo JText::_('JNO');?> </td> <td><?=substr(strip_tags($row->answer),0,$maxlen-1)?></td> <td align="center"> <?php if ($row->senttoauthor == '1') echo JText::_('JYES'); else echo JText::_('JNO'); ?> </td> </tr> <?php $k = 1 – $k; } ?> </table> <input type="hidden" name="option" value="<?php echo $option;?>"/> <input type="hidden" name="task" value=""/> <input type= "hidden" name="boxchecked" value="0"/> </form> <?php } Листинг .</p> <p>Записи выводятся в таблице, для которой задан CSS-класс adminlist. Все заголовки таблицы, кроме первого, – это обычный текст. Первый заголовок является чекбоксом и используется для одновременного выделения всех отображенных записей.</p> <p>Затем начинается цикл для вывода самих записей. Значение переменной $k меняется с 0 на 1 и обратно для того, чтобы переключаться между различными классами CSS для четных и нечетных строк, имеющими немного различающиеся свойства фона. С помощью вызова функции JHTML::_('grid.id') мы получаем HTML-код для чекбокса, который будет обрабатываться с помощью JavaScript.</p> <p>Для каждого вопроса и ответа выводятся первые maxlen символов вместо его текста целиком. При этом с помощью функции strip_tags() отбрасываются теги, чтобы предотвратить ситуацию, когда граница обрезки текста может оказаться внутри тега.</p> <p>Для перехода к форме ответа на вопрос для каждой записи выводится гиперссылка, которая пропускается через функцию JFilterOutput::ampReplace(), заменяющую амперсанды "&" на коды "&" в соответствии со спецификацией XHTML. Для подключения класса JFilterOutput в код вставлена строка jimport('joomla.filter.output').</p> <p>Перед закрывающим тегом </form> расположены три скрытых элемента. Option и task были рассмотрены при анализе формы для ответа на вопрос. Значение boxchecked заключается в следующем. Когда пользователь ставит флажок в каком-либо из чекбоксов, значение boxchecked меняется на 1. Значение boxchecked, равное 0, возвращается, когда ни один из чекбоксов не отмечен. С помощью этого значения JavaScript обрабатывает список.</p> <p>Для обработки случая, когда не выбрано никакой задачи, измените код переключателя switch в файле <b>admin.myquestions.php</b>следующим образом:</p> <p>switch($task) { case 'reply': replyToQuestion($option); break; case 'save': case 'apply': saveQuestion($option, $task); break; default: showQuestions($option); break; }</p> <p>Добавьте в файл <b>/administrator/language/ru-RU/ru-RU.com_myquestions.ini</b>строку:</p> <p>COM_MYQUESTIONS_DATE_NOT_DEFINED="Дата не задана"</p> <p>Теперь при загрузке ссылка: <b>http://localhost/joomla/administrator/index.php?option=com_myquestions</b>должна появиться страница, как на рис. 2.4.</p> <p><img alt="" src="_15.jpg"/></p> <p>(есть увеличенное изображение)</p> <p><b>Рис. 2.4.</b>  Список вопросов</p> <p><b>Удаление записей</b></p> <p>Добавьте следующий оператор case в переключатель switch() в файле <b>admin.myquestions.php</b>:</p> <p>case 'remove': removeQuestions($option); break;</p> <p>Также добавьте функцию removeQuestions():</p> <p>function removeQuestions($option) { global $app; $cid = JRequest::getVar('cid', array(), '', 'array'); $db =& JFactory::getDbo(); if(count($cid)) { $cids = implode(',', $cid); $query = "DELETE FROM #__myquestions WHERE id IN ($cids)"; $db->setQuery($query); if (!$db->query()) { echo "<script> alert('".$db->getErrorMsg()."'); window.history.go(-1); </script>n"; } } $app->redirect('index.php?option=' . $option, JText::_('COM_MYQUESTIONS_QUESTION_DELETED')); }</p> <p>Если в массиве cid есть элементы, то составляется строка из идентификаторов, разделенных запятыми, которая затем используется для построения запроса удаления соответствующих записей. В данном случае нельзя использовать метод JTable::delete(), т.к. он предназначен для удаления одной записи, а не нескольких.</p> <p>Добавьте в файл <b>/administrator/language/ru-RU/ru-RU.com_myquestions.ini</b>строку:</p> <p>COM_MYQUESTIONS_QUESTION_DELETED="Вопрос(ы) успешно удален(ы)"</p> <p><b>Ключевые термины</b></p> <p>JDatabase – абстрактный класс, предоставляющий доступ к соединению с базой данных, создающемуся при инициализации приложения Joomla. JDatabaseQuery – класс, методы которого совпадают с ключевыми словами языка SQL и позволяют упростить создание сложных SQL-запросов. JTable – класс, реализующий паттерн Active Record и использующийся для управления таблицами базы данных. Префикс таблиц базы данных – строка, которая присоединяется к названию каждой таблицы Joomla в базе данных. Реальный префикс – то конкретное сочетание символов, которое используется в названиях таблиц базы данных. Связывание – процесс присвоения каждому полю производного от JTable класса значения элемента массива переменных запроса, так что ключ элемента совпадает с названием поля. Символический префикс – сочетание "#__" (решетка и два знака подчеркивания), которое используется в запросах вместо реального префикса.</p> <p><b>Краткие итоги</b></p> <p>При работе с базой данных различают реальный и символический префиксы. Реальный префикс используется в названиях таблиц базы данных, а символический префикс ("#__") используется в запросах вместо реального префикса. При обработке запроса вместо символического префикса будет автоматически подставлен реальный.</p> <p>Чтобы выполнить запрос к базе данных Joomla, необходимо осуществить пять операций: получение ссылки на объект JDatabase (абстрактный класс, предоставляющий доступ к соединению с базой данных), формирование запроса, задание запроса, выполнение запроса, загрузка результата.</p> <p>Запрос может быть сформулирован в виде строки либо разбит на составляющие и построен с помощью методов класса JDatabaseQuery.</p> <p>Запрос задается для последующего выполнения методом setQuery(), а выполняется либо методом query(), либо, если нам необходимо получить результат, одним из методов для получения форматированного результата: loadResult(), loadRow() и т.д.</p> <p>Для каждой таблицы, использующейся расширением, необходимо создать класс, производный от JTable. Для каждого поля таблицы необходимо создать одноименное поле этого класса. Производный от JTable класс наследует в числе прочих методы bind(), store(), load() и delete(), позволяющие управлять записями таблицы без единой строки SQL-кода. Когда компонент получает массив переменных запроса, он осуществляет связывание, то есть присваивает каждому полю этого класса значение элемента массива, ключ которого совпадает с названием данного поля.</p> <p>Существуют методы класса JTable для управления часто используемыми полями ordering, checked_out/checked_out_time, published и hits.</p> <p><b>Вопросы</b></p> <p>Что такое реальный и символический префиксы?</p> <p>Какие операции необходимо осуществить для выполнения запроса к базе данных Joomla?</p> <p>Каким образом может быть сформулирован SQL-запрос?</p> <p>Какие методы задают и выполняют запрос?</p> <p>Для чего создается производный от JTable класс?</p> <p>В чем заключается связывание?</p> <p>Каким образом осуществляется управления часто используемыми полями?</p> <p><b>Упражнения</b></p> <p>Адаптируйте код из раздела " <b>Практика</b>" для своего варианта (см. список вариантов в дополнительных материалах).</p> <p><b>Генерация элементов HTML (класс JHTML)</b></p> <p>Лекция посвящена классу JHTML и поддерживающим классам. Рассмотрены методы для вывода элементов XHTML.</p> <p></p> <p><b>Цель лекции:</b>Изучить готовые методы Joomla для генерации и отображения элементов XHTML и поведений JavaScript.</p> <p><b>Основной метод класса JHTML</b></p> <p>Joomla содержит методы для генерации и отображения элементов XHTML и поведений JavaScript. Эти методы вызываются с помощью</p> <p>mixed _(string $type)</p> <p>Несмотря на то, что в прототипе метода JHTML::_() указан всего один параметр, на практике их, как правило, бывает больше. Они интерпретируются так: по первому параметру метод _() определяет, какой метод необходимо вызвать, а остальные параметры передаются в этот метод.</p> <p>Параметр $type может быть трех видов:</p> <p>Название метода самого класса JHTML. Например, $type = 'image' приведет к вызову JHTML::image().</p> <p><имя файла>.<имя метода>. Будет вызван метод поддерживающего класса JHTML<Имя файла>.<имя метода>(). В имени поддерживающего класса первая буква <имени файла> станет заглавной. Например, если $type='select.genericlist', то будет вызван метод JHTMLSelect::genericlist().</p> <p><префикс>.<имя файла>.<имя метода> и будет вызван метод <префикс>.<Имя файла>.<имя метода>().</p> <p><b>Методы класса JHTML</b></p> <p>Класс JHTML содержит восемь методов для вывода элементов XHTML.</p> <p><b>Поле для ввода даты и пиктограмма, по щелчку на которой появляется календарь</b></p> <p>string calendar(string $value, string $name, string $id, string $format = '%Y-%m-%d', array $attribs = null)</p> <p>где:</p> <p>$value – значение даты; $name – имя текстового поля; $id – id текстового поля; $format – формат даты; $attribs – дополнительные атрибуты, которые должны быть выведены в теге <input>.</p> <p>Для примера выведем текущую дату (рис. 3.1):</p> <p>echo JHTML::_('calendar', date('Y-m-d',time()), 'created', 'created', '%Y-%m-%d', array('size'=>10,'style'=>"class='inputbox'"));</p> <p><img alt="" src="_16.jpg"/></p> <p><b>Рис. 3.1.</b>  Поле для ввода даты и пиктограмма для вывода календаря</p> <p><b>Строка, содержащая дату в заданном формате и часовом поясе</b></p> <p>string date(string $input = 'now', string $format = null, mixed $tz = true, bool $gregorian=false)</p> <p>где:</p> <p>$input – строка в формате, подходящем для функции date(); $format – формат, к которому необходимо привести дату; $tz – одна из временных зон, поддерживаемых PHP (их список можно найти на странице ссылка: <b>http://www.php.net/manual/ru/timezones.php</b>). Кроме того, $tz может иметь логическое значение: при $tz=true временная зона берется из настроек пользователя, при $tz=false – из настроек сервера; $gregorian – при false для форматирования даты будет использоваться локальный календарь.</p> <p>Для примера выведем текущую дату:</p> <p>echo JHTML::_('date',date('Y-m-d',time()), 'Y-m-d h:m', 'Europe/Moscow', false);</p> <p><b>Элемент <iframe></iframe></b></p> <p>string iframe(string $url, string $name, array $attribs = null, string $noFrames = '')</p> <p>где</p> <p>$url – относительный URL, будущее значение атрибута src; $name – название будущего элемента <iframe>; $attribs – ассоциативный массив атрибутов будущего тега <iframe>; $noFrames – содержимое будущего тега: текст, который будет показан, если браузер не поддерживает тег <iframe>.</p> <p>Пример:</p> <p>echo JHTML::_('iframe','index.php', 'myelement', array('width'=>500,'height'=>300), 'Ваш браузер не поддерживает плавающие фреймы');</p> <p><b>Элемент <img></img></b></p> <p>string image(string $file, string $alt, mixed $attribs = null, bool $relative = false, bool $path_only = false)</p> <p>где</p> <p>$file – абсолютный или относительный URL изображения; $alt – альтернативный текст; $attribs – ассоциативный массив атрибутов будущего тега (может быть задан сразу в виде строки, например: "width="100%" height="100%""); $relative – перебирать ли варианты пути к файлу; $path_only – возвращать ли только путь к изображению или тег <img> со всеми атрибутами.</p> <p>Для методов image(), script() и stylesheet() будет выполнена следующая процедура поиска файла. Если $file начинается с «http», то метод просто вернет $file. В противном случае он производит поиск файла, перебирая возможные варианты его названия в зависимости от браузера пользователя. Например, для значения «/pics/pic.png» и браузера Mozilla 5.0 будут перебираться варианты «/pics/pic.png», «/pics/pic_mozilla.png», «/pics/pic_mozilla_5.png», «/pics/pic_mozilla_5_0.png». При $relative=true перебираются также различные варианты пути к файлу в папке текущего шаблона и папке /media. В противном случае метод будет искать файл <b>JPATH_ROOT/<имя файла></b>для каждого варианта названия файла.</p> <p>Например, следующий код</p> <p>echo JHTML::_('image','req.png','Восклицательный знак', array('width'=>25,'height'=>25), true, false);</p> <p>выведет</p> <p><img src="/joomla/templates/beez_20/images/req.png" alt="Восклицательный знак" width="25" height="25"/></p> <p>Если последним параметром указать true, то эта же строка выведет на экран</p> <p>/joomla/templates/beez_20/images/req.png</p> <p>Обратите внимание, что этот путь мы не задавали, его обнаружил метод image().</p> <p><b>Элемент <a></a></b></p> <p>string link(string $url, string $text, array $attribs = null)</p> <p>где:</p> <p>$text – текст ссылки; $attribs – ассоциативный массив атрибутов будущего тега.</p> <p>Пример:</p> <p>echo JHTML::_('link','index.php','На главную страницу', array('title'=>'На главную','id'=>'linktomainpage'));</p> <p><b>Элемент <script></script></b></p> <p>mixed script(string $file, bool $framework = false, bool $relative = false, bool $path_only = false, bool $detect_browser = true)</p> <p>где</p> <p>$file – путь к файлу; $framework – загружать ли фреймворк Javascript; $path_only – возвращать путь к файлу или добавить все найденные файлы к текущему документу; $detect_browser – определять ли браузер пользователя для включения файлов Javascript для этого браузера.</p> <p>При $path_only=false метод не возвращает никакого значения.</p> <p>Пример:</p> <p>echo JHTML::_('script', 'media/system/js/calendar.js', false, false, true, false);</p> <p><b>Элемент <link rel="stylesheet" style="text/css"/></b></p> <p>mixed stylesheet(string $file, array $attribs = array(), bool $relative = false, bool $path_only = false, bool $detect_browser = true)</p> <p>Все параметры аналогичны рассмотренным выше.</p> <p>Пример:</p> <p>echo JHTML::_('stylesheet', 'media/system/css/system.css', array("title"=>"Название стиля","media"=>"screen, print"), false, true, false);</p> <p><b>Всплывающая подсказка</b></p> <p>string tooltip(string $tooltip, mixed $title = '', string $image = 'tooltip.png', string $text = '', string $href = '', string $alt = 'Tooltip', string $class = 'hasTip')</p> <p>где</p> <p>$tooltip – текст подсказки; $title – название подсказки или ассоциативный массив с ключами title, image, text, href, alt и соответствующими значениями; $image – изображение, для которого будет выводиться подсказка (если не задано значение $text); $text – текст, для которого будет выводиться подсказка (если не задано значение $image); $href – URL, на который будет произведен переход по щелчку на изображение или текст; $alt – значение атрибута alt тега <img>; $class – название класса элемента <span>, в который будет заключен тег <img>.</p> <p>Изображение с подсказкой:</p> <p>echo JHTML::tooltip('Текст подсказки', 'Заголовок подсказки', 'tooltip.png', '', 'http://www.mysite.ru');</p> <p>Текст с подсказкой:</p> <p>echo JHTML::tooltip('Текст подсказки', 'Заголовок подсказки', '', 'Наведите на этот текст курсор мыши, чтобы увидеть подсказку');</p> <p><b>Поддерживающие классы</b></p> <p>Рассмотрим некоторые методы поддерживающих классов. Полный список этих методов можно найти в документации, однако на текущий момент она не достаточно полная и содержит ошибки, поэтому для детальной справки по какому-либо методу вы можете обратиться напрямую к исходным кодам в папке <b>/libraries/joomla/html/html</b>.</p> <p><b>JHTMLBehavior</b></p> <p>Методы этого класса загружают код Javascript в заголовок документа. Методы JHTMLBehavior позволяют вывести календарь, дерево элементов, файловый загрузчик и некоторые другие элементы управления. Рассмотрим один из методов, позволяющий вывести всплывающее модальное окно без перезагрузки страницы:</p> <p>void modal(string $selector = 'a.modal', array $params = array())</p> <p>где</p> <p>$selector – селектор класса; $params – массив параметров, ключи которого могут быть следующими: ajaxOptions, size, shadow, onOpen, onClose, onUpdate, onResize, onShow, onHide.</p> <p>В следующем примере выводятся две ссылки. При нажатии на первую из них появляется всплывающее окно с изображением, на вторую – с веб-страницей.</p> <p><?php JHTML::_('behavior.modal'); ?> Щелкните, чтобы увидеть изображение<br/> Щелкните, чтобы открылось окно с веб-страницей</p> <p>Первое окно выглядит так, как на рис. 3.2.</p> <p><img alt="" src="_17.jpg"/></p> <p>(есть увеличенное изображение)</p> <p><b>Рис. 3.2.</b>  Модальное окно</p> <p><b>JHTMLEmail</b></p> <p>Содержит один метод для скрытия адреса электронной почты в целях его защиты от спам-ботов:</p> <p>string cloak(string $mail, bool $mailto=1, string $text='', bool $email=1)</p> <p>где</p> <p>$mail – e-mail; $mailto – выводить ли e-mail в виде ссылки … или в виде текста; $text – текст этой ссылки; $email – является ли $text адресом электронной почты.</p> <p>Пример:</p> <p>echo JHtml::_('email.cloak', 'admin@mysite.ru', 1, 'Написать администратору', 0);</p> <p><b>JHTMLForm</b></p> <p>Содержит один метод, который возвращает код скрытого поля формы для уменьшения риска CSRF-атак: string token()</p> <p>Именем получившегося элемента формы станет сгенерированная случайным образом строка, которая используется для проверки того, что запрос был сделан из конкретных формы и сессии.</p> <p>Для предотвращения CSRF-атак вставляйте в каждую форму своего компонента строку:</p> <p><?php echo JHTML::_('form.token');?></p> <p><b>JHTMLGrid</b></p> <p>Методы данного класса используются для вывода в таблице в панели управления таких элементов, как чекбокс, пиктограмма для переключения состояния " <b>опубликовано"/"не опубликовано</b>", для отображения заголовка столбца как ссылки для сортировки по этому столбцу и др.</p> <p>Таблица должна располагаться внутри формы под названием adminForm, обязательно включающей два скрытых поля: boxchecked со значением по умолчанию 0 и task.</p> <p>Для создания чекбокса используется метод</p> <p>mixed id(int $rowNum, int $recId, bool $checkedOut=false, string $name='cid')</p> <p>где</p> <p>$rowNum – номер строки в таблице; $recId – id записи; $checkedOut – отмечен ли элемент; $name – имя элемента формы.</p> <p>Метод возвращает html-код чекбокса, если элемент не отмечен, и пустую строку в противном случае.</p> <p>Для создания пиктограммы, по щелчку на которой можно изменять значение поля published с 0 на 1 и обратно, используется</p> <p>string published(mixed $value, int $i, string $img1 = 'tick.png', string $img0 = 'publish_x.png', string $prefix='')</p> <p>где</p> <p>$value – объект или только значение поля published; $i – номер строки в таблице; $img1 – изображение при published = 1; $img0 – изображение при published = 0; $prefix – префикс, который будет добавлен к названиям по умолчанию задач publish/unpublish.</p> <p>Для примера выведем элементы массива $rows как строки таблицы, добавив для каждой записи ячейки с чекбоксом и значком <b>«опубликовано»/"не опубликовано"</b>:</p> <p>$k = 0; for ($i = 0, $n = count($rows); $i < $n; $i ++) { $row = &$rows[$i]; ?> <tr class="<?="row$k"?>"> <td><?=JHTML::_('grid.id', $i, $row->id)?></td> <td><?=$row->name?></td> <td align="center"><?=JHTML::_('grid.published', $row, $i)?></td> </tr> <?php $k = 1 – $k; }</p> <div class="book_page_link"><a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova.html">Назад к карточке книги "Разрботка расширений для CMS Joomla"</a></div> </div> <div class="navigation"><b>Страницы книги >>> </b> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-2.html">Предыдущая</a> | <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-1.html">1</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-2.html">2</a> <span class="cur_page"><b>3</b></span> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-4.html">4</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-5.html">5</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-6.html">6</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-7.html">7</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-8.html">8</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-9.html">9</a> <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-10.html">10</a> | <a href="https://itexts.net/avtor-yana-anatolevna-sedova/130279-razrbotka-rasshireniy-dlya-cms-joomla-yana-sedova/read/page-4.html">Следующая</a></div> <div style="text-align:center;margin:20px 0"> <script type="text/javascript"> if (mobileDevice){ document.write('<!-- Yandex.RTB R-A-386345-10 -->\ <div id="yandex_rtb_R-A-386345-10"></div>\ <script>window.yaContextCb.push(()=>{\ Ya.Context.AdvManager.render({\ renderTo: \'yandex_rtb_R-A-386345-10\',\ blockId: \'R-A-386345-10\'\ })\ })</scr' + 'ipt>'); } else{ document.write('<!-- Yandex.RTB R-A-386345-9 -->\ <div id="yandex_rtb_R-A-386345-9"></div>\ <script>window.yaContextCb.push(()=>{\ Ya.Context.AdvManager.render({\ renderTo: \'yandex_rtb_R-A-386345-9\',\ blockId: \'R-A-386345-9\'\ })\ })</scr' + 'ipt>'); } </script> </div> <br style="clear:both"> <ul class="fullnews-options-bottom"> <div style="margin:8px;float:left;font-weight:bold">Ваша оценка произведения:</div><li class="fullnews-rate"><div id='ratig-layer-130279'><div class="rating"> <ul class="unit-rating"> <li class="current-rating" style="width:0%;">0</li> <li><a href="#" title="Плохо" class="r1-unit" onclick="doRate('1', '130279'); return false;">1</a></li> <li><a href="#" title="Приемлемо" class="r2-unit" onclick="doRate('2', '130279'); return false;">2</a></li> <li><a href="#" title="Средне" class="r3-unit" onclick="doRate('3', '130279'); return false;">3</a></li> <li><a href="#" title="Хорошо" class="r4-unit" onclick="doRate('4', '130279'); return false;">4</a></li> <li><a href="#" title="Отлично" class="r5-unit" onclick="doRate('5', '130279'); return false;">5</a></li> </ul> </div></div></li> </ul> <div class="related"> <div class="std-block-title-fullnews"> <div class="std-block-title2-fullnews"> <h4>Почитать похожее на эту книгу</h4> </div> </div> <div class="related_content"> <div> <a href="https://itexts.net/avtor-dzhim-kollinz/7247-ot-horoshego-k-velikomu-pochemu-odni-kompanii-sovershayut-proryv-a-drugie-net-dzhim-kollinz.html"><img alt="Книга От хорошего к великому. Почему одни компании совершают прорыв, а другие нет... автора Джим Коллинз" border="0" src="//itexts.net/files/books/110/oblozhka-knigi-ot-horoshego-k-velikomu.-pochemu-odni-kompanii-sovershayut-proryv-a-drugie-net.-7247.jpg"></a> <a href="https://itexts.net/avtor-dzhim-kollinz/7247-ot-horoshego-k-velikomu-pochemu-odni-kompanii-sovershayut-proryv-a-drugie-net-dzhim-kollinz.html">От хорошего к великому. Почему одни компании совершают прорыв, а другие нет ...</a><br> <p>Автор: <a href="https://itexts.net/avtor-dzhim-kollinz/">Джим Коллинз</a></p> </div> </div> <br /> </div> </div></div> </div> <div class="std-block-title"> <div class="std-block-title2"> <h4>Популярные книги за неделю</h4> </div> </div> <ul id="bp_slider"> wait_for_cache </ul> <div style="text-align:center"> </div> <!-- Подвал --> <div class="footer"> <div class="footer-text"> <p>При использовании текстов библиотеки ссылка обязательна: <a href="//itexts.net/">itexts.net</a>.<br> Электронная библиотека, © 2018-2024</p> </div> <ul class="footer-banners"> <li style=""><a href="/engine/rss.php">RSS</a>  |  <a target="_blank" href="/opds">OPDS</a>  |  <a rel="nofollow" href="/?do=feedback">Контакты</a>  |  <a rel="nofollow" href="/?do=rules">Правила</a></li> <li> <!-- litres cnt --> </li> <li> </li> <li> <!-- Yandex.Metrika counter --> <script type="text/javascript" > (function(m,e,t,r,i,k,a){m[i]=m[i]||function(){(m[i].a=m[i].a||[]).push(arguments)}; m[i].l=1*new Date();k=e.createElement(t),a=e.getElementsByTagName(t)[0],k.async=1,k.src=r,a.parentNode.insertBefore(k,a)}) (window, document, "script", "https://mc.yandex.ru/metrika/tag.js", "ym"); ym(39505675, "init", { clickmap:true, trackLinks:true, accurateTrackBounce:true }); </script> <noscript><div><img src="https://mc.yandex.ru/watch/39505675" style="position:absolute; left:-9999px;" alt="" /></div></noscript> <!-- /Yandex.Metrika counter --> </li> </ul> </div>  </div> <script type="text/javascript" src="/engine/classes/js/jquery.js"></script> <script type="text/javascript" src="/engine/classes/js/jqueryui.js"></script> <script type="text/javascript" src="/engine/classes/js/dle_js.js"></script> <script type="text/javascript" src="/engine/classes/masha/masha.js"></script> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+"://platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> <script type="text/javascript" src="/templates/UniGray/css/jquery.jcarousel.min.js"></script> <script type="text/javascript" src="/templates/UniGray/css/lib.js"></script> <!-- popup --> <!-- /*{*/include file="popup_2.tpl"/*}*/ --> <!-- end popup --> </body> </html>