shortcake

SORTCAKE (WIO SORTCODE)

Contributors: fusionengineering, mattheu, danielbachhuber, zebulonj, goldenapples, jitendraharpalani, sanchothefat, bfintal, davisshaver, garyj, mte90, fredserva, khromov, bronsonquick, dashaluna, mehigh, sc0ttkclark, kraftner, pravdomil
Теги: шорткоды
Требуется как минимум: 4,5
Протестировано до: 5.0.3
Стабильный тег: 0,7,4
Лицензия: GPLV2 или позже
Лицензия URI: http://www.gnu.org/licenses/gpl-2.0.html

Шорткэк делает использование WordPress Chortcodes куском торта.

Описание

Используемый вместе с add_shortcode , Shortcake предоставляет удобный интерфейс для добавления шорткода в сообщение, а также просмотр и редактирование его из редактора контента.

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

Чтобы сообщить об ошибках или запросах функций, используйте проблемы GitHub.

Установка

Шорткэк может быть установлен, как и любой другой плагин WordPress.

Как только вы это сделаете, вам нужно зарегистрировать пользовательский интерфейс для вашего кода.

Новым в 0.4.0 является возможность прикреплять функции JavaScript к обновлениям атрибутов события. Крюки действий могут использоваться для динамического демонстрации или скрытия поля на основе значения другого или для реализации пользовательских правил проверки.

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

Как зарегистрировать пользовательский интерфейс для произвольных паров ключей/значений в качестве атрибутов короткого кода?

Shortcake не поддерживает Custom Key => пары значений в качестве атрибутов короткометражного кода, потому что это не отличный пользовательский опыт.

После обновления до Shortcake 0.7.x некоторые поля интеркода пользовательского интерфейса (Post Select, Select и т. Д.) Не работают, как и ожидалось. Что я могу сделать?

В версии 0.7.0 мы обновились до самой последней ветви библиотеки SELECT2, которая предоставляет поля Enhanced Select в этих типах поля. Это вызывает известный конфликт с плагинами, которые включают старые версии Select2. (Популярные плагины с известными конфликтами включают Woocommerce и Advanced Custom Fields Pro, среди прочего.)

Если вы обнаружите, что вы испытываете конфликты с этими плагинами, вы можете установить флаг для загрузки Select2 в различном пространстве имен, определив постоянный SELECT2_NOCONFLICT в wp-config.php (или везде, где определяется перед крючком «init»).

 define( 'SELECT2_NOCONFLICT', true );

Заводящие тесты

У нас есть тестовый охват для PHP с использованием PHPUNIT, и JavaScript с использованием Jasmine.

Запуск тестов локально

Жасминовые тесты можно запускать с использованием grunt jasmine , а также выполняются как часть задачи grunt scripts . Чтобы обновить основные файлы WordPress, используемые набором тестов Jasmine, запустите grunt updateJasmineCoreScripts --abspath="/path/to/wordpress-install" .

Скриншоты

1. Без шорткэка шорткоды имеют минимальный пользовательский интерфейс.

2. Но с помощью короткого шорта Tinymce сделает шорткод в виде Tinymce.

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

4. Добавьте новые шорткоды в свой пост через «Добавить медиа».

Уведомление об обновлении

0.4.0

Мы удалили Shim совместимости для аргумента атрибута placeholder . Вы должны зарегистрировать заполнитель для вашей области, используя meta аргумента.

0,3,0

Мы удалили атрибут совместимости для атрибута магического content . Если вы использовали это для поддержки редактирования внутреннего контента, вам нужно изменить регистрацию пользовательского интерфейса, чтобы использовать inner_content .

Изменение

0,7,4 (16 января 2019 г.)

• Совместимость редактора блоков: предотвратить вывод шаблонов перед головой документа, что заставило браузер в QuirksMode, разбивая некоторые стили CSS в редакторе блоков.
• Исправление ошибки: вышеупомянутый ошибка.
• Исправление ошибки: Исправьте ошибку JavaScript, которая приведет к тому, что модаль вставки модала вставка будет пустой, если какой -либо короткометражный код содержит поле выбора без видимых параметров и без установки по умолчанию.
• Исправление ошибки: Исправьте ошибку, в которой кнопка «Select Files» в контроллере медиа -контроллера стала без реагирования после вставки элемента Post.
• Усовершенствование: добавьте дополнительный атрибут поля «Разрешить прозрачность», который будет передаваться в поля SELECT2 (POST, USER или TERM SELECT), чтобы можно было очистить с одним щелчком с одним щелчком. (Эта опция по умолчанию выключается и не должна влиять на существующие поля.)

0,7,3 (5 сентября 2017 г.)

• Безопасность: Используйте незвуковую проверку в обратном вызове Shortcode Ajax для защиты от CSRF.
• Исправление ошибки: убедитесь, что те же крючки JS стреляют по всем типам поля.
• Исправление ошибки: исправление ошибок, влияющих на несколько полей Select (значения не могут быть незаметными после установки, и несколько значений по умолчанию не могут быть установлены).
• Исправление ошибки: предотвращайте кодируемые поля, содержащие два процента символов, не сломаются.
• Исправление ошибки: Исправьте некоторые проблемы, в которых медиа -модальное состояние не было сброшено должным образом, если шорткод был закрыт без сохранения.
• Исправление ошибок: случаи поддержки, когда на странице существует несколько экземпляров WP_Editor, и убедитесь, что отредактированный шорт -код отправляется на нужную страницу.
• Усовершенствование: когда поле Post_select выбирает из более чем одного типа поста, покажите тип поста вместе с именем сообщения для более легкого выбора.
• Улучшение: покажите миниатюры вложения для любого типа вложения, а не только изображений.
• Улучшение: добавьте более полезные сообщения об ошибках, если не зарегистрированы шорткоды с помощью интеркса пользовательского интерфейса.
• Обновление норвежского перевода

0,7,2 (24 апреля 2017 г.)

• Исправление ошибки: исправление поведения в WordPress 4.7.4, где редактирование шорткода вставит новый шорткод в редактор, а не обновляет отредактируемый шорт -код.
• Исправление ошибки: замена, используемая для ухода с процентами (%) символами в атрибутах только заменила первое появление
• Исправление ошибки: для выбора полей с несколькими = true, разрешите выбрать несколько параметров по умолчанию
• Добавлен i18n для всех строк в шаблоне поля прикрепления
• Добавлен финский перевод

0,7,1 (16 марта 2017 г.)

• Измените форматирование шорткода, чтобы добавить пространство, прежде чем самозакрывающаяся сцепление.
• Исправлено выравнивание предварительного просмотра вложения с длинными именами файлов.
• Исправление ошибки: установите начальное значение в полях Select (ранее не было бы установлено значение для поля выбора, если пользователь не взаимодействует с полем).
• Усовершенствование/исправление: повторно используйте одну копию Media Modal и сбросите его состояние при закрытии, а не создание дублирующейся разметки каждый раз, когда обращается к модалу.
• Совместимость: использует «полную» версию SELT2.js 4.0.3, чтобы предотвратить конфликты плагина с другими плагинами, которые ожидают, что полная версия будет включена.
• Совместимость: добавьте флаг SELECT2_NOCONFLICT для загрузки Select2 в уникальном пространстве имен, чтобы предотвратить конфликты с другими плагинами, которые загружают Select2.js версию 3.
• Добавлен норвежский перевод.
• Многочисленные исправления стиля кодирования.

0,7,0 (18 ноября 2016 г.)

• Добавляет кнопку «Добавить элемент post» в кнопки для медиа - один нажмите, чтобы открыть список шорткодов, вместо того, чтобы нажать кнопку «Добавить медиа», а затем найти «Вставить элемент пост» в меню.
• Добавлен тип поля «Term Select».
• Добавлен тип поля «Выбрать пользователя».
• Добавлены новые крючки, которые стреляют при рендеринге/редактировании/закрытии шорткода, который можно использовать для типов поля, которые требуют пользовательской инициализации JavaScript или очистки.
• Выберите Поля: Добавьте полную поддержку для нескольких полей выбора.
• Выберите Поля: Поддержка пользовательского упорядочения параметров.
• Выберите Поля: Опция группировки поддержки в <optgroup> , передавая их в качестве вложенного массива.
• Поля вложения: Поддержите множественный выбор.
• Поля вложения: поддержка изображений SVG (если загрузка SVG включена плагином или темой).
• Исправление ошибки: обрабатывать процентные знаки при декодировании полей с указанными encode=true .
• Исправление ошибки: Исправьте проблему, где требуется два щелчка на шорткоде в редакторе, чтобы поднять модал редактирования короткометражного кода.
• Исправление ошибки: исправление проблемы при поиске шорт -кодов по имени, где, если несколько шорт -кодов начинаются со строки поиска, возвращается только первый.
• Исправление ошибки: только выводит поле описания на атрибуте, если оно не пусто.
• Совместимость: Удалите прокладки для обработки модала носителя в WP 4.1 и 4.2.
• Совместимость: обновите библиотеку SELECT2 до 4.0.3, чтобы избежать конфликтов с другими плагинами, которые используют последнюю версию SELECT2.
• Добавлен турецкий перевод.
• Добавлен финский перевод.
• Добавлен шведский перевод.
• Добавлен венгерский перевод.

0,6,2 (12 ноября 2015 г.)

• Исправление ошибки: прослушивает событие «Изменить» на радиопроизводительных кнопках и флажках, чтобы убедиться, что атрибуты короткометражного кода обновляются.
• Исправление ошибки: гарантирует, что register_shortcode_ui всегда запускается перед вызовом get_shortcodes (). Исправляет сообщение Выберите AJAX Callback при использовании register_shortcode_ui Hook.

0,6,1 (9 ноября 2015 г.)

• Исправляет JavaScript TypeError при нажатии элементов меню Media Frame.
• Исправляет ссылки в README.

0,6,0 (2 ноября 2015 г.)

• Поддерживает необязательный encode=true Argiry для атрибутов, чтобы разрешить ограниченную поддержку HTML. Атрибуты необходимо выполнять через shortcode_atts() чтобы быть должным образом декодированы.
• Определяет константу SHORTCODE_UI_DOING_PREVIEW при рендеринге предварительного просмотра шорткода, который позволяет обратным обращениям служить другому представлению короткометражного кода в tinymce.
• Когда вложение уже выбран для атрибута шорткода, открытие медиа -библиотеки будет включать его.
• Очищенный значок вертикальный выравнивание в пользовательском интерфейсе inst Post Element.
• Добавлены классы коммунальных услуг CSS ко всем полевым HTML. Например, поле вложения теперь обернуто с помощью shortcode-ui-field-attachment .
• Добавлены фильтры, чтобы изменить аргументы в пользу короткого кода по регистрации.
• Очистил пример плагина, так что это гораздо более полезный справочник разработчика.
• Использует Regex javascript от Javascript для шорт -кодов разбора, вместо того, чтобы поддерживать отдельную регуляцию.
• Разрешает HTML в полевых метках и описаниях.
• Добавлен датский перевод.
• Добавлен итальянский перевод.
• Добавлен немецкий перевод.
• Интеграция ядра: полностью поддерживает PHP 5.2.
• Исправление ошибки: сохраняет атрибуты короткометражного кода и внутренний контент, когда для них не зарегистрировано пользовательского интерфейса. Ранее они были отброшены.
• Исправление ошибки: отобразить описание в поле «Выбрать пост».
• Исправление ошибки: событие изменения поля атрибута связывается с событием input а не keyup .
• Полные заметки о выпуске

0,5,0 (26 августа 2015 г.)

• Поле вложения: упростило изменение вложения, нажав на миниатюру; Добавлены метаданные вложения в поле зрения.
• Поле вложения: рефактированный JavaScript для запуска событий.
• Добавлен тип входа range .
• Представил крючок register_shortcode_ui для плагинов для более безопасного регистрации пользовательского интерфейса.
• Удаленная вкладка предварительного просмотра, чтобы приблизить пользовательский опыт Shortcake ближе к Core, в котором встроенный визуальный предварительный просмотр предпочтительнее в отдельном предварительном просмотре в Media Modal.
• Очистить JavaScript с помощью jshint.
• Добавлен русский перевод.
• Добавлен португальский перевод.
• Добавлен PHPDOC ко всем классам.
• Исправление ошибки: сохраняется inner_content для шорткода, даже если пользовательский интерфейс не определен.
• Исправление ошибки: нажимать ESC в представлении песочного печенья теперь закроет модал. (Исправлено в ядре.)
• Исправление ошибки: нажимая удаление, когда в визуальном редакторе выбран предварительный просмотр шорткэк. (Исправлено в ядре.)
• Исправление ошибки: функция Shortcake 'Search' больше не визуально не конфликтует с сетью шорткода при небольших размерах экрана. (Исправлено в ядре.)
• Исправление ошибки: используйте get_post_type() вместо get_current_screen()->post_type , так что контекст правильно установлен на фронте.
• Полные заметки о выпуске

0,4,0 (22 июня 2015 г.)

• Использование Carldanley/WP-JS-Hooks для базового API для регистрации обратных вызовов JS на атрибутах шорткода.
• Поле вложения использует индикатор загрузки при загрузке предварительного просмотра для прикрепления.
• Добавлен китайский перевод.
• Добавил французский перевод.
• Добавлен испанский перевод.
• Исправление ошибок: предотвращает фаталирование, когда редактор загружается в контексте фронта.
• Исправление ошибки: цветовое поле также поддерживает meta аргументы.
• Исправление ошибки: удаляет дорогую пробел из шорткодов без атрибутов.
• Исправление ошибки: удаляет двойную черту в пути редактора CSS.
• Полные заметки о выпуске

0,3,0 (27 апреля 2015 г.)

• Нарушение изменения : мы удалили Shim совместимости для атрибута магического content . Если вы использовали это для поддержки редактирования внутреннего контента, вам нужно изменить регистрацию пользовательского интерфейса, чтобы использовать inner_content .
• Новый тип поля post_select для выбора из списка сообщений. Поддерживает дополнительный параметр query для изменения поискового запроса.
• Используя новый аргумент post_type , пользовательский интерфейс Shortcode может быть зарегистрирован для конкретных типов постов. Это полезно, если вы хотите, чтобы пользовательский интерфейс для данного шорткода отображался только на конкретных типах постов.
• Для каждого атрибута короткометражного кода можно указать meta аргумента, чтобы добавить произвольные атрибуты HTML в поле. Мы добавили совместимость для существующего аргумента placeholder . Эта совместимость будет удалена в V0.4.
• При вставке шорткода пользовательский интерфейс показывает полезное сообщение, когда шорткод не имеет атрибутов для настройки. Ранее пользователь был представлен относительно пустым экраном.
• Наш пример плагин может быть активирован через администратор WordPress.
• Нажав «Вставьте элемент post» в левое меню, фактически действует как кнопку Back, чтобы выбрать шорткод.
• Язык вокруг опыта редактирования отражает шорт -код, который вы редактируете. Например, с шорткодом Pullquote, «Edit Post Element» становится «редактирование Pullquote».
• Добавлен голландский перевод.
• Исходные файлы JavaScript перенесены в js/src для ясности между источником и созданным JavaScript.
• Файлы PHP сканируются с использованием php_codesniffer.
• Исправление ошибки: атрибуты шорткода некритируются должным образом.
• Исправление ошибки: поле вложения правильно регистрирует зависимости.
• Исправление ошибки: «Вставка Post Element Ement» должен работать, когда визуальный редактор отключен. Шортклей только свободно связан с Tinymce.
• Исправление ошибок: стили редактора загружаются на after_setup_theme чтобы предотвратить смертельные фататы.
• Полные заметки о выпуске.

0,2,3 (8 апреля 2015 г.)

• Исправьте проблему WP 4.1 обратной совместимости путем восстановления аргументов, передаваемых Tinymce View Compatibility Shim.

0,2,2 (6 апреля 2015 г.)

• Обновление аргументов, передаваемых для визуализации Tinymce для совместимости WP 4.2. Ранее принятый аргумент не был необходим, поэтому удаление не сломается задом наперед.

0,2,1 (18 марта 2015 г.)

• Обеспечить использование jquery rascols jquery.noconflict () режим в wp.

0,2,0 (18 марта 2015 г.)

• JS абстрагирована с помощью браузероиза.
• Улучшения для пользовательского интерфейса «Добавить элемент Post»: шорткоды сортируются в алфавитном порядке; Поиск на основе этикетки.
• Гораздо проще выбрать предварительный просмотр коротких кодов, которые включают iframes.
• WordPress 4.2 Совместимость.
• Добавлен цветовой сборщик в список потенциальных полей.
• Исправление ошибки: IE11 совместимость.
• Исправление ошибки: поле флажки теперь можно не контролировать.
• Полные заметки о выпуске.

0,1,0 (23 декабря 2014 г.)

• Поддерживает все типы ввода HTML5 для поля формы.
• Вкладка предварительного просмотра шорткода в опыте редактирования. }* Переиздал пользовательский интерфейс вокруг «Post Elements», который является более описательным, чем «элементы контента».
• Много исправлений ошибок.
• Полные заметки о выпуске.