Документация для разработчиков

Создание и редактирование файла

В этом разделе

  • Административный раздел
  • Контекстная панель
  • Форма редактирования
  • Форма редактирования в режиме "Редактировать как текст"
  • Форма редактирования в режиме "Редактировать как PHP"
  • Форма редактирования в режиме "Редактировать как HTML"
  • Кнопки управления
  • Пример создания нового файла
  • Публичный раздел
  • Создать новый или отредактировать уже существующий файл можно как в административном, так и в публичном разделе.

    Административный раздел

    Для создания нового файла служит кнопка Добавить, расположенная на контекстной панели менеджера файлов. Чтобы отредактировать существующий файл, необходимо воспользоваться пунктом Редактировать как <режим_редактирования> меню действий необходимого файла. Доступно три режима редактирования файла:

    • Редактировать как текст;
    • Редактировать как PHP;
    • Редактировать как HTML.

    Контекстная панель

    Кнопка Описание
    Просмотр файлаПереключение в режим просмотра исходного кода файла. Кнопка отображается при редактировании документа.
    Редактировать
    • Редактировать как текст - отображение текста файла, без включения PHP кода. Однако, в этом режиме отображаются все HTML-теги.
    • Редактировать как PHP - редактирование исходного кода файла. Режим предназначен исключительно для использования разработчиками.
    • Редактировать как HTML - редактирование документа в режиме встроенного визуального HTML-редактора, позволяющего форматировать текст аналогично Microsoft Word.
    ПереименоватьКнопка для перехода к форме задания нового имени файла. Отображается при редактировании документа.
    Скачать файл Кнопка предназначена для скачивания редактируемого файла на локальный компьютер.
    Удалить файл Удаление редактируемого файла.

    Форма редактирования

    В зависимости от выбранного режима редактирования, форма редактирования может принимать разный вид.

    Форма редактирования в режиме "Редактировать как текст"

    ПолеОписание
    Шаблон *Шаблон, на основе которого будет создан файл. Например, Стандартная страница, Включаемая область для страницы или Включаемая область для раздела.

    Поле отображается при создании нового файла.
    Заголовок страницы *Произвольный заголовок страницы. Указанный заголовок будет выводиться в теле страницы.

    Кнопка позволяет автоматически генерировать имена файлов из заголовков страниц с возможностью перевода. Для этого необходимо включить опции Включить возможность автоматического генерирования имени файлов и папок из названий при создании страниц и разделов и Использовать переводчик Google для автоматического генерирования имен файлов и папок в настройках модуля Управление структурой.
    Имя файла *Имя создаваемого файла (с указанием расширения). Например, news.php. Начиная с 11-й версии модуля поддерживаются русские буквы. Недопустимо использование следующих спецсимволов: \ / ? * < > " '.

    Поле отображается при создании нового файла.
    Свойства страницы
    Данная секция предназначена для задания и редактирования значений свойств страницы, а также для управления значениями тегов, ключевыми словами (keywords) и описанием (description) страницы.
    ПолеОписание
    СвойствоНазвание свойства.
    ЗначениеПоле для задания значения свойства.
    Кнопка Еще... позволяет добавить пользовательское свойство, значение которого будет использоваться только для текущей страницы. В этом случае в поле Свойство задается код (мнемоническое имя) свойства символами латинского алфавита.

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

    * - поле отображается только при при редактировании документа

    Форма редактирования в режиме "Редактировать как PHP"

    ПолеОписание
    Шаблон *Шаблон, на основе которого будет создан файл. Например, Стандартная страница, Включаемая область для страницы или Включаемая область для раздела. Поле отображается при создании нового файла.
    Имя файла *Имя создаваемого файла (с указанием расширения). Например, news.php. Поле отображается при создании нового файла.
    Редактирование PHP скрипта.
    Поле для ввода содержимого страницы.

    * - поле отображается только при при редактировании документа

    Форма редактирования в режиме "Редактировать как HTML"

    Закладка "Редактирование"
    ПолеОписание
    Шаблон *Шаблон, на основе которого будет создан файл. Например, Стандартная страница, Включаемая область для страницы или Включаемая область для раздела. Поле отображается при создании нового файла.
    Заголовок страницы *Произвольный заголовок страницы. Указанный заголовок будет выводиться в теле страницы.

    Кнопка позволяет автоматически генерировать имена файлов из заголовков страниц с возможностью перевода. Для этого необходимо включить опции Включить возможность автоматического генерирования имени файлов и папок из названий при создании страниц и разделов и Использовать переводчик Google для автоматического генерирования имен файлов и папок в настройках модуля Управление структурой.
    Имя файла *Имя создаваемого файла (с указанием расширения). Например, news.php. Поле отображается при создании нового файла.
    Визуальный HTML-редактор.

    Примечание: Процесс создания и редактирования страницы с помощью визуального редактора подробно описан на странице визуального HTML-редактора.

    * - поле отображается только при при редактировании документа

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

    Примечание: Набор доступных для всех страниц свойств определяется на странице настроек модуля Управление структурой.

    Закладка "Меню"
    ПолеОписание
    Добавить страницу в менюПри отмеченной опции будет создан новый пункт меню для данного файла.
    Тип менюВыбирается тип меню. Например, Главное меню сайта [top].
    Пункт менюВыбирается режим создания пункта меню:
    • Добавить новый - в меню в публичной части сайта для данного файла будет создан отдельный пункт меню;
    • Привязать к существующему - выбирается пункт меню, к которому будет привязан файл. При выборе данной опции следует заполнить поле Пункт.
    ПунктУказывается пункт в меню в публичной части сайта, к которому будет привязан файл.
    Название нового пунктаУказывается название для нового пункта меню.
    Вставить перед пунктомВыбирается расположение нового пункта меню.

    Кнопки управления

    Кнопка Значение
    СохранитьСохранение страницы.
    ПрименитьСохранение выполненных изменений. Продолжение редактирования страницы.
    ОтменитьОтмена внесённых изменений.

    Пример создания нового файла

    1. На контекстной панели выберите Добавить, и далее Добавить файл. Для создания страницы будет открыт редактор, выбранный в настройках модуля Управление структурой как редактор по умолчанию.
    2. Выберите шаблон, на основе которого будет создана страница.
    3. Укажите имя файла (например, company.php).
    4. Нажмите кнопку Сохранить, чтобы добавить новый файл в текущую папку, или Применить, чтобы сохранить файл в текущей папке и продолжить его редактирование.


    Публичный раздел

    Процедура создания нового файла в публичной части сайта подробно описана в уроках Создание новых страниц и разделов и Создание новых страниц и разделов в интерфейсе до версии 9.5.

    Смотрите также:



    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх