Title: Beans Visual Hook Guide
Author: Jeff Cleverley
Published: <strong>March 15, 2018</strong>
Last modified: July 20, 2018

---

Search plugins

![](https://ps.w.org/beans-visual-hook-guide/assets/banner-772x250.png?rev=1840707)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/beans-visual-hook-guide/assets/icon.svg?rev=1841179)

# Beans Visual Hook Guide

 By [Jeff Cleverley](https://profiles.wordpress.org/deftly/)

[Download](https://downloads.wordpress.org/plugin/beans-visual-hook-guide.zip)

 * [Details](https://pcd.wordpress.org/plugins/beans-visual-hook-guide/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/beans-visual-hook-guide/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/beans-visual-hook-guide/#installation)
 * [Development](https://pcd.wordpress.org/plugins/beans-visual-hook-guide/#developers)

 [Support](https://wordpress.org/support/plugin/beans-visual-hook-guide/)

## Description

A Plugin tool to aid theme development with the innovative, flexible, and incredibly
powerful [Beans](https://www.getbeans.io/) Framework.

When enabled alongside Beans Development Mode, this plugin displays all possible
Markup Action Hooks made available by the Beans HTML API.

Beans is a dream to develop with, as all markup and attributes added using Beans
are registered using a unique Markup ID which can be exposed by enabling the Beans
Development Mode in settings.

Once Development Mode is enabled, the Markup IDs are output in a data-markup-id 
tag in the front-end. The values of which can be used by the various [Beans APIs](https://www.getbeans.io/code-reference/api/)
to rapidly develop beautiful themes.

Any markup added using Beans adds several [dynamic action hooks](https://www.getbeans.io/documentation/markup-and-attributes/)
both before and after it:

    ```
    {$markup_id}_before_markup, fires before the opening markup
    {$markup_id}_prepend_markup, fires after the opening markup
    {$markup_id}_append_markup, fires before the closing markup
    {$markup_id}_after_markup, fires after the closing markup.
    ```

( _prepend_markup and _append_markup are not available for self-closed markup )

In short, this means pretty much anything can be added anywhere on any page by adding
actions to the available hooks.

This plugin is intended as a companion tool to the Beans Development Mode and your
Browser inspector. It displays all of the available hooks that have been created
dynamically by the Beans HTML API, making it easy for Beans Themes Developers to
visualise the appropriate hook to use.

The Beans logo and Beans name are being used with kind permission from the amazing
people behind the Beans Framework.

## Screenshots

 * [[
 * Display Hooks Selectively
 * [[
 * Display All Hooks (so many hooks)
 * [[
 * View the possible Hooks for each Markup
 * [[
 * Data Markup IDs viewed in the inspector

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/plugin-name` directory, or 
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress

## FAQ

  Installation Instructions

 1. Upload the plugin files to the `/wp-content/plugins/plugin-name` directory, or 
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress

  I installed the plugin, now what?

The Beans Visual Hook Guide doesn’t have any settings as such. It adds an extra 
menu item to the WordPress Toolbar.

If you haven’t enabled Beans Development Mode this menu item will link to the Beans
setting page so that you may enable it.

Once Beans Development Mode has been enabled, you will be presented with an ‘Enable
Beans Visual Hook Guide’ menu item, click on this and the plugin will do its thing.
You will now have a drop-down menu available, from this menu you can:

*Display Action Hooks on a hook by hook basis
 *Display all Action Hooks at once(
Crazy Mode) *Clear all displayed Action Hooks *Clear all displayed Action Hooks 
and Disable the functionality.

  Does this plugin require the Beans Framework to work

Yes

If a Beans Framework Child theme is not the active theme, the plugin will not activate.

Even if it did activate it would be useless.

  What happens if I deactivate the Beans Framework

If you swap themes to a non-Beans framework theme while the plugin is active then
it will just harmlessly disable itself.

  I have my admin bar disabled, can I still use this plugin?

You can, but it is (much) more difficult. As each hook can be displayed selectively,
there are many (so many) query_args used to display each hook.

When the Beans Visual Hook Guide is active your url will already have the following
query_arg added:

?bvhg_enable=show

To display the ‘beans_content’ hook add this to end of your url:

&beans_content=show

So now it will look like the following:

?bvhg_enable=show&beans_content=show

For each hook you wish to display you need to add an ampersand followed by {markup_id}
=show

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Beans Visual Hook Guide” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Jeff Cleverley ](https://profiles.wordpress.org/deftly/)
 *   [ Tonya Mork ](https://profiles.wordpress.org/hellofromtonya/)

[Translate “Beans Visual Hook Guide” into your language.](https://translate.wordpress.org/projects/wp-plugins/beans-visual-hook-guide)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/beans-visual-hook-guide/),
check out the [SVN repository](https://plugins.svn.wordpress.org/beans-visual-hook-guide/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/beans-visual-hook-guide/)
by [RSS](https://plugins.trac.wordpress.org/log/beans-visual-hook-guide/?limit=100&mode=stop_on_copy&format=rss).

## Meta

 *  Version **1.1.0**
 *  Last updated **8 years ago**
 *  Active installations **10+**
 *  WordPress version ** 4.6 or higher **
 *  Tested up to **4.9.29**
 *  PHP version ** 5.6 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/beans-visual-hook-guide/)
 * Tags
 * [Beans](https://pcd.wordpress.org/plugins/tags/beans/)[Beans Framework](https://pcd.wordpress.org/plugins/tags/beans-framework/)
   [Beans HTML API](https://pcd.wordpress.org/plugins/tags/beans-html-api/)[development tool](https://pcd.wordpress.org/plugins/tags/development-tool/)
   [hooks](https://pcd.wordpress.org/plugins/tags/hooks/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/beans-visual-hook-guide/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/beans-visual-hook-guide/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/beans-visual-hook-guide/reviews/)

## Contributors

 *   [ Jeff Cleverley ](https://profiles.wordpress.org/deftly/)
 *   [ Tonya Mork ](https://profiles.wordpress.org/hellofromtonya/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/beans-visual-hook-guide/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.paypal.me/jeffcleverley)