Add_editor_style () - підключає файл стилів css для візуального редактора tinymce

Функція перевіряє наявність файлу стилів css наданого в секції $ stylesheet. Шлях до файлу повинен бути вказаний щодо каталогу теми. Якщо файл знайдений, то він підключається, якщо не знайдений, то функція намагається знайти файл за умовчанням editor-style.css в каталозі теми.

Якщо використовується дочірня тема, то перевіряються обидва каталогу: дочірній і батьківський, і в разі наявності двох файлів, файли будуть об'єднані і підключені.

Щоб підключати файл не щодо каталогу теми, а щодо каталогу плагіна, використовуйте фільтр "mce_css".

Вішати подія потрібно до того, як TinyMCE налаштований. Не слід вішати на init (бо треба тільки для адмінки), на admin_init (бо спрацьовує при AJAX). Можна повісити наприклад на current_screen. admin_menu.

повертає

Нічого не повертає.

Використання

$ Stylesheet (рядок / масив) Шлях до файлу стилів щодо папки теми. Наприклад, якщо файл знаходиться в папці теми, то потрібно просто вказати назву файлу - 'my-editor-style.css'.
За замовчуванням: "editor-style.css"

Спочатку додайте наступний код в файл теми functions.php:

# 2 Використання стилів теми

Також можна підключити стилі теми в цей файл за допомогою CSS правила @import. Зробіть все як в першому прикладі і в файл editor-styles.css додайте такий рядок:

Передбачається, що файл editor-styles.css лежить в каталозі теми і файл стилів теми (style.css) теж лежить в цьому каталозі. Якщо файл стилів теми (style.css) лежить, в папці "css" каталогу теми, то шлях потрібно буде вказати такий:
@import url ( 'css / style.css');

# 3 Вибір файлу стилів на основі типу записи

Щоб підключити файл стилів спираючись на те, який тип запису ми редагуємо, можна використовувати наступний код у файлі теми functions.php. Мається на увазі, що файли стилів з назвами: editor_styles_.css вже знаходяться в папці теми.

# 5 Використання шрифтів Google

API Google шрифтів дозволяє підключати кілька варіантів шрифту, однієї посиланням для CSS (варіанти розділяються комами). Коми повинні бути кодовані, перед тим як рядок передати в обробку add_editor_styles (). Виглядає це так:

З версії 3.4. WordPress підключить файл стилів, вказаний в параметрі $ styleweet. тільки в разі його існування, тобто якщо буде пройдена перевірка file_exists (). Тому, якщо передати рядок "editor.css? Version = 1.0" вона працювати не буде.

У версії 3.4. при підключенні файлу з дочірньою теми, функція не підключати цей файл, якщо файл з таким же шляхом уже був підключений з батьківської теми. З версії 3.5. це поведінка була змінена і файли підключаються з обох: дочірньої і батьківської теми.

  • Функція використовує глобальну змінну: $ editor_styles.
  • Код add editor style. wp-includes / theme.php WP 4.8.3

    cвязана функції

    З розділу: Інші функції теми

    Схожі статті