Hooks are being classified into "Actions" and into "Filters" and allow an almost unlimited extensibility and customizability of functions and appearances of software applications without having to edit or influence the core files of the software code at the same time.
The actual software code is not modified, instead the developer "hooks" his additional code to the respective "hook" (hook) provided by the WordPress system or other providers.
Implemented hooks remain intact even after updates to the original website code, e.g. the WordPress core or a plugin like Blog2Social, as even implemented customizations "hooked" via hook are not overwritten.
The use of child themes is also recommended, as these prevent the overwrites during updates from the used theme and its "functions.php" file.
In addition to the standard hooks integrated in WordPress, Blog2Social has developed its own hooks for web developers and customers. So also self-developed functions, can "hook" into processes and functions of Blog2Social to work with the Blog2Social WordPress plugin in the background and/or trigger functions (actions) or retrieve (filter).
Hooks are very useful for developers and IT-affine Blog2Social users to implement custom solutions with Blog2Social using self-developed functions.
Action hooks allow you to insert custom code in different places (depending on where the hook is executed).
Filter hooks allow you to modify a variable that you pass in and pass the customized variable back.
When using a hook to add or manipulate code, you can add your custom code to your theme's functions.php file.
To execute your own code, you hook in by using the action hook "do_action('action_name');".
Here is where to place your code:
add_action( 'action_name', 'your_function_name' );
function your_function_name() {
// Your code
}
Filter hooks are called by using the code “apply_filter( 'filter_name', $variable )”.
To manipulate the passed variable, you can do something like the following:
add_filter( 'filter_name', 'your_function_name' );
function your_function_name( $variable ) {
// Your code
return $variable;
}
With filters, you must return a value.
This is a list of action and filter hooks found within Blog2Social files:
Hook | Type | Params | B2S-Version | Info |
b2s_og_meta_title | filter | title | >=5.3.0 | OG Meta Tag Title |
b2s_og_meta_desc | filter | desc | >=5.3.0 | OG Meta Tag Description |
b2s_og_meta_image | filter | image_url | >=5.3.0 | OG Meta Tag Image |
b2s_card_meta_title | filter | title | >=5.3.0 | Twitter Cards Tag Title |
b2s_card_meta_desc | filter | desc | >=5.3.0 | Twitter Cards Tag Description |
b2s_card_meta_image | filter | image_url | >=5.3.0 | Twitter Cards Tag Image |
b2s_card_meta_type | filter | type | >=5.3.0 | Twitter Cards Tag Type |
b2s_filter_wp_user_post_author_display_name | filter | name, author_id | >=6.0.0 | Post-Template: Wordpress Post Author Name |
b2s_filter_wp_post_hashtag | filter | post_id | >=6.4.0 | Hashtags from the post |
b2s_filter_wp_post_image | filter | images, post_id | >=6.5.0 | Change image with filter function |
b2s_filter_posting_template_show_taxonomies* | filter | taxonomies | >=6.8.2 | Show custom taxonomies for selection in posting template |
b2s_filter_posting_template_set_taxonomies* | filter | taxonomies, post_id | >=6.8.2 | Set custom taxonomies from other plugins or own template |
*available from Premium Business
Relevant Links:
https://codex.wordpress.org/Plugin_API/Hooks