Embed Bokun WordPress plugin

Allows you to add Bokun products to your WordPress site via blocks.

You need to have at least WP 5.0 and classic editor not activated.

Documentation

Plugin is extremely developer friendly. See the documentation below.

Filters

embed_bokun_support_post_types ==> Define the post types where Bokun ID meta box is visible

add_filter('embed_bokun_support_post_types', function () {
    return [ 'your_post_type' ];
});

embed_bokun_cron_date_dormat ==> define how to show date and time in Bokun ID meta box

add_filter('embed_bokun_cron_date_dormat', function() {
    return 'd.m.Y H:i:s'; //define whatever you need...
});

embed_bokun_post_update_api_path ==> In case you need to modify api request when post update (example in case of Polang translations)

add_filter('embed_bokun_post_update_api_path', function( $string, $post_id, $bokun_id ) {
    $string = '/activity.json/' . $bokun_id . '?lang=' . pll_get_post_language( $post_id ); //get polylang current post lang as parameter
    return $string;
}, 10, 3);

More filters coming the future....

Actions

Actions are used when building a custom widget.

You can remove the actions and build your own actions in your theme.

Custom widget has these actions hooked.

add_action( 'embed_bokun_custom_product', 'embed_bokun_create_images_carousel', 5, 2 );
add_action( 'embed_bokun_custom_product', 'embed_bokun_create_title', 10, 2 );
add_action( 'embed_bokun_custom_product', 'embed_bokun_create_excerpt', 15, 2 );
add_action( 'embed_bokun_custom_product', 'embed_bokun_create_duration', 20, 2 );
add_action( 'embed_bokun_custom_product', 'embed_bokun_create_content_columns', 30, 2 );

You can also add actions before and after the custom widget content with these two actions, plugin it self will not hook into these: embed_bokun_before_custom_product embed_bokun_after_custom_product

Data fetch from Bokun to build customm widget

You need to define Bokun product ID for posts where you want to use custom style widget.

System will fetch data from Bokun automatically hourly.

Response is saved as post meta data _embed_bokun_product_api_response. You can use that data to build your custom style widget.

Building your own css-styles

Do not overwrite the styles in the plugin folder. In a case of an update, your changes are gone.

Instead, override the styles in your theme code.

Project setup for local development

This project is bootstrapped with Create Guten Block.

Below you will find information on how to run scripts.

You can find the most recent version of this guide here.

👉 npm start

• Use to compile and run the block in development mode.
• Watches for any changes and reports back any errors in your code.

👉 npm run build

• Use to build production code for your block inside dist folder.
• Runs once and reports back the gzip file sizes of the produced code.

👉 npm run eject

• Use to eject your plugin out of create-guten-block.
• Provides all the configurations so you can customize the project as you want.
• It's a one-way street, eject and you have to maintain everything yourself.
• You don't normally have to eject a project because by ejecting you lose the connection with create-guten-block and from there onwards you have to update and maintain all the dependencies on your own.