Знаете ли вы, что все темы, размещенные в репозитории WordPress.org, проходят тщательный процесс проверки со стороны добровольных членов группы по обзору тем (TRT)?
Не все профессионалы, работающие с WordPress, знают о процессе рецензирования и о том, что с ним связано. Если вы среди них, если вы решите впервые представить свою тему в хранилище, вас может удивить.
Понимание того, что существует большое количество руководств и рекомендаций, которым вы должны следовать, может поначалу показаться вам немного ошеломляющим. Если рецензент продолжает возвращаться с просьбой об изменении вашей темы, вы можете даже поддаться искушению нарастить разочарование и добавить полотенце.
Но подожди, пока не сдавайся.
В этой статье вы познакомитесь с необычным инструментом обучения собственной разработки TRT, т. Е. С темой doititrong .
Я собираюсь показать вам, что это такое и как вы можете использовать это в своих интересах.
Что такое неправильная тема?
TRT установил достаточное количество ресурсов для того, чтобы как новые рецензенты, так и разработчики тем работали с рекомендациями для репозитория.
Основным ресурсом является Справочник по обзору тем . Здесь вы можете найти главы о процессе рецензирования, требованиях к теме (строгие правила, которым должна соответствовать тема) и рекомендуемых функциях темы (необязательные рекомендации, которые вы можете игнорировать, хотя было бы неплохо, если бы вы этого не сделали).
Еще один замечательный источник обучения — Theme Developer Handbook . Эта онлайн-книга поможет вам создать собственную тему WordPress с учетом передового опыта.
Еще один ресурс — блог Make WordPress Themes , где вы найдете последние обсуждения по темам, связанным с обзором.
Четвертый вариант — это слабая страница TRT , к которой вы можете легко получить доступ, используя свои учетные данные WordPress.org. На этой странице вы можете обратиться за помощью по всем вопросам, связанным с рецензированием или отправкой тем для хранилища.
Пожалуй, наименее известный, но самый необычный ресурс — это неправильная тема.
Как следует из названия, эта тема является свидетельством плохой практики кодирования. В нем вы найдете множество вещей, которые выкинут любую тему из хранилища за десять секунд.
Так для чего это нужно? — спросите вы. — Что хорошего в том, что так явно неправильно?
Вот мой ответ.
В основе темы лежит старый добрый принцип: учитесь на чужих ошибках. Вот как Джо Кастанеда , член TRT, описывает эту тему:
Тема «Делать неправильно» служит инструментом для рецензентов.
как авторы темы, чтобы лучше понять требования должны быть
встретились до того, как тема может быть сделана живой.
Сделать WordPress.org Темы .
Другими словами, большинство материалов, которые идут вразрез с руководящими принципами WordPress.org, занимают почетное место в теме doitwrong . Начните разбирать его на части, и вы получите возможность увидеть конкретные примеры того, чего не следует делать в вашей теме. Это намного лучше, чем просто читать список всех действий и недостатков, а затем пытаться помнить об этом при кодировании.
Пришло время проработать тему с этим и начать изучать некоторые рекомендации.
Первые шаги процесса обзора тем WordPress.org
Цель этого раздела — описать процесс рассмотрения темы для репозитория WordPress.org с использованием темы doitwrong в качестве морской свинки.
Требования, которые необходимо сосредоточить на кластере вокруг этих областей:
- Специальные возможности (только если ваша тема заявляет, что готова к использованию, используя соответствующий тег в style.css)
- Основные функциональные возможности и особенности
- Презентация против функциональности
- Документация
- язык
- Лицензирование
- Именование
- Параметры и настройки
- Плагины
- Скриншот
- Безопасность и конфиденциальность
- Продажа , кредиты и ссылки
- Таблицы стилей и скрипты
- Шаблоны
Похоже, много, но большая часть этого материала — здравый смысл, остальное просто устанавливает некоторые стандарты для обеспечения качества. Я думаю, что все темы WordPress.org пользователи заслуживают столько же. Не так ли?
Настройте локальную установку WordPress с некоторым демонстрационным контентом, установите плагин Developer , получите копию темы doitwrong на GitHub и оставьте Руководство по обзору тем открытым в своем браузере. Давайте рассмотрим.
Запуск плагина проверки темы
Как только вы установите тему, запустите ее через плагин Theme Check от Samuel Wood (Otto) и Simon Prosser . Если вы ранее установили плагин для разработчиков, Theme Check уже есть в вашей системе. Активируйте его, затем перейдите в Внешний вид> Проверка темы. Теперь выберите тему doitwrong и нажмите «Проверить».
В мгновение ока появляется куча ошибок, предупреждений, рекомендаций и информационных уведомлений. На первый взгляд, вы даже не можете загрузить эту тему для ознакомления, не говоря уже о том, чтобы одобрить ее. Фактически, каждая тема проходит через безошибочную сеть этого плагина на этапе загрузки.
Простое ознакомление с темами, выделенными в Theme Check, особенно необходимыми элементами и предупреждениями, поможет вам в ознакомлении с основными требованиями, которым должна соответствовать ваша тема.
Для полного списка того, что проверяет этот плагин, вам нужна страница Руководства .
Проверка блока комментариев в style.css
Откройте style.css в вашем редакторе кода. Блок комментариев вверху — это одно из первых мест, которое нужно проверить. Здесь делающая неправильно тема превосходит себя.
Посмотрите внимательно. Вы можете что-нибудь заметить? Вот мой собственный взгляд на это:
- Поле URI темы использует сокращатель URL (см. Раздел « Безопасность и конфиденциальность» Руководства).
- Страница URI темы, на которую указывает текст, не имеет ничего общего с темой. Вам не нужно использовать URI темы. Однако, если вы это сделаете, вы должны убедиться, что он ссылается на страницу с полезной информацией о вашей теме (для получения более подробной информации прочитайте страницу Руководства здесь).
- Поле Author использует URI несвязанной страницы. Вы не обязаны добавлять поле Автора, но если вы делаете, информация должна быть соответствующей.
- Поле URI автора не заполнено. Еще раз, если вам не нужно поле, вы просто воздержитесь от добавления его в свой блок комментариев.
- Поле Описание темы не только не дает никакой полезной информации о теме, но и неточно. Если вы просмотрите тему, вы не найдете функции слайдера на домашней странице.
- Наконец, тема использует только два тега. Тем не менее, эта тема поддерживает другие функции WordPress и дизайна. Это должно быть отражено в списке тегов .
Я даже не говорю вам, куда указывает ссылка на тему URI. Я не хочу портить сюрприз. Найди это для себя и дай мне знать.
Заглянуть в header.php и footer.php
Другими вероятными кандидатами, в которых вы можете обнаружить что-то неправильное, являются header.php и footer.php .
Откройте header.php и попытайтесь поймать столько вопросов, сколько сможете.
Вот виновная сторона в разделе <head> документа:
Таблица стилей Google Fonts жестко запрограммирована, что происходит чаще, чем вы думаете. Помните, нет жесткого кодирования стилей и сценариев . Поставьте все в очередь.
Погружение в раздел <body> документа выявляет пару проблем.
Во-первых, аргумент text-domain внутри функции перевода _e() не соответствует текстовому домену, указанному в style.css комментариев style.css . Заявленный текстовый домен делает неправильно , текстовый домен, который автор использует здесь, неверен . Действительно, это неправильно.
Обратитесь к соответствующему разделу «Обзора обзора» :
Используйте один уникальный слаг темы — так как слаг темы появляется в
style.css.
Во-вторых, код извлекает пользовательскую информацию для отображения социальных ссылок на веб-сайте. Тем не менее, в этом случае добавление этой функции осуществляется с помощью панели параметров, а не настройщика.
Начиная с 21 апреля 2015 года , TRT установил требование, чтобы все темы, размещенные на WordPress.org, реализовывали параметры темы с помощью настройщика.
Обновление также четко отражено в руководствах Руководства :
Используйте настройщик для реализации параметров темы.
Еще одним источником распространенных проблем является footer.php . Найдите этот файл в теме doitwrong и откройте его в редакторе кода.
Сколько проблем вы можете придумать? Вот мой список.
- Фрагмент ниже извлекает некоторые данные Testimonial из настройщика с помощью get_theme_mod (). Однако использование Customizer для генерации контента, который должен принадлежать плагинам (пользовательские типы постов являются территорией плагинов), не является подходящим способом. Кроме того, вывод пользовательских данных, печатаемых на странице, следует
esc_html()с помощью соответствующих функций , например,esc_html(),esc_textarea()и т. Д.
- Обратите внимание на кнопку для переключения меню навигации? Если вы внимательно посмотрите, вы увидите, что текст меню нижнего колонтитула не переводится. Все текстовые строки в теме должны быть готовы к переводу с использованием соответствующих функций перевода, например,
_e(),__()и т. Д. Это еще не все: идентификатор меню навигации foter не существует. Правильный идентификатор для нижнего колонтитула — нижний колонтитул (это можно быстро узнать, проверивregister_nav_menus()вfunctions.php).
- И последнее, но не менее важное: WordPress — это
Word"p"ress(с строчной буквой p), что неверно и должно быть исправлено .
Никто не ожидает, что вы выучите инструкции наизусть. Они не написаны в камне, и грязная реальность каждой темы порой побеждает простоту четкого правила.
Но, проверив каждый файл шаблона внутри темы doitwrong на страницах Справочника по обзору тем, вы обнаружите, что изрядное количество руководящих принципов начинает проникать, пока вам не нужно снова и снова просматривать Справочник.
Почему я должен заботиться о том, чтобы делать неправильную тему, или даже руководящие принципы?
Понятно, что вы могли бы задать этот вопрос прямо сейчас. В конце концов, Рекомендации по обзору тем применяются только к темам, размещенным на WordPress.org. Таким образом, вы можете пройти успешную карьеру разработчика тем WordPress, не обращая наименьшего внимания на «Справочник по обзору тем», на занятие по теме или на другие доступные ресурсы.
Тем не менее, я собираюсь привести вам лишь несколько причин, почему вы должны заботиться.
- Одно из достоинств данной темы состоит в том, что она использует практический подход к изучению руководств по репозиторию. Вы можете использовать его вместе с другими ресурсами, чтобы попрактиковаться в обнаружении ошибок, а не просто читать о них.
- Это известный факт, что ловить чужие ошибки легче, чем ловить собственные . Мы слишком близко, чтобы определить, что не так. Тема workingitwrong поможет вам научиться определять, что не так с вашей темой, прежде чем отправлять ее в репозиторий.
- В более общем плане то, что касается репозитория тем WordPress.org, хотя и не обязательно где-либо еще, устанавливает стандарт качества, который трудно игнорировать. Если вы серьезно относитесь к работе над темами WordPress, желательно хотя бы немного ознакомиться с требованиями репозитория тем.
- Потратив некоторое время на ознакомление с руководящими принципами WordPress.org и применяя их к своей работе, вы сможете создавать еще более потрясающие темы WordPress, которые соответствуют передовым методам и просты в использовании , что делает вас лучшим разработчиком тем.
Что дальше?
После того, как вы посмотрите, что нужно, чтобы ваша тема была готова для репозитория WordPress.org, вот что вы можете сделать дальше.
- Размести тему GitHub на GitHub и получай удовольствие, добавляя несколько собственных ошибок.
- Проверьте реальную тему, представленную в хранилище.
Попробуйте выполнить один или оба этих шага и поделитесь своим опытом с сообществом. Я не могу ждать, чтобы услышать все об этом в комментариях.
Счастливого обсуждения WordPress!