Статьи

Панель инструментов Smart WordPress Developer: шаблонная панель плагина WordPress

Знаете ли вы, что вы действительно можете вызвать смерть, написав плагин WordPress? Это правда: если вы создаете плагин, который недостаточно закодирован, чтобы вызвать проблемы с безопасностью, и, скажем, кто-то взламывает сайт небольшой страны с диктаторским правилом, некоторые головы могут перевернуться.

Хотя это маловероятный шанс и пока не сообщается, что он правдив (пока), на самом деле для вас есть веская причина написать лучшие плагины. И в этой части серии «Инструментарий Smart WordPress Developer» мы собираемся спасти несколько жизней, пройдя по шаблонной схеме плагина WordPress.

Что является самой важной сверхдержавой WordPress? Я задавал и отвечал на этот вопрос несколько раз в моих уроках, но вы, вероятно, уже знаете ответ: расширяемость.

Одним из способов использования этой мощи является создание плагинов WordPress и их использование для сообщества. Вы можете выпустить плагин на GitHub, в репозитории плагинов WordPress, на CodeCanyon или на вашем собственном веб-сайте. Вы можете отдать его бесплатно, или попросить денег или пожертвований.

В любом случае вы будете расширять функциональность WordPress каким-либо образом и на ваших собственных условиях. Вы являетесь частью сообщества WordPress и позволяете сообществу расти, расширяя WordPress. Как это круто? Это действительно суперспособность WordPress, и вы можете использовать его.

Но вы также должны напомнить себе, что с большой силой приходит большая ответственность. Вы должны использовать эту силу навсегда и использовать ее хорошо. Создавая плохо написанные плагины для WordPress, вы можете вызвать некоторые действительно плохие вещи, особенно с точки зрения безопасности. Вот почему вам нужно действовать осторожно и создавать хорошо закодированные плагины на прочной основе.

Хотя WordPress Plugin Boilerplate не решает всех ваших проблем с кодированием, он поможет вам начать с правильной ноги, предоставляя эту «прочную основу» и направляя вас к кодированию лучше.

WordPress плагин Boilerplate

Еще в декабре 2011 года Том Макфарлин, наш редактор Tuts + Code, выпустил первую версию WordPress Plugin Boilerplate. За три года за проектом наблюдали более 250 человек, его разветвляли почти 700 раз и получили более 2700 звезд на GitHub.

В марте 2015 года Том объявил, что Девин Винсон перешел во владение проектом WordPress Plugin Boilerplate. На сегодняшний день репозиторий проекта GitHub размещен в учетной записи Девина .

На домашней странице WordPress Plugin Boilerplate проект определен как «стандартизированная, организованная, объектно-ориентированная основа для создания высококачественных плагинов WordPress».

По сути, шаблон WordPress Plugin Boilerplate является одним из лучших инструментов для запуска нового плагина WordPress с прочной основой. Он обеспечивает необходимую структуру файлов и папок, чтобы оставаться организованным, и используя стартовые коды внутри файлов, вы можете оптимизировать рабочий процесс и правильно написать плагин.

Конечно, этот инструмент не для начинающих WordPress. Но вам также не обязательно быть гуру WordPress: даже если у вас есть базовые знания о разработке плагинов WordPress, шаблонная таблица плагинов WordPress будет простым для понимания инструментом для создания лучших плагинов WordPress.

Начать проект плагина WordPress с WordPress Plugin Boilerplate, на самом деле, довольно просто. В начале, все, что вам нужно сделать, это изменить папку с plugin-name плагина на имя вашего плагина и отредактировать все файлы (файлы PHP, JS, CSS и изображения), чтобы изменить «стандартные значения» на значения вашего собственного плагина.

Вы заметите, что есть довольно много файлов для работы и множество частей для редактирования даже до написания собственного кода. Не позволяйте этому оттолкнуть вас — в конце концов, это единовременная вещь.

Давайте быстро рассмотрим некоторые файлы и папки:

  • plugin-name/admin/ : включает в себя CSS-файлы, JS-файлы, партиалы и PHP-файл для класса, специфичного для администратора ( class-plugin-name-admin.php ).
  • plugin-name/includes/ : эта папка является своего рода «основой» вашего плагина. Это состоит из:
    • plugin-name/includes/class-plugin-name.php : основной класс PHP вашего плагина.
    • plugin-name/includes/class-plugin-name-activator.php : Включает функции активации плагина.
    • plugin-name/includes/class-plugin-name-deactivator.php : Включает функции деактивации плагина.
    • plugin-name/includes/class-plugin-name-i18n.php : Включает функцию интернационализации.
    • plugin-name/includes/class-plugin-name-loader.php : Включает действия и фильтры для вашего плагина.
  • plugin-name/languages/ : в эту папку входят языковые файлы вашего плагина. Включает файл plugin-name.pot по умолчанию.
  • plugin-name/public/ : включает в себя CSS-файлы, JS-файлы, партиалы и PHP-файл для общедоступной функциональности ( class-plugin-name-admin.php ).
  • plugin-name/LICENSE.txt : копия лицензии GPL-2.
  • plugin-name/plugin-name.php : основной файл плагина.
  • plugin-name/README.txt : файл README по умолчанию для вашего плагина. Не забудьте изменить это!
  • plugin-name/uninstall.php : Файл, запускаемый, когда пользователь удаляет ваш плагин.

Обратите внимание, что структура папок основана на системе репозитория плагинов WordPress.org.

Подсказка. Используя инструмент WordPress Plugin Boilerplate Generator , вы можете создать собственную копию. Вы предоставляете имя вашего плагина, слаг, сайт, а также ваше имя, адрес электронной почты и сайт; затем инструмент заменяет все соответствующие значения в шаблонных файлах. Ухоженная!

WordPress Plugin Boilerplate, безусловно, является отличным инструментом (даже лучшим инструментом, возможно) для создания лучших плагинов WordPress. Но, как я сказал в начале этой статьи, этого недостаточно. Вы должны помнить о стандартах кодирования WordPress , соблюдать процессы написания плагинов и следить за проблемами безопасности в целом. И если вы хотите узнать больше о написании лучших плагинов, обязательно ознакомьтесь с видеокурсом « Введение в разработку плагинов WordPress », также созданным Томом Макфарлином.

Что вы думаете о WordPress Plugin Boilerplate и создании плагинов с его помощью? Поделитесь своими мыслями с нами, разместив в разделе комментариев ниже. И если вам понравился урок, обязательно поделитесь им с друзьями!

Увидимся в следующей части, где мы поговорим о Envato WordPress Toolkit, инструментарии для установки и обновления тем, приобретенных у ThemeForest.