First batch of notes for the 2020.03 CHANGELOG

[friendica.git] / src / Console / User.php

diff --git a/src/Console/User.php b/src/Console/User.php
index ccd3caa3797b6f39353f1f0c5beba9928df1fa6a..b12a3a6ad36861785766fb000de88c303ad45d8b 100644 (file)
--- a/src/Console/User.php
+++ b/src/Console/User.php
@@ -21,18 +21,19 @@
 
 namespace Friendica\Console;
 
+use Console_Table;
 use Friendica\App;
+use Friendica\Content\Pager;
 use Friendica\Core\L10n;
 use Friendica\Database\Database;
 use Friendica\Model\Register;
 use Friendica\Model\User as UserModel;
+use Friendica\Util\Temporal;
 use RuntimeException;
 use Seld\CliPrompt\CliPrompt;
 
 /**
- * tool to set a new password for a user
- *
- * With this tool, you can set a new password for a user
+ * tool to manage users of the current node
  */
 class User extends \Asika\SimpleConsole\Console
 {
@@ -63,6 +64,14 @@ Usage
        bin/console user deny [<nickname>] [-h|--help|-?] [-v]
        bin/console user block [<nickname>] [-h|--help|-?] [-v]
        bin/console user unblock [<nickname>] [-h|--help|-?] [-v]
+       bin/console user list pending [-s|--start=0] [-c|--count=50] [-h|--help|-?] [-v]
+       bin/console user list removed [-s|--start=0] [-c|--count=50] [-h|--help|-?] [-v]
+       bin/console user list active [-s|--start=0] [-c|--count=50] [-h|--help|-?] [-v]
+       bin/console user list all [-s|--start=0] [-c|--count=50] [-h|--help|-?] [-v]
+       bin/console user search id <UID> [-h|--help|-?] [-v]
+       bin/console user search nick <nick> [-h|--help|-?] [-v]
+       bin/console user search mail <mail> [-h|--help|-?] [-v]
+       bin/console user search guid <GUID> [-h|--help|-?] [-v]
 
 Description
        Modify user settings per console commands.
@@ -118,6 +127,10 @@ HELP;
                                return $this->blockUser(false);
                        case 'delete':
                                return $this->deleteUser();
+                       case 'list':
+                               return $this->listUser();
+                       case 'search':
+                               return $this->searchUser();
                        default:
                                throw new \Asika\SimpleConsole\CommandArgsException('Wrong command.');
                }
@@ -305,4 +318,106 @@ HELP;
 
                return UserModel::remove($user['uid'] ?? -1);
        }
+
+       /**
+        * List users of the current node
+        *
+        * @return bool True, if the command was successful
+        */
+       private function listUser()
+       {
+               $subCmd = $this->getArgument(1);
+               $start = $this->getOption(['s', 'start'], 0);
+               $count = $this->getOption(['c', 'count'], Pager::ITEMS_PER_PAGE);
+
+               $table = new Console_Table();
+
+               switch ($subCmd) {
+                       case 'pending':
+                               $table->setHeaders(['Nick', 'Name', 'URL', 'E-Mail', 'Register Date', 'Comment']);
+                               $pending = Register::getPending($start, $count);
+                               foreach ($pending as $contact) {
+                                       $table->addRow([
+                                               $contact['nick'],
+                                               $contact['name'],
+                                               $contact['url'],
+                                               $contact['email'],
+                                               Temporal::getRelativeDate($contact['created']),
+                                               $contact['note'],
+                                       ]);
+                               }
+                               $this->out($table->getTable());
+                               return true;
+                       case 'all':
+                       case 'active':
+                       case 'removed':
+                               $table->setHeaders(['Nick', 'Name', 'URL', 'E-Mail', 'Register', 'Login', 'Last Item']);
+                               $contacts = UserModel::getList($start, $count, $subCmd);
+                               foreach ($contacts as $contact) {
+                                       $table->addRow([
+                                               $contact['nick'],
+                                               $contact['name'],
+                                               $contact['url'],
+                                               $contact['email'],
+                                               Temporal::getRelativeDate($contact['created']),
+                                               Temporal::getRelativeDate($contact['login_date']),
+                                               Temporal::getRelativeDate($contact['lastitem_date']),
+                                       ]);
+                               }
+                               $this->out($table->getTable());
+                               return true;
+                       default:
+                               $this->out($this->getHelp());
+                               return false;
+               }
+       }
+
+       /**
+        * Returns a user based on search parameter
+        *
+        * @return bool True, if the command was successful
+        */
+       private function searchUser()
+       {
+               $fields = [
+                       'uid',
+                       'guid',
+                       'username',
+                       'nickname',
+                       'email',
+                       'register_date',
+                       'login_date',
+                       'verified',
+                       'blocked',
+               ];
+
+               $subCmd = $this->getArgument(1);
+               $param = $this->getArgument(2);
+
+               $table = new Console_Table();
+               $table->setHeaders(['UID', 'GUID', 'Name', 'Nick', 'E-Mail', 'Register', 'Login', 'Verified', 'Blocked']);
+
+               switch ($subCmd) {
+                       case 'id':
+                               $user = UserModel::getById($param, $fields);
+                               break;
+                       case 'guid':
+                               $user = UserModel::getByGuid($param, $fields);
+                               break;
+                       case 'email':
+                               $user = UserModel::getByEmail($param, $fields);
+                               break;
+                       case 'nick':
+                               $user = UserModel::getByNickname($param, $fields);
+                               break;
+                       default:
+                               $this->out($this->getHelp());
+                               return false;
+               }
+
+               $table->addRow($user);
+               $this->out($table->getTable());
+
+               return true;
+       }
 }