看板初始化提交

2026-06-01 21:23:12 -07:00
commit 54a842f4ab
2104 changed files with 241695 additions and 0 deletions
@@ -0,0 +1,198 @@
+<?php
+
+namespace Kanboard\Helper;
+
+use Kanboard\Core\Base;
+
+/**
+ * User helpers
+ *
+ * @package helper
+ * @author  Frederic Guillot
+ */
+class UserHelper extends Base
+{
+    public function getTheme()
+    {
+        return $this->userSession->getTheme();
+    }
+
+    /**
+     * Return subtask list toggle value
+     *
+     * @access public
+     * @return boolean
+     */
+    public function hasSubtaskListActivated()
+    {
+        return $this->userSession->hasSubtaskListActivated();
+    }
+
+    /**
+     * Return true if the logged user has unread notifications
+     *
+     * @access public
+     * @return boolean
+     */
+    public function hasNotifications()
+    {
+        return $this->userUnreadNotificationModel->hasNotifications($this->userSession->getId());
+    }
+
+    /**
+     * Get initials from a user
+     *
+     * @access public
+     * @param  string  $name
+     * @return string
+     */
+    public function getInitials($name)
+    {
+        $initials = '';
+
+        foreach (explode(' ', $name, 2) as $string) {
+            $initials .= mb_substr($string, 0, 1, 'UTF-8');
+        }
+
+        return mb_strtoupper($initials, 'UTF-8');
+    }
+
+    /**
+     * Return the user full name
+     *
+     * @param  array    $user   User properties
+     * @return string
+     */
+    public function getFullname(array $user = array())
+    {
+        $user = empty($user) ? $this->userSession->getAll() : $user;
+        return $user['name'] ?: $user['username'];
+    }
+
+    /**
+     * Get user id
+     *
+     * @access public
+     * @return integer
+     */
+    public function getId()
+    {
+        return $this->userSession->getId();
+    }
+
+    /**
+     * Check if the given user_id is the connected user
+     *
+     * @param  integer   $user_id   User id
+     * @return boolean
+     */
+    public function isCurrentUser($user_id)
+    {
+        return $this->userSession->getId() == $user_id;
+    }
+
+    /**
+     * Return if the logged user is admin
+     *
+     * @access public
+     * @return boolean
+     */
+    public function isAdmin()
+    {
+        return $this->userSession->isAdmin();
+    }
+
+    /**
+     * Get role
+     *
+     * @access public
+     * @return string
+     */
+    public function getRole()
+    {
+        return $this->userSession->getRole();
+    }
+
+    /**
+     * Get role name
+     *
+     * @access public
+     * @param  string  $role
+     * @return string
+     */
+    public function getRoleName($role = '')
+    {
+        return $this->role->getRoleName($role ?: $this->userSession->getRole());
+    }
+
+    /**
+     * Get group names for a given user and return an associative array:
+     *
+     * @access public
+     * @param  integer   $userID   User id
+     * @return array
+     */
+    public function getUsersGroupNames($userID)
+    {
+        $groupsList = array_column($this->groupMemberModel->getGroups($userID), 'name');
+        $limitedList = $groupsList;
+        $total = count($groupsList);
+
+        if ($total > 0 && SHOW_GROUP_MEMBERSHIPS_IN_USERLIST_WITH_LIMIT > 0) {
+            $limitedList = array_slice($groupsList, 0, SHOW_GROUP_MEMBERSHIPS_IN_USERLIST_WITH_LIMIT);
+        }
+
+        return [
+            'full_list' => $groupsList,
+            'limited_list' => $limitedList,
+            'has_groups' => $total > 0,
+            'total' => $total,
+            'shown' => count($limitedList),
+        ];
+    }
+
+    /**
+     * Check application access
+     *
+     * @param  string  $controller
+     * @param  string  $action
+     * @return bool
+     */
+    public function hasAccess($controller, $action)
+    {
+        if (! $this->userSession->isLogged()) {
+            return false;
+        }
+
+        $key = 'app_access:'.$controller.$action;
+        $result = $this->memoryCache->get($key);
+
+        if ($result === null) {
+            $result = $this->applicationAuthorization->isAllowed($controller, $action, $this->userSession->getRole());
+            $this->memoryCache->set($key, $result);
+        }
+
+        return $result;
+    }
+
+    /**
+     * Check project access
+     *
+     * @param  string  $controller
+     * @param  string  $action
+     * @param  integer $project_id
+     * @return bool
+     */
+    public function hasProjectAccess($controller, $action, $project_id)
+    {
+        $key = 'project_access:'.$controller.$action.$project_id;
+        $result = $this->memoryCache->get($key);
+
+        if ($result === null) {
+            $result = $this->helper->projectRole->checkProjectAccess($controller, $action, $project_id);
+            $this->memoryCache->set($key, $result);
+        }
+
+        return $result;
+    }
+}