Home

How to use this theme with WordPress?

In folder inc/ are all the necessary files to integrate a WordPress theme easily.

Folders presentation:

• async/: contains JS / CSS files that load asynchronously
• services/: contains all the dedicated services
• tools/: contains all services used as tools

Each service contains a feature !

To load the services, just have this code in functions.php who will load all basic services.

/**
* Autoload all the things \o/
*/
require_once 'autoload.php';
/**
* Load all services
*/
add_action( 'after_setup_theme', function () {
// Boot the service, at after_setup_theme
\BEA\Theme\Framework\Framework::get_container()->boot_services();
}, 20 );

Anatomy of a Service

A class Service must extend 3 functions to work:

<?php
namespace BEA\Theme\Framework\Services;
use BEA\Theme\Framework\Service;
use BEA\Theme\Framework\Service_Container;
/**
* Class Menu
*
* @package BEA\Theme\Framework
*/
class Menu implements Service {
/**
* @param Service_Container $container
*/
public function register( Service_Container $container ) {}
/**
* @param Service_Container $container
*/
public function boot( Service_Container $container ) {
}
/**
* @return string
*/
public function get_service_name() {
return 'menu';
}
}

• register(): actions when service is register, example: load others things needed by the service
• boot(): actions when service is load/boot, example: add_action(), add_filter()
• get_service_name(): needed to return the service name, to get it later

To register a new custom service, change the add_action() in functions.php to load extra services:

add_action( 'after_setup_theme', function () {
// Boot the service, at after_setup_theme
$container = \BEA\Theme\Framework\Framework::get_container();
// Add custom services
$container->register_service( \BEA\Theme\Framework\Services\Silo::class );
$container->register_service( \BEA\Theme\Framework\Services\WooCommerce::class );
// Boot all !
$container->boot_services();
}, 20 );

Services utilities

• ACF Service: Contains functions to load simply ACF fields and register theme options page, block theme activation if ACF doesn't active
• Assets Service: Load all styles CSS and scripts JS
• Assets CSS Async Service: Allow to load styles CSS in async
• Assets JS Async Service: Allow to load scripts JS in async
• Favicons Service: Load all favicons in header
• Menu Service: Declare your menus in this service
• Sidebar Service: Declare your sidebars in this service
• SVG Service: Load SVG icons in footer, contains functions to display SVG tag
• Theme Service: Load theme supports, i18n

You can register all new custom services you needed!