Что делать, когда стандарты кодирования темы и WordPress конфликтуют?

Question

Что делать, когда стандарты кодирования темы и WordPress конфликтуют?

Я рассматриваю различные начальные темы, такие как _s и корни . Корни выглядят очень хорошо, особенно его дерзкая вилка. В любом случае, есть одна вещь, которая меня беспокоит. Похоже, что Roots не соответствует стандартам кодирования WordPress тем и плагинов. Какому стандарту я должен следовать, если я хочу использовать корни в качестве начальной темы?

3

coding-standards theme-roots

Author: user54383, 2014-06-18

Source

2 answers

Корни придерживаются своих собственных соглашений с немного меньшим интервалом и отступом в 2 пробела по сравнению с отступом в 1 табуляции WP

Вот что говорится в кодексе о отступах

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

Исключение: если у вас есть блок кода, который был бы более читабельным, если все выровнено, используйте пробелы:

Это это не вопрос соблюдения стандартов кодирования или нет. Всегда помните, что читаемость кода очень и очень важна, и стандарты кодирования предусматривают это.

По вашему вопросу, тема "Корни" все еще работает в рамках стандартов кодирования. Я бы также подумал, что такая успешная тема не стала бы рисковать своей репутацией, чтобы пересечь черту. Придерживайтесь того, что предлагают вам корни, они соответствуют стандартам кодирования, поэтому вам следует придерживаться их структуры для удобочитаемость

Ссылки:

РЕДАКТИРОВАТЬ

Этот вопрос получил близкие голоса как "основанный в первую очередь на опионах", что может быть правильно, но действительно ли стандарты кодирования основаны в первую очередь на опионах?

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

Я действительно думаю, что все это упражнение сводится к чтению и пониманию того, что сказано на этих страницах кодекса.

4

Author: Pieter Goosen, 2020-06-15 08:21:38

score 3 · Accepted Answer

Это очень субъективный вопрос, хотя и очень хороший и интересный, и я постараюсь изложить свой личный взгляд на это.

В общем, вы всегда должны стараться придерживаться стандартов кодирования WordPress. Единственным исключением из этого правила является изменение существующего кода. В принципе, когда вы редактируете существующий "продукт" (например, плагин или тему), вы должны использовать стандарты кодирования, которым следует продукт. Таким образом, в вашем случае вы должны придерживаться стандартов кодирования тема.

Хотя эта дифференциация может показаться довольно черно-белой, это не так. Есть много серых областей, которые нужно учитывать. Я постараюсь осветить некоторые из них, но позвольте мне сначала попытаться дать набор основных правил:

Если вы не меняете продукт, а создаете новый или расширяете существующий, используйте Стандарты кодирования WordPress.
Если вы меняете код в ядре WordPress, используйте Стандарты кодирования WordPress (даже если дополнительные код может не соответствовать им).
Если вы меняете продукт, и код читаем и соответствует форматированию, используйте стандарты кодирования оригинального продукта.

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

Стандарты кодирования для дочерних тем

На самом деле это не серая зона, но это интересный момент, который следует уточнить: при расширении продукта (то есть не изменении, а действительно расширении) вы предоставляете дополнительный продукт, зависящий от существующего продукта. Это отдельный продукт, и вы должны придерживаться стандартов кодирования WordPress.

Нелепые стандарты кодирования

Если вы меняете продукт и у него нелепые стандарты кодирования (например, стандарты кодирования, которые серьезно ухудшают читаемость кода), вам следует выбрать использование стандартов кодирования WordPress.

Несовместимые стандарты кодирования

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