The ultimate autoloader

[plain-solutions-gmbh]

Description

I have been working on a adequate solution for an plugin autoloader.

Here is an example:

App::plugin(
    'vendor/plugin', autoloader: [
    	'cache' => true,
    	'classes' => [
    		'namespace' => 'Vendor\\Namespace'
    	],
    	'config' => [
    		'path' => './extends'
    	],
    	'blueprints', 'snippets', 'fields', 'translations',
    	'custom' => function($autoloader) {
	        $autoloader->merge([
	            "options" => [
	                "my_option" => 'foo'
	            ]
	        ]);
	    }
    ]
);

If true is passed to the autoloader, all tasks defined in the autoloader are executed.

Summary of changes

• Add Autoloader class
• implement to AppPlugin (not plugin class - cause info and root needs to be defined)
• Add Method to AppPlugin to get allowed extensions keys

Reasoning

Plugins (if the developer use the autoloader) can be loaded from cache.
Extensions could be easly integrating into the plugin.

Additional context

I create it because of this rejected pull request
It would be nice if it's goes into V5. Cause Plugin already takes a new parameter license

Changelog

• The autoloader executed if the parameter 'autoload' is either 'true' or an array. (Disabled by default)
• The array contains tasks that are processed in sequence
• Tasks can be modify, enable or extend. (Cache is enabled by default)
• The result is cached and stored by default under ./site/cache/autoloder/{vendor}/{plugin_name}\{timestamp}.php. (Can be deactivated)
• The plugin folder is modified. The cache is renewed.
• Loads the classes (by default from classes folder) automatically
• Fields, sections, blueprints, snippets, templates and translations are loaded from the root by default.
• For other extensions is the subfolder ./config in charge.

Docs

I could write a cookbook if the feature will be applied

Ready?

• In-code documentation (wherever needed)
• Unit tests for fixed bug/feature
• Tests and CI checks all pass

For review team

• Add lab and/or sandbox examples (wherever helpful)
• Add changes & docs to release notes draft in Notion

[plain-solutions-gmbh]

Fixed in commit Fix empty catch.

[bastianallgeier]

This looks very interesting. Give us a bit of time to review this, while we still struggle with the last v5 steps.

[plain-solutions-gmbh]

Todo:

• use F::loadClasses to load classes.
• remove cache task and move them to tasks parameter