Plugin code prechecks - Revision history

Devdocsbot: Protected "Plugin code prechecks": Developer Docs Migration ([Edit=Allow only administrators] (indefinite))

2023-08-11T05:13:29Z

Protected "Plugin code prechecks": Developer Docs Migration ([Edit=Allow only administrators] (indefinite))

← Older revision	Revision as of 05:13, 11 August 2023
(No difference)

Devdocsbot: Update migration status and path

2023-08-11T05:11:10Z

Update migration status and path

← Older revision		Revision as of 05:11, 11 August 2023
Line 1:		Line 1:
	{{~~Plugins development}}~~		{{Template:Migrated\|newDocId=/general/community/plugincontribution/codeprechecks}}

	In the Moodle Plugins directory, uploaded plugins versions are automatically tested against a set of formal criteria. These tests typically do not check the actual plugin functionality, security or code correctness. They are more focused on formal aspects of the coding style. As such, they are most valuable for the plugin maintainers themselves.

	~~== Labels ==~~

	~~Plugin version with no detected errors or warnings has a label like this displayed~~:

	~~[[Image:plugin-codeprechecks-success.png]]~~

	~~If there are some formal errors or warnings detected, a label like this is displayed:~~

	~~[[Image:plugin-codeprechecks-error.png]]~~

	The first of the two numbers gives the total number of detected errors, the second number shows the number of warnings. If there are no errors but some warnings, the label is displayed in orange colour. In case of some errors, the label is displayed in red.

	Clicking the code prechecks label takes you to a page with details on particular tests executed. Individual labels are displayed for each of the test, with the same formatting rules as described above.

	~~[[Image:plugin-codeprechecks-details.png]]~~

	~~Finally, clicking some of these individual test labels takes you to a page with detailed raw output of the test system.~~

	=~~= Test types ==~~

	~~; phplint : Checks the plugin source code for correct PHP syntax.~~
	~~; phpcs : Checks the plugin against the [[Coding style\|Moodle coding style]].~~
	~~; js : Checks the plugin against the [[Javascript~~/~~Coding_Style\|Javascript coding style]].~~
	~~; css : Checks the plugin against the [[CSS Coding Style\|CSS coding style]].~~
	~~; phpdoc : Checks that the plugin files, classes and functions are documented in the source code.~~
	~~; savepoint : Reports issues detected with the handling of [[Upgrade API\|upgrade savepoints]].~~
	~~; thirdparty : Reports issues with the [[Plugin files#thirdpartylibs.xml\|thirdpartylibs.xml]] file.~~
	~~; grunt : Reports issues with [[Grunt]] builds.~~
	~~; shifter : Reports issues with [[YUI~~/~~Shifter]].~~
	~~; mustache : Reports issues with [[Templates\|Mustache templates]].~~

Mudrd8mz: Add list and short description of the tests.

2017-03-20T10:03:33Z

Add list and short description of the tests.

@@ Line 2: / Line 2: @@
 In the Moodle Plugins directory, uploaded plugins versions are automatically tested against a set of formal criteria. These tests typically do not check the actual plugin functionality, security or code correctness. They are more focused on formal aspects of the coding style. As such, they are most valuable for the plugin maintainers themselves.
 Plugin version with no detected errors or warnings has a label like this displayed:
@@ Line 18: / Line 20: @@
 Finally, clicking some of these individual test labels takes you to a page with detailed raw output of the test system.

Mudrd8mz: Include the {{Plugins development}} template

2017-03-20T09:46:19Z

Include the {{Plugins development}} template

← Older revision		Revision as of 09:46, 20 March 2017
Line 1:		Line 1:
			{{Plugins development}}

	In the Moodle Plugins directory, uploaded plugins versions are automatically tested against a set of formal criteria. These tests typically do not check the actual plugin functionality, security or code correctness. They are more focused on formal aspects of the coding style. As such, they are most valuable for the plugin maintainers themselves.		In the Moodle Plugins directory, uploaded plugins versions are automatically tested against a set of formal criteria. These tests typically do not check the actual plugin functionality, security or code correctness. They are more focused on formal aspects of the coding style. As such, they are most valuable for the plugin maintainers themselves.

Mudrd8mz: Start a new page on plugins code prechecks

2017-03-20T09:45:36Z

Start a new page on plugins code prechecks

New page

In the Moodle Plugins directory, uploaded plugins versions are automatically tested against a set of formal criteria. These tests typically do not check the actual plugin functionality, security or code correctness. They are more focused on formal aspects of the coding style. As such, they are most valuable for the plugin maintainers themselves.

Plugin version with no detected errors or warnings has a label like this displayed:

[[Image:plugin-codeprechecks-success.png]]

If there are some formal errors or warnings detected, a label like this is displayed:

[[Image:plugin-codeprechecks-error.png]]

The first of the two numbers gives the total number of detected errors, the second number shows the number of warnings. If there are no errors but some warnings, the label is displayed in orange colour. In case of some errors, the label is displayed in red.

Clicking the code prechecks label takes you to a page with details on particular tests executed. Individual labels are displayed for each of the test, with the same formatting rules as described above.

[[Image:plugin-codeprechecks-details.png]]

Finally, clicking some of these individual test labels takes you to a page with detailed raw output of the test system.