gnusocial/plugins/Directory/actions/userdirectory.php

<?php declare(strict_types=1);
/**
 * StatusNet, the distributed open-source microblogging tool
 *
 * Output a user directory
 *
 * PHP version 5
 *
 * LICENCE: This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * 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 Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * @category  Public
 * @package   StatusNet
 * @author    Zach Copley <zach@status.net>
 * @copyright 2011 StatusNet, Inc.
 * @license   http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
 * @link      http://status.net/
 */

if (!defined('GNUSOCIAL')) {
    exit(1);
}

/**
 * User directory
 *
 * @category Personal
 * @package  StatusNet
 * @author   Zach Copley <zach@status.net>
 * @license  http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
 * @link     http://status.net/
 */
class UserdirectoryAction extends ManagedAction
{
    protected $redirectAfterLogin = true;
    
    /**
     * The page we're on
     *
     * @var integer
     */
    public $page;

    /**
     * What to filter the search results by
     *
     * @var string
     */
    public $filter;

    /**
     * Column to sort by
     *
     * @var string
     */
    public $sort;

    /**
     * How to order search results, ascending or descending
     *
     * @var string
     */
    public $reverse;

    /**
     * Query
     *
     * @var string
     */
    public $q;

    /**
     * Count for display (`count` URL query).
     */
    private int $count;

    /**
     * Title of the page
     *
     * @return string Title of the page
     */
    public function title()
    {
        // @todo fixme: This looks kinda gross

        if ($this->filter == 'all') {
            if ($this->page != 1) {
                // TRANS: Page title for user directory. %d is a page number.
                return(sprintf(_m('User Directory, page %d'), $this->page));
            }
            // TRANS: Page title for user directory.
            return _m('User directory');
        } elseif ($this->page == 1) {
            return sprintf(
                // TRANS: Page title for user directory. %s is the applied filter.
                _m('User directory - %s'),
                strtoupper($this->filter)
            );
        } else {
            return sprintf(
                // TRANS: Page title for user directory.
                // TRANS: %1$s is the applied filter, %2$d is a page number.
                _m('User directory - %1$s, page %2$d'),
                strtoupper($this->filter),
                $this->page
            );
        }
    }

    /**
     * Instructions for use
     *
     * @return instructions for use
     */
    public function getInstructions()
    {
        // TRANS: %%site.name%% is the name of the StatusNet site.
        return _m('Search for people on %%site.name%% by their name, '
                  . 'location, or interests. Separate the terms by spaces; '
                  . ' they must be 3 characters or more.');
    }

    /**
     * Is this page read-only?
     *
     * @return boolean true
     */
    public function isReadOnly($args)
    {
        return true;
    }

    protected function doPreparation()
    {
        $this->page    = ($this->arg('page')) ? ((int) $this->arg('page')) : 1;
        $this->filter  = $this->arg('filter', 'all');
        $this->reverse = $this->boolean('reverse');
        $this->q       = $this->trimmed('q');
        $this->sort    = $this->arg('sort', 'nickname');
        $this->count   = (int) $this->trimmed('count', (string) PROFILES_PER_PAGE);
    }

    /**
     * Show the page notice
     *
     * Shows instructions for the page
     *
     * @return void
     */
    public function showPageNotice()
    {
        $instr  = $this->getInstructions();
        $output = common_markup_to_html($instr);

        $this->elementStart('div', 'instructions');
        $this->raw($output);
        $this->elementEnd('div');
    }


    /**
     * Content area
     *
     * Shows the list of popular notices
     *
     * @return void
     */
    public function showContent()
    {
        $this->showForm();

        $this->elementStart('div', ['id' => 'profile_directory']);

        $alphaNav = new AlphaNav($this, false, false, ['0-9', 'All']);
        $alphaNav->show();

        $profile = null;
        $profile = $this->getUsers();
        $cnt     = 0;
        $args    = [];

        if (!empty($profile)) {
            $profileList = new SortableSubscriptionList(
                $profile,
                common_current_user(),
                $this
            );
            $cnt = $profileList->profile->N;
            $this->pagination(
                $this->page > 1,
                $cnt > $this->count,
                $this->page,
                'userdirectory',
                $args
            );
            $profileList->show($this->count);
            $profile->free();

            if (0 == $cnt) {
                $this->showEmptyListMessage();
            }
        }

        if (isset($this->q)) {
            $args['q'] = $this->q;
        } elseif (isset($this->filter) && $this->filter != 'all') {
            $args['filter'] = $this->filter;
        }
        
        if (isset($this->sort)) {
            $args['sort'] = $this->sort;
        }
        if (!empty($this->reverse)) {
            $args['reverse'] = $this->reverse;
        }

        $this->pagination(
            $this->page > 1,
            $cnt > $this->count,
            $this->page,
            'userdirectory',
            $args
        );

        $this->elementEnd('div');

        // JavaScript for checkbox
        $this->inlineScript(<<<'EOT'
/**
 * @param e - header checkbox input element Event
 */
function allChanged(e) {
    let boxes = document.getElementsByName('ids[]');
    for (let i = 0; i < boxes.length; ++i) {
        if (e.target.checked === true) {
            boxes[i].checked = true;
        } else {
            boxes[i].checked = false;
        }
    }
}
document.querySelector('thead input').addEventListener('click', allChanged);
EOT
        );
    }

    public function showForm($error=null): void
    {
        $this->elementStart('form',
                            ['method' => 'get',
                             'id'     => 'form_search',
                             'class'  => 'form_settings',
                             'action' => common_local_url('userdirectory')]);

        $this->elementStart('fieldset');

        // TRANS: Fieldset legend.
        $this->element('legend', null, _m('Search site'));
        $this->elementStart('ul', 'form_data');
        $this->elementStart('li');

        // TRANS: Field label for user directory filter.
        $this->input('q', _m('Keyword(s)'), $this->q);

        // TRANS: Button text.
        $this->submit('search', _m('BUTTON', 'Search'));
        $this->elementEnd('li');
        $this->elementEnd('ul');
        $this->elementEnd('fieldset');
        $this->elementEnd('form');
 
        // Bulk action.
        $this->elementStart('fieldset');
        // TRANS: Button text.
        // TODO: tag edit, form class.
        $choices = [
            '' => 'Bulk actions',
            'delete' => 'Delete',
            'subscribe' => 'Subscribe',
            'unsubscribe' => 'Unsubscribe'
        ];
        $this->dropdown('selected_action', '', $choices, '', false, '');
        $this->elementStart('button', ['id' => 'bulk']);
        $this->text('Bulk');
        $this->elementEnd('button');
        $this->inlineScript(<<<'EOT'
async function bulkApply(e) {
    let map = {
        'subscribe': {method: 'POST', path: '/api/friendships/create.json'},
        'unsubscribe': {method: 'POST', path: '/api/friendships/destroy.json'},
        'delete': {method: 'DELETE', path: '/api/account/delete.json'},
    };
    let choice = map[this.previousElementSibling.value];
    let boxes = document.querySelectorAll('input[name="ids[]"]:checked');
    for (let i = 0; i < boxes.length; ++i) {
        const response = await fetch(choice.path + '?user_id=' + boxes[i].value, {
            method: choice.method,
            headers: {'Content-Type': 'application/json'}
        });
    }
}
document.getElementById('bulk').addEventListener('click', bulkApply);
EOT);
        $this->elementEnd('fieldset');

        // Display count.
        $this->elementStart('form', [
            'action' => common_local_url('userdirectory')]);
        foreach(['page', 'count', 'sort', 'reverse'] as $e) {
            if (empty($this->args[$e])) {
                continue;
            }
            $this->hidden($e, $this->args[$e]);
        }

        // Number of items per page.
        $this->input('count', '', '', '', 'count', true, [
            'type' => 'number',
            'list' => 'countList',
            'placeholder' => 'Display count',
            'pattern' => '^[1-9][0-9]*',
        ]);
        $this->elementStart('datalist', ['id' => 'countList']);
        foreach ([20, 50, 100, 200, 500, 1000, 2000] as $e) {
            $this->elementStart('option', ['value' => $e]);
            $this->elementEnd('option');
        }
        $this->elementEnd('datalist');
        $this->submit('', _m('BUTTON', 'Apply'),);
        $this->elementEnd('form');
    }

    /*
     * Get users filtered by the current filter, sort key,
     * sort order, and page
     */
    public function getUsers()
    {
        $profile = new Profile();
        // Comment this out or disable to get global profile searches
        $profile->joinAdd(['id', 'user:id']);
        // Overflow for pagenation (max count + 1).
        $limit = $this->count + 1;
        $offset = ($this->page - 1) * $this->count;
        if (!empty($this->q)) {
            // User is searching via query
            $search_engine = $profile->getSearchEngine('profile');

            $mode = 'reverse_chron';

            if ($this->sort == 'nickname') {
                if ($this->reverse) {
                    $mode = 'nickname_desc';
                } else {
                    $mode = 'nickname_asc';
                }
            } else {
                if ($this->reverse) {
                    $mode = 'chron';
                }
            }

            $search_engine->set_sort_mode($mode);
            $search_engine->limit($offset, $limit);
            $search_engine->query($this->q);

            $profile->find();
        } else {
            // User is browsing via AlphaNav

            switch ($this->filter) {
            case 'all':
                // NOOP
                break;
            case '0-9':
                $profile->whereAdd(sprintf('LEFT(%1$s.%2$s, 1) BETWEEN %3$s AND %4$s',
                                           $profile->escapedTableName(),
                                           'nickname',
                                           $profile->_quote("0"),
                                           $profile->_quote("9")));
                break;
            default:
                $profile->whereAdd(sprintf('LEFT(LOWER(%1$s.%2$s), 1) = %3$s',
                                           $profile->escapedTableName(),
                                           'nickname',
                                           $profile->_quote($this->filter)));
            }

            $order = sprintf('%1$s.%2$s %3$s, %1$s.%4$s ASC',
                             $profile->escapedTableName(),
                             $this->getSortKey('nickname'),
                             $this->reverse ? 'DESC' : 'ASC',
                             'nickname');
            $profile->orderBy($order);
            $profile->limit($offset, $limit);
            $profile->find();
        }

        return $profile;
    }

    /**
     * Filter the sort parameter
     *
     * @return string   a column name for sorting
     */
    public function getSortKey($def='nickname')
    {
        switch ($this->sort) {
        case 'nickname':
        case 'created':
            return $this->sort;
        default:
            return 'nickname';
        }
    }

    /**
     * Show a nice message when there's no search results
     */
    public function showEmptyListMessage()
    {
        if (!empty($this->filter) && ($this->filter != 'all')) {
            $this->element('p',
                           'error',
                           sprintf(
                               // TRANS: Empty list message for user directory.
                               _m('No users starting with %s'),
                               $this->filter));
        } else {
            // TRANS: Empty list message for user directory.
            $this->element('p', 'error', _m('No results.'));
            // TRANS: Standard search suggestions shown when a search does not give any results.
            $message = _m("* Make sure all words are spelled correctly.
* Try different keywords.
* Try more general keywords.
* Try fewer keywords.");
            $message .= "\n";

            $this->elementStart('div', 'help instructions');
            $this->raw(common_markup_to_html($message));
            $this->elementEnd('div');
        }
    }
}