cms4site™ :: Работа с сайтом. Руководство пользователя U21RU
ОГЛАВЛЕНИЕ
СОСТАВНЫЕ ЧАСТИ САЙТАНа диаграмме приведена полная и наиболее часто используемая конфигурация системы. Возможен широкий диапазон различных вариантов конфигураций. Полная конфигурация Центр управления сайтом - приложение, работающее под Windows, позволяет изменять структуру сайта и организовывает доступ к другим приложениям для изменения контента, а также совместную работу с Администратором сайта. Имеет встроенные в MS Word и MS Excel конвертеры. Структура сайта - текстовый файл, содержащий описание всех страниц сайта, их очередность, вложенность, названия и др. Изменяется при работе с Центром управления сайтом, но может меняться вручную, текстовым редактором. Константы сайта - текстовый файл, содержащий многоязыковые фрагменты текста для сайта, как правило не относящиеся к области контента. Это может быть, например, название компании, ключевые слова, слоган, год запуска сайта, адрес и телефон, адрес электронной почты и т.п. Изменяется либо в MS Word, либо вручную, текстовым редактором, в зависимости от того, что реализовано разработчиком. Файлы контента .dat - текстовые файлы, содержащие информацию, показываемую на страницах сайта. Изменяются либо в приложениях MS Office (конвертерами), либо вручную, текстовым редактором, в зависимости от того, что реализовано разработчиком. Для одной страницы сайта может применяться несколько файлов контента, может не быть ни одного, также возможны дополнительные файлы контента. Офисные файлы .rtf, .xls - содержат изменяемую менеджером сайта информацию, которая конвертируется затем в файлы контента .dat, совпадают по именам с последними. Возможна однократная конвертация, с последующим удалением офисного файла и дальнейшим использованием для изменений текстового.
Прочие файлы - архивы, изображения и т.п. готовятся менеджером сайта в доступных ему приложениях. Администратор сайта - работает на хостинговом сервере (на сайте), вызывается обращением к защищенной паролем странице, обеспечивает перенос файлов контента с компьютера менеджера сайта на сайт и обратно, прямое редактирование текстовых файлов, удаление файлов контента и пр. Аналогичные действия менеджер сайта может проводить посредством FTP-доступа. Движок сайта - работает на хостинговом сервере (на сайте), обеспечивает выдачу страниц сайта на основе его структуры, констант, файлов контента, стандартных и нестандартных программ и шаблонов дизайна, связанных разработчиком в единый комплекс. Минимальная конфигурация В этом случае используется только веб-сервер, изменение файлов производится с использованием FTP-доступа или, что тоже необязательно, текстового редактора Администратора сайта. Единственным плюсом такого подхода является возможность вносить изменения с любого компьютера, подключенного к Интернет. Естественно, что все ошибки выявляются и устраняются на "живом" сайте, что не очень уместно для сайтов с высокой посещаемостью. В cms4site™ имеется возможность отладки файлов контента специально для таких случаев. Также рекомендуется не надеяться на резервное копирование данных хостинг-провайдером и все-таки иметь свою более-менее регулярно обновляемую копию данных (а лучше - всего сайта). Максимальная конфигурация Вместо компьютера менеджера сайта используется локальный сервер, доступный одновременно как по http-протоколу (то есть к нему можно обращаться броузером), так и в виде жесткого диска (например, W:\). В этом случае все изменения и их отладка производятся на локальном сервере, а затем изменения переносятся на основной сайт на хостинге. На компьютере менеджера рекомендуется хранить архивы локального сайта, который в этом случае на 100% совпадает с основным сайтом. На нем же запускается и Центр управления сайтом, но все данные находятся на локальном сервере, доступном в качестве диска. Основной плюс данной конфигурации в оперативности работы при отладке: исправил, сконвертировал, перечитал. Кроме того, к локальному серверу возможно организовать ограниченный (по соображениям безопасности, скорости и трафика) внешний доступ для предварительного просмотра сайта через Интернет. СТРУКТУРА ДИРЕКТОРИЙСтандартная структура директорий сайта (обязательные помечены *), одинаковая как в локальной копии или на локальном сервере, так и на хостинге, такова: Менеджер сайта может менять информацию только в директориях my* (кроме myphp). Директории myphp, qlayout, qimages, xmmsetup отражают дизайн и функциональность данного сайта. Директории xmmadmin, xmmfiles содержат ненастраиваемую часть cms4site™ и могут заменяться целиком при обновлении ее версий.
СТРУКТУРА САЙТАДанный раздел носит ознакомительный характер относительно формата файла, если вы работаете с Центром управления сайтом. Однако принцип идентификации страниц сайта будет полезен в любом случае. Файл структуры сайта Файл sitemenu.dat - текстовый. Каждая строка описывает одну страницу и имеет следующий формат: <U>#ID|name|info|data1|data2|data3|...|dataN U - Уровень вложенности данной страницы, начиная с 0. Самая первая страница должна иметь уровень 0. Уровень некоторой страницы может быть на 1 больше чем у предыдущей (подстраница), равен ему (на том же уровне), или меньше (относится к более старшему уровню). Обычно уровень 0 отводится для языковых версий, даже если язык на сайте всего один. Рекомендуется (и это реализовано в Центре управления) сдвигать строки табуляцией согласно значению уровня. # - Признак перехода на следующую страницу. ID - Идентификатор страницы (последовательность латинских букв на нижнем регистре и/или цифр). Идентификаторы соседних страниц одного уровня должны быть уникальны. Желателен однотипный подход к смысловой интерпретации идентификаторов (либо английские слова, либо транслит). NB! Начальная страница неязыкового уровня должна иметь идентификатор index. name - Имя пункта меню (страницы). info - Краткое описание страницы (появляется в подсказках, карте сайта и.т.п.). Пустое поле задается как - символ неразрывного пробела в 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|Маленькая|Ну совсем небольшая ... Ветка страницы В примере подчеркнут путь к некоторой странице, этот путь (ветка) составлен из идентификаторов всех страниц на пути к ней, начиная со старшей:
ПРОЦЕССОР КОНТЕНТАПредназначен для обработки файлов контента перед выводом их в контентную область страниц сайта. Может не применяться, если контентные файлы представляют собой 100% HTML, подготавливаемый продвинутым менеджером сайта. В иных случаях обрабатываются как подготовленные вручную файлы контента, так и сформированные конвертерами MS Office. Разница между двумя последними приемами в том, что некоторые конструкции (например, таблицы) переходят из приложений MS Office, где задаются именно как таблицы, а другие (например, изображения) нужно задавать одинаково в обеих случаях. Все это особо отмечается в данной инструкции - знаком * отмечены те пункты, которые справедливы только для ручного набора файлов контента и не применяются в приложениях MS Office. Текст Состоит из абзацев (последовательности слов, разделенных пробелом). Абзацы отделяются друг от друга переводом строки (по клавише Enter). Не следует путать переносы, возникающие при свертке строк (в MS Word, например) с переводами строк. Если в редакторе текста или MS Word включен режим показа спецсимволов, переводы строк показываются знаком ¶. Как правило, показ текста на сайте настраивается так, что для отделения абзацев нужно два перевода строки подряд, например: Текст первого абзаца.¶ ¶ Текст второго абзаца. Пустые строки распознаются Процессором контента, и разработчик может назначить для них, например, уменьшенный интервал. Если это не реализовано, меньший интервал можно задать включением между абзацами специального изображения-разделителя xmmspace.gif: Текст первого абзаца.¶ xmmspace.gif¶ Текст второго абзаца. Если же такая возможность имеется, стандартный интервал будет задаваться тремя переводами строки (двумя пустыми строками): Текст первого абзаца.¶ ¶ ¶ Текст второго абзаца. Если вы хотите отделять абзацы одним переводом строки, а начало следующего отодвигать вправо, нельзя применять пробелы или табуляцию. Это связано со спецификой показа текста броузером, который сокращает многократные пробелы и табуляцию до одного пробела. Для такого действия необходим специальный знак "неразрываемый пробел" Текст первого абзаца.¶ Текст второго абзаца. В MS Word такой пробел задается из меню спецсимволов или по комбинации клавиш Ctrl+Shift+пробел. На что еще следует обращать внимание при наборе текста?
Атрибуты текста* NB! В MS Word просто назначайте атрибуты текста (участков текста). А вообще, здесь идет речь о тэгах и спецсимволах HTML, но рассмотрены лишь несколько самых простых и наиболее полезных... Естественно, что при просмотре страницы броузером сами тэги (как здесь) не показываются, виден только результат. Специальные символы* Предназначены для показа любых, в том числе и специальных, отсутствующих на клавиатуре символов. Имеется два способа назначения: Приведем список наиболее употребительных, за остальными обращайтесь к документации по HTML.
Выравнивание текста* <DIV ALIGN=justify>Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки. Разгонка абзаца по ширине колонки.</DIV> <DIV ALIGN=right>Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо. Выравнивание абзаца вправо.</DIV> <DIV ALIGN=center>Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру. Выравнивание абзаца по центру.</DIV> Принудительный обрыв текста<BR> в<BR> произвольном месте. В MS Word - Shift-Enter. Подзаголовки Процессор контента определяет строки, в которых все символы набраны прописными буквами. Такие строки могут интерпретироваться как подзаголовки в настройках сайта. Например, если набрано: ТЕКСТ ПОДЗАГОЛОВКА выводится (а почему бы и нет?): | ТЕКСТ ПОДЗАГОЛОВКА Отменить такое распознавание для конкретной строки (например, телефона) можно различными способами: (812) 100-33-33 EE820/1600-76 ЭТО НЕ ПОД<b></b>ЗАГОЛОВОК Списки* Список первого уровня задается так: - Первый элемент списка - Второй элемент списка . . .Список второго уровня задается так: + Первый элемент списка + Второй элемент списка . . .Нумерованный список задается так: * Первый элемент списка * Второй элемент списка . . .
Пример комбинации строк списков Двухуровневый список: Нумерованный списочек: И даже вот этак можно: Ссылки и адреса e-mail Внешние ссылки (на сайты, отличные от данного) распознаются Процессором контента в следующих форматах: Адреса электронной почты распознаются по знаку @ и правильному синтаксису: Внутренние ссылки (на страницы данного сайта) лучше задавать в специальном формате: NB! При наборе ссылок в MS Word не следует делать их активными. Если MS Word сделал-таки ссылку активной, отменить это действие сразу же можно кнопкой отмены или Ctrl-Z. Иначе - удалением ссылки через меню Вставить/Гиперссылка. Ненайденные внутренние ссылки игнорируются. Опознанные ссылки делаются кликабельными, адреса электронной почты кодируются в недоступный роботам формат. Внешние ссылки открываются в новом окне, внутренние - в новом или в текущем. Для внешних ссылок и адресов электронной почты объектом ссылки делается она сама, для внутренней ссылки - имя опознанной страницы. Для того, чтобы сделать объектом ссылки что-то другое (в том числе изображение), нужно указать его непосредственно за ссылкой (через пробел) в квадратных скобках: www.sitename.ru [Клевый сайт тут!] Отменить обработку ссылок можно в настройках сайта в целом, настройке данной страницы в структуре сайта, и непосредственно в самой ссылке, приемами аналогичными применяемым к подзаголовкам, например: Также в cms4site™ имеется функциональные модули xmmcollect.php, xmminner.php, xmmtoplevel.php, xmmprevnext.php решающие задачи навигации внутри страницы и внутри сайта.
Изображения В области контента Для размещения изображений из директории myimages или ее поддиректорий (например, myimages/a01), достаточно указать имя файла изображения в отдельной строке: image12006.jpg a01/bigpribor.gif Для размещения среди других элементов (в таблице, в тексте) используются квадратные скобки: Начало текста [image12006.jpg] окончание текста. Изображения показываются в масштабе 1:1. Изменить масштаб и другие параметры показа можно применением параметров HTML-тэга IMG, наиболее употребительные из которых приведены ниже. Следует учесть, что произвольно изменять высоту и ширину можно не для всех изображений, иначе возникнут искажения. Пример применения параметров и наиболее употребительные из них: image001.jpg width=100 height=100 border=1 alt="Прибор 001" В 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! Правило квадратных скобок здесь не применяется, т.е. для показа одного изображения нужна отдельная строка.
Таблицы* Несколько идущих подряд строк, содержащих не менее одного знака | (вертикальная черта) рассматриваются как таблица. Основные правила обработки таблиц: Пример задания таблицы в исходном тексте (параметры изображений опущены): Код|Наименование|Фото|Цена |Комплект 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. Ячейка шапки
Пример задания таблицы в исходном тексте| Таблица 2. Ячейка подзаголовка
| |Пример задания таблицы в исходном тексте Таблица 3. Обычная ячейка
| Пример задания таблицы в исходном тексте| Внимание! При необходимости помещения в таблицу вертикальной черты ее надо задать так: |
Файлы Для построения ссылок на скачиваемые файлы с указанием их атрибутов достаточно разместить сами файлы в директории 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™ обеспечивает подстановку констант, заданных в системе, а также определенных разработчиком и менеджером сайта. Системные константы: Пример: %%mysite%% %%sysvers%% ©%%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.
РАБОТА САЙТАРассмотрим, как работает сайт при запросе страницы. Замечания: ОГРАНИЧЕНИЯ ИМЕН ФАЙЛОВСистема правильно обрабатывает имена файлов, если они включают в себя только указанные символы: Желательно, чтобы части имени, отделенные десятичной точкой, не были пустыми.
ДОПОЛНИТЕЛЬНЫЕ ФАЙЛЫ ДАННЫХДля работы некоторых функциональных модулей требуются отдельные файлы данных. Они могут быть привязаны к текущей странице (т.е. частично совпадать по имени с основным файлом контента), например: 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. Общие принципы построения дополнительных файлов данных таковы: Пример файла данных анонсов для модуля 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 и его показ в табличном виде
|