[4.0] Feature: Adding User(s) Model + View to front-end

administrator/language/en-GB/en-GB.com_users.ini

@@ -240,6 +240,9 @@ COM_USERS_OPTION_LEVEL_DEEPER="%d (deeper)"
 COM_USERS_OPTION_SELECT_COMPONENT="- Select Component -"
 COM_USERS_OPTION_SELECT_LEVEL_END="- Select End Level -"
 COM_USERS_OPTION_SELECT_LEVEL_START="- Select Start Level -"
+COM_USERS_PARAMS_SELECT_GROUPS="Select Groups"
+COM_USERS_PARAMS_SHOW_LAST_VISITED="Last Visited Date"
+COM_USERS_PARAMS_SHOW_ONLINE_STATUS="Online Status"
 COM_USERS_PASSWORD_RESET_REQUIRED="Password Reset Required"
 COM_USERS_REQUIRE_PASSWORD_RESET="Require Password Reset"
 COM_USERS_REVIEW_HEADING="Review Date"
@@ -261,6 +264,7 @@ COM_USERS_SUBMENU_NOTES="User Notes"
 COM_USERS_SUBMENU_NOTE_CATEGORIES="User Note Categories"
 COM_USERS_SUBMENU_USERS="Users"
 COM_USERS_SUBJECT_HEADING="Subject"
+COM_USERS_TAB="Users View"
 COM_USERS_TFA_ACTIVE="Uses Two Factor Authentication"
 COM_USERS_TFA_NOTACTIVE="Does not use Two Factor Authentication"
 COM_USERS_TOOLBAR_ACTIVATE="Activate"

administrator/language/en-GB/en-GB.com_users.sys.ini

@@ -43,8 +43,10 @@ COM_USERS_RESET_VIEW_DEFAULT_DESC="Displays a request to reset password."
 COM_USERS_RESET_VIEW_DEFAULT_OPTION="Default"
 COM_USERS_RESET_VIEW_DEFAULT_TITLE="Password Reset"
 COM_USERS_TAGS_CATEGORY="User Note Category"
-COM_USERS_USERS_VIEW_DEFAULT_DESC="Shows a List of Users"
-COM_USERS_USERS_VIEW_DEFAULT_TITLE="Users"
 COM_USERS_USER_VIEW_EDIT_DESC="Shows a form to create a new User Account"
 COM_USERS_USER_VIEW_EDIT_TITLE="Create User"
+COM_USERS_USERS_VIEW_DEFAULT_DESC="Shows a List of Users"
+COM_USERS_USERS_VIEW_DEFAULT_TITLE="Users"
+COM_USERS_USERS_GROUP_VIEW_DEFAULT="List Users"
+COM_USERS_USERS_GROUP_VIEW_DEFAULT_DESC="This View displays a list of Users from a specified Group."
 COM_USERS_XML_DESCRIPTION="Component for managing users."

components/com_users/Controller/DisplayController.php

@@ -127,6 +127,16 @@ public function display($cachable = false, $urlparams = false)
 					$model = $this->getModel($vName);
 					break;
 
+				case 'users':
+					// If we just want to show the Users overview
+					$model = $this->getModel($vName);
+					break;
+
+				case 'user':
+					// If we just want to show the single User
+					$model = $this->getModel($vName);
+					break;
+
 				default:
 					$model = $this->getModel('Login');
 					break;

components/com_users/Model/UserModel.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * @package     Joomla.Site
+ * @subpackage  com_users
+ *
+ * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Component\Users\Site\Model;
+
+defined('_JEXEC') or die;
+
+use Exception;
+use Joomla\CMS\MVC\Model\ItemModel;
+use Joomla\Database\ParameterType;
+
+/**
+ * This models retrieves some data of a user.
+ *
+ * @since  4.0
+ */
+class UserModel extends ItemModel
+{
+	/**
+	 * Load the Author data.
+	 *
+	 * @param   integer  $id  ID of Author
+	 *
+	 * @return  object  The product information.
+	 * @throws  Exception
+	 * @since   1.0.0
+	 */
+	public function getItem($id = null)
+	{
+		$db    = $this->getDbo();
+		$query = $db->getQuery(true)
+			->select(
+				$db->quoteName(
+					array(
+						'users.id',
+						'users.name',
+						'users.username',
+						'users.email',
+						'users.registerDate',
+						'users.lastvisitDate'
+					)
+				)
+			)
+			->from($db->quoteName('#__users', 'users'))
+			->where($db->quoteName('users.block') . ' = 0')
+			->where($db->quoteName('users.id') . ' = :user_id')
+			->leftJoin(
+				$db->quoteName('#__session', 'session')
+				. ' ON ' . $db->quoteName('session.userid') . ' = ' . $db->quoteName('users.id')
+			)
+			->bind(':user_id', $id, ParameterType::INTEGER);
+		$db->setQuery($query);
+		$item = $db->loadObject();
+
+		return $item;
+	}
+}

components/com_users/Model/UsersModel.php

@@ -0,0 +1,214 @@
+<?php
+/**
+ * @package     Joomla.Site
+ * @subpackage  com_users
+ *
+ * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Component\Users\Site\Model;
+
+defined('_JEXEC') or die;
+
+use Exception;
+use Joomla\CMS\Component\ComponentHelper;
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\Model\ListModel;
+use Joomla\Database\ParameterType;
+use Joomla\Utilities\ArrayHelper;
+
+/**
+ * This models supports retrieving a list of users.
+ *
+ * @since  4.0
+ */
+class UsersModel extends ListModel
+{
+	/**
+	 * User items data
+	 *
+	 * @var array
+	 * @since   4.0
+	 */
+	protected $item = null;
+
+	/**
+	 * The category that applies.
+	 *
+	 * @var        object
+	 * @access    protected
+	 * @since     4.0
+	 */
+	protected $category = null;
+
+	/**
+	 * The list of other contact categories.
+	 *
+	 * @var       array
+	 * @access    protected
+	 * @since     4.0
+	 */
+	protected $categories = null;
+
+	/**
+	 * Constructor
+	 *
+	 * @param   array  $config  An optional associative array of configuration settings.
+	 *
+	 * @throws Exception
+	 * @since   4.0
+	 */
+	public function __construct($config = array())
+	{
+		if (empty($config['filter_fields']))
+		{
+			$config['filter_fields'] = array(
+				'id', 'users.id',
+				'name', 'users.name',
+				'username', 'users.username',
+				'email', 'users.email',
+				'registerDate', 'users.registerDate',
+				'lastvisitDate', 'users.lastvisitDate',
+				'session.time'
+			);
+		}
+
+		parent::__construct($config);
+	}
+
+	/**
+	 * Method to get a list of items.
+	 *
+	 * @return  mixed  An array of objects on success, false on failure.
+	 * @since   4.0
+	 */
+	public function getItems()
+	{
+		// Invoke the parent getItems method to get the main list
+		$items = parent::getItems();
+
+		return $items;
+	}
+
+	/**
+	 * Method to build an SQL query to load the list data.
+	 *
+	 * @return  string    An SQL query
+	 * @throws Exception
+	 * @since   4.0
+	 */
+	protected function getListQuery()
+	{
+		$app        = Factory::getApplication();
+		$menu       = $app->getMenu();
+		$active     = $menu->getActive();
+		$itemId     = $active->id;
+		$menuParams = $menu->getParams($itemId);
+		$groupIds   = $menuParams->get('groups', 0, 'array');
+
+		$db    = $this->getDbo();
+		$query = $db->getQuery(true);
+
+		// Select the required fields from the table.
+		$query->select(
+			$this->getState(
+				'list.select',
+				$db->quoteName(
+					array(
+						'users.id',
+						'users.name',
+						'users.username',
+						'users.email',
+						'users.registerDate',
+						'users.lastvisitDate'
+					)
+				)
+			)
+		)
+			->from($db->quoteName('#__users', 'users'))
+			->leftJoin(
+				$db->quoteName('#__user_usergroup_map', 'usergroupmap')
+				. ' ON ' . $db->quoteName('usergroupmap.user_id') . ' = ' . $db->quoteName('users.id')
+			)
+			->leftJoin(
+				$db->quoteName('#__session', 'session')
+				. ' ON ' . $db->quoteName('session.userid') . ' = ' . $db->quoteName('users.id')
+			)
+			->select($db->quoteName('session.time'))
+			->where($db->quoteName('users.block') . ' = 0')
+			->group($db->quoteName('users.id'))
+			->order(
+				$this->getState('list.ordering', 'users.name') . ' ' .
+				$this->getState('list.direction', 'ASC')
+			);
+
+		if (is_numeric($groupIds))
+		{
+			$query->where($db->quoteName('usergroupmap.group_id') . ' = :group_id')
+				->bind(':group_id', $groupIds, ParameterType::INTEGER);
+		}
+		elseif (is_array($groupIds) && (count($groupIds) > 0))
+		{
+			$groupIds = ArrayHelper::toInteger($groupIds);
+
+			$query->whereIn(
+				$db->quoteName('usergroupmap.group_id'), $groupIds
+			);
+		}
+
+		// Add the list ordering clause
+		$query->order(
+			$this->getState('list.ordering', 'users.name') . ' '
+			. $this->getState('list.direction', 'ASC')
+		);
+
+		return $query;
+	}
+
+	/**
+	 * Method to auto-populate the model state.
+	 *
+	 * Note. Calling getState in this method will result in recursion.
+	 *
+	 * @param   string  $ordering   An optional ordering field.
+	 * @param   string  $direction  An optional direction (asc|desc).
+	 *
+	 * @return  void
+	 * @throws  Exception
+	 * @since   1.6
+	 */
+	protected function populateState($ordering = null, $direction = null)
+	{
+		$app    = Factory::getApplication();
+		$params = ComponentHelper::getParams('com_users');
+
+		// List state information
+		$value = $app->input->get('limit', $app->get('list_limit', 0), 'uint');
+		$this->setState('list.limit', $value);
+
+		$value = $app->input->get('limitstart', 0, 'uint');
+		$this->setState('list.start', $value);
+
+		$orderCol = $app->input->get('filter_order', 'users.name');
+
+		if (!in_array($orderCol, $this->filter_fields))
+		{
+			$orderCol = 'users.id';
+		}
+
+		$this->setState('list.ordering', $orderCol);
+
+		$listOrder = $app->input->get('filter_order_Dir', 'ASC');
+
+		if (!in_array(strtoupper($listOrder), array('ASC', 'DESC', '')))
+		{
+			$listOrder = 'ASC';
+		}
+
+		$this->setState('list.direction', $listOrder);
+
+		// Load the parameters.
+		$this->setState('params', $params);
+	}
+}

components/com_users/View/User/HtmlView.php

@@ -0,0 +1,70 @@
+<?php
+/**
+ * @package     Joomla.Site
+ * @subpackage  com_users
+ *
+ * @copyright   Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Component\Users\Site\View\User;
+
+defined('_JEXEC') or die;
+
+use Exception;
+use Joomla\CMS\Factory;
+use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView;
+use Joomla\Component\Users\Site\Model\UserModel;
+
+/**
+ * View class for Single User
+ *
+ * @since  4.0
+ */
+class HtmlView extends BaseHtmlView
+{
+	/**
+	 * The Author data
+	 *
+	 * @var    object
+	 * @since  1.0.0
+	 */
+	protected $item;
+
+	/**
+	 * The model state
+	 *
+	 * @var    Joomla\Registry\Registry
+	 * @since  1.0.0
+	 */
+	protected $state;
+
+	/**
+	 * Method to display the view.
+	 *
+	 * @param   string  $tpl  The template file to include
+	 *
+	 * @return  mixed
+	 *
+	 * @throws  Exception
+	 *
+	 * @since   1.0.0
+	 */
+	public function display($tpl = null)
+	{
+		$authorId = Factory::getApplication()->input->getInt('id');
+
+		/** @var UserModel $model */
+		$model       = $this->getModel();
+		$this->state = $model->getState();
+		$this->item  = $model->getItem($authorId);
+
+		// Check for errors.
+		if (count($errors = $this->get('Errors')))
+		{
+			throw new Exception(implode("\n", $errors), 500);
+		}
+
+		parent::display($tpl);
+	}
+}