Документация коммунивер-сайта

Сайт предназначен для демонстрации возможностей Коммунивер-технологии. На его основе можно выстроить произвольный коммунивер-сайт.

На данном сайте существуют такие возможности:

публикация материалов разных типов, таких как: тексты, внешние ссылки, файлы, книги (с частями и главами), фотографии, объявления;
настройки пользователя (можно регулировать количество и способ упорядочивания материалов на страницах);
смешанное содержание разделов (рубрики+материалы);
система комментирования материалов сайта;
фотогалереи и форумы;
сервисы "для каждой страницы": подписка, все материалы, все комментарии, вид для печати;
обновления на главной странице;
скрытые рубрики для отдельных групп пользователей;
поддержка полномочий пользователя, доверенного пользователя (может публиковать свои материалы и редактрировать их), редактора (может публиковать материалы и редактировать и свое, и чужое);
полнотекстовый поиск;
регистрация на сайте, поддержка страниц зарегистрированных пользователей.

Структура сайта

Вы можете размещать на сайте свои материалы, различных типов: тексты, фотографии, ссылки, файлы, книги, и комментарии к ним.

На сайте можно выделить такие типы страниц:

главная страница,
страницы разделов (содержащие гиперссылки на другие страницы, например, страницы рубрик со ссылками на материалы, или страницы книг с ссылками на главы, страница объявлений),
содержательные страницы (например, страница текста или главы книги),
страницы дискуссии
страницы пользователей и
служебные страницы (например, страницы регистрации, настроек пользователя или подписки).

"Шапка" сайта, меню и служебные страницы

Вверху каждой страницы расположена "шапка", содержащая данные, не меняющиеся на страницах сайта, заголовок и полный путь текущей страницы.
В "шапке" отображаются:
логотип и название сайта;
текущая дата;
регистрационное имя текущего пользователя (указывается статус пользователя - пользователь, доверенный пользователь или редактор);
поле и кнопка поиска;
название текущей страницы и путь к главной странице сайта.
Там же расположено меню пользователя, в которое входят пункты:

карта сайта (рубрикатор);
login (или logout для зарегистрированного пользователя);
настройки.
Предусмотрена также возможность различного отображения содержимого текущей страницы:

комментарии к материалам ;
вид для печати ;
а также возможность самостоятельно подписаться на обновление содержимого страницы .
На главной странице располагаются также ссылки на все материалы и все новости
Дополнительно редактору сайта в "шапке" будут доступны ссылки, относящиеся к текущей странице:
редактировать;
добавить;
упорядочить;
доступ.
Ссылка "добавить объект" доступна также доверенным пользователям.
Тип добавляемого объекта можно выбрать в выпадающем меню. В зависимости от текущей страницы можно добавить:
рубрику;
текстовый материал;
ссылку;
файл;
фотографию;
фотогалерею;
книгу;
часть книги;
главу книги;
форум;
объявление.
Редактору сайта доступны также ссылки на "вебмастерскую", "обзор сайта" и данную "справку по сайту".
На странице "Карта сайта" отображается список всех созданных на сайте рубрик. Редактор сайта со страницы рубрикатора может создавать новые рубрики, редактировать и удалять их.
На странице "Настроек" любой пользователь может выбрать число материалов, отображающихся на странице и порядок отображения материалов на странице "Все материалы" и "Все новости".
На странице "Регистрации" можно авторизовать уже зарегистрированного пользователя либо прописать на сайте нового. Кнопка "logout" позволяет закрыть сеанс зарегистрированного пользователя и зарегистрироваться анонимом.
На странице "Все материалы" отображаются все новые материалы сайта.
Все материалы будут отсортированы в обратном хронологическом порядке. Редактору сайта будут доступны кнопки edit (редактировать) возле каждого материала, при помощи которых можно редактировать выбранный материал.
На странице "Комментарии к материалам" отображаются последние темы (материалы, на которые даны комментарии) и комментарии к ним для текущего раздела. Темы будут расположены в обратном порядке по дате последнего ответа (то есть выше та тема, последний ответ на которую был позже). Из списка тем можно развернуть дерево, в котором будут показаны ссылки на все комментарии. Ссылка на заголовке темы ведет на страницу соответствующей нити дискуссии. Для каждого комментария указывается тема, его автор и дата написания. Для каждой темы указывается автор, число ответов и дата последнего ответа. Редактору сайта на странице комментариев будет доступна кнопка правка, при помощи которой он сможет редактировать и удалять комментарии.
Любой зарегистрированный пользователь может самостоятельно подписаться на рассылку свежих материалов по интересующей его тематике. Для этого необходимо в заинтересовавшем его разделе войти в "Подписку". Можно выбрать подписку на анонсы или на полные тексты материалов, а также на дискуссии данного раздела. (Например, если текущая страница является рубрикой, можно подписаться на все обновления этой рубрики, включая комментарии. Если страница является материалом или комментарием, в подписку войдут только отклики на него.) Можно также выбрать период рассылки (посылать ежедневно, еженедельно, ежемесячно или не посылать) и формат HTML или PLAIN. Для изменения адреса подписчика необходимо отредактировать форму собственных персональных данных, нажав на соответствующую ссылку. Для отмены подписки необходимо выбрать в выпадающем меню периода рассылки значение "не посылать".
"Вид для печати" отобразит текущую страницу в виде, удобном для печати на бумаге.
Слева на каждой странице располагается навигационное меню сайта (ссылки на рубрики, фотогалереи и форумы верхнего уровня).

Главная страница

На главной странице сайта отображаются свежие объявления в разделе "Новости" и "Обновления" (с датой публикации) - ссылки на самые новые материалы, созданные на сайте.
Все материалы отображены в обратном хронологическом порядке с указанием даты публикации, автора и аннотации.
В шапке на главной странице появляются ссылки на страницы всех материалов и всех объявлений.

Рубрика, фотогалерея

Материалы сайта тематически разделяются по разделам - рубрикам. Материал может входить одновременно в несколько рубрик. Любая рубрика может быть разделена на подрубрурики.
Фотогалерея - особый вид раздела - содержит фотографии (и может включать в себя тематические фотогалереи).

Рубрика обозначается значком .

Страницы разделов содержат ссылки на объекты, составляющие содержимое этих разделов.
Переход по ссылке-названию материала открывает содержательную страницу этого материала. Если материал является внешней ссылкой, происходит переход непосредственно на URL-адрес этой ссылки.
Пользователь, имеющий права редактора на соответствующем разделе, может добавлять и редактировать материалы, а также переупорядочивать материалы на странице раздела.
Чтобы создать новый раздел, редактор должен в выпадающем меню возле кнопки "add" ("добавить") выбрать рубрику или фотогалерею. В открывшейся форме будет предложено заполнить поля Идентификатор, Заголовок, Описание, Рубрика, текстовое поле, Загрузить файл, Загрузить картинку.
Созданный раздел автоматически появляется в рубрикаторе.
На странице редактирования можно изменить все параметры раздела, кроме идентификатора. При необходимости раздел можно "удалить". При удалении содержимое рубрики по выбору удаляется вместе с ней или переносится в другую рубрику.
Содержимое раздела можно упорядочить. Для этого надо нажать кнопку "order" ("упорядочить") , в открывшемся окне с помощью кнопок Вверх и Вниз установить нужный порядок материалов и нажать кнопку Сохранить.

Текст

Текст - обычный текстовый материал, например статья, рассказ или резюме, может содержать разметку HTML. Обозначается значком .
На странице добавления текстового материала предлагается заполнить поля Идентификатор, Заголовок, Описание, Дата написания, Автор, Рубрика, Часть, текстовое поле, Загрузить файл, Загрузить картинку.
На странице редактирования текста можно изменить заголовок, автора, описание, месторасположение на сайте (принадлежность к рубрике или книге), основной текст, либо удалить текст вообще. Загруженные картинки отображаются в окне редактирования, их можно удалить, поставив соответствующий флажок возле картинки.

Файл

Файл - любой файл, который будет доступен для скачивания с сайта на компьютер пользователя. На странице файла размещается ссылка "Скачать файл". Файл обозначается значком .
На странице добавления файла предлагается заполнить поля Идентификатор, Заголовок, Описание, Дата написания, Автор, Рубрика, Загрузить файл.
На странице редактирования файла можно изменить заголовок, автора, описание, месторасположение на сайте (принадлежность к рубрике), содержимое файла, либо удалить файл вообще.

Ссылка

Ссылка - объект, в котором хранится гиперссылка на внешний сетевой ресурс. Переход по заголовку ссылки автоматически переводит браузер на этот ресурс. Ссылка обозначается .
На странице добавления ссылки предлагаются для заполнения поля Идентификатор, Заголовок, Описание, Рубрика, URL, текстовое поле.
При редактировании ссылки можно изменить все, кроме идентификатора. Можно удалить ссылку.

Книга

Книга является составным материалом и формируется из частей, глав и текстов. Обозначается значком .
Структура книги

Книга может состоять из нескольких частей. (Часть - аналог рубрики для книги.) Каждая часть книги может содержать несколько частей нижнего уровня, глав или отдельных текстов. (Глава - аналог текста. Единственное отличие главы от текста заключается в отсутствии необходимости прописывать в ней автора. Автором главы по умолчанию является автор книги. Книга, составленная из текстов разных авторов является сборником текстов, у которой автор - это его составитель.) Книга может не иметь частей - тексты или главы входят непосредственно в книгу.
Создание книги

На странице добавления книги предлагается заполнить поля Идентификатор, Заголовок, Автор, Описание, Дата написания, Рубрика, текстовое поле, Загрузить файл, Загрузить картинку.
В книгу или часть книги можно добавлять части, главы или тексты.
На странице добавления части или главы редактору предлагается заполнить поля: идентификатор, заголовок, описание, часть, основной текст. Также можно загрузить текст из файла при помощи кнопки "обзор".
На странице добавления статьи (при попадании на нее со страницы книги) редактору предлагается заполнить поля: идентификатор, заголовок, автор (проставляется автоматически), описание, часть, рубрика, основной текст. Также можно загрузить текст из файла при помощи кнопки "обзор".
Редактирование всех данных книги аналогично редактированию текста и рубрики. Со страницы редактирования книги доступны страницы редактирования ее частей, текстов и глав.
Главы, части и тексты в книге или части книги можно переупорядочить с помощью кнопки "order" ("упорядочить").

Фотография

Фотография - изображение, хранящееся как отдельный объект. Фотографию можно добавить и просматривать на странице "Фотогалерея".
В форме добавления фотографии предлагается заполнить поля Идентификатор, Заголовок, Описание, Рубрика, Загрузить картинку.
На странице редактирования фотографии можно изменить заголовок или описание, загрузить другую картинку либо удалить фотографию вообще. Загруженные картинки отображаются в окне редактирования, их можно удалить, поставив соответствующий флажок возле картинки.

Комментарии

На страницах текстов расположена ссылка "ответить" .
С помощью этой ссылки любой пользователь может прокомментировать заинтересовавший его текст. (В предложенной форме "Ответить" поле "тема" заполняется автоматически и совпадает с заголовком материала, на который пишется реплика, пользователю остается лишь набрать текст. При необходимости тему можно заменить.)
На каждый комментарий предусмотрена возможность "ответить".
Все комментарии по одной теме (ответы на один материал) собираются на страницу обсуждения . На странице обсуждения можно выбирать способ представления дискуссии:

тред свернут - отображается только выбранный комментарий и дерево ссылок на другие комментарии в нити;
тред развернут - отображаются тексты всех комментариев, при этом они могут располагаться

лентой - сверху исходный материал, затем комментарии в обратном хронологическом порядке -
или
деревом - сверху исходный материал, затем комментарии, упорядоченные в виде дерева.

Редактор может отредактировать любой комментарий (форма редактирования открывается при нажатии кнопки "edit" ("правка")), в том числе, сделать его самостоятельным текстом.

Форум

Форум - это особая рубрика, предназначенная для ведения дискуссий. Создается и редактируется как обычная рубрика.
Страницу форума можно представить в виде
свернутого дерева - отображается только список тем, для каждой темы указывается автор исходного сообщения, количество ответов и дата последнего ответа;
развернутого дерева - отображается список реплик, входящих в каждую тему, для каждой реплики указывается автор и дата. Любой пользователь может добавить тему обсуждения, при этом ему будет предложено заполнить поле Тема и текстовое поле. При желании пользователь может подписаться другим именем.
На страницах тем обсуждения пользователи могут оставлять свои комментарии, как и при обсуждении материалов.

Объявление

Тип материала "Объявление" служит для публикации на сайте важных сообщений. Новые объявления появляются на главной странице сайта. Все объявления помещаются на страницу "Все новости".
Объявление можно добавить на главной странице и странице "Все новости".
В форме добавления объявления предлагается заполнить поля Идентификатор, Заголовок, текстовое поле, Загрузить файл, Загрузить картинку.
На странице редактирования объявления можно изменить заголовок или основной текст, либо удалить объявление вообще. Загруженные картинки отображаются в окне редактирования, их можно удалить, поставив соответствующий флажок возле картинки.

Пользователи

Регистрация пользователя на сайте
Зарегистрированный пользователь на Коммунивер-сайте обычно имеет больше возможностей, чем анонимный. Например, он может подписаться на обновления на сайте, иногда - публиковать свои материалы. Только зарегистрированный пользователь может получить права редактирования сайта и доступ к закрытым разделам сайта.

Для регистрации или авторизации пользователь использует кнопку "login". На странице "Регистрация" для авторизации ранее зарегистрированного пользователя необходимо заполнить поля: имя (маленькими латинскими буквами) и пароль, и нажать кнопку Войти.
Новый пользователь перед регистрацией должен заполнить форму персональных данных, где ему будет предложено заполнить поля: регистрационное имя (маленькими латинскими буквами), пароль (дважды повторить), полное имя, E-mail, ICQ, пол, несколько слов о себе.
После регистрации /авторизации/ регистрационное имя пользователя прописывается в правом верхнем углу, рядом с текущей датой. Имя пользователя будет автоматически подставляться в строку "автор" при написании им комментария.
ВНИМАНИЕ!!! ПРЕДУПРЕЖДЕНИЕ ПО ТЕХНИКЕ БЕЗОПАСНОСТИ!
Некоторые браузеры запоминают предыдущего пользователя. Чтобы сменить пользователя, необходимо:

нажать кнопку "loguot";
закрыть все окна браузера;
вновь открыть окно - на сайте вы появитесь как аноним.

После этого можно регистрироваться под другим именем.

Полномочия пользователей

Пользователь - может быть зарегистрированным или незарегистрированным (анонимом) - знакомится с материалами сайта и комментирует их. У зарегистрированного пользователя на его страничке собираются все материалы, автором которых он указан.
Допущенный пользователь может просматривать материалы закрытых разделов. Если разделу назначен хотя бы один допущенный пользователь, он становится закрытым. Раздел, которому не назначен ни один допущенный пользователь, является открытым для всех пользователей, в том числе для анонимов.
Доверенный пользователь может самостоятельно публиковать на сайте свои материалы и редактировать те материалы, которые он опубликовал.
Редактор сайта - работает с информационным наполнением сайта (добавляет, редактирует и удаляет материалы и рубрики), а также присваивает права доступа пользователям.
Редакторы сайта и доверенные пользователи могут менять информационное наполнение открытой части сайта. Для этого предусмотрены дополнительные кнопки, недоступные другим пользователям:
В "шапке" появляются ссылки "обзор сайта"(только для редактора, доверенному пользователю не виден), "справка по сайту" ("help");
На "главной странице" и страницах рубрик и книг для редактора появляются кнопки "edit" ("правка"), "add" ("добавить"), "order" ("упорядочить"), "access" ("доступ");
На странице материала - "edit" ("правка");
Также кнопки "edit" ("правка") видны редактору сайта на любой странице открытой рубрики напротив заголовка материала или рубрики.
Доверенный пользователь видит кнопку "edit" ("правка") только на страницах тех материалов, которые он опубликовал, и кнопку "add" ("добавить").
При помощи перечисленных кнопок открывается доступ к специальным страницам создания и редактирования материалов сайта.
Кнопка "access" ("доступ") открывает страницу управления полномочиями в данном разделе (рубрике или сайте). На этой странице отображается список пользователей, имеющих на сайте особые полномочия. Полномочия отображаются в чекбоксах:
зеленый квадрат - допущенный пользователь;
сиреневый квадрат - доверенный пользователь;
оранжевый квадрат - редактор.
Чтобы изменить полномочия, надо включить или выключить соответствующий чекбокс. Если полномочия унаследованы пользователем от вышележащего раздела, чекбокс затенен и снять права нельзя.
Кнопка "edit" ("правка") рядом с именем пользователя позволяет отредактировать его права на сайте, а также изменить его данные.
Чтобы дать права пользователю, не упомянутому в списке, надо ввести его логин или полное имя (можно не полностью) и нажать кнопку "найти". После этого в списке появятся пользователи, чей логин или полное имя начинается с введенной строки.
Чтобы завести нового пользователя и дать ему права на сайте, нужно воспользоваться кнопкой "добавить пользователя".

Создание и редактирование материалов и рубрик сайта

Кнопка "add" ("добавить") позволяет создать на сайте новый объект, выбрав тип объекта из выпадающего меню. Кнопка "edit" ("правка") служит для редактирования текущего объекта.

На главной странице можно добавить рубрику, форум, фотогалерею, объявление.

На странице рубрики можно добавить рубрику, текст, внешнюю ссылку, файл, книгу, фотогалерею.

На странице книги можно добавить часть книги, главу или текст.

На странице фотогалереи можно добавить фотогалерею и фотографию.

На странице новостей можно добавить объявление.

На странице карты сайта можно добавить рубрику.

В зависимости от типа, в форме создания и редактирования объекта надо заполнить различные поля редактирования.

Идентификатор

В поле Идентификатор в режиме создания нового документа предлагается ввести уникальное имя объекта; в идентификаторе можно использовать прописные и строчные латинские буквы (различаются), цифры, знак "минус"(-) и "подчеркивание" (_); если оставить это поле пустым, в качестве идентификатора будет автоматически присвоен числовой номер

Заголовок

Поле Заголовок служит для ввода заголовка объекта. Ввод заголовка является обязательным.

Описание

Служит для ввода аннотации к материалу

URL

В поле URL вносится адрес ссылки.

Дата написания

Дата написания проставляется автоматически, ее можно изменить; можно также указать точность отображения даты (точная дата, с точностью до дня, месяца или года, или дата неизвестна).

Автор

По умолчанию в поле прописывается регистрационное имя пользователя, который добавляет объект. Если автором является другой зарегистрированный на сайте пользователь - надо прописать его регистрационное имя. (В это поле нельзя писать ФИО человека.)

Рубрика

Рубрика - поле для ввода идентификатора рубрики, в которую будет добавлен данный объект. По умолчанию прописывается в текущую рубрику (с той страницы сайта, откуда редактор вошел в интерфейс создания объекта). С помощью кнопки "выбрать" можно подобрать нужную рубрику (или рубрики) из списка всех рубрик сайта.

Часть

Выбирается в том случае, если глава, часть или текст включены в книгу.

Текст

В текстовое поле вручную вносится основной текст (его можно загрузить из файла, для которого предусмотрено поле "загрузить текст").
Вводить текст можно либо как HTML-текст, либо как обычный текст, который будет затем автоматически преобразован к формату HTML.

Загрузить текст
Поле "Загрузить текст" - предназначено для выбора с помощью кнопки "обзор" файла, который будет использован в качестве текста материала. В это поле можно загрузить тексты в форматах plain text, rtf или html.

Загрузить файл

В это поле можно загрузить любой файл.

Загрузить картинку

Поле "Загрузить картинку" позволяет выбрать и загрузить файл, который можно будет использовать как иллюстрацию внутри текста. Если текст загружался из файла в формате rtf, картинки будут выделены автоматически.

Ранее загруженные картинки можно удалить, пометив чекбокс возле картинки в форме редактирования.

Форма редактирования текста
Текст, аннотация и некоторые другие атрибуты могут быть представлены в HTML-формате (и хранятся в специальном формате Communiware ? RICHTEXT, не путать с форматом RTF). Однако вводить текст можно либо как HTML-текст, либо как обычный текст, который будет затем автоматически преобразован к формату HTML. При этом в обычном тексте можно использовать обозначения, которые затем будут преобразованы к виду HTML по следующим правилам:
вводится преобразуется в вид на экране
перенос строки: Слово1 Слово2 Слово1 Слово2 Слово1
Слово2

новый абзац: Слово1 Слово2 Слово1 Слово2 Слово1
Слово2

новый абзац обозначается пропущенной строкой

выделение (обычно курсивом): _Слово_ Слово Слово

сильное выделение (обычно жирный текст): *Слово* Слово Слово

одновременно выделить слово обоими способами нельзя

неразрывный пробел: < >  
ненумерованный список:
* Слово1 * Слово2 ...
<ul> <LI>Слово 1 <LI>Слово 2 ... </ul>
Слово 1
Слово 2
...
нумерованный список:
1. Слово1 2. Слово2 ...
<ol> <LI>Слово 1 <LI>Слово 2 ... </ol>
Слово 1
Слово 2
...
Элементов списка должно быть больше одного, они не должны начинаться с начала строки
Кроме того, в текст можно вставлять картинки, ссылки на другие объекты того же сайта и внешние адреса, обозначая их таким образом:
изображение:
pic:id/image.gif(описание)[выравнивание]
преобразуется в
<IMG src="id/image" alt="описание" align="выравнивание">

id - имя объекта, к которому присоединена картинка, image - имя файла картинки (под которым она была загружена на сайт),
файл картинки может иметь расширение gif или jpg;
указывать id, (описание), [выравнивание] необязательно, при отсутствии предполагается id - имя редактируемого объекта, alt="" align=left
ссылка на объект на сайте:
cmw:id/template#anchor(описание)
преобразуется в
<A href="server/id/template#anchor">описание</A>
описание
Обязателен только id
cсылка на почтовый адрес:
mailto:name@domen(Описание)
преобразуется в
<A HREF="mailto:name@domen">описание</A>
описание
описание необязательно
гиперссылки,
начинающиеся с

ftp://
http://
https://
news://

распознаются аналогично mailto

При работе в Internet Explorer с ActiveX от версии не ниже 5.5 есть возможность редактировать текстовое поле во встроенном HTML-редакторе.

WYSIWYG-редактирование HTML

При работе в Internet Explorer с ActiveX от версии не ниже 5.5 есть возможность редактировать текстовое поле во встроенном HTML-редакторе. Для этого в настройках пользователя надо включить режим WYSIWYG-редактирования HTML и настроить уровень безопасности Internet Explorer так, чтобы он разрешал загружать элементы ActiveX. Если не разрешать загружать элементы ActiveX, содержимое текстового поля будет выглядеть как текст HTML.
Если вы предпочитаете работать с текстовым полем как с текстом, а не HTML, поставьте в настройках пользователя включить режим WYSIWYG-редактирования HTML значение нет.
WISYWIG HTML редактор позволяет:

форматирование HTML в визуальном и ручном (режиме редактирования кода).
сохранение элементов форматирования при копировании/вставке из приложений MS Office
поддержка drag-and-drop.
возможность сохранения(или восстановления) копии редактируемого HTML кода на диск.
возможность автоматического удаления нежелательных HTML тэгов и элементов стилевой разметки.

Описание функциональных кнопок:

Сохранить копию редактируемой страницы на диск

Открыть страницу с диска

Отменить все изменения, работает так же как кнопка Reset у формы, только для этого окна.

Откат (Undo)

Отмена отката (Redo)

Создать гиперссылку

Добавить картинку - опрашиваются поля используемой формы <input type="file"> и при наличии в них файлов .gif, .jpg, .png выдается список этих картинок

Сделать отступ слева

Убрать отступ

Нумерация

Маркеры (Bullets)

Очистка тэгов - производится удаление тэгов или их параметров которые указаны при подключении. (см. методы подключения)

Отобразить скрытые элементы страницы

HTML Переключение в режим редактирования HTML кода.

Список команд, вызываемых по правой кнопке мыши(Shift+F10):

Cut - удаление выделенного фрагмента с копированием
Copy - копирование выделенного фрагмента
Paste - вставка ранее скопированного фрагмента
Bold - текст жирным
Italic - текст курсивом
Underline - подчеркнутый текст
Align Left - уровнять по левой стороне
Align Center - уровнять по сентру
Align Right - уровнять по правой стороне
Link - сделать ссылку на другой документ
Select All - выделить все
Remove Formatting - удалить элементы форматирования у выделенного объекта.
Undo - (откат) - отменить последнее изменение
Redo - отменить откат
Image Properties - изменить параметры картинки

Офисная мебель