class UserdirectoryAction extends Action
{
/**
- * @var $page integer the page we're on
+ * 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
*/
- protected $page = null;
+ public $reverse;
/**
- * @var $filter string what to filter the search results by
+ * Query
+ *
+ * @var string
*/
- protected $filter = null;
+ public $q;
/**
* Title of the page
*/
function title()
{
- // @fixme: This looks kinda gross
+ // @todo fixme: This looks kinda gross
if ($this->filter == 'all') {
if ($this->page != 1) {
- return(sprintf(_m('All users, page %d'), $this->page));
+ // TRANS: Page title for user directory. %d is a page number.
+ return(sprintf(_m('User Directory, page %d'), $this->page));
}
- return _m('All users');
- }
-
- if ($this->page == 1) {
+ // TRANS: Page title for user directory.
+ return _m('User directory');
+ } else if ($this->page == 1) {
return sprintf(
- _m('Users with nicknames beginning with %s'),
- $this->filter
+ // TRANS: Page title for user directory. %s is the applied filter.
+ _m('User directory - %s'),
+ strtoupper($this->filter)
);
} else {
return sprintf(
- _m('Users with nicknames starting with %s, page %d'),
- $this->filter,
+ // 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
);
}
*/
function getInstructions()
{
- return _('User directory');
+ // 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.'
+ );
}
/**
*
* @return boolean true
*/
- function isReadOnly($args)
+ function isReadOnly(array $args=array())
{
return true;
}
* @param array $args $_REQUEST args
*
* @return boolean success flag
- *
- * @todo move queries from showContent() to here
*/
- function prepare($args)
+ function prepare(array $args=array())
{
parent::prepare($args);
- $this->page = ($this->arg('page')) ? ($this->arg('page') + 0) : 1;
- $filter = $this->arg('filter');
- $this->filter = isset($filter) ? $filter : 'all';
- $this->sort = $this->arg('sort');
- $this->order = $this->boolean('asc'); // ascending or decending
+ $this->page = ($this->arg('page')) ? ($this->arg('page') + 0) : 1;
+ $this->filter = $this->arg('filter', 'all');
+ $this->reverse = $this->boolean('reverse');
+ $this->q = $this->trimmed('q');
+ $this->sort = $this->arg('sort', 'nickname');
common_set_returnto($this->selfUrl());
*
* @return void
*/
- function handle($args)
+ function handle(array $args=array())
{
parent::handle($args);
$this->showPage();
$this->elementEnd('div');
}
- /**
- * Local navigation
- *
- * This page is part of the public group, so show that.
- *
- * @return void
- */
- function showLocalNav()
- {
- $nav = new PublicGroupNav($this);
- $nav->show();
- }
/**
* Content area
*/
function showContent()
{
- // XXX Need search bar
+ $this->showForm();
- $this->elementStart('div', array('id' => 'user_directory'));
+ $this->elementStart('div', array('id' => 'profile_directory'));
- $alphaNav = new AlphaNav($this, true, array('All'));
+ $alphaNav = new AlphaNav($this, false, false, array('0-9', 'All'));
$alphaNav->show();
- // XXX Maybe use a more specialized version of ProfileList here
-
+ $profile = null;
$profile = $this->getUsers();
$cnt = 0;
);
$cnt = $profileList->show();
+ $profile->free();
if (0 == $cnt) {
$this->showEmptyListMessage();
}
}
+ $args = array();
+ 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 > PROFILES_PER_PAGE,
$this->page,
'userdirectory',
- array('filter' => $this->filter)
+ $args
);
$this->elementEnd('div');
}
+ function showForm($error=null)
+ {
+ $this->elementStart(
+ 'form',
+ array(
+ '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');
+ }
+
/*
- * Get users filtered by the current filter and page
+ * Get users filtered by the current filter, sort key,
+ * sort order, and page
*/
function getUsers()
{
-
$profile = new Profile();
$offset = ($this->page - 1) * PROFILES_PER_PAGE;
$limit = PROFILES_PER_PAGE + 1;
- $sort = $this->getSortKey();
- $sql = 'SELECT profile.* FROM profile, user WHERE profile.id = user.id';
- if ($this->filter != 'all') {
+ if (isset($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
+ $sort = $this->getSortKey();
+ $sql = 'SELECT profile.* FROM profile, user WHERE profile.id = user.id';
+
+ switch($this->filter)
+ {
+ case 'all':
+ // NOOP
+ break;
+ case '0-9':
+ $sql .=
+ ' AND LEFT(profile.nickname, 1) BETWEEN \'0\' AND \'9\'';
+ break;
+ default:
+ $sql .= sprintf(
+ ' AND LEFT(LOWER(profile.nickname), 1) = \'%s\'',
+ $this->filter
+ );
+ }
+
$sql .= sprintf(
- ' AND LEFT(LOWER(profile.nickname), 1) = \'%s\'',
- $this->filter
+ ' ORDER BY profile.%s %s, profile.nickname ASC LIMIT %d, %d',
+ $sort,
+ $this->reverse ? 'DESC' : 'ASC',
+ $offset,
+ $limit
);
- }
- $sql .= sprintf(
- ' ORDER BY profile.%s %s, profile.nickname DESC LIMIT %d, %d',
- $sort,
- ($this->order) ? 'ASC' : 'DESC',
- $offset,
- $limit
- );
-
- $profile->query($sql);
+ $profile->query($sql);
+ }
return $profile;
}
*/
function showEmptyListMessage()
{
- $message = sprintf(_m('No users starting with %s'), $this->filter);
-
- $this->elementStart('div', 'guide');
- $this->raw(common_markup_to_html($message));
- $this->elementEnd('div');
+ 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');
+ }
}
-
}