+ Adapters: Added the Agavi interface for Dwoo (see /Dwoo/Adapters/Agavi/README)

CHANGELOG

@@ -9,6 +9,8 @@
   if you include "../foo/bar.html" AND have an include path set, you will now
   have a problem, because you can't mix both approaches, otherwise you should
   be fine, so to fix this you should convert your relative includes/extends
++ Adapters: Added the Agavi interface for Dwoo
+  (see /Dwoo/Adapters/Agavi/README)
 + API: Added Dwoo_Compilation_Exception methods getCompiler() and
   getTemplate() so you can catch the exception and use those to build a nicer
   error view with all the details you want

lib/Dwoo/Adapters/Agavi/DwooRenderer.php

+<?php
+
+/**
+ * Dwoo adapter for Agavi
+ *
+ * Install instructions :
+ *  - download dwoo from dwoo.org and unzip it somewhere in your agavi app
+ *  - add a renderer to your output_types.xml as such :
+ *     <renderer name="dwoo" class="DwooRenderer">
+ *        <parameter name="assigns">
+ *           <parameter name="routing">ro</parameter>
+ *           <parameter name="request">rq</parameter>
+ *           <parameter name="controller">ct</parameter>
+ *           <parameter name="user">us</parameter>
+ *           <parameter name="translation_manager">tm</parameter>
+ *           <parameter name="request_data">rd</parameter>
+ *        </parameter>
+ *        <parameter name="extract_vars">true</parameter>
+ *        <parameter name="plugin_dir">%core.lib_dir%/dwoo_plugins</parameter>
+ *     </renderer>
+ *
+ *  - add dwoo's directory to your include path or include dwooAutoload.php yourself
+ *    either through agavi's autoload.xml (with name="Dwoo") or through your index.php
+ *
+ * Notes:
+ *  - you can copy the /Dwoo/Adapters/Agavi/dwoo_plugins directory to your agavi app's
+ *    lib directory, or change the plugin_dir parameter in the output_types.xml file.
+ *    these plugins are agavi-specific helpers that shortens the syntax to call common
+ *    agavi helpers (i18n, routing, ..)
+ *
+ * This software is provided 'as-is', without any express or implied warranty.
+ * In no event will the authors be held liable for any damages arising from the
+ * use of this software.
+ *
+ * This file is released under the LGPL
+ * "GNU Lesser General Public License"
+ * More information can be found here:
+ * {@link http://www.gnu.org/copyleft/lesser.html}
+ *
+ * @author     Jordi Boggiano <j.boggiano@seld.be>
+ * @author     David Zülke <dz@bitxtender.com>
+ * @copyright  Copyright (c) 2008, Jordi Boggiano
+ * @license    http://www.gnu.org/copyleft/lesser.html  GNU Lesser General Public License
+ * @link       http://dwoo.org/
+ * @version    1.0.0
+ * @date       2008-09-07
+ * @package    Dwoo
+ */
+class DwooRenderer extends AgaviRenderer implements AgaviIReusableRenderer
+{
+    /**
+     * @constant   string The directory inside the cache dir where templates will
+     *                    be stored in compiled form.
+     */
+    const COMPILE_DIR = 'templates';
+
+    /**
+     * @constant   string The subdirectory inside the compile dir where templates
+     *                    will be stored in compiled form.
+     */
+    const COMPILE_SUBDIR = 'dwoo';
+
+    /**
+     * @constant   string The directory inside the cache dir where cached content
+     *                    will be stored.
+     */
+    const CACHE_DIR = 'dwoo';
+
+    /**
+     * @var        Dwoo Dwoo template engine.
+     */
+    protected $dwoo = null;
+
+    /**
+     * @var        string A string with the default template file extension,
+     *                    including the dot.
+     */
+    protected $defaultExtension = '.html';
+
+    /**
+     * Pre-serialization callback.
+     *
+     * Excludes the Dwoo instance to prevent excessive serialization load.
+     *
+     * @author     David Zülke <dz@bitxtender.com>
+     * @since      0.11.0
+     */
+    public function __sleep()
+    {
+        $keys = parent::__sleep();
+        unset($keys[array_search('dwoo', $keys)]);
+        return $keys;
+    }
+
+    /**
+     * Grab a cleaned up dwoo instance.
+     *
+     * @return     Dwoo A Dwoo instance.
+     *
+     * @author     David Zülke <dz@bitxtender.com>
+     * @since      0.9.0
+     */
+    protected function getEngine()
+    {
+        if($this->dwoo) {
+            return $this->dwoo;
+        }
+
+        if(!class_exists('Dwoo')) {
+        	if (file_exists(dirname(__FILE__).'/../../../dwooAutoload.php')) {
+	        	// file was dropped with the entire dwoo package
+        		require dirname(__FILE__).'/../../../dwooAutoload.php';
+        	} else {
+        		// assume the dwoo package is in the include path
+	            require 'dwooAutoload.php';
+        	}
+        }
+
+        $parentMode = fileperms(AgaviConfig::get('core.cache_dir'));
+
+        $compileDir = AgaviConfig::get('core.cache_dir') . DIRECTORY_SEPARATOR . self::COMPILE_DIR . DIRECTORY_SEPARATOR . self::COMPILE_SUBDIR;
+        AgaviToolkit::mkdir($compileDir, $parentMode, true);
+
+        $cacheDir = AgaviConfig::get('core.cache_dir') . DIRECTORY_SEPARATOR . self::CACHE_DIR;
+        AgaviToolkit::mkdir($cacheDir, $parentMode, true);
+
+        $this->dwoo = new Dwoo($compileDir, $cacheDir);
+
+        if (!empty($this->plugin_dir)) {
+            $this->dwoo->getLoader()->addDirectory($this->plugin_dir);
+        }
+
+        return $this->dwoo;
+    }
+
+    /**
+     * Render the presentation and return the result.
+     *
+     * @param      AgaviTemplateLayer The template layer to render.
+     * @param      array              The template variables.
+     * @param      array              The slots.
+     * @param      array              Associative array of additional assigns.
+     *
+     * @return     string A rendered result.
+     *
+     * @author     David Zülke <dz@bitxtender.com>
+     * @since      0.11.0
+     */
+    public function render(AgaviTemplateLayer $layer, array &$attributes = array(), array &$slots = array(), array &$moreAssigns = array())
+    {
+        $engine = $this->getEngine();
+
+        $data = array();
+        if($this->extractVars) {
+            $data = $attributes;
+        } else {
+            $data[$this->varName] = &$attributes;
+        }
+
+        $data[$this->slotsVarName] =& $slots;
+
+        foreach($this->assigns as $key => $getter) {
+            $data[$key] = $this->context->$getter();
+        }
+
+        foreach($moreAssigns as $key => &$value) {
+            if(isset($this->moreAssignNames[$key])) {
+                $key = $this->moreAssignNames[$key];
+            }
+            $data[$key] =& $value;
+        }
+
+        return $engine->get($layer->getResourceStreamIdentifier(), $data);
+    }
+}
\ No newline at end of file

lib/Dwoo/Adapters/Agavi/README

+// ------------------------
+// Install notes :
+// ------------------------
+
+ - drop dwoo's directory in app/lib/renderer (create if needed)
+
+ - add a renderer to app/config/output_types.xml as such :
+    <renderer name="dwoo" class="DwooRenderer">
+       <parameter name="assigns">
+          <parameter name="routing">ro</parameter>
+          <parameter name="request">rq</parameter>
+          <parameter name="controller">ct</parameter>
+          <parameter name="user">us</parameter>
+          <parameter name="translation_manager">tm</parameter>
+          <parameter name="request_data">rd</parameter>
+       </parameter>
+       <parameter name="extract_vars">true</parameter>
+       <parameter name="plugin_dir">%core.lib_dir%/dwoo_plugins</parameter>
+    </renderer>
+
+ - add the renderer to app/config/autoload.xml as such :
+    <autoload name="DwooRenderer">%core.lib_dir%/renderer/dwoo/Dwoo/Adapter/Agavi/DwooRenderer.php</autoload>
\ No newline at end of file