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

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

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


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


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

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

  • Редактировать как текст;
  • Редактировать как 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-2024, «1С-Битрикс», 2024
Наверх