Содержание Краткое описание возможностей программы Регистрация Навигация по разделам новостей Добавление, редактирование и удаление новостей Установка прав доступа Создание шаблона новостей Добавление раздела новостей Встраивание новостей в сайт КРАТКОЕ ОПИСАНИЕ ВОЗМОЖНОСТЕЙ ПРОГРАММЫ       Данная программа позволяет размещать на сайтах информационные разделы(новости, объявления и т.д.) с возможностью добавления и удаления элементов через веб-интерфейс, так же есть администрирование и разделение на пользователей таким образом, что каждый пользователь может редактировать только новости, созданные им. Так же программа предусматривает сохранение архива новостей, который программно обновляется. Предусмотрена возможность прикрепления файлов к новостям с автоматической вставкой ссылок на прикрепляемые файлы. Существует система поиска новостей по всем разделам по заданной подстроке. Так же есть возможность пользователям просматривать и редактировать созданные ими новости, принадлежащие не только заданному разделу но и разным разделам новостей. Всего предусмотрено три уровня пользователей: администратор, вебмастер и пользователь, которые наделены следующими правами:     администратор - создание шаблонов новостей, разделов новостей, регистрация пользователей и наделения их правами вебмастера, редактирование разделов новостей и структуры каталогов разделов новостей. Администратор может просматривать права всех пользователей и пользователей для каждого раздела новостей в отдельности.     вебмастер - это пользователь обладающий всеми правами для некоторого раздела новостей (ведущий раздела новостей), он может не только добавлять, редактировать и удалять созданные им новости, но редактировать и удалять новости остальных пользователей, вносящих информацию в данный раздел. Так же вебмастер может регистрировать пользователей, наделять их правами, а так же лишать прав по отношению к разделам новостей, вебмастером которых он является.      пользователь - зарегистрированный администратором или вебмастером человек, который может быть наделен одним лишь правом добавления, редактирования и удаления новостей, созданных им. Причем вышеописанные действия пользователь может применять лишь к тем разделам новостей, которые разрешены вебмастером.      Программа написана на языке Perl 5.0 в виде cgi-скриптов с использованием СУБД Postgress 7.0. Разделы новостей встраиваются в любую веб-страницу(*.shtml) с использованием ssi-технологии. Архив новостей реализуется с использованием шаблона. РЕГИСТРАЦИЯ      Данный раздел доступен только для администратора и ведущих новостей. При регистрации следует заполнить все требуемые поля и нажать на кнопку , после чего в случае успешной регистрации новый пользователь получит ID, указывая который он сможет попасть в систему. По умолчанию новый пользователь не имеет никаких прав к разделам новостей, поэтому в случае необходимости можно наделить его такими правами. В БД программы помимо внесенной пользователем информации записывается так же информация о том, кто данного пользователя зарегистрировал. НАВИГАЦИЯ ПО РАЗДЕЛАМ НОВОСТЕЙ      Представление информации о имеющихся в БД разделах новостей имеет иерархическую структуру, которая представлена в разделе "Все разделы". Таким образом, все разделы новостей разбиваются по категориям, которые напоминают директории Windows, которые администратор может создавать и удалять. Названия разделов новостей очевидным образом располагаются напротив значка и являются ссылками на соответствующие разделы. В зависимости от прав доступа текущего пользователя к данному разделу новостей справа от раздела могут отображаться значки , и , которые позволяют соответственно редактировать, просматривать информацию о пользователях и удалять данный раздел. Причем удаление доступно только администратору, просмотр списка пользователей с правами по данному разделу доступно только администратору и ведущему данного раздела, а добавление, изменение и удаление всем пользователям, наделенных данным правом по отношению к текущей новости. Для администратора доступно редактирование параметров раздела новостей.      Для многих пользователей, имеющих сравнительно небольшой список доступных разделов новостей, более удобно просматривать список разделов новостей в разделе "Мои разделы новостей", где отражаются только те разделы, которые доступны текущему пользователю.      Раздел "Мои новости" позволяет просматривать и редактировать созданные текущим пользователем новости, принадлежащие различным разделам новостей. Этот раздел может оказаться особенно полезным пользователям с большим количеством доступных разделов. Здесь доступно редактирование, изменение и удаление своих новостей аналогично действиям в режиме обычного редактирования новостей, только здесь нет возможности добавлять новости. ДОБАВЛЕНИЕ, РЕДАКТИРОВАНИЕ И УДАЛЕНИЕ НОВОСТЕЙ      Переход в раздел редактирования новостей определенного раздела новостей происходит по нажатию на значок , который отображается справа от наименования раздела новостей в разделах "Все разделы" и "Мои разделы новостей". Если такой значок отсутствует, то это означает, что у Вас нет прав для редактирования данного раздела. В верхней части окна отображается форма с чистым бланком "Добавление новости". Для этого нужно в верхней части таблицы набрать текст с новостью, затем нажать на кнопку "Добавление новости". После чего новость автоматически добавится в базу. При этом можно установить дату новости, по умолчанию дата устанавливается сегодняшним числом. Если установить ещё не наступившую дату, то новость не отображается в списке новостей, но автоматически отобразится в дальнейшем, когда наступит эта дата. Например это удобно, если вам обязательно нужно завтра разместить какую-то новость, но времени завтра может не оказаться или не будет доступа в интернет. Легко видеть, что при добавлении новости в нижней части таблицы отображается общий вид этой же новости в том формате, в котором она будет представлена на сайте с учетом дизайна, хранящегося в БД. Следует заметить, что в тексте новости переносы строки заменяются на тег "<BR>", поэтому при отображении новостей этот перенос строки тоже отражается. При заполнении форм новостей разрешено использование любых тегов языка HTML, включая даже элементы программирования на языке JavaScript, но к ним следует подходить с большей осторожностью. Но в основном в новостях используются ссылки и графические элементы. Для размещения графического изображения или текста-ссылки на конкретный Ваш файл, необходимо воспользоваться возможностью закачки файлов. Для того, чтобы закачать некоторый файл в отведенную на сервере папку необходимо совершить стандартную процедуру: нажать на кнопку "Обзор", расположенную правее сообщения "Закачать файл", выбрать закачиваемый файл и нажать на кнопку "Отправить", после чего файл окажется на сервере. В данной версии программы имя файла автоматически изменяется, что избавляет от проблем, связанных с нестандартными именами файлов. Ссылка на закаченный файл добавляется автоматически с учетом типа добавляемого файла. Тип определяется по расширению файла. Следует отметить, что некоторые разделы новостей могут содержать в шаблоне графическое изображение, как обязательный элемент, и в этом случае появляются дополнительные поля для вставки данного графического изображения в новость: "Изображение", где указывается только имя закаченного файла и "Закачать изображение", форма для закачки графического изображения на сервер, при этом первое поле заполняется автоматически. Помимо добавления новостей существует возможность редактирования и удаления. Ниже формы добавления новой новости отображаются новости, которые были добавлены текущим пользователем. Удаление новости выполняется достаточно просто: для этого достаточно нажать на кнопку "Удалить" в таблице удаляемой новости. Для изменения новости нужно внести соответствующие исправления в текст новости и нажать на кнопку "Изменить", после чего будут внесены изменения только для данной новости. Следует заметить, что ведущий данного раздела новостей имеет право просматривать, редактировать и удалять не только свои новости, но и новости, добавленные разными пользователями в данный раздел. УСТАНОВКА ПРАВ ДОСТУПА      После регистрации пользователи не имеют прав редактирования разделов новостей. Такие права доступа устанавливают ведущие новостей, но только на те разделы, ведущими которых они являются. Ведущих разделов новостей аналогичным образом назначает администратор. Для наделения некоторого пользователя правами необходимо в поле "Установка прав" напротив "ID" указать идентификационный номер пользователя, после чего по нажатию кнопки "Ок" будет осуществлен переход в режим редактирования прав доступа. При этом напротив Ваших разделов новостей, ведущими которых Вы являетесь будут располагаться значки , нажатием на которые можно устанавливать и снимать права доступа данного пользователя к этому разделу. Если галочка установлена, то это означает, что пользователь имеет право добавлять новости в этот раздел, в противном случае он лишается такого права. Если напротив раздела новостей отсутствует вышеуказанный значок, то это означает, что у Вас нет прав наделения правами других пользователей на этот раздел, т.е. Вы не являетесь ведущим данного раздела новостей. СОЗДАНИЕ ШАБЛОНА НОВОСТЕЙ      Шаблон новостей - формат таблицы вывода новостей, который создается администратором и в дальнейшем может использоваться для создания раздела новостей, в котором выбирается данный шаблон. Несколько разделов новостей могут использовать один и тот же шаблон. Можно не только создавать шаблоны но и изменять их в процессе работы, и в этом случае результат сразу будет отражаться на сайте. Для создания или редактирования шаблона новостей необходимо зайти в раздел "Шаблоны", после чего в разделе редактирования шаблонов следует выбрать действие: добавление нового шаблона или редактирование существующего. Далее следует указать формат заголовка таблицы и формат отдельной строки для новости. В тексте формата строки могут встречаться макросы #DATA#, #MESSAGE#, #IMAGE#, которые предполагают встраивание даты сообщения, содержания сообщения и графического элемента соответственно. По желанию можно добавить текст "Содержание по умолчанию", который будет каждый раз вставляться по умолчанию при добавлении очередной новости. Ниже располагается пример раздела новостей, использующего данный шаблон(данный пример не изменяется динамически). Добавить или изменить шаблон можно нажатием соответствующей кнопки. ДОБАВЛЕНИЕ РАЗДЕЛА НОВОСТЕЙ     Перед добавлением раздела новостей необходимо убедится в том, что существует хотя бы один шаблон. В случае необходимости, если ни один из имеющихся шаблонов новостей не устраивает, можно добавить новый шаблон. Разные разделы новостей могут использовать один и тот же шаблон. Только администратор может добавлять, редактировать и удалять разделы новостей. Для добавления нового раздела новостей в пункте меню "Все разделы" нужно определить папку, в которую следует поместить этот раздел. Далее следует нажать на значок , расположенный правее названия папки. В появившейся форме необходимо заполнить требуемые поля и нажать на кнопку "Добавить раздел новостей". Следует заметить, что при выборе шаблона после нажатия кнопки "Ок" в нижней части данного окна можно видеть визуальный пример, который демонстрирует внешний вид новости. Поле "Название раздела" является обязательным для заполнения. Под адресом страницы раздела новостей понимается полный адрес к той странице в интернете, в которую будет встроен данный создаваемый раздел. В адресе шаблона архива новостей указывается полный путь к html-файлу шаблону, который в случае необходимости используется для встраивания архива новостей на сервере без поддержки php- и ssi-технологий. Так же здесь можно указать количество по умолчанию отображаемых одновременно на странице новостей в режиме просмотра новостей и архива новостей. Этот параметр так же используется при редактировании новостей. В любой момент времени можно изменить внесенные данные о разделе новостей, щелкнув на значке . ВСТРАИВАНИЕ НОВОСТЕЙ В САЙТ     Рекомендуется встраивать новости, согласно следующему примеру с использованием PHP-технологии:     <?php include("http://news.dvpion.ru/news.cgi?id=ID&max=MAX")?> где(здесь и далее) ID - номер существующего раздела новостей MAX - количество выводимых новостей. Данный параметр можно опустить, в этом случае данная информация будет извлекаться и БД.     Так же в случае поддержки PHP сервером можно встроить аналогичным образом архив новостей в файл archive.php, где новости можно просматривать постранично:     <?php include("http://news.dvpion.ru/arch_php.cgi?id=ID&max=MAX&page=".$page)?>      В случае отсутствия PHP можно воспользоваться SSI-технологией, но только для новостей данного сайта, на котором расположена программа, поскольку данная технология не позволяет встраивать в страницы скрипты с других сайтов. Данная вставка может быть включена в shtml-файл следующим образом:     <!--#include virtual="/cgi-bin/update/news.cgi?id=ID&max=MAX" -->     Большую сложность представляет встраивание раздела новостей на другом сайте без PHP, это возможно с использованием фреймов (не рекомендуется). В этом случае в фреймах, отведенных для отображения новостей и архива новостей следует соответственно отобразить следующие страницы:      http://news.dvpion.ru/news.cgi?id=ID&max=MAX      http://news.dvpion.ru/archive.cgi?id=ID&max=MAX     В том случае, если на сервере нет поддержки PHP и SSI, для встраивания новостей предусмотрена возможность использования файла-шаблона. Данный файл может находиться по любому адресу в интернет(очень желательно, чтобы этот файл находился на данном сервере или на сервере, находящемся в локальной сети с данным сервером). Этот файл представляет собой единый html-документ, в котором все ссылки на подключаемые ресурсы должны иметь полные пути. Так же следует указать в данном файле макрос #ARCHIVE#, вместо которого будет подставлен текст новости. Адрес файла-шаблона указывается администратором при создании раздела новостей. Для загрузки данной страницы с новостями достаточно будет воспользоваться следующей ссылкой:      http://news.dvpion.ru/archive.cgi?id=ID&max=MAX