Этот урок связан с проектом Строим свою CMS на PHP и MySQL

Строим свою CMS на PHP и MySQL. Часть 8

В предыдущих уроках серии мы начали добавлять функционал категорий в нашу простую CMS. Сделаем следующий шаг - модифицируем скрипты серверной и клиентской частей.

demosourse

Модифицируем скрипт 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 сможете потестить свой код, но есть так же решения, которые можно внедрить на свой сайт.

^ Наверх ^