This document discusses the BEAN module in Drupal, which allows users to create custom block types without needing administrator access. It describes what a BEAN entity is, some key coding concepts like using an API-first approach and plugins. It provides code examples for defining a BEAN plugin class, its configuration values, forms, and rendering output. BEANs can incorporate views to dynamically populate content and support editorial listings of nodes.

1. Beans, Beans - They’re
Good For Your... Editors
BADcamp 2011
October 22nd, 2011
Neil Hastings

2. BEANS
Neil Hastings
‣ Senior Engineering
‣ Treehouse Agency
‣ Drupal.org member for 3 years and
34 weeks
‣ @indytechcook
BADcamp 2011, Neil Hastings

3. BEANS
What is a BEAN?
BADcamp 2011, Neil Hastings

4. BEANS
What is a BEAN?
‣ Block Entity
BADcamp 2011, Neil Hastings

5. BEANS
What is a BEAN?
‣ Block Entity
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
BADcamp 2011, Neil Hastings

6. BEANS
What is a BEAN?
‣ Block Entity
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ BEAN Entities Aren’t Nodes
‣ A Healthy Way for users to Create
Blocks
BADcamp 2011, Neil Hastings

7. Blocks on Energy.gov

8. BEANS
Block Creator
!=
Administrator
BADcamp 2011, Neil Hastings

9. BEANS
User generated Blocks
‣ Node-like blocks
‣ Fields
‣ Templates
‣ Listing blocks
‣ User-defined filters
‣ Pre-defined styles
BADcamp 2011, Neil Hastings

12. screenshot of listing
block example, with
highlights like previous
slide

13. screenshot of listing
block example, with
highlights like previous
slide

15. BEANS
Block Entities
‣ Block types
‣ Fieldable
‣ Entity API
‣ Non-admin permissions
‣ Data entry is familiar to users
‣ Build is familiar to Site Builders
BADcamp 2011, Neil Hastings

18. BEANS
Coding Concepts
BADcamp 2011, Neil Hastings

19. BEANS
Coding Concepts
‣ API First
BADcamp 2011, Neil Hastings

20. BEANS
Coding Concepts
‣ API First
‣ Every Type is a Plugin
‣ Even the UI types
BADcamp 2011, Neil Hastings

21. BEANS
Coding Concepts
‣ API First
‣ Every Type is a Plugin
‣ Even the UI types
‣ Two levels of configuration storage
‣ “Config” - BEAN Type/Bundle
‣ “Content” - BEAN/Entity
‣ Block Placement - BOTH!
BADcamp 2011, Neil Hastings

22. BEANS
BADcamp 2011, Neil Hastings

23. BEANS
SHOW ME SOME CODE ALREADY
BADcamp 2011, Neil Hastings

24. BEANS
Code For All
‣ META
BADcamp 2011, Neil Hastings

25. BEANS
Show me the Plugin
BADcamp 2011, Neil Hastings

26. BEANS
We all love Classes
‣ Extend the base class.
‣ bean_plugin
‣ bean_custom - If bean type will be editable in
the UI
‣ Implement Methods
‣ Values - Define settings to be saved against
the Bean.
‣ Form - Define Form for bean add/edit
‣ View - Render the bean.
BADcamp 2011, Neil Hastings

27. BEANS
Define Class
class blog_listing_bean extends bean_plugin {
.
.
}
BADcamp 2011, Neil Hastings

28. BEANS
Define Values
public function values() {
return array(
'filters' => array(
'term' => FALSE,
'topic' => FALSE,
'audience' => FALSE,
),
'items_per_page' => array(
'large_image' => 0,
'small_image' => 0,
'listing' => 0,
),
'more_link' => array(
'text' => '',
'path' => '',
),
);
}
BADcamp 2011, Neil Hastings

29. BEANS
Define Values
public function values() {
return array(
'filters' => array(
'term' => FALSE,
'topic' => FALSE,
'audience' => FALSE,
),
'items_per_page' => array(
'large_image' => 0,
'small_image' => 0,
'listing' => 0,
),
'more_link' => array(
'text' => '',
'path' => '',
),
);
}
BADcamp 2011, Neil Hastings

30. BEANS
Define Values
public function values() {
return array(
'filters' => array(
'term' => FALSE,
'topic' => FALSE,
'audience' => FALSE,
),
'items_per_page' => array(
'large_image' => 0,
'small_image' => 0,
'listing' => 0,
),
'more_link' => array(
'text' => '',
'path' => '',
),
);
}
BADcamp 2011, Neil Hastings

31. BEANS
Define Values
public function values() {
return array(
'filters' => array(
'term' => FALSE,
'topic' => FALSE,
'audience' => FALSE,
),
'items_per_page' => array(
'large_image' => 0,
'small_image' => 0,
'listing' => 0,
),
'more_link' => array(
'text' => '',
'path' => '',
),
);
}
BADcamp 2011, Neil Hastings

32. BEANS
Form for All
public function form($bean) {
$form['more_link']['text'] = array(
'#type' => 'textfield',
'#title' => t('Link text'),
'#default_value' => $bean->more_link['text'],
);
$form['more_link']['path'] = array(
'#type' => 'textfield',
'#title' => t('Link path'),
'#default_value' => $bean->more_link['path'],
);
}
BADcamp 2011, Neil Hastings

33. BEANS
Form for All
public function form($bean) {
$form['more_link']['text'] = array(
'#type' => 'textfield',
'#title' => t('Link text'),
'#default_value' => $bean->more_link['text'],
);
$form['more_link']['path'] = array(
'#type' => 'textfield',
'#title' => t('Link path'),
'#default_value' => $bean->more_link['path'],
);
}
BADcamp 2011, Neil Hastings

34. BEANS
A Bean with a View
public function view($bean, $content, $view_mode =
'full', $langcode = NULL) {
}
‣ Return a Render Array
‣ Currently $view_mode is ignored in
the block rendering
BADcamp 2011, Neil Hastings

35. BEANS
A Bean with a View
public function view($bean, $content, $view_mode =
'full', $langcode = NULL) {
}
‣ Return a Render Array
BADcamp 2011, Neil Hastings

36. BEANS
$count = $bean->items_per_page['large_image'] + $bean->items_per_page['small_image'] + $bean-
>items_per_page['listing'];
$query = new EnergyEntityFieldQuery();
$query
->entityCondition('bundle', 'article')
->clearAudienceConditions()
->setOtherAudienceCondition()
->range(0, $count);
if (!empty($bean->filters['term'])) {
$query->setTermCondition('field_article_type', $bean->filters['term']);
}
if (!empty($bean->filters['topic'])) {
$query->setTopicCondition($bean->filters['topic']);
}
if (!empty($bean->filters['audience'])) {
$query->setTermCondition('field_audience_term', $bean->filters['audience']);
}
$result = $query->execute();
BADcamp 2011, Neil Hastings

37. BEANS
if (empty($result)) {
$content['nodes'] = array();
}
else {
$content['nodes'] = node_load_multiple(array_keys($result['node']));
}
$content['#theme'] = 'energy_blog_list';
$content['more_link'] = array(
'text' => $bean->more_link['text'],
'path' => $bean->more_link['path'],
);
$content['items_per_page'] = array(
'large_image' => $bean->items_per_page['large_image'],
'small_image' => $bean->items_per_page['small_image'],
'listing' => $bean->items_per_page['listing'],
);
BADcamp 2011, Neil Hastings

38. BEANS
if (empty($result)) {
$content['nodes'] = array();
}
else {
$content['nodes'] = node_load_multiple(array_keys($result['node']));
}
$content['#theme'] = 'energy_blog_list';
$content['more_link'] = array(
'text' => $bean->more_link['text'],
'path' => $bean->more_link['path'],
);
$content['items_per_page'] = array(
'large_image' => $bean->items_per_page['large_image'],
'small_image' => $bean->items_per_page['small_image'],
'listing' => $bean->items_per_page['listing'],
);
BADcamp 2011, Neil Hastings

39. BEANS
if (empty($result)) {
$content['nodes'] = array();
}
else {
$content['nodes'] = node_load_multiple(array_keys($result['node']));
}
$content['#theme'] = 'energy_blog_list';
$content['more_link'] = array(
'text' => $bean->more_link['text'],
'path' => $bean->more_link['path'],
);
$content['items_per_page'] = array(
'large_image' => $bean->items_per_page['large_image'],
'small_image' => $bean->items_per_page['small_image'],
'listing' => $bean->items_per_page['listing'],
);
BADcamp 2011, Neil Hastings

40. BEANS
if (empty($result)) {
$content['nodes'] = array();
}
else {
$content['nodes'] = node_load_multiple(array_keys($result['node']));
}
$content['#theme'] = 'energy_blog_list';
$content['more_link'] = array(
'text' => $bean->more_link['text'],
'path' => $bean->more_link['path'],
);
$content['items_per_page'] = array(
'large_image' => $bean->items_per_page['large_image'],
'small_image' => $bean->items_per_page['small_image'],
'listing' => $bean->items_per_page['listing'],
);
BADcamp 2011, Neil Hastings

41. screenshot of listing
block example, with
highlights like previous
slide

42. screenshot of listing
block example, with
highlights like previous
slide

43. BEANS
Editorial listings
‣ Hand-selected listings of nodes
‣ Multiple Node Reference field
‣ View mode set in the Node
Reference field settings
‣ Additional fields
‣ More link, Header text, etc.
BADcamp 2011, Neil Hastings

44. BEANS
More Fun!
‣ BOF in Dwinelle 183 - now
‣ http://treehouseagency.com/blog/
neil-hastings/2011/09/21/building-
custom-block-entities-beans
‣ http://treehouseagency.com/blog/
neil-hastings/2011/09/06/building-
energygov-without-views
‣ http://drupal.org/project/bean
BADcamp 2011, Neil Hastings