Token Boxes Module

Exposes all boxes (using the box module) as tokens. Also adds all available tokens to the help screen.

Usage

Typical use cases are to allow users to insert boxes (blocks) into content fields, using token_filter. Another example is to have configurable pieces of content in the header or footer area of a view.

Related modules

This module depends on:

• Boxes
• Token

This module works well with:

• Token Filter
• Block Edit

Examples of usage

If you want to allow users to insert a box's content into the body of your content, you can use token filter. First you'll want to enable token filter, and then apply token filter to all input filters you are exposing for that content field. Input formats are configurable at Administer -> Site configuration -> Input Formats -> List (admin/settings/filters). Click the "configure" link, and check the "Token filter" box under "Filters". Do this for every input format you want tokens to be evaluated.

Next, create your box, which is really just a block with some extra mojo (such as a machine name) that allow them to be exported (Chaos tool suite (ctools), Features).

The token can be found on the help page for Tokens, Help -> Token (help/token). Expand "Boxes". You should see all boxes created on your site. The token will look like:
[<box-machine-name>], where <box-machine-name> is the machine name you gave the box when you created it.

Here's the tricky part. To add this token to your content body, you'll need to add token boxes to the beginning of the token. So your token will look like this:
[token boxes <box-machine-name>]

For example, if you create a box with a machine name of "foo_bar", you'll see this in the help in the Boxes category:
[foo_bar]
and you'll need to put this into the body of your content:
[token boxes foo_bar]

This works the same in view header and footer fields, since they have input filters on them.