add missing file for api documentation

documentation/api/files/Action/Category.php.txt

@@ -0,0 +1,254 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Action;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Thelia\Core\Event\ActionEvent;
+use Thelia\Core\Event\TheliaEvents;
+use Thelia\Model\Category as CategoryModel;
+use Thelia\Form\CategoryCreationForm;
+use Thelia\Core\Event\CategoryEvent;
+use Thelia\Tools\Redirect;
+use Thelia\Model\CategoryQuery;
+use Thelia\Model\AdminLog;
+use Thelia\Form\CategoryDeletionForm;
+use Thelia\Action\Exception\FormValidationException;
+
+class Category extends BaseAction implements EventSubscriberInterface
+{
+    public function create(ActionEvent $event)
+    {
+    	$request = $event->getRequest();
+
+    	try {
+    		$categoryCreationForm = new CategoryCreationForm($request);
+
+    		$form = $this->validateForm($categoryCreationForm, "POST");
+
+    		$data = $form->getData();
+
+            $category = new CategoryModel();
+
+   			$event->getDispatcher()->dispatch(TheliaEvents::BEFORE_CREATECATEGORY, $event);
+
+           	$category->create(
+                $data["title"],
+                $data["parent"],
+                $data["locale"]
+            );
+
+           	AdminLog::append(sprintf("Category %s (ID %s) created", $category->getTitle(), $category->getId()), $request, $request->getSession()->getAdminUser());
+
+            $categoryEvent = new CategoryEvent($category);
+
+            $event->getDispatcher()->dispatch(TheliaEvents::AFTER_CREATECATEGORY, $categoryEvent);
+
+            // Substitute _ID_ in the URL with the ID of the created category
+            $successUrl = str_replace('_ID_', $category->getId(), $categoryCreationForm->getSuccessUrl());
+
+	    	// Redirect to the success URL
+	    	Redirect::exec($successUrl);
+
+        } catch (PropelException $e) {
+            Tlog::getInstance()->error(sprintf('error during creating category with message "%s"', $e->getMessage()));
+
+            $message = "Failed to create this category, please try again.";
+        }
+
+        // The form has errors, propagate it.
+        $this->propagateFormError($categoryCreationForm, $message, $event);
+    }
+
+    public function modify(ActionEvent $event)
+    {
+    	/*
+        $request = $event->getRequest();
+
+        $customerModification = new CustomerModification($request);
+
+        $form = $customerModification->getForm();
+
+        if ($request->isMethod("post")) {
+
+            $form->bind($request);
+
+            if ($form->isValid()) {
+                $data = $form->getData();
+
+                $customer = CustomerQuery::create()->findPk(1);
+                try {
+                    $customerEvent = new CustomerEvent($customer);
+    				$event->getDispatcher()->dispatch(TheliaEvents::BEFORE_CHANGECUSTOMER, $customerEvent);
+
+                	$data = $form->getData();
+
+                    $customer->createOrUpdate(
+                        $data["title"],
+                        $data["firstname"],
+                        $data["lastname"],
+                        $data["address1"],
+                        $data["address2"],
+                        $data["address3"],
+                        $data["phone"],
+                        $data["cellphone"],
+                        $data["zipcode"],
+                        $data["country"]
+                    );
+
+                    $customerEvent->customer = $customer;
+                    $event->getDispatcher()->dispatch(TheliaEvents::AFTER_CHANGECUSTOMER, $customerEvent);
+
+                    // Update the logged-in user, and redirect to the success URL (exits)
+                    // We don-t send the login event, as the customer si already logged.
+                    $this->processSuccessfullLogin($event, $customer, $customerModification);
+                 }
+                catch(PropelException $e) {
+
+                    Tlog::getInstance()->error(sprintf('error during modifying customer on action/modifyCustomer with message "%s"', $e->getMessage()));
+
+                    $message = "Failed to change your account, please try again.";
+                }
+            }
+            else {
+            	$message = "Missing or invalid data";
+            }
+        }
+        else {
+        	$message = "Wrong form method !";
+        }
+
+        // The form has an error
+        $customerModification->setError(true);
+        $customerModification->setErrorMessage($message);
+
+        // Dispatch the errored form
+        $event->setErrorForm($customerModification);
+        */
+    }
+
+    /**
+     * Delete a category
+     *
+     * @param ActionEvent $event
+     */
+    public function delete(ActionEvent $event)
+    {
+    	$request = $event->getRequest();
+
+    	try {
+    		$categoryDeletionForm = new CategoryDeletionForm($request);
+
+    		$form = $this->validateForm($categoryDeletionForm, "POST");
+
+    		$data = $form->getData();
+
+	    	$category = CategoryQuery::create()->findPk($data['id']);
+
+	    	$categoryEvent = new CategoryEvent($category);
+
+	    	$event->getDispatcher()->dispatch(TheliaEvents::BEFORE_DELETECATEGORY, $categoryEvent);
+
+	    	$category->delete();
+
+	    	AdminLog::append(sprintf("Category %s (ID %s) deleted", $category->getTitle(), $category->getId()), $request, $request->getSession()->getAdminUser());
+
+	    	$categoryEvent->category = $category;
+
+	    	$event->getDispatcher()->dispatch(TheliaEvents::AFTER_DELETECATEGORY, $categoryEvent);
+
+	        // Substitute _ID_ in the URL with the ID of the created category
+	        $successUrl = str_replace('_ID_', $category->getParent(), $categoryDeletionForm->getSuccessUrl());
+
+			// Redirect to the success URL
+			Redirect::exec($successUrl);
+    	}
+        catch(PropelException $e) {
+
+        	Tlog::getInstance()->error(sprintf('error during deleting category ID=%s on action/modifyCustomer with message "%s"', $data['id'], $e->getMessage()));
+
+        	$message = "Failed to change your account, please try again.";
+        }
+        catch(FormValidationException $e) {
+
+         	$message = $e->getMessage();
+        }
+
+        $this->propagateFormError($categoryDeletionForm, $message, $event);
+    }
+
+    /**
+     * Toggle category visibility. No form used here
+     *
+     * @param ActionEvent $event
+     */
+    public function toggleVisibility(ActionEvent $event)
+    {
+    	$request = $event->getRequest();
+
+    	$category = CategoryQuery::create()->findPk($request->get('id', 0));
+
+    	if ($category !== null) {
+
+    		$category->setVisible($category->getVisible() ? false : true);
+
+    		$category->save();
+
+    		$categoryEvent = new CategoryEvent($category);
+
+    		$event->getDispatcher()->dispatch(TheliaEvents::AFTER_CHANGECATEGORY, $categoryEvent);
+    	}
+    }
+
+    /**
+     * Returns an array of event names this subscriber listens to.
+     *
+     * The array keys are event names and the value can be:
+     *
+     *  * The method name to call (priority defaults to 0)
+     *  * An array composed of the method name to call and the priority
+     *  * An array of arrays composed of the method names to call and respective
+     *    priorities, or 0 if unset
+     *
+     * For instance:
+     *
+     *  * array('eventName' => 'methodName')
+     *  * array('eventName' => array('methodName', $priority))
+     *  * array('eventName' => array(array('methodName1', $priority), array('methodName2'))
+     *
+     * @return array The event names to listen to
+     *
+     * @api
+     */
+    public static function getSubscribedEvents()
+    {
+        return array(
+            "action.createCategory" => array("create", 128),
+            "action.modifyCategory" => array("modify", 128),
+            "action.deleteCategory" => array("delete", 128),
+
+            "action.toggleCategoryVisibility" => array("toggleVisibility", 128),
+        );
+    }
+}
+

documentation/api/files/Action/Exception/FormValidationException.php.txt

@@ -0,0 +1,29 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Action\Exception;
+
+
+class FormValidationException extends ActionException
+{
+}

documentation/api/files/Cart/CartTrait.php.txt

@@ -0,0 +1,138 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+namespace Thelia\Cart;
+
+use Thelia\Model\ProductPrice;
+use Thelia\Model\ProductPriceQuery;
+use Thelia\Model\CartItem;
+use Thelia\Model\CartItemQuery;
+use Thelia\Model\CartQuery;
+use Thelia\Model\Cart as CartModel;
+use Thelia\Model\ConfigQuery;
+use Thelia\Model\Customer;
+use Symfony\Component\HttpFoundation\Request;
+use Thelia\Core\HttpFoundation\Session\Session;
+use Thelia\Core\Event\CartEvent;
+use Thelia\Core\Event\TheliaEvents;
+
+trait CartTrait {
+    /**
+     *
+     * search if cart already exists in session. If not try to create a new one or duplicate an old one.
+     *
+     * @param \Symfony\Component\HttpFoundation\Request $request
+     * @return \Thelia\Model\Cart
+     */
+    public function getCart(Request $request)
+    {
+
+        if(null !== $cart = $request->getSession()->getCart()){
+            return $cart;
+        }
+
+        if ($request->cookies->has("thelia_cart")) {
+            //le cookie de panier existe, on le récupère
+            $token = $request->cookies->get("thelia_cart");
+
+            $cart = CartQuery::create()->findOneByToken($token);
+
+            if ($cart) {
+                //le panier existe en base
+                $customer = $request->getSession()->getCustomerUser();
+
+                if ($customer) {
+                    if($cart->getCustomerId() != $customer->getId()) {
+                        //le customer du panier n'est pas le mm que celui connecté, il faut cloner le panier sans le customer_id
+                        $cart = $this->duplicateCart($cart, $request->getSession(), $customer);
+                    }
+                } else {
+                    if ($cart->getCustomerId() != null) {
+                        //il faut dupliquer le panier sans le customer_id
+                        $cart = $this->duplicateCart($cart, $request->getSession());
+                    }
+                }
+
+            } else {
+                $cart = $this->createCart($request->getSession());
+            }
+        } else {
+            //le cookie de panier n'existe pas, il va falloir le créer et faire un enregistrement en base.
+            $cart = $this->createCart($request->getSession());
+        }
+
+        return $cart;
+    }
+
+    /**
+     * @param \Thelia\Core\HttpFoundation\Session\Session $session
+     * @return \Thelia\Model\Cart
+     */
+    protected function createCart(Session $session)
+    {
+        $cart = new CartModel();
+        $cart->setToken($this->generateCookie());
+
+        if(null !== $customer = $session->getCustomerUser()) {
+            $cart->setCustomer($customer);
+        }
+
+        $cart->save();
+
+        $session->setCart($cart->getId());
+
+        return $cart;
+    }
+
+
+    /**
+     * try to duplicate existing Cart. Customer is here to determine if this cart belong to him.
+     *
+     * @param \Thelia\Model\Cart $cart
+     * @param \Thelia\Core\HttpFoundation\Session\Session $session
+     * @param \Thelia\Model\Customer $customer
+     * @return \Thelia\Model\Cart
+     */
+    protected function duplicateCart(CartModel $cart, Session $session, Customer $customer = null)
+    {
+        $newCart = $cart->duplicate($this->generateCookie(), $customer);
+        $session->setCart($newCart->getId());
+
+        $cartEvent = new CartEvent($newCart);
+        $this->dispatcher->dispatch(TheliaEvents::CART_DUPLICATE, $cartEvent);
+
+        return $cartEvent->cart;
+    }
+
+    protected function generateCookie()
+    {
+        $id = null;
+        if (ConfigQuery::read("cart.session_only", 0) == 0) {
+            $id = uniqid('', true);
+            setcookie("thelia_cart", $id, time()+ConfigQuery::read("cart.cookie_lifetime", 60*60*24*365));
+
+        }
+
+        return $id;
+
+    }
+}

documentation/api/files/Core/Event/CategoryEvent.php.txt

@@ -0,0 +1,37 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Core\Event;
+
+
+use Thelia\Model\Category;
+
+class CategoryEvent extends InternalEvent {
+
+    public $category;
+
+    public function __construct(Category $category)
+    {
+        $this->category = $category;
+    }
+}

documentation/api/files/Core/Security/Exception/AuthorizationException.php.txt

@@ -0,0 +1,29 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia                                                                       */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*      along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Core\Security\Exception;
+
+class AuthorizationException extends \Exception
+{
+}
+

documentation/api/files/Core/Template/Loop/CategoryTree.php.txt

@@ -0,0 +1,123 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Core\Template\Loop;
+
+use Propel\Runtime\ActiveQuery\Criteria;
+use Thelia\Core\Template\Element\BaseLoop;
+use Thelia\Core\Template\Element\LoopResult;
+use Thelia\Core\Template\Element\LoopResultRow;
+
+use Thelia\Core\Template\Loop\Argument\ArgumentCollection;
+use Thelia\Core\Template\Loop\Argument\Argument;
+use Thelia\Log\Tlog;
+
+use Thelia\Model\CategoryQuery;
+use Thelia\Model\ConfigQuery;
+use Thelia\Type\TypeCollection;
+use Thelia\Type;
+use Thelia\Type\BooleanOrBothType;
+
+/**
+ *
+ * Category tree loop, to get a category tree from a given category to a given depth.
+ *
+ * - category is the category id
+ * - depth is the maximum depth to go, default unlimited
+ * - visible if true or missing, only visible categories will be displayed. If false, all categories (visible or not) are returned.
+ *
+ * @package Thelia\Core\Template\Loop
+ * @author Franck Allimant <franck@cqfdev.fr>
+ */
+class CategoryTree extends BaseLoop
+{
+    /**
+     * @return ArgumentCollection
+     */
+    protected function getArgDefinitions()
+    {
+        return new ArgumentCollection(
+            Argument::createIntTypeArgument('category', null, true),
+            Argument::createIntTypeArgument('depth', PHP_INT_MAX),
+        	Argument::createBooleanOrBothTypeArgument('visible', true, false),
+        	Argument::createIntListTypeArgument('exclude', array())
+        );
+    }
+
+    // changement de rubrique
+    protected function buildCategoryTree($parent, $visible, $level, $max_level, array $exclude, LoopResult &$loopResult) {
+
+    	if ($level > $max_level) return;
+
+     	$search = CategoryQuery::create();
+
+    	$search->filterByParent($parent);
+
+    	if ($visible != BooleanOrBothType::ANY) $search->filterByVisible($visible);
+
+    	$search->filterById($exclude, Criteria::NOT_IN);
+
+    	$search->orderByPosition(Criteria::ASC);
+
+    	$results = $search->find();
+
+    	foreach($results as $result) {
+
+    		$loopResultRow = new LoopResultRow();
+
+           	$loopResultRow
+           		->set("ID", $result->getId())
+            	->set("TITLE",$result->getTitle())
+	            ->set("PARENT", $result->getParent())
+	            ->set("URL", $result->getUrl())
+	            ->set("VISIBLE", $result->getVisible() ? "1" : "0")
+	            ->set("LEVEL", $level)
+	        ;
+
+           	$loopResult->addRow($loopResultRow);
+
+           	$this->buildCategoryTree($result->getId(), $visible,  1 + $level, $max_level, $exclude, $loopResult);
+    	}
+    }
+
+    /**
+     * @param $pagination (ignored)
+     *
+     * @return \Thelia\Core\Template\Element\LoopResult
+     */
+    public function exec(&$pagination)
+    {
+		$id = $this->getCategory();
+		$depth   = $this->getDepth();
+		$visible = $this->getVisible();
+		$exclude = $this->getExclude();
+
+		//echo "exclude=".print_r($exclude);
+
+		$loopResult = new LoopResult();
+
+		$this->buildCategoryTree($id, $visible, 0, $depth, $exclude, $loopResult);
+
+        return $loopResult;
+    }
+}

documentation/api/files/Core/Template/Loop/Lang.php.txt

@@ -0,0 +1,114 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+
+namespace Thelia\Core\Template\Loop;
+
+use Propel\Runtime\ActiveQuery\Criteria;
+use Thelia\Core\Template\Element\BaseLoop;
+use Thelia\Core\Template\Element\LoopResult;
+use Thelia\Core\Template\Element\LoopResultRow;
+
+use Thelia\Core\Template\Loop\Argument\Argument;
+
+use Thelia\Type\TypeCollection;
+use Thelia\Type;
+use Thelia\Model\LangQuery;
+use Thelia\Core\Template\Loop\Argument\ArgumentCollection;
+
+/**
+ * Language loop, to get a list of available languages
+ *
+ * - id is the language id
+ * - exclude is a comma separated list of lang IDs that will be excluded from output
+ * - default if 1, the loop return only default lang. If 0, return all but the default language
+ *
+ * @package Thelia\Core\Template\Loop
+ * @author Franck Allimant <franck@cqfdev.fr>
+ */
+class Lang extends BaseLoop
+{
+    /**
+     * @return ArgumentCollection
+     */
+    protected function getArgDefinitions()
+    {
+        return new ArgumentCollection(
+            Argument::createIntTypeArgument('id', null),
+            Argument::createIntListTypeArgument('exclude'),
+            Argument::createBooleanTypeArgument('default_only', false)
+        );
+     }
+
+    /**
+     * @param $pagination (ignored)
+     *
+     * @return \Thelia\Core\Template\Element\LoopResult
+     */
+    public function exec(&$pagination)
+    {
+		$id      = $this->getId();
+		$exclude = $this->getExclude();
+		$default_only = $this->getDefaultOnly();
+
+        $search = LangQuery::create();
+
+        if (! is_null($id))
+			$search->filterById($id);
+
+        if ($default_only)
+        	$search->filterByByDefault(true);
+
+        if (! is_null($exclude)) {
+        	$search->filterById($exclude, Criteria::NOT_IN);
+        }
+
+        $search->orderByPosition(Criteria::ASC);
+
+        $results = $this->search($search, $pagination);
+
+        $loopResult = new LoopResult();
+
+        foreach ($results as $result) {
+
+        	$loopResultRow = new LoopResultRow();
+
+        	$loopResultRow
+	        	->set("ID", $result->getId())
+	        	->set("TITLE",$result->getTitle())
+	        	->set("CODE", $result->getCode())
+	        	->set("LOCALE", $result->getLocale())
+	        	->set("URL", $result->getUrl())
+	        	->set("IS_DEFAULT", $result->getByDefault())
+	        	->set("URL", $result->getUrl())
+	        	->set("POSITION", $result->getPosition())
+
+	        	->set("CREATE_DATE", $result->getCreatedAt())
+	        	->set("UPDATE_DATE", $result->getUpdatedAt())
+	        ;
+
+        	$loopResult->addRow($loopResultRow);
+        }
+
+        return $loopResult;
+    }
+}

documentation/api/files/Form/CategoryCreationForm.php.txt

@@ -0,0 +1,56 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+namespace Thelia\Form;
+
+use Symfony\Component\Form\FormBuilderInterface;
+use Symfony\Component\Validator\Constraints\NotBlank;
+
+class CategoryCreationForm extends BaseForm {
+
+    protected function buildForm()
+    {
+        $this->formBuilder
+            ->add("title", "text", array(
+                "constraints" => array(
+                    new NotBlank()
+                )
+            ))
+            ->add("parent", "integer", array(
+                "constraints" => array(
+                	new NotBlank()
+                )
+            ))
+            ->add("locale", "text", array(
+            	"constraints" => array(
+            		new NotBlank()
+            	)
+            ))
+        ;
+    }
+
+    public function getName()
+    {
+        return "thelia_category_creation";
+    }
+}
+

documentation/api/files/Form/CategoryDeletionForm.php.txt

@@ -0,0 +1,45 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia	                                                                     */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*	    along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+namespace Thelia\Form;
+
+use Symfony\Component\Form\FormBuilderInterface;
+use Symfony\Component\Validator\Constraints\NotBlank;
+
+class CategoryDeletionForm extends BaseForm {
+
+    protected function buildForm()
+    {
+        $this->formBuilder
+            ->add("id", "integer", array(
+                "constraints" => array(
+                	new NotBlank()
+                )
+            ))
+        ;
+    }
+
+    public function getName()
+    {
+        return "thelia_category_deletion";
+    }
+}

documentation/api/files/Type/BooleanOrBothType.php.txt

@@ -0,0 +1,54 @@
+<?php
+/*************************************************************************************/
+/*                                                                                   */
+/*      Thelia                                                                       */
+/*                                                                                   */
+/*      Copyright (c) OpenStudio                                                     */
+/*      email : info@thelia.net                                                      */
+/*      web : http://www.thelia.net                                                  */
+/*                                                                                   */
+/*      This program is free software; you can redistribute it and/or modify         */
+/*      it under the terms of the GNU General Public License as published by         */
+/*      the Free Software Foundation; either version 3 of the License                */
+/*                                                                                   */
+/*      This program is distributed in the hope that it will be useful,              */
+/*      but WITHOUT ANY WARRANTY; without even the implied warranty of               */
+/*      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                */
+/*      GNU General Public License for more details.                                 */
+/*                                                                                   */
+/*      You should have received a copy of the GNU General Public License            */
+/*      along with this program. If not, see <http://www.gnu.org/licenses/>.         */
+/*                                                                                   */
+/*************************************************************************************/
+namespace Thelia\Type;
+
+/**
+ * This filter accepts either a boolean value, or '*' which means both, true and false
+ *
+ * @author Etienne Roudeix <eroudeix@openstudio.fr>
+ *
+ */
+
+class BooleanOrBothType implements TypeInterface
+{
+
+	const ANY = '*';
+
+    public function getType()
+    {
+        return 'Boolean or both type';
+    }
+
+    public function isValid($value)
+    {
+        return $value === self::ANY || filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE) !== null;
+    }
+
+    public function getFormattedValue($value)
+    {
+    	if ($value === self::ANY) return $value;
+
+        return $value === null ? null : filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
+    }
+}
+