Справочный центр
Сервер документов Р7-Офис

Customization

Описание

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

Параметры
Имя Описание Тип Пример
Определяет, включен ли пункт меню Автосохранение. Если параметр установлен в значение false, может быть выбран только Строгий режим совместного редактирования, так как режим Быстрый не работает с автосохранением. Учтите, пожалуйста, что в случае изменения вами этого пункта меню, это будет сохранено в локальном хранилище вашего браузера. Значением по умолчанию является true. логический true
Определяет отображение кнопки меню Чат; учтите, пожалуйста, что в случае, если вы скроете кнопку Чат, соответствующие функции чатов также будут отключены. Значением по умолчанию является true. логический true
Определяет, может ли пользователь редактировать все комментарии или только свои. Значением по умолчанию является false. логический true
Определяет, скрыта ли кнопка меню Комментарии; учтите, пожалуйста, что если вы скроете эту кнопку, комментарии будут доступны лишь для просмотра, их добавление или редактирование будет невозможным. Данный параметр не используется, пожалуйста, используйте вместо него параметр document.permissions.comment. логический true
Определяет, отображена ли верхняя панель инструментов полностью (false) или компактно (true). Значением по умолчанию является false. логический false
Содержит информацию для раздела О компании. Объект имеет следующие параметры:
  • address - почтовый адрес вышеуказанной компании или человека,
    тип: строка,
    пример: "Мой город, 123-45";
  • info - некоторая информация о вышеуказанной компании или человеке, которая будет отображена на странице О компании, видимой для всех пользователей,
    тип: строка,
    пример: "Некоторая дополнительная информация";
  • logo - путь к файлу изображения логотипа, который будет отображён на странице О компании (не существует каких-либо рекомендаций для данного файла, но лучше всего, если этот файл является файлом формата .png с прозрачным фоном. Данное изображение должно иметь следующий размер: 432x70,
    тип: строка,
    пример: "https://example.com/logo-big.png".
  • mail - адрес электронной почты вышеуказанной компании или человека,
    тип: строка,
    пример: "john@example.com".
  • name - имя вышеуказанной компании или человека, предоставляющих доступ к редакторам,
    тип: строка,
    пример: "Иван Петров и сыновья.";
  • www - адрес сайта вышеуказанной компании или человека,
    тип: строка,
    пример: "example.com".
объект
Определяет настройки для кнопки Обратная связь и поддержка. Может быть логическим типом (лишь отображает или скрывает кнопку меню Обратная связь и поддержка) или объектом. В случае, если он имеет объектный тип, доступны следующие параметры:
  • url - абсолютный адрес сайта, который будет открыт при нажатии кнопки Обратная связь и поддержка,
    тип: строка,
    пример: "https://example.com";
  • visible - отображает или скрывает кнопку Обратная связь и поддержка,
    тип: логический,
    пример: true
Значением по умолчанию является false.
логический или объектный true
Добавляет запрос на принудительное сохранение обработчику обратных вызовов при сохранении документа, при работе в сервисе редактирования документов (например, нажимая кнопку Сохранить и т.п.). Значением по умолчанию является false. логический false
Определяет настройки для кнопки меню Перейти к документам и кнопке в верхнем правом углу. Объект имеет следующие параметры:
  • blank - открыть веб-сайт в новой вкладке/окне браузера (если параметр установлен в значение true) или текущей вкладке (если параметр установлен в значение false), при нажатии на кнопку Перейти к документам. Значение по умолчанию - true,
    тип: логический,
    пример: true;
  • text - текст, который будет отображён для кнопки Перейти к документам и кнопке в верхнем правом углу (то есть вместо Перейти к документам),
    тип: строка,
    пример: "Перейти к документам";
  • url- абсолютный адрес сайта, который будет открыт при нажатии кнопки Перейти к документам, тип: строка,
    пример: "https://example.com".
логический или объектный true
Определяет видимость кнопки меню Помощь. Значением по умолчанию является true. логический true
Изменяет изображение в верхнем левом углу заголовка редактора. Рекомендуемая высота изображения - 20 пикселей. Объект имеет следующие параметры:
  • image - путь к файлу изображения, отображаемому в обычном режиме работы (то есть в режимах просмотра и редактирования для всех редакторов). Данное изображение должно иметь следующий размер: 172x40,
    тип: строка,
    пример: "https://example.com/logo.png";
  • imageEmbedded - путь к файлу изображения, отображаемый во встроенном режиме (смотрите раздел config, чтобы выяснить, как определить встроенный тип документа). Данное изображение должно иметь следующий размер: 248x40,
    тип: строка,
    пример: "https://example.com/logo_em.png";
  • url - абсолютная ссылка, которая будет использована, когда кто-либо нажимает на логотип (может быть использовано для перехода на ваш сайт, и т.д.). Оставьте пустой строкой или null, чтобы сделать логотип некликабельным,
    тип: строка,
    пример: "https://example.com".
object
Определяет, отображается ли панель отзывов автоматически при загрузке редактора. Значением по умолчанию является false. логический false
Определяет значение масштаба, измеряемое в процентах. Может принимать значения большие 0. Для текстовых документов и презентаций возможно устанавливать данный параметр в значение -1 (функция, подгоняющая размер документа под размер страницы) или -2 (функция, подгоняющая ширину документа под размер редактора). Значением по умолчанию является 100. целочисленный 100
* - доступно для редактирования только в Решении для разработчиков
Пример
var docEditor = new DocsAPI.DocEditor("placeholder", {
    "editorConfig": {
        "customization": {
            "chat": true,
            "commentAuthorOnly": false,
            "compactToolbar": false,
            "customer": {
                "address": "Мой город, 123-45",
                "info": "Дополнительная информация",
                "logo": "https://example.com/logo-big.png",
                "mail": "john@example.com",
                "name": "Иван Петров и сыновья.",
                "www": "example.com"
            },
            "feedback": {
                "url": "https://example.com",
                "visible": true
            },
            "forcesave": false,
            "goback": {
                "blank": true,
                "text": "Вернуться к документам",
                "url": "https://example.com"
            },
            "help": true,
            "logo": {
                "image": "https://example.com/logo.png",
                "imageEmbedded": "https://example.com/logo_em.png",
                "url": "https://www.r7-office.ru"
            },
            "showReviewChanges": false,
            "zoom": 100
        },
        ...
    },
    ...
});

Где example.com - имя сервера, на котором установлены менеджер документов и сервис хранения документов. Смотрите раздел Как это работает, чтобы узнать больше о клиент-серверных взаимодействиях Сервера документов.