Plugin Check (PCP)

Журнал змін

2.0.0

• Покращення — додано перевірку сумісності функцій WordPress, щоб позначати використання функцій, недоступних у мінімальній заявленій версії WordPress для плагіна.
• Покращення — додано перевірку Write File для виявлення плагінів, які зберігають дані в теці плагіна замість каталогу uploads або бази даних.
• Покращення — додано пакетне виявлення хибних спрацювань за допомогою ШІ зі спеціальними підказками для перевірок і вибором моделі ШІ для WP-CLI.
• Покращення — додано підтримку експорту результатів перевірки у CTRF.
• Покращення — додано підсумок кількості помилок до інтерфейсу Plugin Check.
• Покращення — покращено виявлення прямого доступу до файлів для файлів у стилі бібліотек.
• Покращення — налаштовано перевірки для режиму оновлення.
• Виправлення — пом’якшено перевірку заголовка Update URI для URL плагінів WordPress.org.
• Виправлення — покращено визначення сумісності функцій WordPress, щоб уникнути хибних спрацювань через серіалізацію PHP.
• Виправлення — враховано wp_supports_ai() і фільтрування моделей із підтримкою тексту в Plugin Namer.
• Виправлення — показано використання токенів Plugin Namer у результатах.
• Виправлення — EUPL розпізнається як ліцензія, сумісна з GPL.
• Виправлення — покращено інтернаціоналізацію для міток із префіксом-емодзі.
• Виправлення — оновлено посилання на репозиторії сніферів PHPCS.
• Коригування — оновлено документацію перевірок середовища виконання WP-CLI.
• Службове — додано автоматичну генерацію даних сумісності функцій WordPress.
• Службове — додано розкриття інформації про використання ШІ до шаблону pull request.
• Службове — додано інструкції для ШІ-агента кодування.
• Завдання – усунути попередження щодо конфігурації wp-env для розробки та тестування.
• Завдання – показувати кнопку попереднього перегляду WordPress Playground у пул-реквестах.
• Завдання — оновити залежності, пов’язані з розробкою та безперервною інтеграцією.

1.9.0

• Покращення — використано основні AI connectors WordPress 7.0.
• Покращення — додано перевірку External Admin Menu Links для виявлення зовнішніх URL у меню адмінпанелі верхнього рівня.
• Покращення — додано й уточнено перевірку сумісності метаданих блоків, яка вимагає apiVersion 3+ для сумісності з iframe-редактором WordPress 7.0+, зокрема з налаштованою серйозністю залежно від режиму.
• Покращення — покращено виявлення Plugin Updater для визначення викликів Plugin Update Checker (PUC).
• Покращення — WTFPL приймається як ліцензія, сумісна з GPL.
• Виправлення — покращено перевірку URL пожертв PayPal для складних рядків запиту.
• Виправлення — забезпечено використання налаштованої бажаної моделі в AI Check.
• Виправлення — показано зрозуміле повідомлення про помилку Plugin Namer, коли стан конектора ШІ недоступний.
• Виправлення — оновлено посилання на сторінку налаштувань конектора Plugin Namer.
• Коригування — перевірку load_plugin_textdomain() змінено з рівня помилки на попередження.
• Виправлення — покращено перевірку contributors у readme за наявності ком у кінці.
• Виправлення — перевірки markdown-файлів зроблено нечутливими до регістру.
• Коригування — уточнено повідомлення про помилки сніфера екранування для зрозуміліших підказок.
• Службове — оновлено залежності розробки, зокрема @wordpress/scripts, simple-git, basic-ftp, svgo, immutable і @wp-playground/cli.
• Коригування — оновлено назву команди WordPress.org Plugins Team для узгодженості.

1.8.0

• Покращення — додано інструмент Plugin Namer на основі ШІ для оцінювання назв плагінів щодо конфліктів із торговельними марками та найкращих практик найменування.
• Покращення — додано перевірку AI Instructions Detection Check для виявлення конфігураційних файлів інструментів ШІ та каталогів, призначених лише для розробки.
• Покращення — додано підтримку експорту результатів перевірки у форматах CSV, JSON і Markdown.
• Покращення — додано фільтр типів перевірок для фільтрування результатів за помилками та попередженнями.
• Покращення — додано перевірку Direct File Access для забезпечення належної перевірки безпеки за допомогою константи ABSPATH.
• Покращення — додано перевірку невідповідності заголовка “Tested up to” між заголовком плагіна та readme.txt.
• Покращення — оновлено перевірку торговельних марок, щоб вилучити винятки для абревіатур і покращити гнучкість.
• Покращення — додано heredoc-сніфер для виявлення та обмеження використання heredoc (nowdoc дозволено).
• Виправлення — оновлено blueprint інтеграції Playground для сумісності.
• Виправлення — примусово забезпечено правильне визначення слага плагіна в команді WP-CLI.

1.7.0

• Покращення — додано Minified File Detection Check для виявлення та обробки мінімізованих файлів у плагінах.
• Покращення — реалізовано перевірку небезпечного використання wp_verify_nonce() для покращення перевірки безпеки.
• Покращення — додано сніфер прямих запитів до бази даних для виявлення прямих викликів бази даних без використання функцій WordPress.
• Покращення — додано перевірку префіксів, щоб забезпечити належне префіксування назв функцій і класів.
• Покращення — оновлено regex сніфера localhost для кращого виявлення URL localhost, зокрема доменів *.local.
• Покращення — заборонено перевірки середовища виконання, коли визначено константи власної таблиці користувачів, для кращої сумісності.
• Покращення — додано перевірку заборонених функцій для виявлення використання недозволених функцій PHP.
• Покращення — нова перевірка wp_safe_redirect, яка заохочує використовувати безпечну функцію переспрямування WordPress.
• Покращення — покращено перевірку невідповідного text domain для кращої перевірки інтернаціоналізації.
• Покращення — виявлення посилань, які просять поставити п’ятизіркові відгуки, для забезпечення дотримання настанов каталогу плагінів.
• Покращення — додано The Unlicense до перевірки ліцензій, сумісних із GPL.
• Покращення — покращено код сніфера localhost для точнішого виявлення.
• Виправлення — теки vendor_prefixed і vendor-prefixed ігноруються під час перевірок, щоб запобігти хибним спрацюванням.
• Виправлення — оброблено можливий порожній елемент у сканері, щоб запобігти попередженням PHP.
• Виправлення — приховано вивід помилок у сканері для чистішого виводу.
• Виправлення — ReflectionProperty::setAccessible() викликається лише в старіших версіях PHP для кращої сумісності з PHP 8.1+.
• Виправлення — запобігання видаленню власних таблиць WordPress під час очищення в тестовому середовищі.

1.6.0

• Покращення — підтримка суворого формату виводу для команд CLI.
• Покращення — покращено перевірку посилання для пожертв у readme.
• Покращення — покращено info-перевірку в утилітах Version.
• Покращення — покращено перевірку URL для полів заголовка плагіна.
• Покращення — покращено файли ruleset.
• Покращення — підвищено серйозність перевірок недійсного домену plugin uri та опису плагіна в заголовку плагіна.
• Покращення — видалено CallTimePassByReference, оскільки це застаріле правило.
• Покращення — заборонено спеціальні символи в textdomain.
• Покращення — імпортовано парсер readme для запобігання конфліктам із wordpress.org. Використовується парсер readme dotorg, якщо він доступний.
• Покращення — не рекомендується використовувати load_plugin_textdomain, знайдений у плагінах, оскільки він не потрібен на wordpress.org.
• Покращення — підвищено серйозність для відсутніх заголовків readme.
• Покращення — показ перевірки мінорної версії “Tested up to” лише тоді, коли це поточна мажорна версія.
• Покращення — додано посилання на сторінці плагінів для запуску перевірки плагіна.
• Виправлення — динамічна тека WP Content.
• Виправлення — виправлено тест для спеціальних символів у назвах файлів, які створювали проблеми користувачам після клонування.
• Виправлення — видалено Image_Functions_Check, оскільки вона давала хибні спрацювання.
• Виправлення — запобігання позначенню WordPress версії 10+ як помилки у перевірці “Tested up to”.

1.5.0

• Покращення — покращено перевірку URL для виявлення дубльованого протоколу.
• Покращення — оновлено серйозність для неправильних textdomains і кодів помилок i18n.
• Покращення — тепер проблеми у перевірці URL Author мають рівень ERROR замість WARNING.
• Покращення — нова перевірка мінорної версії в Tested up.
• Покращення — забезпечено, щоб заголовки не були порожніми у перевірці заголовка requires.
• Покращення — додано експериментальну опцію в адмінпанелі.
• Покращення — додано тест Behat для експериментальних перевірок із доповнень.
• Покращення — покращено перевірку ліцензії Apache.
• Покращення — попередження, якщо заголовки requires у readme та заголовку плагіна не збігаються.
• Виправлення — видалено попередження для динамічного callback у перевірці register_setting.
• Виправлення — неправильні таблиці бази даних використовувалися на підсайтах у Multisite.

1.4.0

• Покращення — ліцензію ISC дозволено в перевірці License.
• Покращення — додано перевірку використання налаштувань із callback-функцією санітизації.
• Покращення — додано –ignore-codes у CLI, щоб запровадити механізм ігнорування певних кодів помилок.
• Покращення — нові утиліти для отримання потрібних відомостей про версію.
• Покращення — додано перевірку непідтримуваної назви плагіна в полі заголовка плагіна.
• Покращення — розділено серйозність перевірок i18n. Забезпечено виведення помилок у правильному контексті.
• Покращення — надано докладнішу інформацію про перевірки, коли README не містить перевіреної версії або списку contributors.
• Покращення — додано правила з WPCS, щоб запобігати проблемам із надсиланням вмісту до заголовків і попереджати про використання Call-time pass-by-reference.
• Покращення — додано більше контексту в помилці перевірки неправильно названих файлів.
• Покращення — спрощено налаштування PHPUnit. Тепер воно не залежить від запуску всередині встановленого WordPress.
• Покращення — додано нову перевірку для обмежених contributors.
• Виправлення — видалення transient-даних у модульних тестах, щоб уникнути хибних спрацювань.
• Виправлення — неправильне порівняння версії Tested up to створювало помилку для двох наступних мажорних версій.
• Виправлення — використання функцій file_get_contents і file_put_contents виключено з перевірки, щоб запобігти хибним спрацюванням.
• Виправлення — дубльоване повідомлення про помилку в перевірці неправильно названих файлів.
• Виправлення – Використання Json-кодування не викликало повідомлення про помилку.
• Виправлення – Змінено тип помилки NonEnqueuedImage у ImageFunctions sniff з ERROR на WARNING.

1.3.1

• Покращення — додано утиліти версій.
• Виправлення — екранування повідомлень про помилки.
• Виправлення — типи помилок перейменовано на ERROR_LOW_SEVERITY і WARNING_LOW_SEVERITY.
• Виправлення — виправлено перевірки PHPCS у файлових системах без права запису.

1.3.0

• Покращення — оновлено заборонені домени для перевірки Plugin URI.
• Покращення — додано нові перевірки для полів заголовка плагіна: відсутній опис плагіна, відсутня версія плагіна та недійсна версія плагіна.
• Покращення — нова перевірка посилання для пожертв у файлі readme.
• Покращення — підвищено серйозність для неправильного Plugin Requires.
• Покращення — додано перевірку обмеження parse_str() без другого аргументу.
• Покращення — нова перевірка для заборони використання HEREDOC і NOWDOC.
• Покращення — додано дозволені абревіатури у перевірках Trademark.
• Покращення — додано опцію в CLI для додавання помилок і попереджень низької серйозності.
• Покращення — змінено тип помилки для кодів помилок перевірки License.
• Покращення — завжди використовуються таблиці з префіксом під час запитів перевірок середовища виконання.
• Покращення — створено новий клас для перевірки ліцензій.
• Покращення — додано підтримку ліцензії MPL-2.0.
• Покращення — реалізовано gherkin linter у GH action.
• Покращення — оновлено перевірку Contributors у markdown-файлах readme.
• Покращення — CLI: виправлено заплутаний порядок налаштування середовища виконання.
• Покращення — власним перевіркам дозволено надавати installed_paths.
• Покращення — покращено використання URL localhost у плагіні.
• Покращення — перевірки задокументовано в плагіні.
• Покращення — підвищено серйозність перевірок обфускації коду.
• Покращення — розрізнення між відсутнім файлом readme та типовим файлом readme.
• Покращення — розробників заохочено використовувати нативні функції для завантаження зображень у шаблонах.
• Покращення — додано перевірку, що не дозволяє підключати бібліотеки, які вже є в ядрі WordPress.
• Покращення — попередження щодо використання query_posts() на користь WP_Query.
• Виправлення — виправлено налаштування локального середовища перед тестуванням.
• Виправлення — виправлено невиконання перевірок доповнень під час запуску перевірок середовища виконання.
• Виправлення — default дозволено як text domain у перевірці text domain.
• Виправлення — дозволено URL GitHub у полі Plugin URI.
• Виправлення — ліцензію Apache не позначено. Вона дозволена в каталозі плагінів WordPress.org.
• Виправлення — шлях перед плагіном видалено, щоб він не впливав на неправильно названі файли.

1.2.0

• Покращення — додано перевірку неправильно використаних назв у файлах.
• Покращення — підвищено серйозність для BacktickOperator, DisallowShortOpenTag, DisallowAlternativePHPTags, RestrictedClasses і RestrictedFunctions.
• Покращення — додано перевірки безпеки до категорії Plugin repository.
• Покращення — дозволено runtime-set у перевірках code sniffer.
• Покращення — попередження змінено на помилки у перевірках заголовка плагіна.
• Покращення — виявлення заборонених заголовків плагіна, як-от URI репозиторію в Directory.
• Покращення — додано нову перевірку функцій розробки, які не дозволені у фінальних плагінах.
• Покращення — створено нові зображення та іконки для плагіна.
• Покращення — додано аргумент slug у CLI.
• Покращення — додано перевірку нерекомендованих функцій PHP.
• Покращення — додано перевірку Contributors у файлі readme.
• Покращення — додано попередження про невідповідність назв плагіна в заголовку плагіна та файлі readme.
• Покращення — додано перевірку полів заголовка плагіна: Name, Plugin URI, Description, Author URI, Requires at least, Requires PHP і Requires Plugins.
• Покращення — додано попередження, якщо значення “Tested up to” у файлі readme перевищує випущену версію WordPress.
• Виправлення — показ повідомлення про успішне завершення, якщо не знайдено помилок або попереджень.
• Виправлення — результати таблиць зроблено адаптивними.
• Виправлення — запобігання переходу до наступної перевірки, якщо значення Stable Tag встановлено як trunk.
• Виправлення — дозволено ініціалізацію середовища виконання навіть тоді, коли запитано лише перевірки доповнень.
• Виправлення — виправлено попередження SPDX для ліцензії GPL version 3.
• Виправлення — запобігання перевіркам середовища виконання в контексті CLI, коли їх неможливо використати.

1.1.0

• Функція — нова перевірка середовища виконання Non_Blocking_Scripts_Check (non_blocking_scripts), яка попереджає про підключені скрипти, що не використовують ані defer, ані async.
• Покращення — змінено простір імен включених перевірок.
• Покращення — запроваджено рівні серйозності для всіх помилок і попереджень.
• Покращення — CLI: підтримка перевірки плагіна за шляхом або URL.
• Покращення — додано короткі описи та URL для кожної перевірки.
• Покращення — покращено повідомлення в результатах перевірки.
• Покращення — оновлено перевірку обфускації коду з точнішими результатами.
• Покращення — оновлено перевірку огляду плагіна, щоб позначати відсутню санітизацію введення (WordPress.Security.ValidatedSanitizedInput).
• Виправлення — покращено перевірки readme для виключення недійсних файлів.
• Виправлення — показ посилання редагування лише тоді, коли файли справді можна редагувати.

1.0.2

• Функція — нові перевірки швидкодії Enqueued_Scripts_Scope_Check (enqueued_scripts_scope), Enqueued_Styles_Size_Check (enqueued_styles_size) і Enqueued_Resources_Check (enqueued_resources).
• Покращення — покращено перевірку readme та додано новий фільтр wp_plugin_check_ignored_readme_warnings.
• Покращення — новий фільтр wp_plugin_check_default_categories, який дозволяє змінювати категорії, вибрані за замовчуванням.
• Покращення — новий фільтр wp_plugin_check_ignore_files, який дозволяє ігнорувати певні файли.
• Виправлення — виправлено виявлення файлів readme у Windows шляхом нормалізації шляхів до файлів.

1.0.1

• Виправлення — додано відсутню теку test-content, потрібну для перевірок середовища виконання.
• Виправлення — не надсилати електронні листи під час налаштування тестового середовища.
• Виправлення — запобігання попередженню PHP, коли змінну argv не встановлено.

1.0.0

• Функція — повна переробка плагіна, його архітектури та всіх перевірок.
• Функція — додано нові команди WP-CLI для запуску перевірок і перегляду доступних опцій.
• Покращення — додано опцію запуску перевірок лише для певної категорії.

0.2.3

• Коригування — використано версію 3.8.0 бібліотеки PHP_CodeSniffer, з переходом від squizlabs/PHP_CodeSniffer до PHPCSStandards/PHP_CodeSniffer.
• Виправлення — забезпечено очікувану роботу плагіна в середовищі WP Playground, щоб рецензенти могли використовувати PCP. Дякуємо @tellyworth.
• Виправлення — невизначений ключ масиву “argv” під час запуску перевірки плагіна в певних середовищах. Дякуємо @afragen. #340

0.2.2

• Покращення — додано підтримку серверів Windows.
• Покращення — уникнення прямого використання PHP CLI, що дає змогу розробникам плагінів використовувати PCP у багатьох нових середовищах.
• Виправлення — видалено залежність від функцій shell_exec і exec, що дає змогу розробникам плагінів використовувати PCP у багатьох нових середовищах.
• Виправлення — запобігання проблемам із попередженням парсера Readme, пов’язаним із contributor_ignored, під час запуску перевірки поза WP.org. Дякуємо @dev4press. #276
• Виправлення — видалено зайву крапку в кінці речення для попередження Phar. Дякуємо @pixolin. #275

0.2.1

• Додано — посилання «Переглянути в редакторі коду» під кожною помилкою або попередженням PHPCS. Дякуємо @EvanHerman, @westonruter, @felixarntz, @mukeshpanchal27 #262
• Виправлення — забезпечено пріоритет readme.txt над readme.md, коли наявні обидва файли. Дякуємо @bordoni, @afragen #258
• Виправлення — забезпечено запуск перевірки PHPCS навіть тоді, коли бінарний файл PHPCS не є виконуваним. Дякуємо @bordoni, @shawn-digitalpoint, @mrfoxtalbot #254
• Виправлення — зміни readme та друкарські помилки. Дякуємо @aaronjorbin. #261
• Виправлення — довгі рядки коду з перевіркою PHPCS більше не розширюються за межі повідомлення. Дякуємо @bordoni, @felixarntz. #263
• Виправлення — забезпечено сумісність із PHP 7.2, видалено кому в кінці. Дякуємо @bordoni, @leoloso. #265
• Виправлення — включено всі рядки, пропущені в попередньому випуску. Дякуємо @bordoni, @pixolin. #270

0.2.0

• Функція — увімкнено зміну шляху до бінарного файлу PHP, який використовується плагіном, за допомогою константи PLUGIN_CHECK_PHP_BIN.
• Функція — додано перевірку використання ALLOW_UNFILTERED_UPLOADS у будь-яких PHP-файлах — дякуємо EvanHerman у #45
• Функція — додано перевірку наявності файлів застосунків (.a, .bin, .bpk, .deploy, .dist, .distz, .dmg, .dms, .DS_Store, .dump, .elc, .exe, .iso, .lha, .lrf, .lzh, .o, .obj, .phar, .pkg, .sh, ‘.so`) — дякуємо EvanHerman у #43
• Функція — додано перевірку наявності файлу readme.txt або readme.md — дякуємо EvanHerman у #42
• Виправлення — забезпечено правильне підключення парсингу Readme, коли наявний файл readme.md або readme.txt. Дякуємо Bordoni #52
• Коригування — заборонено функції move_uploaded_file, passthru, proc_open — дякуємо alexsanford у #50
• Коригування — тип повідомлення для використання функцій, які вже містить WordPress, змінено з Warning на Error. Дякуємо davidperezgar у #18
• Коригування — тип повідомлення для неправильного використання Stable tag змінено з Notice/Warning на Error. Дякуємо davidperezgar у #3

[0.1] 2011-09-04

Оригінальна версія інструмента перевірки плагінів, а не випущена версія плагіна; цей журнал змін наведено лише з історичною метою.