- Метки урока:
- web дизайн
- кодинг
- php
Строим свою CMS на PHP и MySQL. Часть 8
В предыдущих уроках серии мы начали добавлять функционал категорий в нашу простую CMS. Сделаем следующий шаг - модифицируем скрипты серверной и клиентской частей.
Модифицируем скрипт index.php
клиентской части
Добавим в скрипт клиентской части index.php
функционал для отображения категорий. Вот так будет выглядеть готовый файл index.php
в папке cms
:
<?php require( "config.php" ); $action = isset( $_GET['action'] ) ? $_GET['action'] : ""; switch ( $action ) { case 'archive': archive(); break; case 'viewArticle': viewArticle(); break; default: homepage(); } function archive() { $results = array(); $categoryId = ( isset( $_GET['categoryId'] ) && $_GET['categoryId'] ) ? (int)$_GET['categoryId'] : null; $results['category'] = Category::getById( $categoryId ); $data = Article::getList( 100000, $results['category'] ? $results['category']->id : null ); $results['articles'] = $data['results']; $results['totalRows'] = $data['totalRows']; $data = Category::getList(); $results['categories'] = array(); foreach ( $data['results'] as $category ) $results['categories'][$category->id] = $category; $results['pageHeading'] = $results['category'] ? $results['category']->name : "Article Archive"; $results['pageTitle'] = $results['pageHeading'] . " | Widget News"; require( TEMPLATE_PATH . "/archive.php" ); } function viewArticle() { if ( !isset($_GET["articleId"]) || !$_GET["articleId"] ) { homepage(); return; } $results = array(); $results['article'] = Article::getById( (int)$_GET["articleId"] ); $results['category'] = Category::getById( $results['article']->categoryId ); $results['pageTitle'] = $results['article']->title . " | Widget News"; require( TEMPLATE_PATH . "/viewArticle.php" ); } function homepage() { $results = array(); $data = Article::getList( HOMEPAGE_NUM_ARTICLES ); $results['articles'] = $data['results']; $results['totalRows'] = $data['totalRows']; $data = Category::getList(); $results['categories'] = array(); foreach ( $data['results'] as $category ) $results['categories'][$category->id] = $category; $results['pageTitle'] = "Widget News"; require( TEMPLATE_PATH . "/homepage.php" ); } ?>
Рассмотрим подробно изменения функций в index.php
:
archive()
Оригинальная функция
archive()
просто выводила список всех статей в CMS. Мы адаптируем функциюarchive()
так, чтобы она принимала опциональный параметрcategoryId
. ЕслиcategoryId
задан, то функция возвращает соответствующий объектCategory
с помощью вызоваCategory::getById()
, и если действие было успешным, передает ID категории в функциюArticle::getList()
для получения статей только из соответствующей категории.Также добавляем код в функцию
archive()
для получения всех категорий в базе данных и сохранения их в$results['categories']
с ID категории в качестве ключа. Шаблон страницы архиваarchive.php
использует данный массив для вывода имени категории для каждой статьи.Создаем переменную
$results['pageHeading']
, которая содержит либо имя категории (еслиcategoryId
было задано), либо текст "Article Archive". Данное значение будет отображаться в заголовке страницы архива. Также создаем переменную$results['pageTitle']
для использования в элементе<title>
. Просто для вывода названия сайта "Widget News" в заголовке страницы.viewArticle()
Здесь мы делаем только одно добавление: возвращаем объект
Category
соответствующий статье с помощью вызова методаCategory::getById()
, передавая ему значение свойства статьи$categoryId
. Полученный объектCategory
сохраняем$results['category']
. Будем использовать данный объект для вывода названия категории в шаблонеviewArticle.php
.homepage()
В функцию
homepage()
добавляем три строки. Данный код вызываетCategory::getList()
для получения всех категорий в CMS, затем сохраняем категории в$results['categories']
с ID категории в качестве ключа. То есть мы можем вывести названия категорий для каждой статьи на главной странице.
Модифицируем скрипт серверной части admin.php
Файл admin.php
содержит все функции администратора для нашей CMS. Нужно сделать несколько изменений и добавлений в данном файле для обработки категорий.
Новый код файла admin.php
, будет выглядеть следующим образом:
<?php require( "config.php" ); session_start(); $action = isset( $_GET['action'] ) ? $_GET['action'] : ""; $username = isset( $_SESSION['username'] ) ? $_SESSION['username'] : ""; if ( $action != "login" && $action != "logout" && !$username ) { login(); exit; } switch ( $action ) { case 'login': login(); break; case 'logout': logout(); break; case 'newArticle': newArticle(); break; case 'editArticle': editArticle(); break; case 'deleteArticle': deleteArticle(); break; case 'listCategories': listCategories(); break; case 'newCategory': newCategory(); break; case 'editCategory': editCategory(); break; case 'deleteCategory': deleteCategory(); break; default: listArticles(); } function login() { $results = array(); $results['pageTitle'] = "Admin Login | Widget News"; if ( isset( $_POST['login'] ) ) { // User has posted the login form: attempt to log the user in if ( $_POST['username'] == ADMIN_USERNAME && $_POST['password'] == ADMIN_PASSWORD ) { // Login successful: Create a session and redirect to the admin homepage $_SESSION['username'] = ADMIN_USERNAME; header( "Location: admin.php" ); } else { // Login failed: display an error message to the user $results['errorMessage'] = "Incorrect username or password. Please try again."; require( TEMPLATE_PATH . "/admin/loginForm.php" ); } } else { // User has not posted the login form yet: display the form require( TEMPLATE_PATH . "/admin/loginForm.php" ); } } function logout() { unset( $_SESSION['username'] ); header( "Location: admin.php" ); } function newArticle() { $results = array(); $results['pageTitle'] = "New Article"; $results['formAction'] = "newArticle"; if ( isset( $_POST['saveChanges'] ) ) { // User has posted the article edit form: save the new article $article = new Article; $article->storeFormValues( $_POST ); $article->insert(); header( "Location: admin.php?status=changesSaved" ); } elseif ( isset( $_POST['cancel'] ) ) { // User has cancelled their edits: return to the article list header( "Location: admin.php" ); } else { // User has not posted the article edit form yet: display the form $results['article'] = new Article; $data = Category::getList(); $results['categories'] = $data['results']; require( TEMPLATE_PATH . "/admin/editArticle.php" ); } } function editArticle() { $results = array(); $results['pageTitle'] = "Edit Article"; $results['formAction'] = "editArticle"; if ( isset( $_POST['saveChanges'] ) ) { // User has posted the article edit form: save the article changes if ( !$article = Article::getById( (int)$_POST['articleId'] ) ) { header( "Location: admin.php?error=articleNotFound" ); return; } $article->storeFormValues( $_POST ); $article->update(); header( "Location: admin.php?status=changesSaved" ); } elseif ( isset( $_POST['cancel'] ) ) { // User has cancelled their edits: return to the article list header( "Location: admin.php" ); } else { // User has not posted the article edit form yet: display the form $results['article'] = Article::getById( (int)$_GET['articleId'] ); $data = Category::getList(); $results['categories'] = $data['results']; require( TEMPLATE_PATH . "/admin/editArticle.php" ); } } function deleteArticle() { if ( !$article = Article::getById( (int)$_GET['articleId'] ) ) { header( "Location: admin.php?error=articleNotFound" ); return; } $article->delete(); header( "Location: admin.php?status=articleDeleted" ); } function listArticles() { $results = array(); $data = Article::getList(); $results['articles'] = $data['results']; $results['totalRows'] = $data['totalRows']; $data = Category::getList(); $results['categories'] = array(); foreach ( $data['results'] as $category ) $results['categories'][$category->id] = $category; $results['pageTitle'] = "All Articles"; if ( isset( $_GET['error'] ) ) { if ( $_GET['error'] == "articleNotFound" ) $results['errorMessage'] = "Error: Article not found."; } if ( isset( $_GET['status'] ) ) { if ( $_GET['status'] == "changesSaved" ) $results['statusMessage'] = "Your changes have been saved."; if ( $_GET['status'] == "articleDeleted" ) $results['statusMessage'] = "Article deleted."; } require( TEMPLATE_PATH . "/admin/listArticles.php" ); } function listCategories() { $results = array(); $data = Category::getList(); $results['categories'] = $data['results']; $results['totalRows'] = $data['totalRows']; $results['pageTitle'] = "Article Categories"; if ( isset( $_GET['error'] ) ) { if ( $_GET['error'] == "categoryNotFound" ) $results['errorMessage'] = "Error: Category not found."; if ( $_GET['error'] == "categoryContainsArticles" ) $results['errorMessage'] = "Error: Category contains articles. Delete the articles, or assign them to another category, before deleting this category."; } if ( isset( $_GET['status'] ) ) { if ( $_GET['status'] == "changesSaved" ) $results['statusMessage'] = "Your changes have been saved."; if ( $_GET['status'] == "categoryDeleted" ) $results['statusMessage'] = "Category deleted."; } require( TEMPLATE_PATH . "/admin/listCategories.php" ); } function newCategory() { $results = array(); $results['pageTitle'] = "New Article Category"; $results['formAction'] = "newCategory"; if ( isset( $_POST['saveChanges'] ) ) { // User has posted the category edit form: save the new category $category = new Category; $category->storeFormValues( $_POST ); $category->insert(); header( "Location: admin.php?action=listCategories&status=changesSaved" ); } elseif ( isset( $_POST['cancel'] ) ) { // User has cancelled their edits: return to the category list header( "Location: admin.php?action=listCategories" ); } else { // User has not posted the category edit form yet: display the form $results['category'] = new Category; require( TEMPLATE_PATH . "/admin/editCategory.php" ); } } function editCategory() { $results = array(); $results['pageTitle'] = "Edit Article Category"; $results['formAction'] = "editCategory"; if ( isset( $_POST['saveChanges'] ) ) { // User has posted the category edit form: save the category changes if ( !$category = Category::getById( (int)$_POST['categoryId'] ) ) { header( "Location: admin.php?action=listCategories&error=categoryNotFound" ); return; } $category->storeFormValues( $_POST ); $category->update(); header( "Location: admin.php?action=listCategories&status=changesSaved" ); } elseif ( isset( $_POST['cancel'] ) ) { // User has cancelled their edits: return to the category list header( "Location: admin.php?action=listCategories" ); } else { // User has not posted the category edit form yet: display the form $results['category'] = Category::getById( (int)$_GET['categoryId'] ); require( TEMPLATE_PATH . "/admin/editCategory.php" ); } } function deleteCategory() { if ( !$category = Category::getById( (int)$_GET['categoryId'] ) ) { header( "Location: admin.php?action=listCategories&error=categoryNotFound" ); return; } $articles = Article::getList( 1000000, $category->id ); if ( $articles['totalRows'] > 0 ) { header( "Location: admin.php?action=listCategories&error=categoryContainsArticles" ); return; } $category->delete(); header( "Location: admin.php?action=listCategories&status=categoryDeleted" ); } ?>
Расмотрим изменения в файле admin.php
подробно:
- Добавления Additions to the
switch
blockНам нужно добавить новый функционал в файл
admin.php
для обработки вывода, создания, редактирования и удаления категорий. Поэтому мы добавляем блокиlistCategories
,newCategory
,editCategory
иdeleteCategory
case
в выражениеswitch
в начале файла. Данные блоки вызывают различные функции для обработки категорий. - Изменения в функциях
newArticle()
,editArticle()
иlistArticles()
Нужно сделать небольшие изменения в каждой из перечисленных функций для получения списка категорий в базе данных и использования в форме редактирования и создания статьи. Полученный список категорий хранится в переменной
$results['categories']
. Для функцииlistArticles()
мы также используем в качестве ключа ID категории для облегчения применения списка в шаблонеlistArticles.php.
listCategories()
Данная функция выводит список всех категорий для администратора. Она работает так же как и функция
listArticles()
. Все категории извлекаются из базы данных с помощью функцииCategory::getList()
, затем сохраняются в массиве$results['categories']
. Также записывается общее количество категорий в переменной$results['totalRows']
и сохраняется название страницы в переменной$results['pageTitle']
. Затем производится проверка на наличие кодов статуса в строке запроса и устанавливаются значения переменных$results['errorMessage']
или$results['statusMessage']
соответственно. В завершение включается шаблонlistCategories.php
для вывода списка категорий.newCategory()
Функция для добавления новых категорий в базу данных, так же как и
newArticle()
добавляет новую статью. Если пользователь передал форму редактирования категории, то функция создает новый объектCategory
object, наполняет его данными из формы, вызывает функциюinsert()
для вставки категории в базу данных, и перенаправляет на страницу со списком категорий, выводя сообщение о сохранении изменений. Если пользователь нажимает кнопку Cancel в форме, то функция просто перенаправляет на список категорий. Если пользователь еще не отправил форму, то функция создает новый пустой объектCategory
для использования в форме, сохраняет его в$results['category']
и включает шаблонeditCategory.php
для вывода формы редактирования категории.editCategory()
Данная функция редактирует существующую категорию в базе данных, позволяя пользователю менять название категории и/или описание.она действует по такому же сценарию, что и
editArticle()
. Если форма редактирования отправлена, загружаем категорию из базы данных, сохраняем новые значения формы в объекте Category, и обновляем категорию в базе данных с помощью методаupdate()
. Если пользователь отказался от редактирования, то функция перенаправляет его на список категорий. Если пользователь еще не отправил форму, то функция загружает категорию, указанную параметромcategoryId
в строке запроса, сохраняет ее в переменной$results['category']
и включает шаблонeditCategory.php
для вывода заполненной формы редактирования.deleteCategory()
Последняя новая функция позволяет удалять категорию из базы данных. Она вызывается, когда пользователь нажимает ссылку Delete This Category (Удалить категорию ) на странице редактирования категорий. Сначала функция получает категорию, заданную параметром запроса
categoryId
(если категории нет, то выводится сообщение об ошибке). Затем производится проверка наличия статьей в категории. Если статьи есть , то выводится сообщение об ошибке и происходит выход из функции. Если статей в категории нет, то функция удаляет категорию и перенаправляет на страницу со списком категорий, выводя сообщение об удалении категории.
В следующем уроке серии мы рассмотрим изменения в шаблонах нашей CMS? которые надо сделать для добавления функционала категорий.
Данный урок подготовлен для вас командой сайта ruseller.com
Источник урока: www.elated.com/articles/add-article-categories-to-your-cms/
Перевел: Сергей Фастунов
Урок создан: 17 Декабря 2012
Просмотров: 35208
Правила перепечатки
5 последних уроков рубрики "PHP"
-
Фильтрация данных с помощью zend-filter
Когда речь идёт о безопасности веб-сайта, то фраза "фильтруйте всё, экранируйте всё" всегда будет актуальна. Сегодня поговорим о фильтрации данных.
-
Контекстное экранирование с помощью zend-escaper
Обеспечение безопасности веб-сайта — это не только защита от SQL инъекций, но и протекция от межсайтового скриптинга (XSS), межсайтовой подделки запросов (CSRF) и от других видов атак. В частности, вам нужно очень осторожно подходить к формированию HTML, CSS и JavaScript кода.
-
Подключение Zend модулей к Expressive
Expressive 2 поддерживает возможность подключения других ZF компонент по специальной схеме. Не всем нравится данное решение. В этой статье мы расскажем как улучшили процесс подключение нескольких модулей.
-
Совет: отправка информации в Google Analytics через API
Предположим, что вам необходимо отправить какую-то информацию в Google Analytics из серверного скрипта. Как это сделать. Ответ в этой заметке.
-
Подборка PHP песочниц
Подборка из нескольких видов PHP песочниц. На некоторых вы в режиме online сможете потестить свой код, но есть так же решения, которые можно внедрить на свой сайт.