IZ MD Pages

Описание

IZ MD Pages превращает ваш сайт WordPress в двухформатный контент-хаб, генерируя и отдавая чистые, быстрые и структурированные страницы Markdown параллельно со стандартным HTML.

Оптимизированный для поисковых систем на базе ИИ, LLM, документации для разработчиков, CLI-утилит и RSS-ридеров, IZ MD Pages обеспечивает мгновенное получение вашего контента в виде чистого Markdown без лишнего кода.

Основные возможности

  • Специальные Markdown-эндпоинты и параметры запроса: Получайте доступ к Markdown-версии любой записи или страницы через понятные URL (например, https://example.com/sample-post/md) или GET-параметры (https://example.com/sample-post/?md) с автоматическими каноническими 301-редиректами.
  • Теги автообнаружения ссылок: Добавляет стандартный тег <link rel="alternate" type="text/markdown"> в <head>, делая Markdown-страницы легко обнаруживаемыми поисковыми роботами, ИИ-ассистентами и браузерными расширениями.
  • Продвинутая конвертация Gutenberg и классического редактора: Преобразует блоки Gutenberg (заголовки, абзацы, списки, цитаты, таблицы, блоки кода, изображения, вставки) и классический HTML в чистый стандартный Markdown.
  • Гибкие шаблоны для типов записей: Настраивайте шаблоны разметки для каждого активного типа записи с помощью удобных плейсхолдеров (например, # {%post_title%}\n\n{%post_content%}).
  • Универсальные шаблоны шапки и подвала: Настройте глобальный верхний и нижний Markdown-колонтитулы (например, баннеры с метаданными, лицензию или призыв к действию), добавляемые ко всем создаваемым Markdown-страницам.
  • Мощный движок плейсхолдеров:
    • Основные поля записи: {%post_title%}, {%post_content%}, {%post_excerpt%}, {%post_url%}, {%post_date%}, {%post_date_gmt%}, {%post_time%}, {%post_modified%}, {%thumbnail_url%}, {%thumbnail_id%}.
    • Информация об авторе: {%author_name%}, {%author_email%}, {%author_url%}, {%author_bio%}, {%author_first_name%}, {%author_last_name%}.
    • Таксономии: {%categories%}, {%tags%}, {%taxonomy:taxonomy_name%} с настраиваемыми разделителями и префиксами (\n*, \t, :before, :leading).
    • Комментарии и их количество: {%comments%}, {%comments_count%}.
    • Произвольные поля (метаданные записи): {%meta:key%} с рекурсивным форматированием сложных вложенных массивов и объектов.
  • Детальное управление для каждой записи: Специальный метабокс на экранах редактирования для отключения генерации Markdown для конкретных записей или ввода индивидуального Markdown вручную со сбросом в один клик.
  • Удобство для разработчиков и расширяемость: Более 15 хуков-фильтров WordPress, позволяющих полностью настроить рендеринг шаблонов, конвертацию блоков, обработку произвольных плейсхолдеров и итоговый вывод страницы.
  • Высокая производительность: Конвертация на чистом PHP без внешних зависимостей и удаленных вызовов API.

Как внести свой вклад

Если вы хотите помочь в разработке плагина, посетите его репозиторий на GitHub: https://github.com/IvanZhuck/iz-md-pages. Репозиторий содержит исходный код и инструменты для разработки.

Скриншоты

Установка

Автоматическая установка

  1. Войдите в панель управления WordPress.
  2. Перейдите в Плагины → Добавить новый.
  3. Выполните поиск IZ MD Pages.
  4. Нажмите Установить, а затем Активировать.

Ручная установка

  1. Скачайте ZIP-архив плагина.
  2. Загрузите распакованную директорию iz-md-pages в папку /wp-content/plugins/.
  3. Активируйте плагин через меню Плагины в WordPress.

Настройка после установки

  1. Перейдите в Настройки → IZ MD Pages, чтобы настроить включенные типы записей, формат URL (эндпоинт /md или параметр ?md) и параметры главной страницы.
  2. Перейдите в Настройки → IZ MD Pages → Шаблоны, чтобы настроить Markdown-шаблоны типов записей, а также верхний и нижний колонтитулы.
  3. Перейдите в Настройки → IZ MD Pages → Документация для подробных руководств, справочника синтаксиса и хуков для разработчиков.

Часто задаваемые вопросы

Как посетители и AI-агенты получают доступ к Markdown-версии записи?

По умолчанию вы можете добавить /md к постоянной ссылке любой записи или страницы (например, https://example.com/my-article/md). Вы также можете переключить формат URL на режим GET-параметра (?md) в настройках плагина.

Влияет ли это на обычный HTML-фронтенд моего сайта или SEO?

Нет. Ваши стандартные HTML-страницы остаются абсолютно неизменными. Плагин отдает Markdown только при запросе к специальному эндпоинту /md или с параметром ?md. Кроме того, в секцию head вашего HTML добавляются теги автообнаружения (<link rel="alternate" type="text/markdown">), чтобы информировать поисковых роботов об альтернативном формате.

Могу ли я отключить генерацию Markdown для определенных записей?

Да. На экране редактирования любой записи или страницы найдите метабокс Страница Markdown и отметьте Отключить версию MD для этой страницы.

Могу ли я вручную написать произвольный Markdown для отдельной записи вместо использования шаблона?

Да. В метабоксе Страница Markdown отметьте чекбокс Задать текст страницы MD вручную и введите ваш Markdown в текстовое поле.

Поддерживаются ли в шаблонах произвольные таксономии и произвольные поля ACF / post meta?

Да! Вы можете использовать {%taxonomy:your_tax_name%} для любой произвольной таксономии и {%meta:your_field_key%} для любого произвольного поля записи или значения ACF.

Могу ли я переопределить шаблоны или конвертацию Markdown в коде темы?

Да. IZ MD Pages предоставляет множество хуков-фильтров, таких как iz_md_post_type_template_{$postType}, iz_md_post_template_{$postId}, iz_md_render_block_{$blockName}, iz_md_render_custom_placeholder_{$tag} и iz_md_page_content.

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«IZ MD Pages» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«IZ MD Pages» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «IZ MD Pages» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.0.0

  • Первый публичный релиз.
  • Поддержка эндпоинта /md и переменной запроса ?md с каноническим 301-редиректом.
  • Рендерер блоков Gutenberg и конвертер HTML в Markdown.
  • Гибкие шаблоны типов записей с возможностью настройки верхнего и нижнего колонтитулов.
  • Продвинутый движок плейсхолдеров с поддержкой базовых атрибутов записи, полей автора, таксономий, комментариев и произвольных полей метаданных.
  • Метабокс на экране редактирования записи с переключателями включения/отключения и ручным редактированием Markdown.
  • Автоматическое добавление тегов автообнаружения альтернативных ссылок в заголовок.
  • Полноценная архитектура хуков-фильтров для разработчиков.