Макеты Шаблонов Liferay. Макеты Шаблонов Liferay
 Скачать 236 Kb.
|
|
#if ($selectable) $theme.include($content_include) #else $portletDisplay.recycle() $portletDisplay.setTitle($the_title) $theme.wrapPortlet("portlet.vm", $content_include) #end Этот код создает div меткой портлетов области контента для всех окон портала, который может внести на странице. Первая часть представляет собой сайт-панировочные сухари для пользователей, чтобы легко определить, где страница находится в навигации. $Content_include velociyt атрибут вызывает либо ${PORTAL_ROOT_HOME}/html/portal/layout/view/portlet.jsp или ${PORTAL_ROOT_HOME}/html/portal/layout/edit/portlet.jsp,, который, в свою очередь, вызывает статический метод processTemplate из RuntimePortletUtil.java для генерации применяется шаблон макета и призывает Liferay-портлетов: время выполнения библиотеки тегов рекурсивно оказать всю портлетов загружены на страницу. Мы опишем, как портал страница отображается в более подробно далее в этой главе. Базовая структура шаблон макета В настоящее время мы знаем, что макет можно сделать в презентации портала страницы. Чтобы лучше понять расположение и его структуры, мы будем использовать одну из вне готовых шаблонов Liferay это макет, как например, прежде чем мы на самом деле начать работать на наших собственных шаблонов макета. Давайте посмотрим на следующие выделенные строки в: // ignore details Как вы можете видеть, это XML-файл начинается с версии XML и включает в DTD для параметров макета Шаблоны для Liferay Portal, как в выделенной линией. DOCTYPE определение доступных на http://www.liferay.com/dtd/liferay-layout-templates_6_0_0.dtd указывает, что Есть два типа компоновки шаблонов: стандартные и пользовательские. Оба они имеют тот же набор параметров. В соответствии с определением DTD, каждый макет-шаблон включает в себя шаблон-элемент пути, WAP-шаблонов элемент пути, дополнительно миниатюр-элементу, и необязательный элемент ролей. Необязательный элемент ролей содержит список имен ролей, которые обозначают имена ролей безопасности в Liferay Portal. Пользователи, у которых какой-либо из этих ролей будет в состоянии применить этот шаблон макета, чтобы страницы портала. Каждый может использовать этот макет шаблона, если никакой роли имена установлены. Liferay вне окна стандартных шаблонов макета Прежде чем обсуждать стандартные шаблоны компоновки, давайте взглянем на окно портала окно состояния. Как определено в javax.portlet.WindowState.java, Есть три стандартных состояния окна портлета, указанных в спецификации JSR 168 портлета. WindowState.MAXIMIZED: развернутое окно государство признак того, что портлет может быть только портлетов, оказываемые на странице портала, или что портлет больше места по сравнению с другими портлетов на странице портала. WindowState.MINIMIZED: когда портлет в свернутом состоянии окна, окна портала должны только оказывать минимальное выход или не выход на всех. WindowState.NORMAL: нормальное состояние окна указывает, что портлет может быть обмен на страницу с других портлетов. Есть также два пользовательских Liferay окно состояния, как это определено в: ${PORTAL_ROOT_HOME}/WEB-INF/portlet-custom.xml Эти два состояния пользовательских окна для различных целей: Эксклюзив: пользовательские эксклюзивные состояние окно используется для потоковой передачи двоичных файлов и не оказывают фазы. Это полезно, когда AJAX используется для вызова сервером и получить данные обновляются в течение конкретной области портлетов без обновления всей страницы портала. pop_up: Есть два вида pop_up окна: Плавающий pop_up дел и оконные pop_up. В случае плавающей pop_up дел, нам нужно иметь WindowState набор параметров для LiferayWindowstate.EXCLUSIVE того, чтобы сделать асинхронный вызов URL портлета. С другой стороны, окна pop_up такие как Печать страницы портлета загружалась в новом окне браузера. Pop_up портлет должен иметь свой WindowState параметра в URL портлетов установлен в LiferayWindowState.POP_UP. Трое из выше стандартных и нестандартных состояниях окна определены в следующий файл в Liferay: exclusive, maximized, и pop_up. com.liferay.portal.kernel.portlet.LiferayWindowState.java Соответственно, Есть три стандартных шаблонов макета в Liferay: эксклюзивные, не более, и pop_up, которые показаны в ${PORTAL_ROOT_HOME}/WEB-INF/liferay-layout-templates.xml файл, как показано ниже: Файлы из этих трех из собственного окна стандартных шаблонов макета находятся в ${PORTAL_ROOT_HOME}/layouttpl/standard каталог серии. Файлы TPL и. PNG файлы. Как показано на следующем exclusive.tpl файл, шаблон макета включает CSS определений, таких как окна портала колонки в некоторых дел теги для управления разметкой пользовательского интерфейса. Ключ кода для обработки содержания портлетов в рамках каждого макета столбец по выделенной линии. $processor.processMax("portlet-column-content portlet-column-content-only") Если вы сравните файл один стандартный шаблон макета, такие как эксклюзивный, с соответствующим файлом другого стандартный шаблон макета, такие как pop_up, вы обнаружите, что они точно так же. Разница с сервером обработки. Liferay вне окна пользовательских шаблонов макета Как и выше трех из собственного окна стандартных шаблонов макета, Есть десять из собственного окна пользовательских шаблонов макета определены в: ${PORTAL_ROOT_HOME}/WEB-INF/liferay-layout-templates.xml // ignore details Эти десять из собственного окна пользовательских шаблонов макета доступны для пользователей с правом разрешения (Manage Pages permission) для применения в индивидуальном порядке на странице портала. Их исходные коды находятся в the ${PORTAL_ROOT_HOME}/layouttpl/custom каталогов в виде серии. TPL файлов и. PNG файлы. Подобно файлу в стандартные шаблоны компоновки, скорость метод $ processor.processColumn в каждом файле TPL играет ключевую роль в создании портлетов содержание в частности идентификатор столбца, как показано в следующем фрагменте кода: $processor.processColumn("column-1", "portlet-column-content portlet-column-content-only") Создание нового пользовательского макета Теперь мы знаем, что шаблон макета составляет около, что он делает, и как применять одну из вне окна пользовательских шаблонов Liferay в расположение на странице портала. Настало время для нас, чтобы создать наш собственный пользовательский шаблон макета. Создание макета шаблонов производится в подобной манере к созданию портлеты и темы. Это может быть выполнено с помощью плагинов Liferay SDK. Создание скелета шаблон макета в Plugins SDK Существует layouttpl папки внутри Liferay Плагины SDK, где все новые шаблоны компоновки проживают. SDK предоставляет скрипт для создания скелета нового шаблона макета. Чтобы создать новый шаблон макета, вы запускаете команду в этой папке layouttpl похож на тот, который вы используете для создания нового портала или тему. Теперь перейдите к ${liferay.plugins.sdk.home}/layouttpl папку и запустите сценарий создания, как: Для Windows: create Для Unix / Linux / Mac: ./create.sh Где Например, следующая команда, чтобы создать пустой скелет 1_3 макет Колонны на Windows: C:\workspace_6.0.5_book\liferay-plugins-sdk-6.0.5\layouttpl>create 1_3_columns "1_3 Columns" Liferay предлагает Liferay IDE как плагин Eclipse. Вы можете использовать Liferay IDE для создания шаблона макета, включая скелет папки и файлы, созданные сценарии выполняются в приведенной выше команде. Теперь вы можете пойти в Windows Explorer и заметили, что шаблон макета папку с именем 1_3_columns-layouttpl был создан автоматически при ${liferay.plugins.sdk.home}/layouttpl папку. Имя папки совпадает с именем шаблона макета, который был указан в качестве первого элемента ввода в командный сценарий создания, с-layouttpl добавляется к концу имени шаблона макета. Она имеет следующие скелета:  Вы заметите, следующие три файла в папке DOCROOT Вашего макета шаблона: 1_3_columns.tpl: Это файл шаблона макета для регулярного веб-браузеров. 1_3_columns.wap.tpl: Это файл шаблона макета для мобильных устройств. 1_3_columns.png: Это стандартный образ миниатюры из того, что раскладка выглядит следующим образом. Это миниатюр отображается, когда пользователь портала с правым кликов разрешение на управление | Макет страницы страницы из меню Dockbar. Liferay может автоматически определять клиента, который будет использоваться для подключения к узлу портала и подать соответствующий шаблон. Если клиент мобильного устройства, он будет служить 1_3_columns.wap.tpl файл. В противном случае, он будет служить 1_3_columns.tpl файл для обычных веб-браузер. Добавление собственной реализации в файлы шаблона макета Оба выше порожденных 1_3_columns.tpl и 1_3_columns.wap.tpl файлы пустые. 1_3_columns.png по умолчанию изображение, которое не представляет фактическое шаблон макета, мы должны создать. Следующие шаги, чтобы добавить свои коды на два файла шаблона. Открытое 1_3_columns.tpl файл в выбранной редактор, добавьте следующие коды, а затем сохранить его.
Пожалуйста, обратите внимание, что этот шаблон макета в два ряда: первый ряд имеет только одну колонку и второй ряд состоит из трех одинаково широкий столбцов. Каждая клетка определяется строк и столбцов имеет уникальный идентификатор, например, колонка-1, колонка-2, колонка-3, а в графе-4. Этот уникальный идентификатор важно для придания этому праву портлетов (ы) в нужное место на странице портала, где этот шаблон макета был применен. Теперь мы копируем и тот же код из 1_3_columns.tpl к 1_3_columns.wap.tpl файл. Вы можете изменить 1_3_columns.wap.tpl файл, как вы хотите, чтобы освежить дизайн шаблон макета для мобильных устройств. В-третьих, мы должны сделать, заключается в использовании программа для работы с изображениями, таких как GIMP или Adobe Photoshop для создания 1_3_columns.png, что выглядит так, как шаблон макета должно выглядеть. Строительство и регистрации шаблон макета Теперь у нас есть все необходимые файлы на месте. Откройте командную строку, перейдите в каталог ${liferay.plugins.sdk.home}/layouttpl/1_3_columns-layouttpl папку, а затем запустить ant у для построения пользовательских шаблонов макета в WAR-файл, который будет скопирован в ${liferay.plugins.sdk.home}/dist папку. ant команда также скопировать сгенерированный 1_3_columns-layouttpl- Теперь войти в систему как администратор портала и убедитесь, вновь созданный шаблон макета, который был зарегистрирован в Liferay портал, как показано на Manage | Page Layout страницы:  Следующим шагом является создание Test Page с именем пробной страницы, применять вновь созданный шаблон макета на этой странице, и добавить несколько примеров портлетов в каждой ячейке строки и столбца. Вы можете видеть, что этот новый макет был успешно создан, развернутых в применении к тестовой странице, как показано на следующем скриншоте:  | ||||||