CMB2 │

CMB2 - это набор инструментов разработчика для создания метабоксов, пользовательских полей и форм для WordPress, который взорвет ваш разум. Легко управляйте метаполями для постов, терминов, пользователей, комментариев или создавайте пользовательские страницы опций.

CMB2 - это полная переработка Custom Metaboxes and Fields для WordPress. Чтобы начать работу, пожалуйста, следуйте примерам в прилагаемом файле example-functions.php и ознакомьтесь с базовыми инструкциями по использованию.

Список доступных типов полей можно посмотреть здесь.

Особенности:

• Создание метабоксов для использования на экранах редактирования постов.

• Создание форм для использования на страницах опций.

• Создание форм для обработки пользовательских метаданных и их отображение на страницах добавления/редактирования профиля пользователя.

• Создание форм для обработки метаданных терминов и их отображение везде, где используются таксономии.

• Гибкий API, позволяющий использовать формы CMB практически везде, даже на front-end.

• Включено несколько типов полей.

• Пользовательский API хук, позволяющий создавать собственные типы полей.

• Имеется множество хуков и фильтров, позволяющих изменять многие аспекты библиотеки (не редактируя ее напрямую).

• Поддерживаются повторяющиеся поля для большинства типов полей, а также повторяющиеся группы полей.

• CMB2 безопасно подключать к любому проекту. Он будет загружать только самую новую версию в системе.

Документация

Документацию по CMB2 можно найти на вики CMB2 на github. Также, если вы любите читать код и встроенную документацию, мы постарались, чтобы все функции и методы были полностью встроены в документацию.

Вклад

Разработка ведется на Github, и все вклады приветствуются. Пожалуйста, прочитайте документ CONTRIBUTING для более подробной информации.

Полный список всех контрибутеров можно найти здесь: github.com/CMB2/CMB2/graphs/contributors.

Перевод

Если вы хотите предоставить файлы перевода, пожалуйста, сделайте это через WordPress Plugin Translations.

Ресурсы сторонних разработчиков

Пользовательские типы полей:

• CMB2 Field Type: CMB Attached Posts Field от coreymcollins: custom_attached_posts, для прикрепления постов к странице.

• CMB2 Field Type: Post Search Ajax от alexis-magina: post_search_ajax Прикрепление постов друг к другу. Тот же подход, что и в CMB2 Attached Posts Field, но с Ajax-запросом, возможностью выбора нескольких/одного и другим UI.

• CMB2 Field Type: CMB2 Post Search field: post_search_text добавляет диалог поиска постов для поиска/прикрепления других идентификаторов постов.

• CMB2 Field Type: CMB2 User Search field из Mte90: user_search_text добавляет диалог поиска пользователя для поиска/прикрепления других идентификаторов пользователя.

• CMB2 Field Type: Google Maps от mustardBees: Пользовательский тип поля для Google Maps.

  Поле pw_map хранит значения широты/долготы, которые вы можете использовать для отображения карты в вашей теме.

• CMB2 Field Type: Leaflet Maps от villeristi: Пользовательский тип поля для Leaflet Maps.

• CMB2 Field Type: Select2 от mustardBees: Пользовательские типы полей, использующие скрипт Select2:

  Поле pw_select действует аналогично полю select по умолчанию. Однако оно добавляет поиск в стиле typeahead, позволяющий быстро сделать выбор из большого списка.

  Поле pw_multiselect позволяет выбрать несколько значений с поиском в стиле typeahead. Значения можно перетаскивать для изменения порядка.

• CMB Field Type: Slider от mattkrupnik: Добавляет поле jQuery UI Slider.

• WDS CMB2 Date Range Field от dustyf из WebDevStudios: Добавляет поле диапазона дат.

• CMB2 Remote Image Select от JayWood из WebDevStudios: Позволяет пользователям вводить URL в текстовое поле и выбирать одно изображение для использования в метапосте. Аналогично селектору избранных изображений Facebook.

• CMB Field Type: Sorter: Этот плагин предоставляет вам два типа полей CMB, основанных на скрипте Sorter.

• CMB Field Type: Tags: Тип поля, подобный WordPress-Tags, для CMB2. Примечание: это не устанавливает теги постов, а просто предоставляет уникальный текстовый ввод

• CMB Field Type: Link Picker: Используя элемент управления Link Picker for CMB2, вы можете выбрать ссылку с вашего сайта WordPress или ввести ее вручную. Вы также можете определить, должна ли ссылка открываться в новом окне или нет.

• CMB Field Type: MultidatesPicker: Создает тип поля CMB2, который позволяет использовать календарь с несколькими датами. Он использует плагин MultiDatesPicker v1.6.3 для jQuery UI.

• CMB Field Type: CMB2-radio-image: Изображение в виде радиокнопок.

• CMB2 Term Select: Специальное поле CMB2, которое позволяет пользователям определить текстовое поле автозаполнения для терминов. Примечание: это поле будет устанавливать термины таксономии, но имеет возможность ('apply_term' => false) отключить и сохранить идентификаторы терминов как данные (как для страниц опций и т.д.).

• CMB2 Related Links: Позволяет пользователям добавлять связанные ссылки через повторяющуюся группу полей. Ввод полей осуществляется с помощью поля CMB2 Field Type: CMB2 Post Search field, описанного выше, поэтому каждая ссылка может быть заполнена существующим содержимым WordPress при нажатии на кнопку поиска. Примечание: это не стандартный тип поля, а функция, которую вы используете в сочетании с CMB2::add_field().

• CMB2 Field Type: Order by rubengc: Позволяет пользователям определять пользовательский порядок предопределенных опций.

• CMB2 Field Type: Animation by rubengc: Позволяет пользователям выбирать анимацию из Animate.css (включает предварительный просмотр выбранной анимации).

• CMB2 Field Type: Ajax Search by rubengc: Основан на CMB2 Field Type: Post Search Ajax, добавляет возможность прикреплять посты/пользователей/термины, а также возможность ограничить максимальное количество прикрепленных объектов.

• CMB2 Field Type: Visual Style Editor by rubengc: Пользовательское поле для CMB2, позволяющее настраивать стиль с помощью небольшого набора элементов управления.

• CMB2 Field Type: Content Wrap by rubengc: Пользовательское поле для CMB2 для хранения значений обводки содержимого (padding, margin или border width).

• CMB2 Field JS Controls by rubengc: Показывает любое поле, аналогично действиям WordPress при публикации (Post/Page post_status, visibility и post_date submit box field).

• CMB2 Field Type: Position by rubengc: Тип поля CMB2 для установки значений позиции jquery UI.

• CMB2 Field Type: CMB2 Roadway Segments by pixelwatt: Этот плагин добавляет новый тип поля CMB2 для нанесения сегментов дорожного полотна на карту и предоставляет шорткод для отображения.

• CMB2 Field Type: Font Awesome by serkanalgur: Этот плагин добавляет новый тип поля CMB2 для выбора иконок Font Awesome.

• CMB2 Field Type: Typography by eduplessis: Этот плагин добавляет новый тип поля CMB2 "Typography" и использует jQuery fontselect для выбора семейства шрифтов.

• CMB2 Field Type: Markdown by Rekenna: Этот плагин добавляет новый тип поля CMB2 "CMB2 Markdown", где вы можете набирать текст в формате markdown и просматривать результаты в реальном времени или конвертировать в html с помощью кнопки.

• CMB2 Field Type: Switch Button by themevan: Этот плагин добавляет тип поля Custom Switch Button для CMB2.

• CMB2 Field Type: select_plus от manzoorwanijk: Тип поля Select, который действует так же, как поле по умолчанию select. Однако он добавляет поддержку optgroup и сохранение значений с атрибутом multiple.

• CMB2 Field Type: Address by scottsawyer: Простое, повторяющееся поле адреса. На самом деле это просто сниппет из CMB2 Snippet Library, преобразованный в плагин.

• CMB2 Field Type: Link by scottsawyer: Создает поле ссылки с некоторыми атрибутами. Очень удобно для стилизации ссылок.

• CMB2 Field Type: Widget Selector by scottsawyer: Вам нужно поле, которое позволит вам (или вашему редактору) выбрать / отобразить существующий экземпляр виджета? Тогда этот плагин для вас.

Другие полезные ресурсы

• CMB2 Admin Extension: Добавляет пользовательский интерфейс для создания метабоксов CMB2 из админки WordPress. Также на wordpress.org.

• WordPress Shortcode Button: Использует поля CMB2 для генерации полей для модалов ввода шорткодов.

• WDS-Simple-Page-Builder: Использует существующие части шаблона в текущей активной теме для создания пользовательской страницы с возможностью перестановки элементов. Построено с помощью CMB2.

• Пример темы CMB2: Демонстрация того, как включить CMB2 в вашу тему, а также несколько полезных советов и трюков.

• facetwp-cmb2: Интеграция FacetWP с CMB2.

• CMB2-grid из origgami: Система сетки для библиотеки WordPress CMB2, которая позволяет создавать колонки для лучшего расположения в админке.

• CMB2 Metatabs Options от rogerlos: CMO позволяет легко создавать страницы опций с несколькими метабоксами и дополнительными вкладками в админке WordPress.

• CMB2 Conditionals от jcchavezs: Позволяет разработчикам связывать поля так, чтобы отображение одного из них зависело от значения другого.

• CMB2 Metabox Code Generator от willthemoor: Пропустите скучные биты. Используйте этот генератор для легкого создания полнофункциональных метабоксов CMB2. Теперь с массовым вводом!

• Caldera Metaplate от CalderaWP: Не специфичен для CMB2, но позволяет создавать шаблоны для вывода ваших пользовательских полей.

• Yoast CMB2 Field Analysis WP Plugin by alexis-magina: Этот плагин добавляет основанный на js метод пересчета оценок содержимого Yoast SEO при обновлении содержимого страницы, в частности, пользовательских мета-полей, добавленных с помощью библиотеки CMB2.

• Skeleton от awethemes: Полный фреймворк для WordPress, использует движок CMB2.

• WP Simple Iconfonts by awethemes: Менеджер иконочных шрифтов и предоставляет подборщик иконок шрифтов для CMB2.

• CMB2 Nav Menus by nsrosenqvist: Позволяет использовать CMB2 в навигационных меню...

Ссылки

• Project Homepage

• Github project page

• Documentation (GitHub wiki)

• Snippet Library