plugin-check icon indicating copy to clipboard operation
plugin-check copied to clipboard

Create Autoloaded_Options_Check

Open mehulkaklotar opened this issue 3 years ago • 5 comments
trafficstars

Description

Checks the usage of the add_option and update_option functions and warns if the $autoload parameter is not set, i.e. the default $autoload value is used, which is true. Too many autoloaded options can lead to performance issues so this option should not be set to true unless necessary. No existing sniff exists but the existing WordPress.WP.EnqueuedResourceParameters sniff in the WordPress Coding Standards can be used as a starting point.

Potentially, a warning could be triggered if "yes" is passed, but the most important part is to highlight the importance of considering that parameter and what it means for performance.

Acceptance Criteria

  • Class Autoloaded_Options_Check should be created and exists at includes/Checker/Checks
  • Class Autoloaded_Options_Check should extend the PHPCodesniffer_Check abstract class which extends Check interface
  • Property $violation code should be warning
  • Method run should be implemented from the PHPCodesniffer_Check abstract class if needed
  • Check_Result $check_result should be used from the run method parameter to append the results
  • $_SERVER['argv'] arguments should be passed to parent run method to provide PHPCS information about standard, report and sniff
  • Custom sniff to detect the usage of $autoload option to true or false

Tests Coverage

  • Autoloaded_Options_Check class expected to extend PHPCodesniffer_Check abstract class
  • Autoloaded_Options_Check class expected to be instance of PHPCodesniffer_Check class
  • run method expected to append results of check into $check_result

mehulkaklotar avatar Nov 21 '22 14:11 mehulkaklotar

@jjgrainger I will update AC for this issue, thanks! 🙂

vishalkakadiya avatar Feb 07 '23 13:02 vishalkakadiya

Such a custom sniff is probably best contributed to WPCS first. We don't have precedence for any sniffs in this plugin itself I think, plus contributing it upstream ensures high visibility and code quality.

swissspidy avatar Jul 29 '24 15:07 swissspidy

We don't have precedence for any sniffs in this plugin itself

No longer true, we now have some custom sniffs in the plugin

swissspidy avatar Sep 26 '24 13:09 swissspidy

There is some progress on the WPCS side: https://github.com/WordPress/WordPress-Coding-Standards/issues/2473

swissspidy avatar Oct 02 '24 15:10 swissspidy

Nice!

davidperezgar avatar Oct 02 '24 16:10 davidperezgar