cms4site™ :: Работа с сайтом. Руководство пользователя
cms4site™ система построения сайтов и управления контентом 3.5.11
 U21RU 



cms4site™ :: Работа с сайтом. Руководство пользователя
[2]



ОГЛАВЛЕНИЕ

          СОСТАВНЫЕ ЧАСТИ САЙТА         3
                    Полная конфигурация         3
                    Минимальная конфигурация         4
                    Максимальная конфигурация         4
          СТРУКТУРА ДИРЕКТОРИЙ         4
          СТРУКТУРА САЙТА         5
                    Файл структуры сайта         5
                    Пример структуры         5
                    Ветка страницы         5
          ПРОЦЕССОР КОНТЕНТА         6
                    Текст         6
                    Атрибуты текста*         7
                    Специальные символы*         7
                    Выравнивание текста*         8
                    Подзаголовки         8
                    Списки*         8
                    Ссылки и адреса e-mail         9
                    Изображения         10
                              В области контента         10
                              В отдельном окне         10
                    Таблицы*         11
                    Файлы         12
                    HTML тэги*         12
                    Модули PHP         12
                    Комментарии         12
                    Подстановка, константы сайта         13
          РАБОТА САЙТА         14
          ОГРАНИЧЕНИЯ ИМЕН ФАЙЛОВ         14
          ДОПОЛНИТЕЛЬНЫЕ ФАЙЛЫ ДАННЫХ         15
©2000-2008 cms4site group. All rights reserved
http://web.demos-spb.ru,


cms4site™ :: Работа с сайтом. Руководство пользователя
[3]




СОСТАВНЫЕ ЧАСТИ САЙТА


На диаграмме приведена полная и наиболее часто используемая конфигурация системы. Возможен широкий диапазон различных вариантов конфигураций.



Полная конфигурация

Центр управления сайтом - приложение, работающее под Windows, позволяет изменять структуру сайта и организовывает доступ к другим приложениям для изменения контента, а также совместную работу с Администратором сайта. Имеет встроенные в MS Word и MS Excel конвертеры.

Структура сайта - текстовый файл, содержащий описание всех страниц сайта, их очередность, вложенность, названия и др. Изменяется при работе с Центром управления сайтом, но может меняться вручную, текстовым редактором.

Константы сайта - текстовый файл, содержащий многоязыковые фрагменты текста для сайта, как правило не относящиеся к области контента. Это может быть, например, название компании, ключевые слова, слоган, год запуска сайта, адрес и телефон, адрес электронной почты и т.п. Изменяется либо в MS Word, либо вручную, текстовым редактором, в зависимости от того, что реализовано разработчиком.

Файлы контента .dat - текстовые файлы, содержащие информацию, показываемую на страницах сайта. Изменяются либо в приложениях MS Office (конвертерами), либо вручную, текстовым редактором, в зависимости от того, что реализовано разработчиком. Для одной страницы сайта может применяться несколько файлов контента, может не быть ни одного, также возможны дополнительные файлы контента.

Офисные файлы .rtf, .xls - содержат изменяемую менеджером сайта информацию, которая конвертируется затем в файлы контента .dat, совпадают по именам с последними. Возможна однократная конвертация, с последующим удалением офисного файла и дальнейшим использованием для изменений текстового.


cms4site™ :: Работа с сайтом. Руководство пользователя
[4]



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

Администратор сайта - работает на хостинговом сервере (на сайте), вызывается обращением к защищенной паролем странице, обеспечивает перенос файлов контента с компьютера менеджера сайта на сайт и обратно, прямое редактирование текстовых файлов, удаление файлов контента и пр. Аналогичные действия менеджер сайта может проводить посредством FTP-доступа.

Движок сайта - работает на хостинговом сервере (на сайте), обеспечивает выдачу страниц сайта на основе его структуры, констант, файлов контента, стандартных и нестандартных программ и шаблонов дизайна, связанных разработчиком в единый комплекс.

Минимальная конфигурация

В этом случае используется только веб-сервер, изменение файлов производится с использованием FTP-доступа или, что тоже необязательно, текстового редактора Администратора сайта. Единственным плюсом такого подхода является возможность вносить изменения с любого компьютера, подключенного к Интернет. Естественно, что все ошибки выявляются и устраняются на "живом" сайте, что не очень уместно для сайтов с высокой посещаемостью. В cms4site™ имеется возможность отладки файлов контента специально для таких случаев.

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

Максимальная конфигурация

Вместо компьютера менеджера сайта используется локальный сервер, доступный одновременно как по http-протоколу (то есть к нему можно обращаться броузером), так и в виде жесткого диска (например, W:\). В этом случае все изменения и их отладка производятся на локальном сервере, а затем изменения переносятся на основной сайт на хостинге. На компьютере менеджера рекомендуется хранить архивы локального сайта, который в этом случае на 100% совпадает с основным сайтом. На нем же запускается и Центр управления сайтом, но все данные находятся на локальном сервере, доступном в качестве диска.

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

СТРУКТУРА ДИРЕКТОРИЙ


Стандартная структура директорий сайта (обязательные помечены *), одинаковая как в локальной копии или на локальном сервере, так и на хостинге, такова:
  • (корневая)* - содержит основной файл для обращения к сайту index.php и служебные файлы
  • mycontent* - контент сайта (файлы .dat)
  • mycurrency - кэш файлов погоды и валют
  • myecat - данные каталога продукции xmmecat
  • myfiles - файлы для скачивания (.zip, .exe, .pdf)
  • mygblight - записи гостевой книги
  • myguest - отладка файлов контента
  • myimages* - изображения для контента страниц сайта
  • myphp - нестандартные программные модули для данного сайта
  • mysend - отправленные формы (письма)
  • mysitemenu* - структура сайта и константы сайта: sitemenu.dat, sitedata.dat
  • mysqldata - данные обмена с MySQL
  • mystat - данные сбора статистики посещений
  • myuauth - данные для авторизации посетителей сайта
  • myupdatelog - журнал обновлений сайта Администратором
  • qlayout* - шаблоны дизайна и программы данного сайта
  • qimages* - изображения для шаблонов дизайна данного сайта
  • xmmadmin - Администратор сайта, программы сбора и обработки статистики, MySQL-редактор
  • xmmdocs - документация по системе в формате pdf
  • xmmfiles* - стандартные программы cms4site™
  • xmmimages* - стандартные изображения cms4site™
  • xmmscript* - подгружаемые стили и программы javascript
  • xmmsetup* - настройка программ cms4site™ для данного сайта

Менеджер сайта может менять информацию только в директориях my* (кроме myphp). Директории myphp, qlayout, qimages, xmmsetup отражают дизайн и функциональность данного сайта. Директории xmmadmin, xmmfiles содержат ненастраиваемую часть cms4site™ и могут заменяться целиком при обновлении ее версий.


cms4site™ :: Работа с сайтом. Руководство пользователя
[5]



СТРУКТУРА САЙТА


Данный раздел носит ознакомительный характер относительно формата файла, если вы работаете с Центром управления сайтом. Однако принцип идентификации страниц сайта будет полезен в любом случае.

Файл структуры сайта

Файл sitemenu.dat - текстовый. Каждая строка описывает одну страницу и имеет следующий формат:

<U>#ID|name|info|data1|data2|data3|...|dataN

U - Уровень вложенности данной страницы, начиная с 0. Самая первая страница должна иметь уровень 0. Уровень некоторой страницы может быть на 1 больше чем у предыдущей (подстраница), равен ему (на том же уровне), или меньше (относится к более старшему уровню). Обычно уровень 0 отводится для языковых версий, даже если язык на сайте всего один. Рекомендуется (и это реализовано в Центре управления) сдвигать строки табуляцией согласно значению уровня.

# - Признак перехода на следующую страницу.

ID - Идентификатор страницы (последовательность латинских букв на нижнем регистре и/или цифр). Идентификаторы соседних страниц одного уровня должны быть уникальны. Желателен однотипный подход к смысловой интерпретации идентификаторов (либо английские слова, либо транслит). NB! Начальная страница неязыкового уровня должна иметь идентификатор index.

name - Имя пункта меню (страницы).

info - Краткое описание страницы (появляется в подсказках, карте сайта и.т.п.). Пустое поле задается как &nbsp; - символ неразрывного пробела в HTML-разметке.

dataN - Специальные поля данных, определяемые при разработке сайта. Формат и назначение отражены в документации по сайту.

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

Пример структуры

<0>#ru|RU|Russian version
    <1>index|Начало|
        <2>codetable|Кодировка|Таблица русской кодировки
        <2>randomdata|Огласите весь цитатник, пожалуйста!|Весь в виде таблицы
    <1>content|Контент|Обработчик контента в действии
        <2>text|Текст|Отступы абзацев, текстовые атрибуты
        <2>headings|Заголовки|Заголовки без атрибутов
        <2>lists|Списки|Одно- и двухуровневые списки
        <2>links|Ссылки/Мэйлы|Распознавание внешних/внутренних ссылок, мэйлов
        <2>tables|Таблицы|Представление таблиц|LABEL1
        <2>images|Изображения|В тексте и в отдельных окнах
#       <2>files|Файлы|Файлы для скачивания
        <2>html|HTML|Тэги HTML||LABEL2
        <2>php|PHP|Вызов модулей PHP
        <2>replace|Подстановка|Подстановка переменных значений
        <2>comments|Комментарии|Временная отмена строк контента
        <2>nocontentfile|Нет файла|Отсутствующий файл контента
    <1>webmodules|Модули|Стандартные модули в cms4site
        <2>search|Поиск|Поиск по сайту
        <2>sitemap|Карта|Карта сайта
            <3>all|Все языки|Полная карта сайта
            <3>short|Укороченная|Укороченная по уровню вложенности
            <3>small|Маленькая|Ну совсем небольшая
            ...


Ветка страницы

В примере подчеркнут путь к некоторой странице, этот путь (ветка) составлен из идентификаторов всех страниц на пути к ней, начиная со старшей: ru-content-replace. Ветки страниц используются для их вызова (например, www.mysite.ru/ru-content-replace.html), определения имени файлов контента (например, ru-content-replace.dat, ru-content-replace.2.dat) и т.п. Пример еще одной ветки: ru-webmodules-sitemap-short.


cms4site™ :: Работа с сайтом. Руководство пользователя
[6]



ПРОЦЕССОР КОНТЕНТА


Предназначен для обработки файлов контента перед выводом их в контентную область страниц сайта. Может не применяться, если контентные файлы представляют собой 100% HTML, подготавливаемый продвинутым менеджером сайта. В иных случаях обрабатываются как подготовленные вручную файлы контента, так и сформированные конвертерами MS Office. Разница между двумя последними приемами в том, что некоторые конструкции (например, таблицы) переходят из приложений MS Office, где задаются именно как таблицы, а другие (например, изображения) нужно задавать одинаково в обеих случаях. Все это особо отмечается в данной инструкции - знаком * отмечены те пункты, которые справедливы только для ручного набора файлов контента и не применяются в приложениях MS Office.

Текст

Состоит из абзацев (последовательности слов, разделенных пробелом). Абзацы отделяются друг от друга переводом строки (по клавише Enter). Не следует путать переносы, возникающие при свертке строк (в MS Word, например) с переводами строк. Если в редакторе текста или MS Word включен режим показа спецсимволов, переводы строк показываются знаком ¶. Как правило, показ текста на сайте настраивается так, что для отделения абзацев нужно два перевода строки подряд, например:

Текст первого абзаца.¶
¶ 
Текст второго абзаца.


Пустые строки распознаются Процессором контента, и разработчик может назначить для них, например, уменьшенный интервал. Если это не реализовано, меньший интервал можно задать включением между абзацами специального изображения-разделителя xmmspace.gif:

Текст первого абзаца.¶
xmmspace.gif¶
Текст второго абзаца.


Если же такая возможность имеется, стандартный интервал будет задаваться тремя переводами строки (двумя пустыми строками):

Текст первого абзаца.¶
¶ 
¶ 
Текст второго абзаца.


Если вы хотите отделять абзацы одним переводом строки, а начало следующего отодвигать вправо, нельзя применять пробелы или табуляцию. Это связано со спецификой показа текста броузером, который сокращает многократные пробелы и табуляцию до одного пробела. Для такого действия необходим специальный знак "неразрываемый пробел" &nbsp;

Текст первого абзаца.¶
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Текст второго абзаца.


В MS Word такой пробел задается из меню спецсимволов или по комбинации клавиш Ctrl+Shift+пробел.

На что еще следует обращать внимание при наборе текста?
  • Пробел перед переводом строки может вызвать лишний отступ: ...окончание текста абзаца. ¶
  • Пробел перед запятой, точкой, восклицательным и вопросительным знаками, двоеточием, точкой с запятой, закрывающей скобкой, закрывающей кавычкой, не только уродлив, но и может привести к переносу этого знака на новую строку.
  • Пробел после открывающей кавычки, открывающей скобки, не только уродлив, но и может привести к переносу следующего за ними текста на новую строку.
  • Не следует путать тире и дефис ("серо-буро-малиновый", но "наш Васька – плут"). Кстати, cms4site™ можно настроить на замену двух знаков дефиса подряд на типографское тире... Вообще-то есть длинное тире &#151; и короткое &#150; (emdash и endash в MS Word).


cms4site™ :: Работа с сайтом. Руководство пользователя
[7]



Атрибуты текста*

NB! В MS Word просто назначайте атрибуты текста (участков текста). А вообще, здесь идет речь о тэгах и спецсимволах HTML, но рассмотрены лишь несколько самых простых и наиболее полезных... Естественно, что при просмотре страницы броузером сами тэги (как здесь) не показываются, виден только результат.

  1. Жирность текста задается <B>таким</B> образом.
  2. Курсив (не злоупотребляйте курсивом - плохо читается) <I>задается</I> так.
  3. Жирный курсив - <B><I>комбинация</I></B> двух предыдущих.
  4. Подчеркивание, также <U>действует в комбинациях с <I>курсивом</I>, <B>жирностью</B> и <B><I>жирнокурсивностью</I></B></U>. Обратите внимание на правильную вложенность открывающих <ТЭГ> и закрывающих </ТЭГ> тэгов - "позже открыт - раньше закрыт".
  5. Цвет шрифта задается <FONT COLOR=red>так</FONT>. Вместо red могут быть заданы различные значения цвета, как текстовые (red, green, blue, yellow, lightyellow...), так и цифровые (#FF9900 - оранжевый, #FFFFFF - белый, #000000 - черный...), для чего нужно обратиться к документации по HTML.
  6. Шрифт <BIG>увеличенного</BIG> и <SMALL>уменьшенного</SMALL> размера.
  7. Шрифт фиксированной ширины (курьер) <TT>задается так</TT>.
  8. Неразрывность участка текста (например, в телефонном номере) задается так:
    <NOBR>+7 (812) 100-00-00</NOBR>, поскольку иначе перенос производится броузером по знакам пробела и дефиса. Связать два и более слов можно с помощью знака неразрывного пробела &nbsp; первое_слово&nbsp;второе_слово, А.&nbsp;С.&nbsp;Пушкин.
  9. Верхние и нижние индексы C<SUB>2</SUB>H<SUB>5</SUB>OH, r<SUP>2</SUP>/2 (C2H5OH, r2/2).
  10. Заголовок

    <H1>назначается так</H1>

    При этом происходит самопроизвольный гарантированный перенос (как здесь) на отдельную строку с вертикальными отступами (вертикальные отступы могут быть заблокированы через настройку соответствующих параметров в таблицах стилей css). Возможны еще H2, H3,..., H6 - желательно, чтобы разработчик назначил им определенные характеристики.

Специальные символы*

Предназначены для показа любых, в том числе и специальных, отсутствующих на клавиатуре символов. Имеется два способа назначения:
  • По названию - &название;
  • По номеру символа - &#номер;

Приведем список наиболее употребительных, за остальными обращайтесь к документации по HTML.
  • &nbsp; неразрываемый пробел
  • &reg; ® зарегистрированная торговая марка
  • &copy; © знак авторских прав
  • &#8482; ™ торговая марка
  • &deg; ° градус
  • &#8364; € евро
  • &#151; — длинное тире
  • &#150; – короткое тире
  • &#177; ± плюс-минус
  • &amp; & амперсанд
  • &lt; < угловая скобка открывающая
  • &gt; > угловая скобка закрывающая
  • &quot; " двойная кавычка
  • &laquo; « кавычка-елочка открывающая
  • &raquo; » кавычка-елочка закрывающая
  • &bull; • буллет


cms4site™ :: Работа с сайтом. Руководство пользователя
[8]



Выравнивание текста*

<DIV ALIGN=justify>Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки.</DIV>

<DIV ALIGN=right>Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо.</DIV>

<DIV ALIGN=center>Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру.</DIV>

Принудительный обрыв текста<BR>
в<BR>
произвольном месте. В MS Word - Shift-Enter.

<DIR>Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца. Отступ абзаца.</DIR>
<DIR><DIR>Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца. Двойной отступ абзаца.</DIR></DIR>

Подзаголовки

Процессор контента определяет строки, в которых все символы набраны прописными буквами. Такие строки могут интерпретироваться как подзаголовки в настройках сайта. Например, если набрано:

ТЕКСТ ПОДЗАГОЛОВКА

выводится (а почему бы и нет?):

| ТЕКСТ ПОДЗАГОЛОВКА

Отменить такое распознавание для конкретной строки (например, телефона) можно различными способами:

(812)&nbsp;100-33-33
EE820/1600-76&nbsp;
ЭТО НЕ ПОД<b></b>ЗАГОЛОВОК

Списки*

Список первого уровня задается так:
- Первый элемент списка
- Второй элемент списка

. . .


Список второго уровня задается так:
+ Первый элемент списка
+ Второй элемент списка

. . .


Нумерованный список задается так:
* Первый элемент списка
* Второй элемент списка

. . .



cms4site™ :: Работа с сайтом. Руководство пользователя
[9]



Пример комбинации строк списков

Двухуровневый список:
  • Первый элемент списка
    • А вот и второй уровень
    • А вот и второй уровень
  1. Вклинилась цифра
  • И даже с правильной пунктуацией, когда надо.
    • А вот и второй уровень
    • А вот и второй уровень

  • И даже одна строка может быть списком.

Нумерованный списочек:
  1. Первый элемент списка
  2. Второй
  3. Последний

И даже вот этак можно:
    • Далеко

Ссылки и адреса e-mail

Внешние ссылки (на сайты, отличные от данного) распознаются Процессором контента в следующих форматах:
  • www.sitename.com - если начинается с www. и имеет правильный синтаксис
  • http://sales.sitename.com - если не начинается с www. и имеет правильный синтаксис

Адреса электронной почты распознаются по знаку @ и правильному синтаксису:
  • mail@mail.mail

Внутренние ссылки (на страницы данного сайта) лучше задавать в специальном формате:
  • here://ветка - по ветке страницы, например: here://ru-content-lists
  • here://ветка#МЕТКА - то же, с установкой на метку внутри страницы, например: here://ru-content#E1
  • here://ИДЕНТИФИКАТОР - по идентификатору страницы (прописные буквы!) в поле data1 структуры сайта, например: here://UU16
  • here://ИДЕНТИФИКАТОР#МЕТКА - то же, на метку, например: here://UU16#A1
  • hnew://всеварианты - все рассмотренное выше, но с открытием в новом окне.

NB! При наборе ссылок в MS Word не следует делать их активными. Если MS Word сделал-таки ссылку активной, отменить это действие сразу же можно кнопкой отмены или Ctrl-Z. Иначе - удалением ссылки через меню Вставить/Гиперссылка.

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

www.sitename.ru [Клевый сайт тут!]

Отменить обработку ссылок можно в настройках сайта в целом, настройке данной страницы в структуре сайта, и непосредственно в самой ссылке, приемами аналогичными применяемым к подзаголовкам, например:
  • ht<b></b>tp://sales.sitename.com
  • ww<b></b>w.sitename.com
  • he<b></b>re://ru-webmodules-sitemap-small
  • mail<b></b>@mail.mail

Также в cms4site™ имеется функциональные модули xmmcollect.php, xmminner.php, xmmtoplevel.php, xmmprevnext.php решающие задачи навигации внутри страницы и внутри сайта.


cms4site™ :: Работа с сайтом. Руководство пользователя
[10]



Изображения

В области контента

Для размещения изображений из директории myimages или ее поддиректорий (например, myimages/a01), достаточно указать имя файла изображения в отдельной строке:

image12006.jpg
a01/bigpribor.gif


Для размещения среди других элементов (в таблице, в тексте) используются квадратные скобки:

Начало текста [image12006.jpg] окончание текста.

Изображения показываются в масштабе 1:1. Изменить масштаб и другие параметры показа можно применением параметров HTML-тэга IMG, наиболее употребительные из которых приведены ниже. Следует учесть, что произвольно изменять высоту и ширину можно не для всех изображений, иначе возникнут искажения.

Пример применения параметров и наиболее употребительные из них:

image001.jpg width=100 height=100 border=1 alt="Прибор 001"

  • width=100 - ширина изображения в точках (пикселях)
  • height=100 - высота изображения в точках (пикселях)
  • border=1 - толщина рамки вокруг изображения в точках (пикселях)
  • border=0 - нет рамки
  • alt="Текст" - комментарий (появляется во всплывающей подсказке при наведении курсора)
  • vspace=4 - отступ сверху и снизу в точках (пикселях)
  • hspace=8 - отступ слева и справа в точках (пикселях)
  • align=right - изображение сдвигается к правому краю, текст обтекает его слева
  • align=left - текст обтекает изображение справа

В cms4site™ имеется специальное полностью прозрачное изображение xmmspace.gif размером 6х6 точек, для создания нестандартных отступов между абзацами:

xmmspace.gif
xmmspace.gif height=19

В отдельном окне

Большие изображения рекомендуется показывать в отдельных окнах, задавая их так:

bigimage.jpg * Текст для ссылки открытия окна

Можно подготовить маленькие изображения предварительного просмотра, например:

big/img01.jpg * [small/img01.jpg border=0] Текст
big/img02.jpg * [small/img02.jpg border=0]

Если на сервере для PHP установлена библиотека GD, изображения предварительного просмотра могут создаваться автоматически:

bigimage1.jpg + Текст
bigimage2.jpg +

NB! Правило квадратных скобок здесь не применяется, т.е. для показа одного изображения нужна отдельная строка.


cms4site™ :: Работа с сайтом. Руководство пользователя
[11]



Таблицы*

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

Основные правила обработки таблиц:
  • Пустые строки и столбцы пропускаются.
  • Первая (в том числе и пустая пропускаемая) строка - заголовок (шапка).
  • Строка с пустой первой, непустой второй ячейкой и отсутствием других ячеек - подзаголовок, объединяющий все ячейки строки.
  • Пробелы (кроме &nbsp;) и табуляция по краям ячеек игнорируются.
  • В ячейках распознаются тэги HTML, изображения и ссылки.

Пример задания таблицы в исходном тексте (параметры изображений опущены):

Код|Наименование|Фото|Цена
|Комплект 1
101|Брюбрик Классический|poll01m.jpg|600.00
102|Брюбрик Супер|poll02m.jpg|700.00
103|Брюбрик Супер-Пупер|poll03m.jpg|899.00
|Комплект 2
201|Брябрик Супер|poll04m.jpg|900.00
202|Брябрик Супер-Пупер|solo.gif|999.99


Результат обработки:

КодНаименованиеФотоЦена
Комплект 1
101Брюбрик Классический600.00
102Брюбрик Супер700.00
103Брюбрик Супер-Пупер899.00
Комплект 2
201Брябрик Супер900.00
202Брябрик Супер-Пупер999.99

Примеры табличных фокусов:

Таблица 1. Ячейка шапки

Пример задания таблицы в исходном тексте

Пример задания таблицы в исходном тексте|

Таблица 2. Ячейка подзаголовка

Пример задания таблицы в исходном тексте

| 
|Пример задания таблицы в исходном тексте


Таблица 3. Обычная ячейка

Пример задания таблицы в исходном тексте

| 
Пример задания таблицы в исходном тексте|


Внимание! При необходимости помещения в таблицу вертикальной черты ее надо задать так: &#124;


cms4site™ :: Работа с сайтом. Руководство пользователя
[12]



Файлы

Для построения ссылок на скачиваемые файлы с указанием их атрибутов достаточно разместить сами файлы в директории myfiles или ее поддиректориях, а в тексте указать имя файла:

en-convert-doc.zip
en-convert-doc.exe

Результат:

 en-convert-doc.zip  1,721 байт 11.01.2005 17:53:26  
 en-convert-doc.exe  5,922 байт 11.01.2005 17:53:27  

Для организации скачивания большого количества файлов имеется функциональный модуль xmmdirlist.php основывающийся только на именах директорий и файлов.

HTML тэги*

Допускается использование любых тэгов HTML, разрешенных разработчиком в настройках системы:

<HR NOSHADE WIDTH=40% SIZE=1 COLOR=silver ALIGN=left>
<HR NOSHADE WIDTH=32 SIZE=32 COLOR=silver ALIGN=left>
<HR NOSHADE WIDTH=40% SIZE=1 COLOR=silver ALIGN=left>






Модули PHP

Вызываются как стандартные функциональные модули cms4site™, так и любые другие, вызов которых обеспечен разработчиком (размещены в директории myphp или ее поддиректориях). Это может быть, например, база данных продукции. Вызываемому модулю может передаваться строка параметров произвольного формата, например:

xmmprevnext.php
prodatabase.php load=20099,accnt=6E555RTY3
xmmsitemap.php SHORT ALL INFO
xmmdatetime.php * MYRUN C,D,T

Вызов модуля xmmdatetime.php из последней строки примера:


Кроме вызова из контента, разработчик может обеспечить вызов модулей, указанных, например, в структуре сайта (в полях dataN). В этом случае контентный файл может не понадобиться совсем.

Стандартные функциональные модули описаны в отдельном документе.

Комментарии

Строки файлов контента можно временно комментировать знаком @ в первой позиции строки. При необходимости размещения этого знака в первой позиции можно воспользоваться таким приемом:

<b></b>@ Результат

@ Результат

Закомментированные строки не попадают в выходной поток ни в каком виде и не участвуют в поиске по сайту.


cms4site™ :: Работа с сайтом. Руководство пользователя
[13]



Подстановка, константы сайта

cms4site™ обеспечивает подстановку констант, заданных в системе, а также определенных разработчиком и менеджером сайта.

Системные константы:
  • sysvers - версия системы;
  • sysyear - текущий год;
  • sysdate - текущая дата;
  • systime - текущее время;
  • sysserver - имя сайта;
  • все константы, определенные в модуле XMMLocale(), например, 'reload'.

Пример:

%%mysite%% %%sysvers%% &copy;%%sysyear%% %%democopy%%
%%sysdate%% %%systime%% %%sysserver%%

Результат:

cms4site™ 3.5.11 ©2008 cms4site group. All rights reserved
10.04.2008 15:09:36 www.cms4site.ru

Пользовательские константы берутся из файла sitedata.dat. Если вы пишете на многих страницах телефон фирмы, задайте его через константу, тогда при изменении номера достаточно будет исправить его всего в одном месте.

Файл констант сайта состоит из строк, каждая из которых определяет одну константу и имеет следующий формат:

идентификатор|английский|немецкий|русский|словацкий

Идентификаторы должны содержать только латинские буквы на нижнем регистре и цифры, рекомендуется начинать идентификатор с символов my во избежание путаницы. Если сайт одноязыковый, для неиспользуемых языков нужно оставить пустые значения полей, например:

myslogan|||Низкие цены - икачество!

Константа mysite зарезервирована для размещения в начале титула окна броузера. По стандартным настройкам системы туда выводится значение этой константы и имена страниц от начальной до текущей, например, при задании для mysite значения ПРОГРЕСС в титуле появится надпись вида:

ПРОГРЕСС - Продукция - Брюбрики - B700 - Microsoft Internet Explorer

Пустые строки и строки, начинающиеся со знака # пропускаются. Файл имеет табличный формат и при желании может модифицироваться из MS Word.



cms4site™ :: Работа с сайтом. Руководство пользователя
[14]



РАБОТА САЙТА


Рассмотрим, как работает сайт при запросе страницы.

  1. Загружается движок сайта, назначаются его настройки, инициализируется сжатие выходного потока.
  2. Считывается структура сайта, определяется текущая страница, текущий язык, формируется система навигации для данной страницы.
  3. Проверяются условия возможной выдачи 404 кода (страница не найдена).
  4. Проверяется необходимость переадресации страницы.
  5. Срабатывает система сбора статистики.
  6. Проверяется авторизация доступа к странице (если использована).
  7. Загружается языковая поддержка, стили, программы javascript, константы сайта.
  8. Загружается процессор контента, назначаются его настройки.
  9. Считывается шаблон страницы и начинает формироваться HTML-код с системами меню.
  10. Вызывается процессор контента.
  11. Считывается файл контента.
  12. Выполняется функция подстановки.
  13. Выполняется функция разработчика (необязательная).
  14. Производится распознавание объектов в строках контента.
  15. Формируется HTML-код области контента по шаблонам настроек.
  16. Заканчивается формирование HTML-кода страницы, сформированный код отправляется запросившему ее.

Замечания:

  • На этапе 9 возможен выбор вида шаблона страницы по уровню ее вложенности или по данным, заданным в структуре сайта.
  • Этапы 10-15 повторяются для каждой области контента, если их несколько. Здесь возможен также анализ наличия файлов контента и формирование разных шаблонов сайта на основе этого анализа. Например, правая дополнительная колонка формируется только тогда, когда имеется файл контента вида ветка.2.dat (в дополнение к основному ветка.dat).
  • На этапе 13 может быть вызвана функция разработчика, которой доступны любые действия по изменению области контента. Например, адреса электронной почты, заданные как mail@@mail.mail выводить нормально, но не делать активными.
  • На этапе 15 возможно изменение шаблонов настроек (например, для изменения дизайна таблиц), в том числе в пределах одной области контента. Например, вызов mytable.mini.php перед таблицей, изменяет ее дизайн (предполагается, что указанный модуль подготовлен разработчиком в директории myphp).
  • Для страниц с вызовом функционального модуля из структуры сайта вместо этапов 10-15 происходит непосредственное выполнение модуля, который самостоятельно формирует область контента. Например, модуль поиска необязательно вызывать в файле контента, который в этом случае будет состоять всего из одной строки: xmmsearch.php, удобнее задать такой вызов в структуре сайта.


ОГРАНИЧЕНИЯ ИМЕН ФАЙЛОВ


Система правильно обрабатывает имена файлов, если они включают в себя только указанные символы:
  • латинские буквы на нижнем регистре;
  • цифры;
  • знак минуса;
  • знак подчеркивания;
  • десятичную точку.

Желательно, чтобы части имени, отделенные десятичной точкой, не были пустыми.


cms4site™ :: Работа с сайтом. Руководство пользователя
[15]



ДОПОЛНИТЕЛЬНЫЕ ФАЙЛЫ ДАННЫХ


Для работы некоторых функциональных модулей требуются отдельные файлы данных. Они могут быть привязаны к текущей странице (т.е. частично совпадать по имени с основным файлом контента), например:

ru-contacts-letter.dat - основной файл контента с вызовом формопостроителя xmmformsender.php
ru-contacts-letter.form.dat - файл с данными формы (письма) для формопостроителя

ru-order.dat - основной файл контента с вызовом формопостроителя xmmformsender.php
ru-order.form.dat - файл с данными формы (заказа) для формопостроителя

Если же модуль формопостроителя вызывается из структуры сайта, файлу с данными формы может быть назначено имя основного файла контента ru-contacts-letter.dat, хотя правила построения этого файла несколько иные.

Или, например, для модуля вывода анонсов xmmrandom.php, вызываемого в шаблоне сайта для всех страниц и выводящего по два случайно выбранных анонса из нескольких, нужен файл данных с анонсами, не привязанный ни к какой странице. Предположительно его имя с учетом языков может быть таким: ru.announces.dat.

Общие принципы построения дополнительных файлов данных таковы:
  • Файлы имеют табличный формат, т.е. поля данных в строке разделяются символом вертикальной черты | и могут, следовательно, готовиться в MS Word. Если поле данных в каждой строке всего одно, знак | не требуется.
  • Все строки имеют однотипный формат, поэтому размещение дополнительной информации в таком файле не предусмотрено
  • Пустые строки и строки, начинающиеся со символа # пропускаются. Эта разница в комментировании строк позволяет при необходимости использовать файл как обычный контентный.
  • Файлы не совпадающие по имени с контентным не участвуют в поиске по сайту, что можно регулировать способом вызова функционального модуля - из контентного файла или из структуры сайта, как показано выше в примере.

Пример файла данных анонсов для модуля xmmrandom.php

#Head|Text|Link|Image
Angleterre****+ special offer SGL/DBL $241/$272||en-spb-hotels-ang
Ost-West Kontaktservice awards||en-welcome-award|award-an.gif
Order accommodation and get free visa invitation||en-accom
The Amber Room is the most popular excursion object||en-sights-excursions
Super Discount for standard rooms in Grand Hotel Emerald||en-spb-hotels-eme
Get your invitation to Russia online in 5 minutes||en-visa-online


и его показ в табличном виде

#HeadTextLinkImage
Angleterre****+ special offer SGL/DBL $241/$272 en-spb-hotels-ang 
Ost-West Kontaktservice awards en-welcome-awardaward-an.gif
Order accommodation and get free visa invitation en-accom 
The Amber Room is the most popular excursion object en-sights-excursions 
Super Discount for standard rooms in Grand Hotel Emerald en-spb-hotels-eme 
Get your invitation to Russia online in 5 minutes en-visa-online