1 # Pleroma: A lightweight social networking server
2 # Copyright © 2017-2020 Pleroma Authors <https://pleroma.social/>
3 # SPDX-License-Identifier: AGPL-3.0-only
5 defmodule Pleroma.User do
10 import Ecto, only: [assoc: 2]
13 alias Pleroma.Activity
15 alias Pleroma.Conversation.Participation
16 alias Pleroma.Delivery
17 alias Pleroma.EctoType.ActivityPub.ObjectValidators
19 alias Pleroma.FollowingRelationship
20 alias Pleroma.Formatter
24 alias Pleroma.Notification
26 alias Pleroma.Registration
29 alias Pleroma.UserRelationship
31 alias Pleroma.Web.ActivityPub.ActivityPub
32 alias Pleroma.Web.ActivityPub.Builder
33 alias Pleroma.Web.ActivityPub.Pipeline
34 alias Pleroma.Web.ActivityPub.Utils
35 alias Pleroma.Web.CommonAPI
36 alias Pleroma.Web.CommonAPI.Utils, as: CommonUtils
37 alias Pleroma.Web.OAuth
38 alias Pleroma.Web.RelMe
39 alias Pleroma.Workers.BackgroundWorker
43 @type t :: %__MODULE__{}
44 @type account_status ::
47 | :password_reset_pending
48 | :confirmation_pending
50 @primary_key {:id, FlakeId.Ecto.CompatType, autogenerate: true}
52 # credo:disable-for-next-line Credo.Check.Readability.MaxLineLength
53 @email_regex ~r/^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/
55 @strict_local_nickname_regex ~r/^[a-zA-Z\d]+$/
56 @extended_local_nickname_regex ~r/^[a-zA-Z\d_-]+$/
58 # AP ID user relationships (blocks, mutes etc.)
59 # Format: [rel_type: [outgoing_rel: :outgoing_rel_target, incoming_rel: :incoming_rel_source]]
60 @user_relationships_config [
62 blocker_blocks: :blocked_users,
63 blockee_blocks: :blocker_users
66 muter_mutes: :muted_users,
67 mutee_mutes: :muter_users
70 reblog_muter_mutes: :reblog_muted_users,
71 reblog_mutee_mutes: :reblog_muter_users
74 notification_muter_mutes: :notification_muted_users,
75 notification_mutee_mutes: :notification_muter_users
77 # Note: `inverse_subscription` relationship is inverse: subscriber acts as relationship target
78 inverse_subscription: [
79 subscribee_subscriptions: :subscriber_users,
80 subscriber_subscriptions: :subscribee_users
84 @cachex Pleroma.Config.get([:cachex, :provider], Cachex)
87 field(:bio, :string, default: "")
88 field(:raw_bio, :string)
89 field(:email, :string)
91 field(:nickname, :string)
92 field(:password_hash, :string)
93 field(:password, :string, virtual: true)
94 field(:password_confirmation, :string, virtual: true)
96 field(:public_key, :string)
97 field(:ap_id, :string)
98 field(:avatar, :map, default: %{})
99 field(:local, :boolean, default: true)
100 field(:follower_address, :string)
101 field(:following_address, :string)
102 field(:search_rank, :float, virtual: true)
103 field(:search_type, :integer, virtual: true)
104 field(:tags, {:array, :string}, default: [])
105 field(:last_refreshed_at, :naive_datetime_usec)
106 field(:last_digest_emailed_at, :naive_datetime)
107 field(:banner, :map, default: %{})
108 field(:background, :map, default: %{})
109 field(:note_count, :integer, default: 0)
110 field(:follower_count, :integer, default: 0)
111 field(:following_count, :integer, default: 0)
112 field(:is_locked, :boolean, default: false)
113 field(:confirmation_pending, :boolean, default: false)
114 field(:password_reset_pending, :boolean, default: false)
115 field(:approval_pending, :boolean, default: false)
116 field(:registration_reason, :string, default: nil)
117 field(:confirmation_token, :string, default: nil)
118 field(:default_scope, :string, default: "public")
119 field(:domain_blocks, {:array, :string}, default: [])
120 field(:deactivated, :boolean, default: false)
121 field(:no_rich_text, :boolean, default: false)
122 field(:ap_enabled, :boolean, default: false)
123 field(:is_moderator, :boolean, default: false)
124 field(:is_admin, :boolean, default: false)
125 field(:show_role, :boolean, default: true)
126 field(:mastofe_settings, :map, default: nil)
127 field(:uri, ObjectValidators.Uri, default: nil)
128 field(:hide_followers_count, :boolean, default: false)
129 field(:hide_follows_count, :boolean, default: false)
130 field(:hide_followers, :boolean, default: false)
131 field(:hide_follows, :boolean, default: false)
132 field(:hide_favorites, :boolean, default: true)
133 field(:pinned_activities, {:array, :string}, default: [])
134 field(:email_notifications, :map, default: %{"digest" => false})
135 field(:mascot, :map, default: nil)
136 field(:emoji, :map, default: %{})
137 field(:pleroma_settings_store, :map, default: %{})
138 field(:fields, {:array, :map}, default: [])
139 field(:raw_fields, {:array, :map}, default: [])
140 field(:is_discoverable, :boolean, default: false)
141 field(:invisible, :boolean, default: false)
142 field(:allow_following_move, :boolean, default: true)
143 field(:skip_thread_containment, :boolean, default: false)
144 field(:actor_type, :string, default: "Person")
145 field(:also_known_as, {:array, :string}, default: [])
146 field(:inbox, :string)
147 field(:shared_inbox, :string)
148 field(:accepts_chat_messages, :boolean, default: nil)
151 :notification_settings,
152 Pleroma.User.NotificationSetting,
156 has_many(:notifications, Notification)
157 has_many(:registrations, Registration)
158 has_many(:deliveries, Delivery)
160 has_many(:outgoing_relationships, UserRelationship, foreign_key: :source_id)
161 has_many(:incoming_relationships, UserRelationship, foreign_key: :target_id)
163 for {relationship_type,
165 {outgoing_relation, outgoing_relation_target},
166 {incoming_relation, incoming_relation_source}
167 ]} <- @user_relationships_config do
168 # Definitions of `has_many` relations: :blocker_blocks, :muter_mutes, :reblog_muter_mutes,
169 # :notification_muter_mutes, :subscribee_subscriptions
170 has_many(outgoing_relation, UserRelationship,
171 foreign_key: :source_id,
172 where: [relationship_type: relationship_type]
175 # Definitions of `has_many` relations: :blockee_blocks, :mutee_mutes, :reblog_mutee_mutes,
176 # :notification_mutee_mutes, :subscriber_subscriptions
177 has_many(incoming_relation, UserRelationship,
178 foreign_key: :target_id,
179 where: [relationship_type: relationship_type]
182 # Definitions of `has_many` relations: :blocked_users, :muted_users, :reblog_muted_users,
183 # :notification_muted_users, :subscriber_users
184 has_many(outgoing_relation_target, through: [outgoing_relation, :target])
186 # Definitions of `has_many` relations: :blocker_users, :muter_users, :reblog_muter_users,
187 # :notification_muter_users, :subscribee_users
188 has_many(incoming_relation_source, through: [incoming_relation, :source])
191 # `:blocks` is deprecated (replaced with `blocked_users` relation)
192 field(:blocks, {:array, :string}, default: [])
193 # `:mutes` is deprecated (replaced with `muted_users` relation)
194 field(:mutes, {:array, :string}, default: [])
195 # `:muted_reblogs` is deprecated (replaced with `reblog_muted_users` relation)
196 field(:muted_reblogs, {:array, :string}, default: [])
197 # `:muted_notifications` is deprecated (replaced with `notification_muted_users` relation)
198 field(:muted_notifications, {:array, :string}, default: [])
199 # `:subscribers` is deprecated (replaced with `subscriber_users` relation)
200 field(:subscribers, {:array, :string}, default: [])
203 :multi_factor_authentication_settings,
211 for {_relationship_type, [{_outgoing_relation, outgoing_relation_target}, _]} <-
212 @user_relationships_config do
213 # `def blocked_users_relation/2`, `def muted_users_relation/2`,
214 # `def reblog_muted_users_relation/2`, `def notification_muted_users/2`,
215 # `def subscriber_users/2`
216 def unquote(:"#{outgoing_relation_target}_relation")(user, restrict_deactivated? \\ false) do
217 target_users_query = assoc(user, unquote(outgoing_relation_target))
219 if restrict_deactivated? do
220 restrict_deactivated(target_users_query)
226 # `def blocked_users/2`, `def muted_users/2`, `def reblog_muted_users/2`,
227 # `def notification_muted_users/2`, `def subscriber_users/2`
228 def unquote(outgoing_relation_target)(user, restrict_deactivated? \\ false) do
230 |> apply(unquote(:"#{outgoing_relation_target}_relation"), [
232 restrict_deactivated?
237 # `def blocked_users_ap_ids/2`, `def muted_users_ap_ids/2`, `def reblog_muted_users_ap_ids/2`,
238 # `def notification_muted_users_ap_ids/2`, `def subscriber_users_ap_ids/2`
239 def unquote(:"#{outgoing_relation_target}_ap_ids")(user, restrict_deactivated? \\ false) do
241 |> apply(unquote(:"#{outgoing_relation_target}_relation"), [
243 restrict_deactivated?
245 |> select([u], u.ap_id)
250 def cached_blocked_users_ap_ids(user) do
251 @cachex.fetch!(:user_cache, "blocked_users_ap_ids:#{user.ap_id}", fn _ ->
252 blocked_users_ap_ids(user)
256 def cached_muted_users_ap_ids(user) do
257 @cachex.fetch!(:user_cache, "muted_users_ap_ids:#{user.ap_id}", fn _ ->
258 muted_users_ap_ids(user)
262 defdelegate following_count(user), to: FollowingRelationship
263 defdelegate following(user), to: FollowingRelationship
264 defdelegate following?(follower, followed), to: FollowingRelationship
265 defdelegate following_ap_ids(user), to: FollowingRelationship
266 defdelegate get_follow_requests(user), to: FollowingRelationship
267 defdelegate search(query, opts \\ []), to: User.Search
270 Dumps Flake Id to SQL-compatible format (16-byte UUID).
271 E.g. "9pQtDGXuq4p3VlcJEm" -> <<0, 0, 1, 110, 179, 218, 42, 92, 213, 41, 44, 227, 95, 213, 0, 0>>
273 def binary_id(source_id) when is_binary(source_id) do
274 with {:ok, dumped_id} <- FlakeId.Ecto.CompatType.dump(source_id) do
281 def binary_id(source_ids) when is_list(source_ids) do
282 Enum.map(source_ids, &binary_id/1)
285 def binary_id(%User{} = user), do: binary_id(user.id)
287 @doc "Returns status account"
288 @spec account_status(User.t()) :: account_status()
289 def account_status(%User{deactivated: true}), do: :deactivated
290 def account_status(%User{password_reset_pending: true}), do: :password_reset_pending
291 def account_status(%User{local: true, approval_pending: true}), do: :approval_pending
293 def account_status(%User{local: true, confirmation_pending: true}) do
294 if Config.get([:instance, :account_activation_required]) do
295 :confirmation_pending
301 def account_status(%User{}), do: :active
303 @spec visible_for(User.t(), User.t() | nil) ::
306 | :restricted_unauthenticated
308 | :confirmation_pending
309 def visible_for(user, for_user \\ nil)
311 def visible_for(%User{invisible: true}, _), do: :invisible
313 def visible_for(%User{id: user_id}, %User{id: user_id}), do: :visible
315 def visible_for(%User{} = user, nil) do
316 if restrict_unauthenticated?(user) do
317 :restrict_unauthenticated
319 visible_account_status(user)
323 def visible_for(%User{} = user, for_user) do
324 if superuser?(for_user) do
327 visible_account_status(user)
331 def visible_for(_, _), do: :invisible
333 defp restrict_unauthenticated?(%User{local: true}) do
334 Config.restrict_unauthenticated_access?(:profiles, :local)
337 defp restrict_unauthenticated?(%User{local: _}) do
338 Config.restrict_unauthenticated_access?(:profiles, :remote)
341 defp visible_account_status(user) do
342 status = account_status(user)
344 if status in [:active, :password_reset_pending] do
351 @spec superuser?(User.t()) :: boolean()
352 def superuser?(%User{local: true, is_admin: true}), do: true
353 def superuser?(%User{local: true, is_moderator: true}), do: true
354 def superuser?(_), do: false
356 @spec invisible?(User.t()) :: boolean()
357 def invisible?(%User{invisible: true}), do: true
358 def invisible?(_), do: false
360 def avatar_url(user, options \\ []) do
362 %{"url" => [%{"href" => href} | _]} ->
366 unless options[:no_default] do
367 Config.get([:assets, :default_user_avatar], "#{Web.base_url()}/images/avi.png")
372 def banner_url(user, options \\ []) do
374 %{"url" => [%{"href" => href} | _]} -> href
375 _ -> !options[:no_default] && "#{Web.base_url()}/images/banner.png"
379 # Should probably be renamed or removed
380 def ap_id(%User{nickname: nickname}), do: "#{Web.base_url()}/users/#{nickname}"
382 def ap_followers(%User{follower_address: fa}) when is_binary(fa), do: fa
383 def ap_followers(%User{} = user), do: "#{ap_id(user)}/followers"
385 @spec ap_following(User.t()) :: String.t()
386 def ap_following(%User{following_address: fa}) when is_binary(fa), do: fa
387 def ap_following(%User{} = user), do: "#{ap_id(user)}/following"
389 @spec restrict_deactivated(Ecto.Query.t()) :: Ecto.Query.t()
390 def restrict_deactivated(query) do
391 from(u in query, where: u.deactivated != ^true)
394 defp truncate_fields_param(params) do
395 if Map.has_key?(params, :fields) do
396 Map.put(params, :fields, Enum.map(params[:fields], &truncate_field/1))
402 defp truncate_if_exists(params, key, max_length) do
403 if Map.has_key?(params, key) and is_binary(params[key]) do
404 {value, _chopped} = String.split_at(params[key], max_length)
405 Map.put(params, key, value)
411 defp fix_follower_address(%{follower_address: _, following_address: _} = params), do: params
413 defp fix_follower_address(%{nickname: nickname} = params),
414 do: Map.put(params, :follower_address, ap_followers(%User{nickname: nickname}))
416 defp fix_follower_address(params), do: params
418 def remote_user_changeset(struct \\ %User{local: false}, params) do
419 bio_limit = Config.get([:instance, :user_bio_length], 5000)
420 name_limit = Config.get([:instance, :user_name_length], 100)
423 case params[:name] do
424 name when is_binary(name) and byte_size(name) > 0 -> name
425 _ -> params[:nickname]
430 |> Map.put(:name, name)
431 |> Map.put_new(:last_refreshed_at, NaiveDateTime.utc_now())
432 |> truncate_if_exists(:name, name_limit)
433 |> truncate_if_exists(:bio, bio_limit)
434 |> truncate_fields_param()
435 |> fix_follower_address()
458 :hide_followers_count,
467 :accepts_chat_messages
470 |> cast(params, [:name], empty_values: [])
471 |> validate_required([:ap_id])
472 |> validate_required([:name], trim: false)
473 |> unique_constraint(:nickname)
474 |> validate_format(:nickname, @email_regex)
475 |> validate_length(:bio, max: bio_limit)
476 |> validate_length(:name, max: name_limit)
477 |> validate_fields(true)
478 |> validate_non_local()
481 defp validate_non_local(cng) do
482 local? = get_field(cng, :local)
486 |> add_error(:local, "User is local, can't update with this changeset.")
492 def update_changeset(struct, params \\ %{}) do
493 bio_limit = Config.get([:instance, :user_bio_length], 5000)
494 name_limit = Config.get([:instance, :user_name_length], 100)
514 :hide_followers_count,
517 :allow_following_move,
520 :skip_thread_containment,
523 :pleroma_settings_store,
527 :accepts_chat_messages
530 |> unique_constraint(:nickname)
531 |> validate_format(:nickname, local_nickname_regex())
532 |> validate_length(:bio, max: bio_limit)
533 |> validate_length(:name, min: 1, max: name_limit)
534 |> validate_inclusion(:actor_type, ["Person", "Service"])
537 |> put_change_if_present(:bio, &{:ok, parse_bio(&1, struct)})
538 |> put_change_if_present(:avatar, &put_upload(&1, :avatar))
539 |> put_change_if_present(:banner, &put_upload(&1, :banner))
540 |> put_change_if_present(:background, &put_upload(&1, :background))
541 |> put_change_if_present(
542 :pleroma_settings_store,
543 &{:ok, Map.merge(struct.pleroma_settings_store, &1)}
545 |> validate_fields(false)
548 defp put_fields(changeset) do
549 if raw_fields = get_change(changeset, :raw_fields) do
552 |> Enum.filter(fn %{"name" => n} -> n != "" end)
556 |> Enum.map(fn f -> Map.update!(f, "value", &parse_fields(&1)) end)
559 |> put_change(:raw_fields, raw_fields)
560 |> put_change(:fields, fields)
566 defp parse_fields(value) do
568 |> Formatter.linkify(mentions_format: :full)
572 defp put_emoji(changeset) do
573 emojified_fields = [:bio, :name, :raw_fields]
575 if Enum.any?(changeset.changes, fn {k, _} -> k in emojified_fields end) do
576 bio = Emoji.Formatter.get_emoji_map(get_field(changeset, :bio))
577 name = Emoji.Formatter.get_emoji_map(get_field(changeset, :name))
579 emoji = Map.merge(bio, name)
583 |> get_field(:raw_fields)
584 |> Enum.reduce(emoji, fn x, acc ->
585 Map.merge(acc, Emoji.Formatter.get_emoji_map(x["name"] <> x["value"]))
588 put_change(changeset, :emoji, emoji)
594 defp put_change_if_present(changeset, map_field, value_function) do
595 with {:ok, value} <- fetch_change(changeset, map_field),
596 {:ok, new_value} <- value_function.(value) do
597 put_change(changeset, map_field, new_value)
603 defp put_upload(value, type) do
604 with %Plug.Upload{} <- value,
605 {:ok, object} <- ActivityPub.upload(value, type: type) do
610 def update_as_admin_changeset(struct, params) do
612 |> update_changeset(params)
613 |> cast(params, [:email])
614 |> delete_change(:also_known_as)
615 |> unique_constraint(:email)
616 |> validate_format(:email, @email_regex)
617 |> validate_inclusion(:actor_type, ["Person", "Service"])
620 @spec update_as_admin(User.t(), map()) :: {:ok, User.t()} | {:error, Changeset.t()}
621 def update_as_admin(user, params) do
622 params = Map.put(params, "password_confirmation", params["password"])
623 changeset = update_as_admin_changeset(user, params)
625 if params["password"] do
626 reset_password(user, changeset, params)
628 User.update_and_set_cache(changeset)
632 def password_update_changeset(struct, params) do
634 |> cast(params, [:password, :password_confirmation])
635 |> validate_required([:password, :password_confirmation])
636 |> validate_confirmation(:password)
637 |> put_password_hash()
638 |> put_change(:password_reset_pending, false)
641 @spec reset_password(User.t(), map()) :: {:ok, User.t()} | {:error, Changeset.t()}
642 def reset_password(%User{} = user, params) do
643 reset_password(user, user, params)
646 def reset_password(%User{id: user_id} = user, struct, params) do
649 |> Multi.update(:user, password_update_changeset(struct, params))
650 |> Multi.delete_all(:tokens, OAuth.Token.Query.get_by_user(user_id))
651 |> Multi.delete_all(:auth, OAuth.Authorization.delete_by_user_query(user))
653 case Repo.transaction(multi) do
654 {:ok, %{user: user} = _} -> set_cache(user)
655 {:error, _, changeset, _} -> {:error, changeset}
659 def update_password_reset_pending(user, value) do
662 |> put_change(:password_reset_pending, value)
663 |> update_and_set_cache()
666 def force_password_reset_async(user) do
667 BackgroundWorker.enqueue("force_password_reset", %{"user_id" => user.id})
670 @spec force_password_reset(User.t()) :: {:ok, User.t()} | {:error, Ecto.Changeset.t()}
671 def force_password_reset(user), do: update_password_reset_pending(user, true)
673 # Used to auto-register LDAP accounts which won't have a password hash stored locally
674 def register_changeset_ldap(struct, params = %{password: password})
675 when is_nil(password) do
676 params = Map.put_new(params, :accepts_chat_messages, true)
679 if Map.has_key?(params, :email) do
680 Map.put_new(params, :email, params[:email])
690 :accepts_chat_messages
692 |> validate_required([:name, :nickname])
693 |> unique_constraint(:nickname)
694 |> validate_exclusion(:nickname, Config.get([User, :restricted_nicknames]))
695 |> validate_format(:nickname, local_nickname_regex())
697 |> unique_constraint(:ap_id)
698 |> put_following_and_follower_address()
701 def register_changeset(struct, params \\ %{}, opts \\ []) do
702 bio_limit = Config.get([:instance, :user_bio_length], 5000)
703 name_limit = Config.get([:instance, :user_name_length], 100)
704 reason_limit = Config.get([:instance, :registration_reason_length], 500)
705 params = Map.put_new(params, :accepts_chat_messages, true)
708 if is_nil(opts[:need_confirmation]) do
709 Config.get([:instance, :account_activation_required])
711 opts[:need_confirmation]
715 if is_nil(opts[:need_approval]) do
716 Config.get([:instance, :account_approval_required])
722 |> confirmation_changeset(need_confirmation: need_confirmation?)
723 |> approval_changeset(need_approval: need_approval?)
731 :password_confirmation,
733 :accepts_chat_messages,
736 |> validate_required([:name, :nickname, :password, :password_confirmation])
737 |> validate_confirmation(:password)
738 |> unique_constraint(:email)
739 |> validate_format(:email, @email_regex)
740 |> validate_change(:email, fn :email, email ->
742 Config.get([User, :email_blacklist])
743 |> Enum.all?(fn blacklisted_domain ->
744 !String.ends_with?(email, ["@" <> blacklisted_domain, "." <> blacklisted_domain])
747 if valid?, do: [], else: [email: "Invalid email"]
749 |> unique_constraint(:nickname)
750 |> validate_exclusion(:nickname, Config.get([User, :restricted_nicknames]))
751 |> validate_format(:nickname, local_nickname_regex())
752 |> validate_length(:bio, max: bio_limit)
753 |> validate_length(:name, min: 1, max: name_limit)
754 |> validate_length(:registration_reason, max: reason_limit)
755 |> maybe_validate_required_email(opts[:external])
758 |> unique_constraint(:ap_id)
759 |> put_following_and_follower_address()
762 def maybe_validate_required_email(changeset, true), do: changeset
764 def maybe_validate_required_email(changeset, _) do
765 if Config.get([:instance, :account_activation_required]) do
766 validate_required(changeset, [:email])
772 defp put_ap_id(changeset) do
773 ap_id = ap_id(%User{nickname: get_field(changeset, :nickname)})
774 put_change(changeset, :ap_id, ap_id)
777 defp put_following_and_follower_address(changeset) do
778 followers = ap_followers(%User{nickname: get_field(changeset, :nickname)})
781 |> put_change(:follower_address, followers)
784 defp autofollow_users(user) do
785 candidates = Config.get([:instance, :autofollowed_nicknames])
788 User.Query.build(%{nickname: candidates, local: true, deactivated: false})
791 follow_all(user, autofollowed_users)
794 defp autofollowing_users(user) do
795 candidates = Config.get([:instance, :autofollowing_nicknames])
797 User.Query.build(%{nickname: candidates, local: true, deactivated: false})
799 |> Enum.each(&follow(&1, user, :follow_accept))
804 @doc "Inserts provided changeset, performs post-registration actions (confirmation email sending etc.)"
805 def register(%Ecto.Changeset{} = changeset) do
806 with {:ok, user} <- Repo.insert(changeset) do
807 post_register_action(user)
811 def post_register_action(%User{} = user) do
812 with {:ok, user} <- autofollow_users(user),
813 {:ok, _} <- autofollowing_users(user),
814 {:ok, user} <- set_cache(user),
815 {:ok, _} <- send_welcome_email(user),
816 {:ok, _} <- send_welcome_message(user),
817 {:ok, _} <- send_welcome_chat_message(user),
818 {:ok, _} <- try_send_confirmation_email(user) do
823 def send_welcome_message(user) do
824 if User.WelcomeMessage.enabled?() do
825 User.WelcomeMessage.post_message(user)
832 def send_welcome_chat_message(user) do
833 if User.WelcomeChatMessage.enabled?() do
834 User.WelcomeChatMessage.post_message(user)
841 def send_welcome_email(%User{email: email} = user) when is_binary(email) do
842 if User.WelcomeEmail.enabled?() do
843 User.WelcomeEmail.send_email(user)
850 def send_welcome_email(_), do: {:ok, :noop}
852 @spec try_send_confirmation_email(User.t()) :: {:ok, :enqueued | :noop}
853 def try_send_confirmation_email(%User{confirmation_pending: true, email: email} = user)
854 when is_binary(email) do
855 if Config.get([:instance, :account_activation_required]) do
856 send_confirmation_email(user)
863 def try_send_confirmation_email(_), do: {:ok, :noop}
865 @spec send_confirmation_email(Uset.t()) :: User.t()
866 def send_confirmation_email(%User{} = user) do
868 |> Pleroma.Emails.UserEmail.account_confirmation_email()
869 |> Pleroma.Emails.Mailer.deliver_async()
874 def needs_update?(%User{local: true}), do: false
876 def needs_update?(%User{local: false, last_refreshed_at: nil}), do: true
878 def needs_update?(%User{local: false} = user) do
879 NaiveDateTime.diff(NaiveDateTime.utc_now(), user.last_refreshed_at) >= 86_400
882 def needs_update?(_), do: true
884 @spec maybe_direct_follow(User.t(), User.t()) :: {:ok, User.t()} | {:error, String.t()}
886 # "Locked" (self-locked) users demand explicit authorization of follow requests
887 def maybe_direct_follow(%User{} = follower, %User{local: true, is_locked: true} = followed) do
888 follow(follower, followed, :follow_pending)
891 def maybe_direct_follow(%User{} = follower, %User{local: true} = followed) do
892 follow(follower, followed)
895 def maybe_direct_follow(%User{} = follower, %User{} = followed) do
896 if not ap_enabled?(followed) do
897 follow(follower, followed)
899 {:ok, follower, followed}
903 @doc "A mass follow for local users. Respects blocks in both directions but does not create activities."
904 @spec follow_all(User.t(), list(User.t())) :: {atom(), User.t()}
905 def follow_all(follower, followeds) do
907 |> Enum.reject(fn followed -> blocks?(follower, followed) || blocks?(followed, follower) end)
908 |> Enum.each(&follow(follower, &1, :follow_accept))
913 def follow(%User{} = follower, %User{} = followed, state \\ :follow_accept) do
914 deny_follow_blocked = Config.get([:user, :deny_follow_blocked])
917 followed.deactivated ->
918 {:error, "Could not follow user: #{followed.nickname} is deactivated."}
920 deny_follow_blocked and blocks?(followed, follower) ->
921 {:error, "Could not follow user: #{followed.nickname} blocked you."}
924 FollowingRelationship.follow(follower, followed, state)
928 def unfollow(%User{ap_id: ap_id}, %User{ap_id: ap_id}) do
929 {:error, "Not subscribed!"}
932 @spec unfollow(User.t(), User.t()) :: {:ok, User.t(), Activity.t()} | {:error, String.t()}
933 def unfollow(%User{} = follower, %User{} = followed) do
934 case do_unfollow(follower, followed) do
935 {:ok, follower, followed} ->
936 {:ok, follower, Utils.fetch_latest_follow(follower, followed)}
943 @spec do_unfollow(User.t(), User.t()) :: {:ok, User.t(), User.t()} | {:error, String.t()}
944 defp do_unfollow(%User{} = follower, %User{} = followed) do
945 case get_follow_state(follower, followed) do
946 state when state in [:follow_pending, :follow_accept] ->
947 FollowingRelationship.unfollow(follower, followed)
950 {:error, "Not subscribed!"}
954 @doc "Returns follow state as Pleroma.FollowingRelationship.State value"
955 def get_follow_state(%User{} = follower, %User{} = following) do
956 following_relationship = FollowingRelationship.get(follower, following)
957 get_follow_state(follower, following, following_relationship)
960 def get_follow_state(
963 following_relationship
965 case {following_relationship, following.local} do
967 case Utils.fetch_latest_follow(follower, following) do
968 %Activity{data: %{"state" => state}} when state in ["pending", "accept"] ->
969 FollowingRelationship.state_to_enum(state)
975 {%{state: state}, _} ->
983 def locked?(%User{} = user) do
984 user.is_locked || false
988 Repo.get_by(User, id: id)
991 def get_by_ap_id(ap_id) do
992 Repo.get_by(User, ap_id: ap_id)
995 def get_all_by_ap_id(ap_ids) do
996 from(u in __MODULE__,
997 where: u.ap_id in ^ap_ids
1002 def get_all_by_ids(ids) do
1003 from(u in __MODULE__, where: u.id in ^ids)
1007 # This is mostly an SPC migration fix. This guesses the user nickname by taking the last part
1008 # of the ap_id and the domain and tries to get that user
1009 def get_by_guessed_nickname(ap_id) do
1010 domain = URI.parse(ap_id).host
1011 name = List.last(String.split(ap_id, "/"))
1012 nickname = "#{name}@#{domain}"
1014 get_cached_by_nickname(nickname)
1017 def set_cache({:ok, user}), do: set_cache(user)
1018 def set_cache({:error, err}), do: {:error, err}
1020 def set_cache(%User{} = user) do
1021 @cachex.put(:user_cache, "ap_id:#{user.ap_id}", user)
1022 @cachex.put(:user_cache, "nickname:#{user.nickname}", user)
1023 @cachex.put(:user_cache, "friends_ap_ids:#{user.nickname}", get_user_friends_ap_ids(user))
1027 def update_and_set_cache(struct, params) do
1029 |> update_changeset(params)
1030 |> update_and_set_cache()
1033 def update_and_set_cache(changeset) do
1034 with {:ok, user} <- Repo.update(changeset, stale_error_field: :id) do
1039 def get_user_friends_ap_ids(user) do
1040 from(u in User.get_friends_query(user), select: u.ap_id)
1044 @spec get_cached_user_friends_ap_ids(User.t()) :: [String.t()]
1045 def get_cached_user_friends_ap_ids(user) do
1046 @cachex.fetch!(:user_cache, "friends_ap_ids:#{user.ap_id}", fn _ ->
1047 get_user_friends_ap_ids(user)
1051 def invalidate_cache(user) do
1052 @cachex.del(:user_cache, "ap_id:#{user.ap_id}")
1053 @cachex.del(:user_cache, "nickname:#{user.nickname}")
1054 @cachex.del(:user_cache, "friends_ap_ids:#{user.ap_id}")
1055 @cachex.del(:user_cache, "blocked_users_ap_ids:#{user.ap_id}")
1056 @cachex.del(:user_cache, "muted_users_ap_ids:#{user.ap_id}")
1059 @spec get_cached_by_ap_id(String.t()) :: User.t() | nil
1060 def get_cached_by_ap_id(ap_id) do
1061 key = "ap_id:#{ap_id}"
1063 with {:ok, nil} <- @cachex.get(:user_cache, key),
1064 user when not is_nil(user) <- get_by_ap_id(ap_id),
1065 {:ok, true} <- @cachex.put(:user_cache, key, user) do
1073 def get_cached_by_id(id) do
1077 @cachex.fetch!(:user_cache, key, fn _ ->
1078 user = get_by_id(id)
1081 @cachex.put(:user_cache, "ap_id:#{user.ap_id}", user)
1082 {:commit, user.ap_id}
1088 get_cached_by_ap_id(ap_id)
1091 def get_cached_by_nickname(nickname) do
1092 key = "nickname:#{nickname}"
1094 @cachex.fetch!(:user_cache, key, fn _ ->
1095 case get_or_fetch_by_nickname(nickname) do
1096 {:ok, user} -> {:commit, user}
1097 {:error, _error} -> {:ignore, nil}
1102 def get_cached_by_nickname_or_id(nickname_or_id, opts \\ []) do
1103 restrict_to_local = Config.get([:instance, :limit_to_local_content])
1106 is_integer(nickname_or_id) or FlakeId.flake_id?(nickname_or_id) ->
1107 get_cached_by_id(nickname_or_id) || get_cached_by_nickname(nickname_or_id)
1109 restrict_to_local == false or not String.contains?(nickname_or_id, "@") ->
1110 get_cached_by_nickname(nickname_or_id)
1112 restrict_to_local == :unauthenticated and match?(%User{}, opts[:for]) ->
1113 get_cached_by_nickname(nickname_or_id)
1120 @spec get_by_nickname(String.t()) :: User.t() | nil
1121 def get_by_nickname(nickname) do
1122 Repo.get_by(User, nickname: nickname) ||
1123 if Regex.match?(~r(@#{Pleroma.Web.Endpoint.host()})i, nickname) do
1124 Repo.get_by(User, nickname: local_nickname(nickname))
1128 def get_by_email(email), do: Repo.get_by(User, email: email)
1130 def get_by_nickname_or_email(nickname_or_email) do
1131 get_by_nickname(nickname_or_email) || get_by_email(nickname_or_email)
1134 def fetch_by_nickname(nickname), do: ActivityPub.make_user_from_nickname(nickname)
1136 def get_or_fetch_by_nickname(nickname) do
1137 with %User{} = user <- get_by_nickname(nickname) do
1141 with [_nick, _domain] <- String.split(nickname, "@"),
1142 {:ok, user} <- fetch_by_nickname(nickname) do
1145 _e -> {:error, "not found " <> nickname}
1150 @spec get_followers_query(User.t(), pos_integer() | nil) :: Ecto.Query.t()
1151 def get_followers_query(%User{} = user, nil) do
1152 User.Query.build(%{followers: user, deactivated: false})
1155 def get_followers_query(%User{} = user, page) do
1157 |> get_followers_query(nil)
1158 |> User.Query.paginate(page, 20)
1161 @spec get_followers_query(User.t()) :: Ecto.Query.t()
1162 def get_followers_query(%User{} = user), do: get_followers_query(user, nil)
1164 @spec get_followers(User.t(), pos_integer() | nil) :: {:ok, list(User.t())}
1165 def get_followers(%User{} = user, page \\ nil) do
1167 |> get_followers_query(page)
1171 @spec get_external_followers(User.t(), pos_integer() | nil) :: {:ok, list(User.t())}
1172 def get_external_followers(%User{} = user, page \\ nil) do
1174 |> get_followers_query(page)
1175 |> User.Query.build(%{external: true})
1179 def get_followers_ids(%User{} = user, page \\ nil) do
1181 |> get_followers_query(page)
1182 |> select([u], u.id)
1186 @spec get_friends_query(User.t(), pos_integer() | nil) :: Ecto.Query.t()
1187 def get_friends_query(%User{} = user, nil) do
1188 User.Query.build(%{friends: user, deactivated: false})
1191 def get_friends_query(%User{} = user, page) do
1193 |> get_friends_query(nil)
1194 |> User.Query.paginate(page, 20)
1197 @spec get_friends_query(User.t()) :: Ecto.Query.t()
1198 def get_friends_query(%User{} = user), do: get_friends_query(user, nil)
1200 def get_friends(%User{} = user, page \\ nil) do
1202 |> get_friends_query(page)
1206 def get_friends_ap_ids(%User{} = user) do
1208 |> get_friends_query(nil)
1209 |> select([u], u.ap_id)
1213 def get_friends_ids(%User{} = user, page \\ nil) do
1215 |> get_friends_query(page)
1216 |> select([u], u.id)
1220 def increase_note_count(%User{} = user) do
1222 |> where(id: ^user.id)
1223 |> update([u], inc: [note_count: 1])
1225 |> Repo.update_all([])
1227 {1, [user]} -> set_cache(user)
1232 def decrease_note_count(%User{} = user) do
1234 |> where(id: ^user.id)
1237 note_count: fragment("greatest(0, note_count - 1)")
1241 |> Repo.update_all([])
1243 {1, [user]} -> set_cache(user)
1248 def update_note_count(%User{} = user, note_count \\ nil) do
1253 where: fragment("?->>'actor' = ? and ?->>'type' = 'Note'", a.data, ^user.ap_id, a.data),
1259 |> cast(%{note_count: note_count}, [:note_count])
1260 |> update_and_set_cache()
1263 @spec maybe_fetch_follow_information(User.t()) :: User.t()
1264 def maybe_fetch_follow_information(user) do
1265 with {:ok, user} <- fetch_follow_information(user) do
1269 Logger.error("Follower/Following counter update for #{user.ap_id} failed.\n#{inspect(e)}")
1275 def fetch_follow_information(user) do
1276 with {:ok, info} <- ActivityPub.fetch_follow_information_for_user(user) do
1278 |> follow_information_changeset(info)
1279 |> update_and_set_cache()
1283 defp follow_information_changeset(user, params) do
1290 :hide_followers_count,
1295 @spec update_follower_count(User.t()) :: {:ok, User.t()}
1296 def update_follower_count(%User{} = user) do
1297 if user.local or !Config.get([:instance, :external_user_synchronization]) do
1298 follower_count = FollowingRelationship.follower_count(user)
1301 |> follow_information_changeset(%{follower_count: follower_count})
1302 |> update_and_set_cache
1304 {:ok, maybe_fetch_follow_information(user)}
1308 @spec update_following_count(User.t()) :: {:ok, User.t()}
1309 def update_following_count(%User{local: false} = user) do
1310 if Config.get([:instance, :external_user_synchronization]) do
1311 {:ok, maybe_fetch_follow_information(user)}
1317 def update_following_count(%User{local: true} = user) do
1318 following_count = FollowingRelationship.following_count(user)
1321 |> follow_information_changeset(%{following_count: following_count})
1322 |> update_and_set_cache()
1325 @spec get_users_from_set([String.t()], keyword()) :: [User.t()]
1326 def get_users_from_set(ap_ids, opts \\ []) do
1327 local_only = Keyword.get(opts, :local_only, true)
1328 criteria = %{ap_id: ap_ids, deactivated: false}
1329 criteria = if local_only, do: Map.put(criteria, :local, true), else: criteria
1331 User.Query.build(criteria)
1335 @spec get_recipients_from_activity(Activity.t()) :: [User.t()]
1336 def get_recipients_from_activity(%Activity{recipients: to, actor: actor}) do
1339 query = User.Query.build(%{recipients_from_activity: to, local: true, deactivated: false})
1345 @spec mute(User.t(), User.t(), map()) ::
1346 {:ok, list(UserRelationship.t())} | {:error, String.t()}
1347 def mute(%User{} = muter, %User{} = mutee, params \\ %{}) do
1348 notifications? = Map.get(params, :notifications, true)
1349 expires_in = Map.get(params, :expires_in, 0)
1351 with {:ok, user_mute} <- UserRelationship.create_mute(muter, mutee),
1352 {:ok, user_notification_mute} <-
1353 (notifications? && UserRelationship.create_notification_mute(muter, mutee)) ||
1355 if expires_in > 0 do
1356 Pleroma.Workers.MuteExpireWorker.enqueue(
1358 %{"muter_id" => muter.id, "mutee_id" => mutee.id},
1359 schedule_in: expires_in
1363 @cachex.del(:user_cache, "muted_users_ap_ids:#{muter.ap_id}")
1365 {:ok, Enum.filter([user_mute, user_notification_mute], & &1)}
1369 def unmute(%User{} = muter, %User{} = mutee) do
1370 with {:ok, user_mute} <- UserRelationship.delete_mute(muter, mutee),
1371 {:ok, user_notification_mute} <-
1372 UserRelationship.delete_notification_mute(muter, mutee) do
1373 @cachex.del(:user_cache, "muted_users_ap_ids:#{muter.ap_id}")
1374 {:ok, [user_mute, user_notification_mute]}
1378 def unmute(muter_id, mutee_id) do
1379 with {:muter, %User{} = muter} <- {:muter, User.get_by_id(muter_id)},
1380 {:mutee, %User{} = mutee} <- {:mutee, User.get_by_id(mutee_id)} do
1381 unmute(muter, mutee)
1383 {who, result} = error ->
1385 "User.unmute/2 failed. #{who}: #{result}, muter_id: #{muter_id}, mutee_id: #{mutee_id}"
1392 def subscribe(%User{} = subscriber, %User{} = target) do
1393 deny_follow_blocked = Config.get([:user, :deny_follow_blocked])
1395 if blocks?(target, subscriber) and deny_follow_blocked do
1396 {:error, "Could not subscribe: #{target.nickname} is blocking you"}
1398 # Note: the relationship is inverse: subscriber acts as relationship target
1399 UserRelationship.create_inverse_subscription(target, subscriber)
1403 def subscribe(%User{} = subscriber, %{ap_id: ap_id}) do
1404 with %User{} = subscribee <- get_cached_by_ap_id(ap_id) do
1405 subscribe(subscriber, subscribee)
1409 def unsubscribe(%User{} = unsubscriber, %User{} = target) do
1410 # Note: the relationship is inverse: subscriber acts as relationship target
1411 UserRelationship.delete_inverse_subscription(target, unsubscriber)
1414 def unsubscribe(%User{} = unsubscriber, %{ap_id: ap_id}) do
1415 with %User{} = user <- get_cached_by_ap_id(ap_id) do
1416 unsubscribe(unsubscriber, user)
1420 def block(%User{} = blocker, %User{} = blocked) do
1421 # sever any follow relationships to prevent leaks per activitypub (Pleroma issue #213)
1423 if following?(blocker, blocked) do
1424 {:ok, blocker, _} = unfollow(blocker, blocked)
1430 # clear any requested follows as well
1432 case CommonAPI.reject_follow_request(blocked, blocker) do
1433 {:ok, %User{} = updated_blocked} -> updated_blocked
1437 unsubscribe(blocked, blocker)
1439 unfollowing_blocked = Config.get([:activitypub, :unfollow_blocked], true)
1440 if unfollowing_blocked && following?(blocked, blocker), do: unfollow(blocked, blocker)
1442 {:ok, blocker} = update_follower_count(blocker)
1443 {:ok, blocker, _} = Participation.mark_all_as_read(blocker, blocked)
1444 add_to_block(blocker, blocked)
1447 # helper to handle the block given only an actor's AP id
1448 def block(%User{} = blocker, %{ap_id: ap_id}) do
1449 block(blocker, get_cached_by_ap_id(ap_id))
1452 def unblock(%User{} = blocker, %User{} = blocked) do
1453 remove_from_block(blocker, blocked)
1456 # helper to handle the block given only an actor's AP id
1457 def unblock(%User{} = blocker, %{ap_id: ap_id}) do
1458 unblock(blocker, get_cached_by_ap_id(ap_id))
1461 def mutes?(nil, _), do: false
1462 def mutes?(%User{} = user, %User{} = target), do: mutes_user?(user, target)
1464 def mutes_user?(%User{} = user, %User{} = target) do
1465 UserRelationship.mute_exists?(user, target)
1468 @spec muted_notifications?(User.t() | nil, User.t() | map()) :: boolean()
1469 def muted_notifications?(nil, _), do: false
1471 def muted_notifications?(%User{} = user, %User{} = target),
1472 do: UserRelationship.notification_mute_exists?(user, target)
1474 def blocks?(nil, _), do: false
1476 def blocks?(%User{} = user, %User{} = target) do
1477 blocks_user?(user, target) ||
1478 (blocks_domain?(user, target) and not User.following?(user, target))
1481 def blocks_user?(%User{} = user, %User{} = target) do
1482 UserRelationship.block_exists?(user, target)
1485 def blocks_user?(_, _), do: false
1487 def blocks_domain?(%User{} = user, %User{} = target) do
1488 domain_blocks = Pleroma.Web.ActivityPub.MRF.subdomains_regex(user.domain_blocks)
1489 %{host: host} = URI.parse(target.ap_id)
1490 Pleroma.Web.ActivityPub.MRF.subdomain_match?(domain_blocks, host)
1493 def blocks_domain?(_, _), do: false
1495 def subscribed_to?(%User{} = user, %User{} = target) do
1496 # Note: the relationship is inverse: subscriber acts as relationship target
1497 UserRelationship.inverse_subscription_exists?(target, user)
1500 def subscribed_to?(%User{} = user, %{ap_id: ap_id}) do
1501 with %User{} = target <- get_cached_by_ap_id(ap_id) do
1502 subscribed_to?(user, target)
1507 Returns map of outgoing (blocked, muted etc.) relationships' user AP IDs by relation type.
1508 E.g. `outgoing_relationships_ap_ids(user, [:block])` -> `%{block: ["https://some.site/users/userapid"]}`
1510 @spec outgoing_relationships_ap_ids(User.t(), list(atom())) :: %{atom() => list(String.t())}
1511 def outgoing_relationships_ap_ids(_user, []), do: %{}
1513 def outgoing_relationships_ap_ids(nil, _relationship_types), do: %{}
1515 def outgoing_relationships_ap_ids(%User{} = user, relationship_types)
1516 when is_list(relationship_types) do
1519 |> assoc(:outgoing_relationships)
1520 |> join(:inner, [user_rel], u in assoc(user_rel, :target))
1521 |> where([user_rel, u], user_rel.relationship_type in ^relationship_types)
1522 |> select([user_rel, u], [user_rel.relationship_type, fragment("array_agg(?)", u.ap_id)])
1523 |> group_by([user_rel, u], user_rel.relationship_type)
1525 |> Enum.into(%{}, fn [k, v] -> {k, v} end)
1530 fn rel_type -> {rel_type, db_result[rel_type] || []} end
1534 def incoming_relationships_ungrouped_ap_ids(user, relationship_types, ap_ids \\ nil)
1536 def incoming_relationships_ungrouped_ap_ids(_user, [], _ap_ids), do: []
1538 def incoming_relationships_ungrouped_ap_ids(nil, _relationship_types, _ap_ids), do: []
1540 def incoming_relationships_ungrouped_ap_ids(%User{} = user, relationship_types, ap_ids)
1541 when is_list(relationship_types) do
1543 |> assoc(:incoming_relationships)
1544 |> join(:inner, [user_rel], u in assoc(user_rel, :source))
1545 |> where([user_rel, u], user_rel.relationship_type in ^relationship_types)
1546 |> maybe_filter_on_ap_id(ap_ids)
1547 |> select([user_rel, u], u.ap_id)
1552 defp maybe_filter_on_ap_id(query, ap_ids) when is_list(ap_ids) do
1553 where(query, [user_rel, u], u.ap_id in ^ap_ids)
1556 defp maybe_filter_on_ap_id(query, _ap_ids), do: query
1558 def deactivate_async(user, status \\ true) do
1559 BackgroundWorker.enqueue("deactivate_user", %{"user_id" => user.id, "status" => status})
1562 def deactivate(user, status \\ true)
1564 def deactivate(users, status) when is_list(users) do
1565 Repo.transaction(fn ->
1566 for user <- users, do: deactivate(user, status)
1570 def deactivate(%User{} = user, status) do
1571 with {:ok, user} <- set_activation_status(user, status) do
1574 |> Enum.filter(& &1.local)
1575 |> Enum.each(&set_cache(update_following_count(&1)))
1577 # Only update local user counts, remote will be update during the next pull.
1580 |> Enum.filter(& &1.local)
1581 |> Enum.each(&do_unfollow(user, &1))
1587 def approve(users) when is_list(users) do
1588 Repo.transaction(fn ->
1589 Enum.map(users, fn user ->
1590 with {:ok, user} <- approve(user), do: user
1595 def approve(%User{} = user) do
1596 change(user, approval_pending: false)
1597 |> update_and_set_cache()
1600 def update_notification_settings(%User{} = user, settings) do
1602 |> cast(%{notification_settings: settings}, [])
1603 |> cast_embed(:notification_settings)
1604 |> validate_required([:notification_settings])
1605 |> update_and_set_cache()
1608 @spec purge_user_changeset(User.t()) :: Changeset.t()
1609 def purge_user_changeset(user) do
1610 # "Right to be forgotten"
1611 # https://gdpr.eu/right-to-be-forgotten/
1622 last_refreshed_at: nil,
1623 last_digest_emailed_at: nil,
1630 confirmation_pending: false,
1631 password_reset_pending: false,
1632 approval_pending: false,
1633 registration_reason: nil,
1634 confirmation_token: nil,
1638 is_moderator: false,
1640 mastofe_settings: nil,
1643 pleroma_settings_store: %{},
1646 is_discoverable: false,
1651 def delete(users) when is_list(users) do
1652 for user <- users, do: delete(user)
1655 def delete(%User{} = user) do
1656 BackgroundWorker.enqueue("delete_user", %{"user_id" => user.id})
1659 defp delete_and_invalidate_cache(%User{} = user) do
1660 invalidate_cache(user)
1664 defp delete_or_deactivate(%User{local: false} = user), do: delete_and_invalidate_cache(user)
1666 defp delete_or_deactivate(%User{local: true} = user) do
1667 status = account_status(user)
1670 :confirmation_pending ->
1671 delete_and_invalidate_cache(user)
1673 :approval_pending ->
1674 delete_and_invalidate_cache(user)
1678 |> purge_user_changeset()
1679 |> update_and_set_cache()
1683 def perform(:force_password_reset, user), do: force_password_reset(user)
1685 @spec perform(atom(), User.t()) :: {:ok, User.t()}
1686 def perform(:delete, %User{} = user) do
1687 # Remove all relationships
1690 |> Enum.each(fn follower ->
1691 ActivityPub.unfollow(follower, user)
1692 unfollow(follower, user)
1697 |> Enum.each(fn followed ->
1698 ActivityPub.unfollow(user, followed)
1699 unfollow(user, followed)
1702 delete_user_activities(user)
1703 delete_notifications_from_user_activities(user)
1705 delete_outgoing_pending_follow_requests(user)
1707 delete_or_deactivate(user)
1710 def perform(:deactivate_async, user, status), do: deactivate(user, status)
1712 @spec external_users_query() :: Ecto.Query.t()
1713 def external_users_query do
1721 @spec external_users(keyword()) :: [User.t()]
1722 def external_users(opts \\ []) do
1724 external_users_query()
1725 |> select([u], struct(u, [:id, :ap_id]))
1729 do: where(query, [u], u.id > ^opts[:max_id]),
1734 do: limit(query, ^opts[:limit]),
1740 def delete_notifications_from_user_activities(%User{ap_id: ap_id}) do
1742 |> join(:inner, [n], activity in assoc(n, :activity))
1743 |> where([n, a], fragment("? = ?", a.actor, ^ap_id))
1744 |> Repo.delete_all()
1747 def delete_user_activities(%User{ap_id: ap_id} = user) do
1749 |> Activity.Queries.by_actor()
1750 |> Repo.chunk_stream(50, :batches)
1751 |> Stream.each(fn activities ->
1752 Enum.each(activities, fn activity -> delete_activity(activity, user) end)
1757 defp delete_activity(%{data: %{"type" => "Create", "object" => object}} = activity, user) do
1758 with {_, %Object{}} <- {:find_object, Object.get_by_ap_id(object)},
1759 {:ok, delete_data, _} <- Builder.delete(user, object) do
1760 Pipeline.common_pipeline(delete_data, local: user.local)
1762 {:find_object, nil} ->
1763 # We have the create activity, but not the object, it was probably pruned.
1764 # Insert a tombstone and try again
1765 with {:ok, tombstone_data, _} <- Builder.tombstone(user.ap_id, object),
1766 {:ok, _tombstone} <- Object.create(tombstone_data) do
1767 delete_activity(activity, user)
1771 Logger.error("Could not delete #{object} created by #{activity.data["ap_id"]}")
1772 Logger.error("Error: #{inspect(e)}")
1776 defp delete_activity(%{data: %{"type" => type}} = activity, user)
1777 when type in ["Like", "Announce"] do
1778 {:ok, undo, _} = Builder.undo(user, activity)
1779 Pipeline.common_pipeline(undo, local: user.local)
1782 defp delete_activity(_activity, _user), do: "Doing nothing"
1784 defp delete_outgoing_pending_follow_requests(user) do
1786 |> FollowingRelationship.outgoing_pending_follow_requests_query()
1787 |> Repo.delete_all()
1790 def html_filter_policy(%User{no_rich_text: true}) do
1791 Pleroma.HTML.Scrubber.TwitterText
1794 def html_filter_policy(_), do: Config.get([:markup, :scrub_policy])
1796 def fetch_by_ap_id(ap_id), do: ActivityPub.make_user_from_ap_id(ap_id)
1798 def get_or_fetch_by_ap_id(ap_id) do
1799 cached_user = get_cached_by_ap_id(ap_id)
1801 maybe_fetched_user = needs_update?(cached_user) && fetch_by_ap_id(ap_id)
1803 case {cached_user, maybe_fetched_user} do
1804 {_, {:ok, %User{} = user}} ->
1807 {%User{} = user, _} ->
1811 {:error, :not_found}
1816 Creates an internal service actor by URI if missing.
1817 Optionally takes nickname for addressing.
1819 @spec get_or_create_service_actor_by_ap_id(String.t(), String.t()) :: User.t() | nil
1820 def get_or_create_service_actor_by_ap_id(uri, nickname) do
1822 case get_cached_by_ap_id(uri) do
1824 with {:error, %{errors: errors}} <- create_service_actor(uri, nickname) do
1825 Logger.error("Cannot create service actor: #{uri}/.\n#{inspect(errors)}")
1829 %User{invisible: false} = user ->
1839 @spec set_invisible(User.t()) :: {:ok, User.t()}
1840 defp set_invisible(user) do
1842 |> change(%{invisible: true})
1843 |> update_and_set_cache()
1846 @spec create_service_actor(String.t(), String.t()) ::
1847 {:ok, User.t()} | {:error, Ecto.Changeset.t()}
1848 defp create_service_actor(uri, nickname) do
1854 follower_address: uri <> "/followers"
1857 |> unique_constraint(:nickname)
1862 def public_key(%{public_key: public_key_pem}) when is_binary(public_key_pem) do
1865 |> :public_key.pem_decode()
1867 |> :public_key.pem_entry_decode()
1872 def public_key(_), do: {:error, "key not found"}
1874 def get_public_key_for_ap_id(ap_id) do
1875 with {:ok, %User{} = user} <- get_or_fetch_by_ap_id(ap_id),
1876 {:ok, public_key} <- public_key(user) do
1883 def ap_enabled?(%User{local: true}), do: true
1884 def ap_enabled?(%User{ap_enabled: ap_enabled}), do: ap_enabled
1885 def ap_enabled?(_), do: false
1887 @doc "Gets or fetch a user by uri or nickname."
1888 @spec get_or_fetch(String.t()) :: {:ok, User.t()} | {:error, String.t()}
1889 def get_or_fetch("http" <> _host = uri), do: get_or_fetch_by_ap_id(uri)
1890 def get_or_fetch(nickname), do: get_or_fetch_by_nickname(nickname)
1892 # wait a period of time and return newest version of the User structs
1893 # this is because we have synchronous follow APIs and need to simulate them
1894 # with an async handshake
1895 def wait_and_refresh(_, %User{local: true} = a, %User{local: true} = b) do
1896 with %User{} = a <- get_cached_by_id(a.id),
1897 %User{} = b <- get_cached_by_id(b.id) do
1904 def wait_and_refresh(timeout, %User{} = a, %User{} = b) do
1905 with :ok <- :timer.sleep(timeout),
1906 %User{} = a <- get_cached_by_id(a.id),
1907 %User{} = b <- get_cached_by_id(b.id) do
1914 def parse_bio(bio) when is_binary(bio) and bio != "" do
1916 |> CommonUtils.format_input("text/plain", mentions_format: :full)
1920 def parse_bio(_), do: ""
1922 def parse_bio(bio, user) when is_binary(bio) and bio != "" do
1923 # TODO: get profile URLs other than user.ap_id
1924 profile_urls = [user.ap_id]
1927 |> CommonUtils.format_input("text/plain",
1928 mentions_format: :full,
1929 rel: &RelMe.maybe_put_rel_me(&1, profile_urls)
1934 def parse_bio(_, _), do: ""
1936 def tag(user_identifiers, tags) when is_list(user_identifiers) do
1937 Repo.transaction(fn ->
1938 for user_identifier <- user_identifiers, do: tag(user_identifier, tags)
1942 def tag(nickname, tags) when is_binary(nickname),
1943 do: tag(get_by_nickname(nickname), tags)
1945 def tag(%User{} = user, tags),
1946 do: update_tags(user, Enum.uniq((user.tags || []) ++ normalize_tags(tags)))
1948 def untag(user_identifiers, tags) when is_list(user_identifiers) do
1949 Repo.transaction(fn ->
1950 for user_identifier <- user_identifiers, do: untag(user_identifier, tags)
1954 def untag(nickname, tags) when is_binary(nickname),
1955 do: untag(get_by_nickname(nickname), tags)
1957 def untag(%User{} = user, tags),
1958 do: update_tags(user, (user.tags || []) -- normalize_tags(tags))
1960 defp update_tags(%User{} = user, new_tags) do
1961 {:ok, updated_user} =
1963 |> change(%{tags: new_tags})
1964 |> update_and_set_cache()
1969 defp normalize_tags(tags) do
1972 |> Enum.map(&String.downcase/1)
1975 defp local_nickname_regex do
1976 if Config.get([:instance, :extended_nickname_format]) do
1977 @extended_local_nickname_regex
1979 @strict_local_nickname_regex
1983 def local_nickname(nickname_or_mention) do
1986 |> String.split("@")
1990 def full_nickname(nickname_or_mention),
1991 do: String.trim_leading(nickname_or_mention, "@")
1993 def error_user(ap_id) do
1997 nickname: "erroruser@example.com",
1998 inserted_at: NaiveDateTime.utc_now()
2002 @spec all_superusers() :: [User.t()]
2003 def all_superusers do
2004 User.Query.build(%{super_users: true, local: true, deactivated: false})
2008 def muting_reblogs?(%User{} = user, %User{} = target) do
2009 UserRelationship.reblog_mute_exists?(user, target)
2012 def showing_reblogs?(%User{} = user, %User{} = target) do
2013 not muting_reblogs?(user, target)
2017 The function returns a query to get users with no activity for given interval of days.
2018 Inactive users are those who didn't read any notification, or had any activity where
2019 the user is the activity's actor, during `inactivity_threshold` days.
2020 Deactivated users will not appear in this list.
2024 iex> Pleroma.User.list_inactive_users()
2027 @spec list_inactive_users_query(integer()) :: Ecto.Query.t()
2028 def list_inactive_users_query(inactivity_threshold \\ 7) do
2029 negative_inactivity_threshold = -inactivity_threshold
2030 now = NaiveDateTime.truncate(NaiveDateTime.utc_now(), :second)
2031 # Subqueries are not supported in `where` clauses, join gets too complicated.
2032 has_read_notifications =
2033 from(n in Pleroma.Notification,
2034 where: n.seen == true,
2036 having: max(n.updated_at) > datetime_add(^now, ^negative_inactivity_threshold, "day"),
2039 |> Pleroma.Repo.all()
2041 from(u in Pleroma.User,
2042 left_join: a in Pleroma.Activity,
2043 on: u.ap_id == a.actor,
2044 where: not is_nil(u.nickname),
2045 where: u.deactivated != ^true,
2046 where: u.id not in ^has_read_notifications,
2049 max(a.inserted_at) < datetime_add(^now, ^negative_inactivity_threshold, "day") or
2050 is_nil(max(a.inserted_at))
2055 Enable or disable email notifications for user
2059 iex> Pleroma.User.switch_email_notifications(Pleroma.User{email_notifications: %{"digest" => false}}, "digest", true)
2060 Pleroma.User{email_notifications: %{"digest" => true}}
2062 iex> Pleroma.User.switch_email_notifications(Pleroma.User{email_notifications: %{"digest" => true}}, "digest", false)
2063 Pleroma.User{email_notifications: %{"digest" => false}}
2065 @spec switch_email_notifications(t(), String.t(), boolean()) ::
2066 {:ok, t()} | {:error, Ecto.Changeset.t()}
2067 def switch_email_notifications(user, type, status) do
2068 User.update_email_notifications(user, %{type => status})
2072 Set `last_digest_emailed_at` value for the user to current time
2074 @spec touch_last_digest_emailed_at(t()) :: t()
2075 def touch_last_digest_emailed_at(user) do
2076 now = NaiveDateTime.truncate(NaiveDateTime.utc_now(), :second)
2078 {:ok, updated_user} =
2080 |> change(%{last_digest_emailed_at: now})
2081 |> update_and_set_cache()
2086 @spec toggle_confirmation(User.t()) :: {:ok, User.t()} | {:error, Changeset.t()}
2087 def toggle_confirmation(%User{} = user) do
2089 |> confirmation_changeset(need_confirmation: !user.confirmation_pending)
2090 |> update_and_set_cache()
2093 @spec toggle_confirmation([User.t()]) :: [{:ok, User.t()} | {:error, Changeset.t()}]
2094 def toggle_confirmation(users) do
2095 Enum.map(users, &toggle_confirmation/1)
2098 @spec need_confirmation(User.t(), boolean()) :: {:ok, User.t()} | {:error, Changeset.t()}
2099 def need_confirmation(%User{} = user, bool) do
2101 |> confirmation_changeset(need_confirmation: bool)
2102 |> update_and_set_cache()
2105 def get_mascot(%{mascot: %{} = mascot}) when not is_nil(mascot) do
2109 def get_mascot(%{mascot: mascot}) when is_nil(mascot) do
2110 # use instance-default
2111 config = Config.get([:assets, :mascots])
2112 default_mascot = Config.get([:assets, :default_mascot])
2113 mascot = Keyword.get(config, default_mascot)
2116 "id" => "default-mascot",
2117 "url" => mascot[:url],
2118 "preview_url" => mascot[:url],
2120 "mime_type" => mascot[:mime_type]
2125 def ensure_keys_present(%{keys: keys} = user) when not is_nil(keys), do: {:ok, user}
2127 def ensure_keys_present(%User{} = user) do
2128 with {:ok, pem} <- Keys.generate_rsa_pem() do
2130 |> cast(%{keys: pem}, [:keys])
2131 |> validate_required([:keys])
2132 |> update_and_set_cache()
2136 def get_ap_ids_by_nicknames(nicknames) do
2138 where: u.nickname in ^nicknames,
2144 defp put_password_hash(
2145 %Ecto.Changeset{valid?: true, changes: %{password: password}} = changeset
2147 change(changeset, password_hash: Pbkdf2.hash_pwd_salt(password))
2150 defp put_password_hash(changeset), do: changeset
2152 def is_internal_user?(%User{nickname: nil}), do: true
2153 def is_internal_user?(%User{local: true, nickname: "internal." <> _}), do: true
2154 def is_internal_user?(_), do: false
2156 # A hack because user delete activities have a fake id for whatever reason
2157 # TODO: Get rid of this
2158 def get_delivered_users_by_object_id("pleroma:fake_object_id"), do: []
2160 def get_delivered_users_by_object_id(object_id) do
2162 inner_join: delivery in assoc(u, :deliveries),
2163 where: delivery.object_id == ^object_id
2168 def change_email(user, email) do
2170 |> cast(%{email: email}, [:email])
2171 |> validate_required([:email])
2172 |> unique_constraint(:email)
2173 |> validate_format(:email, @email_regex)
2174 |> update_and_set_cache()
2177 # Internal function; public one is `deactivate/2`
2178 defp set_activation_status(user, deactivated) do
2180 |> cast(%{deactivated: deactivated}, [:deactivated])
2181 |> update_and_set_cache()
2184 def update_banner(user, banner) do
2186 |> cast(%{banner: banner}, [:banner])
2187 |> update_and_set_cache()
2190 def update_background(user, background) do
2192 |> cast(%{background: background}, [:background])
2193 |> update_and_set_cache()
2196 def roles(%{is_moderator: is_moderator, is_admin: is_admin}) do
2199 moderator: is_moderator
2203 def validate_fields(changeset, remote? \\ false) do
2204 limit_name = if remote?, do: :max_remote_account_fields, else: :max_account_fields
2205 limit = Config.get([:instance, limit_name], 0)
2208 |> validate_length(:fields, max: limit)
2209 |> validate_change(:fields, fn :fields, fields ->
2210 if Enum.all?(fields, &valid_field?/1) do
2218 defp valid_field?(%{"name" => name, "value" => value}) do
2219 name_limit = Config.get([:instance, :account_field_name_length], 255)
2220 value_limit = Config.get([:instance, :account_field_value_length], 255)
2222 is_binary(name) && is_binary(value) && String.length(name) <= name_limit &&
2223 String.length(value) <= value_limit
2226 defp valid_field?(_), do: false
2228 defp truncate_field(%{"name" => name, "value" => value}) do
2230 String.split_at(name, Config.get([:instance, :account_field_name_length], 255))
2233 String.split_at(value, Config.get([:instance, :account_field_value_length], 255))
2235 %{"name" => name, "value" => value}
2238 def admin_api_update(user, params) do
2245 |> update_and_set_cache()
2248 @doc "Signs user out of all applications"
2249 def global_sign_out(user) do
2250 OAuth.Authorization.delete_user_authorizations(user)
2251 OAuth.Token.delete_user_tokens(user)
2254 def mascot_update(user, url) do
2256 |> cast(%{mascot: url}, [:mascot])
2257 |> validate_required([:mascot])
2258 |> update_and_set_cache()
2261 def mastodon_settings_update(user, settings) do
2263 |> cast(%{mastofe_settings: settings}, [:mastofe_settings])
2264 |> validate_required([:mastofe_settings])
2265 |> update_and_set_cache()
2268 @spec confirmation_changeset(User.t(), keyword()) :: Changeset.t()
2269 def confirmation_changeset(user, need_confirmation: need_confirmation?) do
2271 if need_confirmation? do
2273 confirmation_pending: true,
2274 confirmation_token: :crypto.strong_rand_bytes(32) |> Base.url_encode64()
2278 confirmation_pending: false,
2279 confirmation_token: nil
2283 cast(user, params, [:confirmation_pending, :confirmation_token])
2286 @spec approval_changeset(User.t(), keyword()) :: Changeset.t()
2287 def approval_changeset(user, need_approval: need_approval?) do
2288 params = if need_approval?, do: %{approval_pending: true}, else: %{approval_pending: false}
2289 cast(user, params, [:approval_pending])
2292 def add_pinnned_activity(user, %Pleroma.Activity{id: id}) do
2293 if id not in user.pinned_activities do
2294 max_pinned_statuses = Config.get([:instance, :max_pinned_statuses], 0)
2295 params = %{pinned_activities: user.pinned_activities ++ [id]}
2297 # if pinned activity was scheduled for deletion, we remove job
2298 if expiration = Pleroma.Workers.PurgeExpiredActivity.get_expiration(id) do
2299 Oban.cancel_job(expiration.id)
2303 |> cast(params, [:pinned_activities])
2304 |> validate_length(:pinned_activities,
2305 max: max_pinned_statuses,
2306 message: "You have already pinned the maximum number of statuses"
2311 |> update_and_set_cache()
2314 def remove_pinnned_activity(user, %Pleroma.Activity{id: id, data: data}) do
2315 params = %{pinned_activities: List.delete(user.pinned_activities, id)}
2317 # if pinned activity was scheduled for deletion, we reschedule it for deletion
2318 if data["expires_at"] do
2319 # MRF.ActivityExpirationPolicy used UTC timestamps for expires_at in original implementation
2321 data["expires_at"] |> Pleroma.EctoType.ActivityPub.ObjectValidators.DateTime.cast()
2323 Pleroma.Workers.PurgeExpiredActivity.enqueue(%{
2325 expires_at: expires_at
2330 |> cast(params, [:pinned_activities])
2331 |> update_and_set_cache()
2334 def update_email_notifications(user, settings) do
2335 email_notifications =
2336 user.email_notifications
2337 |> Map.merge(settings)
2338 |> Map.take(["digest"])
2340 params = %{email_notifications: email_notifications}
2341 fields = [:email_notifications]
2344 |> cast(params, fields)
2345 |> validate_required(fields)
2346 |> update_and_set_cache()
2349 defp set_domain_blocks(user, domain_blocks) do
2350 params = %{domain_blocks: domain_blocks}
2353 |> cast(params, [:domain_blocks])
2354 |> validate_required([:domain_blocks])
2355 |> update_and_set_cache()
2358 def block_domain(user, domain_blocked) do
2359 set_domain_blocks(user, Enum.uniq([domain_blocked | user.domain_blocks]))
2362 def unblock_domain(user, domain_blocked) do
2363 set_domain_blocks(user, List.delete(user.domain_blocks, domain_blocked))
2366 @spec add_to_block(User.t(), User.t()) ::
2367 {:ok, UserRelationship.t()} | {:error, Ecto.Changeset.t()}
2368 defp add_to_block(%User{} = user, %User{} = blocked) do
2369 with {:ok, relationship} <- UserRelationship.create_block(user, blocked) do
2370 @cachex.del(:user_cache, "blocked_users_ap_ids:#{user.ap_id}")
2375 @spec add_to_block(User.t(), User.t()) ::
2376 {:ok, UserRelationship.t()} | {:ok, nil} | {:error, Ecto.Changeset.t()}
2377 defp remove_from_block(%User{} = user, %User{} = blocked) do
2378 with {:ok, relationship} <- UserRelationship.delete_block(user, blocked) do
2379 @cachex.del(:user_cache, "blocked_users_ap_ids:#{user.ap_id}")
2384 def set_invisible(user, invisible) do
2385 params = %{invisible: invisible}
2388 |> cast(params, [:invisible])
2389 |> validate_required([:invisible])
2390 |> update_and_set_cache()
2393 def sanitize_html(%User{} = user) do
2394 sanitize_html(user, nil)
2397 # User data that mastodon isn't filtering (treated as plaintext):
2400 def sanitize_html(%User{} = user, filter) do
2402 Enum.map(user.fields, fn %{"name" => name, "value" => value} ->
2405 "value" => HTML.filter_tags(value, Pleroma.HTML.Scrubber.LinksOnly)
2410 |> Map.put(:bio, HTML.filter_tags(user.bio, filter))
2411 |> Map.put(:fields, fields)
2414 def get_host(%User{ap_id: ap_id} = _user) do
2415 URI.parse(ap_id).host