The core building block of the Flynt Framework.
The Flynt Core WordPress plugin provides a small public interface, combined with several WordPress hooks, to achieve the main principles of the Flynt Framework.
This plugin essentially functions as a HTML generator with two key steps:
- Given a minimal configuration, the Flynt Core plugin creates a hierarchical plan for how the site will be constructed (the Construction Plan).
- The Construction Plan is parsed and rendered into HTML.
Each configuration passed to the plugin represents a single component. This configuration can also contain additional, nested component configurations, which are contained within "areas".
To install via composer, run:
composer require flyntwp/flynt-coreActivate the plugin in the WordPress back-end and you're good to go.
To see the simplest way of using Flynt Core, add the following code to your theme's functions.php:
$componentManager = Flynt\ComponentManager::getInstance();
$componentManager->registerComponent('HelloWorld');
add_filter('Flynt/renderComponent?name=HelloWorld', function () {
return 'Hello, world!';
});This defines a new component ('HelloWorld'), which when rendered, will output the text 'Hello, world!'.
To render the component, add the following code to your theme's index.php:
Flynt\echoHtmlFromConfig([
'name' => 'HelloWorld'
]);We recommend initializing the plugin's default settings. Do this by adding the following line of code to your theme's functions.php:
Flynt\initDefaults();This will:
- Implement the component structure.
- Load component scripts.
- Enable PHP file rendering.
This also adds the following hooks:
// Set the config path to './config'.
add_filter('Flynt/configPath', ['Flynt\Defaults', 'setConfigPath'], 999, 2);
// Parse `.json` config files.
add_filter('Flynt/configFileLoader', ['Flynt\Defaults', 'loadConfigFile'], 999, 3);
// Set the component path to `./Components`.
add_filter('Flynt/componentPath', ['Flynt\Defaults', 'setComponentPath'], 999, 2);
// Load ./Components/{$componentName}/functions.php from every registered component.
add_action('Flynt/registerComponent', ['Flynt\Defaults', 'loadFunctionsFile']);
// Render `./Components/{$componentName}/index.php` and make view helper functions `$data` and `$area` available (see explanation below).
add_filter('Flynt/renderComponent', ['Flynt\Defaults', 'renderComponent'], 999, 4);With the 'Flynt/renderComponent' filter added above you can now use the following helper functions in your template files:
$datais used to access the component's data in the view template.$areais used to include the HTML of an area's components into the components template itself.
You can read the full documentation here.
This project is maintained by bleech.
The main people in charge of this repo are:
To contribute, please use GitHub issues. Pull requests are accepted. Please also take a moment to read the Contributing Guidelines and Code of Conduct.
If editing the README, please conform to the standard-readme specification.
MIT © bleech