diff sites/all/modules/views/help/api-handler-area.html @ 0:ff03f76ab3fe

initial version

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/sites/all/modules/views/help/api-handler-area.html	Wed Aug 21 18:51:11 2013 +0100
@@ -0,0 +1,45 @@
+In Views areas (header, footer, empty-text) are pluggable, this means you can write your own php logic to place whatever you want.
+
+<h3>Requirements</h3>
+You should have read <a href="topic:views/api">API</a> and <a href="topic:views/api-tables">Tables API</a> to get a basic knowledge
+how to extend views.
+
+<h3>Create your own area handler</h3>
+
+The first step is to tell views: Hey i want to add a new area handler.
+Therefore you have to implement hook_views_data and add a new one. For example:
+
+<pre>
+function yourmodule_views_data() {
+  $data['views']['collapsible_area'] = array(
+    'title' =&gt; t('Collabsible Text area'),
+    'help' =&gt; t('Provide collabsible markup text for the area.'),
+    'area' =&gt; array(
+      'handler' =&gt; 'yourmodule_handler_collapsible_area_text',
+    ),
+  );
+}
+</pre>
+
+The second step is to write this handler. Therefore create a file called yourmodule_handler_collapsible_area_text.inc and
+add it to the .info file of your module.
+
+Then add content to your area file like this:
+<pre>
+class yourmodule_handler_collapsible_area_text extends views_handler_area_text {
+  function render($empty = FALSE) {
+    // Here you just return a string of your content you want.
+    if ($render = parent::render($empty)) {
+      $element = array(
+        '#type' =&gt; 'fieldset',
+        '#title' =&gt; t('Title'),
+        '#value' =&gt; $render,
+      );
+      $output = theme('fieldset', $element);
+      return $output;
+    }
+  }
+}
+</pre>
+
+As on every handler you can add options so you can configure the behavior. If the area isn't shown yet in the views interface, please clear the cache :)