added control sidebar #10 (#87)

- added configurable sidebar #10
- added language switch in sidebar preferences tab #10
- added sidebar tab with kimai beta-info message #10
- use trait for repositories
- improved README

src/Repository/RepositoryTrait.php

@@ -0,0 +1,55 @@
+<?php
+
+/*
+ * This file is part of the Kimai package.
+ *
+ * (c) Kevin Papst <kevin@kevinpapst.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace App\Repository;
+
+use App\Repository\Query\BaseQuery;
+use Doctrine\ORM\Query;
+use Doctrine\ORM\QueryBuilder;
+use Pagerfanta\Adapter\DoctrineORMAdapter;
+use Pagerfanta\Pagerfanta;
+
+/**
+ * Trait RepositoryTrait
+ *
+ * @author Kevin Papst <kevin@kevinpapst.de>
+ */
+trait RepositoryTrait
+{
+    /**
+     * @param QueryBuilder $qb
+     * @param BaseQuery $query
+     * @return QueryBuilder|Pagerfanta
+     */
+    protected function getBaseQueryResult(QueryBuilder $qb, BaseQuery $query)
+    {
+        if ($query->getResultType() == BaseQuery::RESULT_TYPE_PAGER) {
+            return $this->getPager($qb->getQuery(), $query->getPage(), $query->getPageSize());
+        }
+
+        return $qb;
+    }
+
+    /**
+     * @param Query $query
+     * @param int $page
+     * @param int $maxPerPage
+     * @return Pagerfanta
+     */
+    protected function getPager(Query $query, $page = 1, $maxPerPage = 25)
+    {
+        $paginator = new Pagerfanta(new DoctrineORMAdapter($query, false));
+        $paginator->setMaxPerPage($maxPerPage);
+        $paginator->setCurrentPage($page);
+
+        return $paginator;
+    }
+}