CakePHP с нуля: создаем тему. Часть 9 из 10

В данном уроке мы продолжим построение приложения с помощью CakePHP. Если вы последовательно выполняли все предыдущие уроки, то у вас должно иметься  функциональное демонстрационное приложение. К настоящему моменту оно имеет вид, заданный по умолчанию CakePHP. Изменим его и установим шаблон, который можно свободно скачать из сети.

Второй задачей будет разделение шаблона и подготовка темы, чтобы в будущем можно было просто изменить дизайн, сменив тему. Очень похоже на смену тем в WordPress.

Шаблон размещен в исходниках. Он выглядит следующим образом:

Шаблон имеет избыточные элементы для нашего приложения. Но это не помешает нам использовать его.

В данном уроке мы будем делать все вручную без использования генератора Bake. Таким образом, будет виден весь процесс и понятно, что происходит с кодом.

Итак, скачайте шаблон в исходниках к уроку (или вы можете использовать свой, что будет даже интереснее). В шаблон включен PSD файл страницы, так что можно его использовать и в других проектах.

Для того чтобы использовать тему вам нужно создать папку, которая будет содержать файлы темы. Переходим в каталог /app/views и создаем новую папку с именем themed. В данной папке создаем папку с именем default. В этой папке будут содержаться файлы нашей темы. Теперь копируем все папки и файлы из каталога /app/views в каталог /app/views/themed/default.

Наши файлы CSS и Javascript будут храниться в каталоге /app/views/themed/default/webroot. Его надо создать, а в нем создать каталоги с именами css, img и js. Копируем файлы CSS из загруженного шаблона в папку /app/views/themed/default/webroot/css и переименовываем файл style.css в default.css. копируем изображения шаблона в папку /app/views/themed/default/webroot/img. Теперь надо открыть файл CSS темы и изменить в нем путь к изображениям на ../img, чтобы браузер смог их найти.

Теперь переходим в каталог /app/views/themed/default/layouts/ и копируем в него файл index.html из загруженного шаблона. Для использования файла в нашей теме его надо переименовать в default.ctp.

Мы проделали предварительную подготовку для формирования темы. Теперь нужно сказать CakePHP, что мы будем использовать тему и указать имя темы. Так как тема будет использоваться во всем нашем приложении, то лучшим местом для ее указания будет контроллер app_controller (контроллер приложения). Контроллер приложения является классом, расширяющим базовый класс CakePHP Controller и вызываемым в каждом контроллере.

Нужно создать файл /app/app_controller.php и поместить в него код:

<?php
class AppController extends Controller {
    public $view   = 'Theme';
    public $theme = 'default';
}
?>

Таким образом, мы изменяем класс View, используемый по умолчанию для каждого контроллера, и указываем на использование класса Theme. Одновременно мы сообщаем CakePHP, что наша тема называется default.

Теперь CakePHP будет искать тему в только что созданных нами папках. Если файлы вида будут отсутствовать в папке темы, то CakePHP будет искать их в папке /app/views/. Таким образом, можно создать мастер файлы видов и просто их модифицировать в теме.

Если сейчас ввести в адресной строке браузера адрес вашего проекта (например, http://localhost/cake/), то вы увидите, что тема уже работает. Вы получите код  HTML загруженного шаблона без использования стилей.

Если закомментировать две строки, которые мы только что добавили в файл app_controller.php и обновить страницу в браузере, то вы увидите шаблон CakePHP по умолчанию. Перейдем к настройке использования CSS.

CSS не работает потому, что путь к файлам неправильный. Нужно открыть файл /app/views/themed/default/layouts/default.ctp. Это шаблон нашего приложения. Вы можете создать столько шаблонов, сколько хочется. Просто размещайте их в папке app/views/layouts (или /app/views/themed/layouts для использования в темах), и переключайтесь между ними в действиях ваших контроллеров с помощью переменной $layout или функции setLayout().

Для начала сменим кодировку:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

Будем изменять шаблон сверху вниз. Сделаем наш заголовок динамическим. Изменяем тег title следующим образом:

<title><?php echo $title_for_layout; ?></title>

$title_for_layout содержит заголовок страницы. Теперь заменяем тег для стилей CSS на строку, которая формирует корректный путь к CSS файлам:

<?php echo $this->Html->css('default'); ?>

Если обновить страницу нашего приложения в браузере, то вы увидите, что CakePHP корректно отображает шаблон и использует тему CSS. Обратите внимание,  что изображения не выводятся, потому что указан неправильный путь. Данный вопрос мы разберем в следующем уроке.

Подправим логотип. Найдите строку:

<a href="/index.html"><img src="/images/logo.gif" alt="Package" width="205" height="62" border="0" class="logo" title="Package" /></a>

и замените ее на:

<?php echo $html->link($html->image("logo.gif"), array('controller'=>'jobs', 'action' => 'index'), array('escape' => false)); ?>

Обновите вашу страницу, и вы увидите логотип.

Теперь удалим меню из файла default.ctp и создадим новый элемент для навигации.

Вырежьте (удалите с копированием в буфер) следующий код:

<!--Navigation Background Part Starts -->
<div id="navigation-bg">
	<!--Navigation Part Starts -->
	<div id="navigation">
		<ul class="mainMenu">
			<li><a href="#" class="selectMenu" title="Home">Home</a></li>
			<li><a href="#" title="About">About</a></li>
			<li><a href="#" title="Services">Services</a></li>
			<li><a href="#" title="Support">Support</a></li>
			<li><a href="#" title="Chat">Chat</a></li>
			<li><a href="#" title="History">History</a></li>
			<li class="noBg"><a href="#" title="Contact">Contact</a></li>
		</ul>
		<a href="#" class="signup" title="signup now"></a>
		<br class="spacer" />
		<!-- <ul class="subNav">
			<li class="noBg"><a href="#" title="Our Benefits">Our Benefits</a></li>
			<li><a href="#" title="What Our Future Plans">What Our Future Plans</a></li>
			<li><a href="#" title="Our Success">Our Success</a></li>
			<li><a href="#" title="Ratings">Ratings</a></li>
			<li><a href="#" title="Latest Blogs">Latest Blogs</a></li>
			<li><a href="#" title="News">News</a></li>
			<li><a href="#" title="Testimonials">Testimonials</a></li>
			<li><a href="#" title="Comments">Comments</a></li>
		</ul> -->
		<br class="spacer" />
	</div>
	<!--Navigation Part Ends -->
</div>
<!--Navigation Background Part Ends -->

Создайте файл menu.ctp в папке /app/views/themed/default/elements и скопируйте в него код меню. А в файл default.ctp на место меню добавьте:

<?php echo $this->element('menu', array('cache' => true)); ?>

cache указывает ядру CakePHP, что мы хотим кэшировать элемент, так как он почти никогда не будет меняться.

Теперь изменим меню, чтобы оно соответствовало нашему приложению:

<!--Navigation Background Part Starts -->
<div id="navigation-bg">
    <!--Navigation Part Starts -->
    <div id="navigation">
        <ul class="mainMenu">
            <li><?php echo $html->link('Главная', array('controller'=>'jobs', 'action' => 'index'));?></li>
            <li><?php echo $html->link('Категории', array('controller'=>'categories', 'action' => 'index'));?></li>
            <li><?php echo $html->link('Пользователи', array('controller'=>'users', 'action' => 'index'));?></li>
        </ul>
        <a href="#" class="signup" title="signup now"></a>
    </div>
    <!--Navigation Part Ends -->
</div>
<!--Navigation Background Part Ends -->

Теперь меню соответствует нашему приложению. Мы удалили часть подменю, потому что она пока не нужна. Если обновить страницу, то ничего не изменится. Потому что мы указали CakePHP кэшировать элемент. Теперь надо перейти в папку /app/tmp/cache/views и удалить файл кэша (он называется element__menu). Обновляем страницу и наше меню появляется.

Теперь включим наши виды в шаблон. Найдите и удалите ниже приведенный код в файле default.ctp:

<!--Our Company Left Part Starts -->
		<div id="ourCompany-leftPart">
			<h2 class="faq-Hdr">Latest F.A.Q?s</h2>
			<ul class="ourCompany-list">
				<li>Nulla congue pretium elit. Integer enim risus, mollis.</li>
				<li>Eget, accumsan id, feugiat eu, velit. Sed molestie.</li>
				<li>lectus id nisi.</li>
			</ul>
			<h2 class="moreIdeas-Hdr">More Ideas About Us</h2>
			<ul class="ourCompany-list noBottomPadding">
				<li>Quisque laoreet, elit at tincidunt porta, massa torr.</li>
				<li>Porttitor magna, at vehicula pede dui id enim.</li>
				<li>Pellentesque rhoncus metus quis nulla. Donecllus.</li>
				<li>Metus, vehicula nec, scelerisque commodo.</li>
				<li>Egestas eget.</li>
			</ul>
		</div>
		<!--Our Company Left Part Ends -->
		<!--Our Company Right Part Starts -->
		<div id="ourCompany-rightPart">
			<h2 class="moreInfo-Hdr">More Informations</h2>
			<ul class="ourCompany-list noBottomPadding">
				<li><a href="#">Aenean viverra sapien a enim pellentesque</a></li>
			</ul>
			<p class="moreInfo-Text">Pellentesque id nunc at leo<br />
			vestibulum lobortis</p>
			<h2 class="searchUrl-Hdr">Search Our Url's</h2>
			<ul class="ourCompany-list noBottomPadding">
				<li><a href="#">www.,elit at tincidunt/porta.com</a></li>
				<li><a href="#">www.vehicula pede /a/dui id enim.com</a></li>
				<li><a href="#">www. quis nulla.com</a></li>
				<li><a href="#">www.scelerisque commodo.com</a></li>
			</ul>
		</div>
		<!--Our Company Right Part Ends -->

А на его место добавьте следующий код:

<?php echo $content_for_layout; ?>

А тег h2, который располагается выше только что сделанной вставки, нужно заменить на:

<h2 class="ourCompany-hdr"><?php echo $title_for_layout; ?></h2>

Обновляем страницу нашего проекта в браузере. Теперь наше приложение функционирует в новом оформлении (хотя и несколько корявом).

В следующем уроке мы продолжим работать над темой, чтобы довести ее до нормального вида.

• Комментарии