htmlburger / wpemerge-blade
Enables the use of Blade views in WP Emerge.
Installs: 6 447
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 6
Forks: 10
Open Issues: 1
Requires
- php: ^7.0
- htmlburger/wpemerge: ~0.17.0
- illuminate/view: ^7.12.0
README
Enables the use of Blade views in WP Emerge.
Summary
Quickstart
- Run
composer require htmlburger/wpemerge-blade
in your theme directory - Add
\WPEmergeBlade\View\ServiceProvider
to your array of providers in WP Emerge's configuration:\App::make()->bootstrap( [ 'providers' => [ \WPEmergeBlade\View\ServiceProvider::class, ], ] );
- If you are using the WP Emerge Starter Theme you can replace your theme views with the ones inside
theme/views-alternative/blade/
. - If you are using the WP Emerge Starter Theme you must enable the
filter_core_templates
configuration option in order to have.blade.php
template support for WordPress core templates (index.php
,single.php
etc.).
Options
Default options:
[ // Automatically replace the default view engine for WP Emerge. 'replace_default_engine' => true, // Pass .php views to the default view engine. // replace_default_engine must be true for this to take effect. 'proxy_php_views' => true, // Filter core theme templates to search for .blade.php files. // This is only necessary in themes. 'filter_core_templates' => false, // Options passed directly to Blade. 'options' => [ // 'views' defaults to the main ['views'] key of the configuration. 'views' => [get_stylesheet_directory(), get_template_directory()], // 'cache' defaults to the main ['cache']['path'] key of the configuration. 'cache' => 'wp-content/uploads/wpemerge/cache/blade', ], ]
You can change these options by specifying a blade
key in your WP Emerge config array:
\App::make()->bootstrap( [ // ... other WP Emerge options 'blade' => [ // ... other WP Emerge Blade options 'options' => [ // ... other Blade options 'cache' => get_stylesheet_directory() . DIRECTORY_SEPARATOR . 'blade-cache', ], ], ] );
Extending Blade
You can use the following to extend blade with a custom directive, for example:
// \App::resolve() used for brevity's sake - use a Service Provider instead. $blade = \App::resolve( WPEMERGEBLADE_VIEW_BLADE_VIEW_ENGINE_KEY ); $blade->compiler()->directive( 'mydirective', function( $expression ) { return "<?php echo 'MyDirective: ' . $expression . '!'; ?>"; } );
With this, you now have your very own custom Blade directive:
@mydirective('foobar')
More information on how you can extend Blade is available on https://laravel.com/docs/5.4/blade#extending-blade
WooCommerce
In order to render WooCommerce templates using Blade you must NOT use the .blade.php
extension for WooCommerce templates as it will not detect them. Instead, use the usual .php
extension for your files, for example:
my-theme/woocommerce.php
my-theme/woocommerce/single-product.php
my-theme/woocommerce/archive-product.php
Even though these files are .php
, this extension will render them using Blade.