How to search user by email ?

xasharma

Hey guys,
How can I search a user by their mail on my forum ?

katos

xasharma Hi! At the moment, there is no search by mail built into the core of Flarum.
This is actually something that we've been discussing internally this afternoon, and there is an issue on core: flarum/core2988 to address changes to the user page to extend functionality such as this.

jordanjay29

katos xasharma There is a search gambit in the main search outside the admin panel:

email:useremail@provider.com will search for users with that email. Flarum Source

example of searching with this gambit on discuss, with my email which brings up my username

xasharma

Ok Thank you ... we will wait

katos

jordanjay29 I keep forgetting about that gambit…! Thanks Jordan!

Hari

jordanjay29 it would be nice if someone lists all flarum search tricks 👍

xasharma

jordanjay29

ohh Thank you very much

SKevo

Hari it would be nice if someone lists all flarum search tricks 👍

~~This should probably have it's own thread, or be at the docs:~~

Gambits

Discussions:

created:2021-06-26 (example) - filter discussions created at a specific date. This also supports a date range, which also includes posts made in the specified date range (e. g.: created:2023-08-14..2023-08-15 - thanks iPurpl3x)
is:hidden (example) - only all hidden discussions, works only if you have the permissions to view these discussions (obviously)
is:unread (example) - unread discussions only
author:username (example) - filter discussions made by user with a specific username

Extensions:

is:private(example) - search for private discussions (FoF Byobu)
is:sticky (example) - show only sticky discussions
is:locked (example) - show only locked discussions
is:following (example) - show only discussions that you follow
is:ignored (example) - show only discussions that you ignore. AFAIK this is currently the only way how to obtain these discussions, but I might be wrong
tag:name (example) - filter discussions by a specific tag (e. g.: `tag:support)

Users:

The following gambits only work in the search dropdown:

email:test@doge.gov - filter users by this E-mail address
group:founder (example) - filter users by specific group, matches both singular and plural group names
is:suspended - returns only suspended users

Multiple filters

Some gambits can be combined to narrow down search results (example: is:locked is:sticky will show locked and stickied discussions).

Negation:

To filter results NOT matching a specific query, prepend the gambit with dash (-). For example, to view all discussions on Discuss that are NOT locked and that weren't created within the 2017-01-01..2026-01-01 date range, and that have been marked as read: -is:locked -created:2017-01-01..2026-01-01 -is:unread

Sources:

~~getGambitPattern~~ GambitManager.ts
flarum/core1355 - revamp of the search API
flarum/framework3941 - PR for 2.x

jordanjay29

SKevo There is also one special gambit (noResult:anything), and I have no idea how it works. But I assume that it's some gambit for debugging search

It's in the test files, so yeah, it's basically a dummy gambit meant to test that they function.

Great compilation here SKevo! I'll note that other extensions create their own gambits, too, like Subscriptions creates* is:followed and Byobu creates is:private to filter their featured discussions out.

If you'd like to create a new discussion for this, I would move it to our Resources > FAQ tag for you. It's a pretty valuable resource to have for reference somewhere.

*ETA: Subscriptions actually creates is:following, is:ignoring, is:followed and is:ignored, it's quite graceful about your gambit selections.

SKevo

jordanjay29 yeah feel free to move it here, and thanks for clarification about other gambits too

Prosperous

SKevo Done. 😉