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
85 field(:bio, :string, default: "")
86 field(:raw_bio, :string)
87 field(:email, :string)
89 field(:nickname, :string)
90 field(:password_hash, :string)
91 field(:password, :string, virtual: true)
92 field(:password_confirmation, :string, virtual: true)
94 field(:public_key, :string)
95 field(:ap_id, :string)
96 field(:avatar, :map, default: %{})
97 field(:local, :boolean, default: true)
98 field(:follower_address, :string)
99 field(:following_address, :string)
100 field(:search_rank, :float, virtual: true)
101 field(:search_type, :integer, virtual: true)
102 field(:tags, {:array, :string}, default: [])
103 field(:last_refreshed_at, :naive_datetime_usec)
104 field(:last_digest_emailed_at, :naive_datetime)
105 field(:banner, :map, default: %{})
106 field(:background, :map, default: %{})
107 field(:note_count, :integer, default: 0)
108 field(:follower_count, :integer, default: 0)
109 field(:following_count, :integer, default: 0)
110 field(:locked, :boolean, default: false)
111 field(:confirmation_pending, :boolean, default: false)
112 field(:password_reset_pending, :boolean, default: false)
113 field(:approval_pending, :boolean, default: false)
114 field(:registration_reason, :string, default: nil)
115 field(:confirmation_token, :string, default: nil)
116 field(:default_scope, :string, default: "public")
117 field(:domain_blocks, {:array, :string}, default: [])
118 field(:deactivated, :boolean, default: false)
119 field(:no_rich_text, :boolean, default: false)
120 field(:ap_enabled, :boolean, default: false)
121 field(:is_moderator, :boolean, default: false)
122 field(:is_admin, :boolean, default: false)
123 field(:show_role, :boolean, default: true)
124 field(:mastofe_settings, :map, default: nil)
125 field(:uri, ObjectValidators.Uri, default: nil)
126 field(:hide_followers_count, :boolean, default: false)
127 field(:hide_follows_count, :boolean, default: false)
128 field(:hide_followers, :boolean, default: false)
129 field(:hide_follows, :boolean, default: false)
130 field(:hide_favorites, :boolean, default: true)
131 field(:unread_conversation_count, :integer, default: 0)
132 field(:pinned_activities, {:array, :string}, default: [])
133 field(:email_notifications, :map, default: %{"digest" => false})
134 field(:mascot, :map, default: nil)
135 field(:emoji, :map, default: %{})
136 field(:pleroma_settings_store, :map, default: %{})
137 field(:fields, {:array, :map}, default: [])
138 field(:raw_fields, {:array, :map}, default: [])
139 field(:discoverable, :boolean, default: false)
140 field(:invisible, :boolean, default: false)
141 field(:allow_following_move, :boolean, default: true)
142 field(:skip_thread_containment, :boolean, default: false)
143 field(:actor_type, :string, default: "Person")
144 field(:also_known_as, {:array, :string}, default: [])
145 field(:inbox, :string)
146 field(:shared_inbox, :string)
147 field(:accepts_chat_messages, :boolean, default: nil)
150 :notification_settings,
151 Pleroma.User.NotificationSetting,
155 has_many(:notifications, Notification)
156 has_many(:registrations, Registration)
157 has_many(:deliveries, Delivery)
159 has_many(:outgoing_relationships, UserRelationship, foreign_key: :source_id)
160 has_many(:incoming_relationships, UserRelationship, foreign_key: :target_id)
162 for {relationship_type,
164 {outgoing_relation, outgoing_relation_target},
165 {incoming_relation, incoming_relation_source}
166 ]} <- @user_relationships_config do
167 # Definitions of `has_many` relations: :blocker_blocks, :muter_mutes, :reblog_muter_mutes,
168 # :notification_muter_mutes, :subscribee_subscriptions
169 has_many(outgoing_relation, UserRelationship,
170 foreign_key: :source_id,
171 where: [relationship_type: relationship_type]
174 # Definitions of `has_many` relations: :blockee_blocks, :mutee_mutes, :reblog_mutee_mutes,
175 # :notification_mutee_mutes, :subscriber_subscriptions
176 has_many(incoming_relation, UserRelationship,
177 foreign_key: :target_id,
178 where: [relationship_type: relationship_type]
181 # Definitions of `has_many` relations: :blocked_users, :muted_users, :reblog_muted_users,
182 # :notification_muted_users, :subscriber_users
183 has_many(outgoing_relation_target, through: [outgoing_relation, :target])
185 # Definitions of `has_many` relations: :blocker_users, :muter_users, :reblog_muter_users,
186 # :notification_muter_users, :subscribee_users
187 has_many(incoming_relation_source, through: [incoming_relation, :source])
190 # `:blocks` is deprecated (replaced with `blocked_users` relation)
191 field(:blocks, {:array, :string}, default: [])
192 # `:mutes` is deprecated (replaced with `muted_users` relation)
193 field(:mutes, {:array, :string}, default: [])
194 # `:muted_reblogs` is deprecated (replaced with `reblog_muted_users` relation)
195 field(:muted_reblogs, {:array, :string}, default: [])
196 # `:muted_notifications` is deprecated (replaced with `notification_muted_users` relation)
197 field(:muted_notifications, {:array, :string}, default: [])
198 # `:subscribers` is deprecated (replaced with `subscriber_users` relation)
199 field(:subscribers, {:array, :string}, default: [])
202 :multi_factor_authentication_settings,
210 for {_relationship_type, [{_outgoing_relation, outgoing_relation_target}, _]} <-
211 @user_relationships_config do
212 # `def blocked_users_relation/2`, `def muted_users_relation/2`,
213 # `def reblog_muted_users_relation/2`, `def notification_muted_users/2`,
214 # `def subscriber_users/2`
215 def unquote(:"#{outgoing_relation_target}_relation")(user, restrict_deactivated? \\ false) do
216 target_users_query = assoc(user, unquote(outgoing_relation_target))
218 if restrict_deactivated? do
219 restrict_deactivated(target_users_query)
225 # `def blocked_users/2`, `def muted_users/2`, `def reblog_muted_users/2`,
226 # `def notification_muted_users/2`, `def subscriber_users/2`
227 def unquote(outgoing_relation_target)(user, restrict_deactivated? \\ false) do
229 |> apply(unquote(:"#{outgoing_relation_target}_relation"), [
231 restrict_deactivated?
236 # `def blocked_users_ap_ids/2`, `def muted_users_ap_ids/2`, `def reblog_muted_users_ap_ids/2`,
237 # `def notification_muted_users_ap_ids/2`, `def subscriber_users_ap_ids/2`
238 def unquote(:"#{outgoing_relation_target}_ap_ids")(user, restrict_deactivated? \\ false) do
240 |> apply(unquote(:"#{outgoing_relation_target}_relation"), [
242 restrict_deactivated?
244 |> select([u], u.ap_id)
249 defdelegate following_count(user), to: FollowingRelationship
250 defdelegate following(user), to: FollowingRelationship
251 defdelegate following?(follower, followed), to: FollowingRelationship
252 defdelegate following_ap_ids(user), to: FollowingRelationship
253 defdelegate get_follow_requests(user), to: FollowingRelationship
254 defdelegate search(query, opts \\ []), to: User.Search
257 Dumps Flake Id to SQL-compatible format (16-byte UUID).
258 E.g. "9pQtDGXuq4p3VlcJEm" -> <<0, 0, 1, 110, 179, 218, 42, 92, 213, 41, 44, 227, 95, 213, 0, 0>>
260 def binary_id(source_id) when is_binary(source_id) do
261 with {:ok, dumped_id} <- FlakeId.Ecto.CompatType.dump(source_id) do
268 def binary_id(source_ids) when is_list(source_ids) do
269 Enum.map(source_ids, &binary_id/1)
272 def binary_id(%User{} = user), do: binary_id(user.id)
274 @doc "Returns status account"
275 @spec account_status(User.t()) :: account_status()
276 def account_status(%User{deactivated: true}), do: :deactivated
277 def account_status(%User{password_reset_pending: true}), do: :password_reset_pending
278 def account_status(%User{local: true, approval_pending: true}), do: :approval_pending
280 def account_status(%User{local: true, confirmation_pending: true}) do
281 if Config.get([:instance, :account_activation_required]) do
282 :confirmation_pending
288 def account_status(%User{}), do: :active
290 @spec visible_for(User.t(), User.t() | nil) ::
293 | :restricted_unauthenticated
295 | :confirmation_pending
296 def visible_for(user, for_user \\ nil)
298 def visible_for(%User{invisible: true}, _), do: :invisible
300 def visible_for(%User{id: user_id}, %User{id: user_id}), do: :visible
302 def visible_for(%User{} = user, nil) do
303 if restrict_unauthenticated?(user) do
304 :restrict_unauthenticated
306 visible_account_status(user)
310 def visible_for(%User{} = user, for_user) do
311 if superuser?(for_user) do
314 visible_account_status(user)
318 def visible_for(_, _), do: :invisible
320 defp restrict_unauthenticated?(%User{local: true}) do
321 Config.restrict_unauthenticated_access?(:profiles, :local)
324 defp restrict_unauthenticated?(%User{local: _}) do
325 Config.restrict_unauthenticated_access?(:profiles, :remote)
328 defp visible_account_status(user) do
329 status = account_status(user)
331 if status in [:active, :password_reset_pending] do
338 @spec superuser?(User.t()) :: boolean()
339 def superuser?(%User{local: true, is_admin: true}), do: true
340 def superuser?(%User{local: true, is_moderator: true}), do: true
341 def superuser?(_), do: false
343 @spec invisible?(User.t()) :: boolean()
344 def invisible?(%User{invisible: true}), do: true
345 def invisible?(_), do: false
347 def avatar_url(user, options \\ []) do
349 %{"url" => [%{"href" => href} | _]} ->
353 unless options[:no_default] do
354 Config.get([:assets, :default_user_avatar], "#{Web.base_url()}/images/avi.png")
359 def banner_url(user, options \\ []) do
361 %{"url" => [%{"href" => href} | _]} -> href
362 _ -> !options[:no_default] && "#{Web.base_url()}/images/banner.png"
366 # Should probably be renamed or removed
367 def ap_id(%User{nickname: nickname}), do: "#{Web.base_url()}/users/#{nickname}"
369 def ap_followers(%User{follower_address: fa}) when is_binary(fa), do: fa
370 def ap_followers(%User{} = user), do: "#{ap_id(user)}/followers"
372 @spec ap_following(User.t()) :: String.t()
373 def ap_following(%User{following_address: fa}) when is_binary(fa), do: fa
374 def ap_following(%User{} = user), do: "#{ap_id(user)}/following"
376 @spec restrict_deactivated(Ecto.Query.t()) :: Ecto.Query.t()
377 def restrict_deactivated(query) do
378 from(u in query, where: u.deactivated != ^true)
381 defp truncate_fields_param(params) do
382 if Map.has_key?(params, :fields) do
383 Map.put(params, :fields, Enum.map(params[:fields], &truncate_field/1))
389 defp truncate_if_exists(params, key, max_length) do
390 if Map.has_key?(params, key) and is_binary(params[key]) do
391 {value, _chopped} = String.split_at(params[key], max_length)
392 Map.put(params, key, value)
398 defp fix_follower_address(%{follower_address: _, following_address: _} = params), do: params
400 defp fix_follower_address(%{nickname: nickname} = params),
401 do: Map.put(params, :follower_address, ap_followers(%User{nickname: nickname}))
403 defp fix_follower_address(params), do: params
405 def remote_user_changeset(struct \\ %User{local: false}, params) do
406 bio_limit = Config.get([:instance, :user_bio_length], 5000)
407 name_limit = Config.get([:instance, :user_name_length], 100)
410 case params[:name] do
411 name when is_binary(name) and byte_size(name) > 0 -> name
412 _ -> params[:nickname]
417 |> Map.put(:name, name)
418 |> Map.put_new(:last_refreshed_at, NaiveDateTime.utc_now())
419 |> truncate_if_exists(:name, name_limit)
420 |> truncate_if_exists(:bio, bio_limit)
421 |> truncate_fields_param()
422 |> fix_follower_address()
446 :hide_followers_count,
455 :accepts_chat_messages
458 |> validate_required([:name, :ap_id])
459 |> unique_constraint(:nickname)
460 |> validate_format(:nickname, @email_regex)
461 |> validate_length(:bio, max: bio_limit)
462 |> validate_length(:name, max: name_limit)
463 |> validate_fields(true)
466 def update_changeset(struct, params \\ %{}) do
467 bio_limit = Config.get([:instance, :user_bio_length], 5000)
468 name_limit = Config.get([:instance, :user_name_length], 100)
488 :hide_followers_count,
491 :allow_following_move,
494 :skip_thread_containment,
497 :pleroma_settings_store,
501 :accepts_chat_messages
504 |> unique_constraint(:nickname)
505 |> validate_format(:nickname, local_nickname_regex())
506 |> validate_length(:bio, max: bio_limit)
507 |> validate_length(:name, min: 1, max: name_limit)
508 |> validate_inclusion(:actor_type, ["Person", "Service"])
511 |> put_change_if_present(:bio, &{:ok, parse_bio(&1, struct)})
512 |> put_change_if_present(:avatar, &put_upload(&1, :avatar))
513 |> put_change_if_present(:banner, &put_upload(&1, :banner))
514 |> put_change_if_present(:background, &put_upload(&1, :background))
515 |> put_change_if_present(
516 :pleroma_settings_store,
517 &{:ok, Map.merge(struct.pleroma_settings_store, &1)}
519 |> validate_fields(false)
522 defp put_fields(changeset) do
523 if raw_fields = get_change(changeset, :raw_fields) do
526 |> Enum.filter(fn %{"name" => n} -> n != "" end)
530 |> Enum.map(fn f -> Map.update!(f, "value", &parse_fields(&1)) end)
533 |> put_change(:raw_fields, raw_fields)
534 |> put_change(:fields, fields)
540 defp parse_fields(value) do
542 |> Formatter.linkify(mentions_format: :full)
546 defp put_emoji(changeset) do
547 emojified_fields = [:bio, :name, :raw_fields]
549 if Enum.any?(changeset.changes, fn {k, _} -> k in emojified_fields end) do
550 bio = Emoji.Formatter.get_emoji_map(get_field(changeset, :bio))
551 name = Emoji.Formatter.get_emoji_map(get_field(changeset, :name))
553 emoji = Map.merge(bio, name)
557 |> get_field(:raw_fields)
558 |> Enum.reduce(emoji, fn x, acc ->
559 Map.merge(acc, Emoji.Formatter.get_emoji_map(x["name"] <> x["value"]))
562 put_change(changeset, :emoji, emoji)
568 defp put_change_if_present(changeset, map_field, value_function) do
569 with {:ok, value} <- fetch_change(changeset, map_field),
570 {:ok, new_value} <- value_function.(value) do
571 put_change(changeset, map_field, new_value)
577 defp put_upload(value, type) do
578 with %Plug.Upload{} <- value,
579 {:ok, object} <- ActivityPub.upload(value, type: type) do
584 def update_as_admin_changeset(struct, params) do
586 |> update_changeset(params)
587 |> cast(params, [:email])
588 |> delete_change(:also_known_as)
589 |> unique_constraint(:email)
590 |> validate_format(:email, @email_regex)
591 |> validate_inclusion(:actor_type, ["Person", "Service"])
594 @spec update_as_admin(User.t(), map()) :: {:ok, User.t()} | {:error, Changeset.t()}
595 def update_as_admin(user, params) do
596 params = Map.put(params, "password_confirmation", params["password"])
597 changeset = update_as_admin_changeset(user, params)
599 if params["password"] do
600 reset_password(user, changeset, params)
602 User.update_and_set_cache(changeset)
606 def password_update_changeset(struct, params) do
608 |> cast(params, [:password, :password_confirmation])
609 |> validate_required([:password, :password_confirmation])
610 |> validate_confirmation(:password)
611 |> put_password_hash()
612 |> put_change(:password_reset_pending, false)
615 @spec reset_password(User.t(), map()) :: {:ok, User.t()} | {:error, Changeset.t()}
616 def reset_password(%User{} = user, params) do
617 reset_password(user, user, params)
620 def reset_password(%User{id: user_id} = user, struct, params) do
623 |> Multi.update(:user, password_update_changeset(struct, params))
624 |> Multi.delete_all(:tokens, OAuth.Token.Query.get_by_user(user_id))
625 |> Multi.delete_all(:auth, OAuth.Authorization.delete_by_user_query(user))
627 case Repo.transaction(multi) do
628 {:ok, %{user: user} = _} -> set_cache(user)
629 {:error, _, changeset, _} -> {:error, changeset}
633 def update_password_reset_pending(user, value) do
636 |> put_change(:password_reset_pending, value)
637 |> update_and_set_cache()
640 def force_password_reset_async(user) do
641 BackgroundWorker.enqueue("force_password_reset", %{"user_id" => user.id})
644 @spec force_password_reset(User.t()) :: {:ok, User.t()} | {:error, Ecto.Changeset.t()}
645 def force_password_reset(user), do: update_password_reset_pending(user, true)
647 # Used to auto-register LDAP accounts which won't have a password hash stored locally
648 def register_changeset_ldap(struct, params = %{password: password})
649 when is_nil(password) do
650 params = Map.put_new(params, :accepts_chat_messages, true)
653 if Map.has_key?(params, :email) do
654 Map.put_new(params, :email, params[:email])
664 :accepts_chat_messages
666 |> validate_required([:name, :nickname])
667 |> unique_constraint(:nickname)
668 |> validate_exclusion(:nickname, Config.get([User, :restricted_nicknames]))
669 |> validate_format(:nickname, local_nickname_regex())
671 |> unique_constraint(:ap_id)
672 |> put_following_and_follower_address()
675 def register_changeset(struct, params \\ %{}, opts \\ []) do
676 bio_limit = Config.get([:instance, :user_bio_length], 5000)
677 name_limit = Config.get([:instance, :user_name_length], 100)
678 reason_limit = Config.get([:instance, :registration_reason_length], 500)
679 params = Map.put_new(params, :accepts_chat_messages, true)
682 if is_nil(opts[:need_confirmation]) do
683 Config.get([:instance, :account_activation_required])
685 opts[:need_confirmation]
689 if is_nil(opts[:need_approval]) do
690 Config.get([:instance, :account_approval_required])
696 |> confirmation_changeset(need_confirmation: need_confirmation?)
697 |> approval_changeset(need_approval: need_approval?)
705 :password_confirmation,
707 :accepts_chat_messages,
710 |> validate_required([:name, :nickname, :password, :password_confirmation])
711 |> validate_confirmation(:password)
712 |> unique_constraint(:email)
713 |> validate_format(:email, @email_regex)
714 |> validate_change(:email, fn :email, email ->
716 Config.get([User, :email_blacklist])
717 |> Enum.all?(fn blacklisted_domain ->
718 !String.ends_with?(email, ["@" <> blacklisted_domain, "." <> blacklisted_domain])
721 if valid?, do: [], else: [email: "Invalid email"]
723 |> unique_constraint(:nickname)
724 |> validate_exclusion(:nickname, Config.get([User, :restricted_nicknames]))
725 |> validate_format(:nickname, local_nickname_regex())
726 |> validate_length(:bio, max: bio_limit)
727 |> validate_length(:name, min: 1, max: name_limit)
728 |> validate_length(:registration_reason, max: reason_limit)
729 |> maybe_validate_required_email(opts[:external])
732 |> unique_constraint(:ap_id)
733 |> put_following_and_follower_address()
736 def maybe_validate_required_email(changeset, true), do: changeset
738 def maybe_validate_required_email(changeset, _) do
739 if Config.get([:instance, :account_activation_required]) do
740 validate_required(changeset, [:email])
746 defp put_ap_id(changeset) do
747 ap_id = ap_id(%User{nickname: get_field(changeset, :nickname)})
748 put_change(changeset, :ap_id, ap_id)
751 defp put_following_and_follower_address(changeset) do
752 followers = ap_followers(%User{nickname: get_field(changeset, :nickname)})
755 |> put_change(:follower_address, followers)
758 defp autofollow_users(user) do
759 candidates = Config.get([:instance, :autofollowed_nicknames])
762 User.Query.build(%{nickname: candidates, local: true, deactivated: false})
765 follow_all(user, autofollowed_users)
768 @doc "Inserts provided changeset, performs post-registration actions (confirmation email sending etc.)"
769 def register(%Ecto.Changeset{} = changeset) do
770 with {:ok, user} <- Repo.insert(changeset) do
771 post_register_action(user)
775 def post_register_action(%User{} = user) do
776 with {:ok, user} <- autofollow_users(user),
777 {:ok, user} <- set_cache(user),
778 {:ok, _} <- send_welcome_email(user),
779 {:ok, _} <- send_welcome_message(user),
780 {:ok, _} <- send_welcome_chat_message(user),
781 {:ok, _} <- try_send_confirmation_email(user) do
786 def send_welcome_message(user) do
787 if User.WelcomeMessage.enabled?() do
788 User.WelcomeMessage.post_message(user)
795 def send_welcome_chat_message(user) do
796 if User.WelcomeChatMessage.enabled?() do
797 User.WelcomeChatMessage.post_message(user)
804 def send_welcome_email(%User{email: email} = user) when is_binary(email) do
805 if User.WelcomeEmail.enabled?() do
806 User.WelcomeEmail.send_email(user)
813 def send_welcome_email(_), do: {:ok, :noop}
815 @spec try_send_confirmation_email(User.t()) :: {:ok, :enqueued | :noop}
816 def try_send_confirmation_email(%User{confirmation_pending: true} = user) do
817 if Config.get([:instance, :account_activation_required]) do
818 send_confirmation_email(user)
825 def try_send_confirmation_email(_), do: {:ok, :noop}
827 @spec send_confirmation_email(Uset.t()) :: User.t()
828 def send_confirmation_email(%User{} = user) do
830 |> Pleroma.Emails.UserEmail.account_confirmation_email()
831 |> Pleroma.Emails.Mailer.deliver_async()
836 def needs_update?(%User{local: true}), do: false
838 def needs_update?(%User{local: false, last_refreshed_at: nil}), do: true
840 def needs_update?(%User{local: false} = user) do
841 NaiveDateTime.diff(NaiveDateTime.utc_now(), user.last_refreshed_at) >= 86_400
844 def needs_update?(_), do: true
846 @spec maybe_direct_follow(User.t(), User.t()) :: {:ok, User.t()} | {:error, String.t()}
848 # "Locked" (self-locked) users demand explicit authorization of follow requests
849 def maybe_direct_follow(%User{} = follower, %User{local: true, locked: true} = followed) do
850 follow(follower, followed, :follow_pending)
853 def maybe_direct_follow(%User{} = follower, %User{local: true} = followed) do
854 follow(follower, followed)
857 def maybe_direct_follow(%User{} = follower, %User{} = followed) do
858 if not ap_enabled?(followed) do
859 follow(follower, followed)
865 @doc "A mass follow for local users. Respects blocks in both directions but does not create activities."
866 @spec follow_all(User.t(), list(User.t())) :: {atom(), User.t()}
867 def follow_all(follower, followeds) do
869 |> Enum.reject(fn followed -> blocks?(follower, followed) || blocks?(followed, follower) end)
870 |> Enum.each(&follow(follower, &1, :follow_accept))
875 def follow(%User{} = follower, %User{} = followed, state \\ :follow_accept) do
876 deny_follow_blocked = Config.get([:user, :deny_follow_blocked])
879 followed.deactivated ->
880 {:error, "Could not follow user: #{followed.nickname} is deactivated."}
882 deny_follow_blocked and blocks?(followed, follower) ->
883 {:error, "Could not follow user: #{followed.nickname} blocked you."}
886 FollowingRelationship.follow(follower, followed, state)
888 {:ok, _} = update_follower_count(followed)
891 |> update_following_count()
895 def unfollow(%User{ap_id: ap_id}, %User{ap_id: ap_id}) do
896 {:error, "Not subscribed!"}
899 @spec unfollow(User.t(), User.t()) :: {:ok, User.t(), Activity.t()} | {:error, String.t()}
900 def unfollow(%User{} = follower, %User{} = followed) do
901 case do_unfollow(follower, followed) do
902 {:ok, follower, followed} ->
903 {:ok, follower, Utils.fetch_latest_follow(follower, followed)}
910 @spec do_unfollow(User.t(), User.t()) :: {:ok, User.t(), User.t()} | {:error, String.t()}
911 defp do_unfollow(%User{} = follower, %User{} = followed) do
912 case get_follow_state(follower, followed) do
913 state when state in [:follow_pending, :follow_accept] ->
914 FollowingRelationship.unfollow(follower, followed)
915 {:ok, followed} = update_follower_count(followed)
919 |> update_following_count()
921 {:ok, follower, followed}
924 {:error, "Not subscribed!"}
928 @doc "Returns follow state as Pleroma.FollowingRelationship.State value"
929 def get_follow_state(%User{} = follower, %User{} = following) do
930 following_relationship = FollowingRelationship.get(follower, following)
931 get_follow_state(follower, following, following_relationship)
934 def get_follow_state(
937 following_relationship
939 case {following_relationship, following.local} do
941 case Utils.fetch_latest_follow(follower, following) do
942 %Activity{data: %{"state" => state}} when state in ["pending", "accept"] ->
943 FollowingRelationship.state_to_enum(state)
949 {%{state: state}, _} ->
957 def locked?(%User{} = user) do
962 Repo.get_by(User, id: id)
965 def get_by_ap_id(ap_id) do
966 Repo.get_by(User, ap_id: ap_id)
969 def get_all_by_ap_id(ap_ids) do
970 from(u in __MODULE__,
971 where: u.ap_id in ^ap_ids
976 def get_all_by_ids(ids) do
977 from(u in __MODULE__, where: u.id in ^ids)
981 # This is mostly an SPC migration fix. This guesses the user nickname by taking the last part
982 # of the ap_id and the domain and tries to get that user
983 def get_by_guessed_nickname(ap_id) do
984 domain = URI.parse(ap_id).host
985 name = List.last(String.split(ap_id, "/"))
986 nickname = "#{name}@#{domain}"
988 get_cached_by_nickname(nickname)
991 def set_cache({:ok, user}), do: set_cache(user)
992 def set_cache({:error, err}), do: {:error, err}
994 def set_cache(%User{} = user) do
995 Cachex.put(:user_cache, "ap_id:#{user.ap_id}", user)
996 Cachex.put(:user_cache, "nickname:#{user.nickname}", user)
997 Cachex.put(:user_cache, "friends_ap_ids:#{user.nickname}", get_user_friends_ap_ids(user))
1001 def update_and_set_cache(struct, params) do
1003 |> update_changeset(params)
1004 |> update_and_set_cache()
1007 def update_and_set_cache(changeset) do
1008 with {:ok, user} <- Repo.update(changeset, stale_error_field: :id) do
1013 def get_user_friends_ap_ids(user) do
1014 from(u in User.get_friends_query(user), select: u.ap_id)
1018 @spec get_cached_user_friends_ap_ids(User.t()) :: [String.t()]
1019 def get_cached_user_friends_ap_ids(user) do
1020 Cachex.fetch!(:user_cache, "friends_ap_ids:#{user.ap_id}", fn _ ->
1021 get_user_friends_ap_ids(user)
1025 def invalidate_cache(user) do
1026 Cachex.del(:user_cache, "ap_id:#{user.ap_id}")
1027 Cachex.del(:user_cache, "nickname:#{user.nickname}")
1028 Cachex.del(:user_cache, "friends_ap_ids:#{user.ap_id}")
1031 @spec get_cached_by_ap_id(String.t()) :: User.t() | nil
1032 def get_cached_by_ap_id(ap_id) do
1033 key = "ap_id:#{ap_id}"
1035 with {:ok, nil} <- Cachex.get(:user_cache, key),
1036 user when not is_nil(user) <- get_by_ap_id(ap_id),
1037 {:ok, true} <- Cachex.put(:user_cache, key, user) do
1045 def get_cached_by_id(id) do
1049 Cachex.fetch!(:user_cache, key, fn _ ->
1050 user = get_by_id(id)
1053 Cachex.put(:user_cache, "ap_id:#{user.ap_id}", user)
1054 {:commit, user.ap_id}
1060 get_cached_by_ap_id(ap_id)
1063 def get_cached_by_nickname(nickname) do
1064 key = "nickname:#{nickname}"
1066 Cachex.fetch!(:user_cache, key, fn ->
1067 case get_or_fetch_by_nickname(nickname) do
1068 {:ok, user} -> {:commit, user}
1069 {:error, _error} -> {:ignore, nil}
1074 def get_cached_by_nickname_or_id(nickname_or_id, opts \\ []) do
1075 restrict_to_local = Config.get([:instance, :limit_to_local_content])
1078 is_integer(nickname_or_id) or FlakeId.flake_id?(nickname_or_id) ->
1079 get_cached_by_id(nickname_or_id) || get_cached_by_nickname(nickname_or_id)
1081 restrict_to_local == false or not String.contains?(nickname_or_id, "@") ->
1082 get_cached_by_nickname(nickname_or_id)
1084 restrict_to_local == :unauthenticated and match?(%User{}, opts[:for]) ->
1085 get_cached_by_nickname(nickname_or_id)
1092 @spec get_by_nickname(String.t()) :: User.t() | nil
1093 def get_by_nickname(nickname) do
1094 Repo.get_by(User, nickname: nickname) ||
1095 if Regex.match?(~r(@#{Pleroma.Web.Endpoint.host()})i, nickname) do
1096 Repo.get_by(User, nickname: local_nickname(nickname))
1100 def get_by_email(email), do: Repo.get_by(User, email: email)
1102 def get_by_nickname_or_email(nickname_or_email) do
1103 get_by_nickname(nickname_or_email) || get_by_email(nickname_or_email)
1106 def fetch_by_nickname(nickname), do: ActivityPub.make_user_from_nickname(nickname)
1108 def get_or_fetch_by_nickname(nickname) do
1109 with %User{} = user <- get_by_nickname(nickname) do
1113 with [_nick, _domain] <- String.split(nickname, "@"),
1114 {:ok, user} <- fetch_by_nickname(nickname) do
1117 _e -> {:error, "not found " <> nickname}
1122 @spec get_followers_query(User.t(), pos_integer() | nil) :: Ecto.Query.t()
1123 def get_followers_query(%User{} = user, nil) do
1124 User.Query.build(%{followers: user, deactivated: false})
1127 def get_followers_query(%User{} = user, page) do
1129 |> get_followers_query(nil)
1130 |> User.Query.paginate(page, 20)
1133 @spec get_followers_query(User.t()) :: Ecto.Query.t()
1134 def get_followers_query(%User{} = user), do: get_followers_query(user, nil)
1136 @spec get_followers(User.t(), pos_integer() | nil) :: {:ok, list(User.t())}
1137 def get_followers(%User{} = user, page \\ nil) do
1139 |> get_followers_query(page)
1143 @spec get_external_followers(User.t(), pos_integer() | nil) :: {:ok, list(User.t())}
1144 def get_external_followers(%User{} = user, page \\ nil) do
1146 |> get_followers_query(page)
1147 |> User.Query.build(%{external: true})
1151 def get_followers_ids(%User{} = user, page \\ nil) do
1153 |> get_followers_query(page)
1154 |> select([u], u.id)
1158 @spec get_friends_query(User.t(), pos_integer() | nil) :: Ecto.Query.t()
1159 def get_friends_query(%User{} = user, nil) do
1160 User.Query.build(%{friends: user, deactivated: false})
1163 def get_friends_query(%User{} = user, page) do
1165 |> get_friends_query(nil)
1166 |> User.Query.paginate(page, 20)
1169 @spec get_friends_query(User.t()) :: Ecto.Query.t()
1170 def get_friends_query(%User{} = user), do: get_friends_query(user, nil)
1172 def get_friends(%User{} = user, page \\ nil) do
1174 |> get_friends_query(page)
1178 def get_friends_ap_ids(%User{} = user) do
1180 |> get_friends_query(nil)
1181 |> select([u], u.ap_id)
1185 def get_friends_ids(%User{} = user, page \\ nil) do
1187 |> get_friends_query(page)
1188 |> select([u], u.id)
1192 def increase_note_count(%User{} = user) do
1194 |> where(id: ^user.id)
1195 |> update([u], inc: [note_count: 1])
1197 |> Repo.update_all([])
1199 {1, [user]} -> set_cache(user)
1204 def decrease_note_count(%User{} = user) do
1206 |> where(id: ^user.id)
1209 note_count: fragment("greatest(0, note_count - 1)")
1213 |> Repo.update_all([])
1215 {1, [user]} -> set_cache(user)
1220 def update_note_count(%User{} = user, note_count \\ nil) do
1225 where: fragment("?->>'actor' = ? and ?->>'type' = 'Note'", a.data, ^user.ap_id, a.data),
1231 |> cast(%{note_count: note_count}, [:note_count])
1232 |> update_and_set_cache()
1235 @spec maybe_fetch_follow_information(User.t()) :: User.t()
1236 def maybe_fetch_follow_information(user) do
1237 with {:ok, user} <- fetch_follow_information(user) do
1241 Logger.error("Follower/Following counter update for #{user.ap_id} failed.\n#{inspect(e)}")
1247 def fetch_follow_information(user) do
1248 with {:ok, info} <- ActivityPub.fetch_follow_information_for_user(user) do
1250 |> follow_information_changeset(info)
1251 |> update_and_set_cache()
1255 defp follow_information_changeset(user, params) do
1262 :hide_followers_count,
1267 @spec update_follower_count(User.t()) :: {:ok, User.t()}
1268 def update_follower_count(%User{} = user) do
1269 if user.local or !Config.get([:instance, :external_user_synchronization]) do
1270 follower_count = FollowingRelationship.follower_count(user)
1273 |> follow_information_changeset(%{follower_count: follower_count})
1274 |> update_and_set_cache
1276 {:ok, maybe_fetch_follow_information(user)}
1280 @spec update_following_count(User.t()) :: {:ok, User.t()}
1281 def update_following_count(%User{local: false} = user) do
1282 if Config.get([:instance, :external_user_synchronization]) do
1283 {:ok, maybe_fetch_follow_information(user)}
1289 def update_following_count(%User{local: true} = user) do
1290 following_count = FollowingRelationship.following_count(user)
1293 |> follow_information_changeset(%{following_count: following_count})
1294 |> update_and_set_cache()
1297 def set_unread_conversation_count(%User{local: true} = user) do
1298 unread_query = Participation.unread_conversation_count_for_user(user)
1301 |> join(:inner, [u], p in subquery(unread_query))
1303 set: [unread_conversation_count: p.count]
1305 |> where([u], u.id == ^user.id)
1307 |> Repo.update_all([])
1309 {1, [user]} -> set_cache(user)
1314 def set_unread_conversation_count(user), do: {:ok, user}
1316 def increment_unread_conversation_count(conversation, %User{local: true} = user) do
1318 Participation.unread_conversation_count_for_user(user)
1319 |> where([p], p.conversation_id == ^conversation.id)
1322 |> join(:inner, [u], p in subquery(unread_query))
1324 inc: [unread_conversation_count: 1]
1326 |> where([u], u.id == ^user.id)
1327 |> where([u, p], p.count == 0)
1329 |> Repo.update_all([])
1331 {1, [user]} -> set_cache(user)
1336 def increment_unread_conversation_count(_, user), do: {:ok, user}
1338 @spec get_users_from_set([String.t()], keyword()) :: [User.t()]
1339 def get_users_from_set(ap_ids, opts \\ []) do
1340 local_only = Keyword.get(opts, :local_only, true)
1341 criteria = %{ap_id: ap_ids, deactivated: false}
1342 criteria = if local_only, do: Map.put(criteria, :local, true), else: criteria
1344 User.Query.build(criteria)
1348 @spec get_recipients_from_activity(Activity.t()) :: [User.t()]
1349 def get_recipients_from_activity(%Activity{recipients: to, actor: actor}) do
1352 query = User.Query.build(%{recipients_from_activity: to, local: true, deactivated: false})
1358 @spec mute(User.t(), User.t(), map()) ::
1359 {:ok, list(UserRelationship.t())} | {:error, String.t()}
1360 def mute(%User{} = muter, %User{} = mutee, params \\ %{}) do
1361 notifications? = Map.get(params, :notifications, true)
1362 expires_in = Map.get(params, :expires_in, 0)
1364 with {:ok, user_mute} <- UserRelationship.create_mute(muter, mutee),
1365 {:ok, user_notification_mute} <-
1366 (notifications? && UserRelationship.create_notification_mute(muter, mutee)) ||
1368 if expires_in > 0 do
1369 Pleroma.Workers.MuteExpireWorker.enqueue(
1371 %{"muter_id" => muter.id, "mutee_id" => mutee.id},
1372 schedule_in: expires_in
1376 {:ok, Enum.filter([user_mute, user_notification_mute], & &1)}
1380 def unmute(%User{} = muter, %User{} = mutee) do
1381 with {:ok, user_mute} <- UserRelationship.delete_mute(muter, mutee),
1382 {:ok, user_notification_mute} <-
1383 UserRelationship.delete_notification_mute(muter, mutee) do
1384 {:ok, [user_mute, user_notification_mute]}
1388 def subscribe(%User{} = subscriber, %User{} = target) do
1389 deny_follow_blocked = Config.get([:user, :deny_follow_blocked])
1391 if blocks?(target, subscriber) and deny_follow_blocked do
1392 {:error, "Could not subscribe: #{target.nickname} is blocking you"}
1394 # Note: the relationship is inverse: subscriber acts as relationship target
1395 UserRelationship.create_inverse_subscription(target, subscriber)
1399 def subscribe(%User{} = subscriber, %{ap_id: ap_id}) do
1400 with %User{} = subscribee <- get_cached_by_ap_id(ap_id) do
1401 subscribe(subscriber, subscribee)
1405 def unsubscribe(%User{} = unsubscriber, %User{} = target) do
1406 # Note: the relationship is inverse: subscriber acts as relationship target
1407 UserRelationship.delete_inverse_subscription(target, unsubscriber)
1410 def unsubscribe(%User{} = unsubscriber, %{ap_id: ap_id}) do
1411 with %User{} = user <- get_cached_by_ap_id(ap_id) do
1412 unsubscribe(unsubscriber, user)
1416 def block(%User{} = blocker, %User{} = blocked) do
1417 # sever any follow relationships to prevent leaks per activitypub (Pleroma issue #213)
1419 if following?(blocker, blocked) do
1420 {:ok, blocker, _} = unfollow(blocker, blocked)
1426 # clear any requested follows as well
1428 case CommonAPI.reject_follow_request(blocked, blocker) do
1429 {:ok, %User{} = updated_blocked} -> updated_blocked
1433 unsubscribe(blocked, blocker)
1435 unfollowing_blocked = Config.get([:activitypub, :unfollow_blocked], true)
1436 if unfollowing_blocked && following?(blocked, blocker), do: unfollow(blocked, blocker)
1438 {:ok, blocker} = update_follower_count(blocker)
1439 {:ok, blocker, _} = Participation.mark_all_as_read(blocker, blocked)
1440 add_to_block(blocker, blocked)
1443 # helper to handle the block given only an actor's AP id
1444 def block(%User{} = blocker, %{ap_id: ap_id}) do
1445 block(blocker, get_cached_by_ap_id(ap_id))
1448 def unblock(%User{} = blocker, %User{} = blocked) do
1449 remove_from_block(blocker, blocked)
1452 # helper to handle the block given only an actor's AP id
1453 def unblock(%User{} = blocker, %{ap_id: ap_id}) do
1454 unblock(blocker, get_cached_by_ap_id(ap_id))
1457 def mutes?(nil, _), do: false
1458 def mutes?(%User{} = user, %User{} = target), do: mutes_user?(user, target)
1460 def mutes_user?(%User{} = user, %User{} = target) do
1461 UserRelationship.mute_exists?(user, target)
1464 @spec muted_notifications?(User.t() | nil, User.t() | map()) :: boolean()
1465 def muted_notifications?(nil, _), do: false
1467 def muted_notifications?(%User{} = user, %User{} = target),
1468 do: UserRelationship.notification_mute_exists?(user, target)
1470 def blocks?(nil, _), do: false
1472 def blocks?(%User{} = user, %User{} = target) do
1473 blocks_user?(user, target) ||
1474 (blocks_domain?(user, target) and not User.following?(user, target))
1477 def blocks_user?(%User{} = user, %User{} = target) do
1478 UserRelationship.block_exists?(user, target)
1481 def blocks_user?(_, _), do: false
1483 def blocks_domain?(%User{} = user, %User{} = target) do
1484 domain_blocks = Pleroma.Web.ActivityPub.MRF.subdomains_regex(user.domain_blocks)
1485 %{host: host} = URI.parse(target.ap_id)
1486 Pleroma.Web.ActivityPub.MRF.subdomain_match?(domain_blocks, host)
1489 def blocks_domain?(_, _), do: false
1491 def subscribed_to?(%User{} = user, %User{} = target) do
1492 # Note: the relationship is inverse: subscriber acts as relationship target
1493 UserRelationship.inverse_subscription_exists?(target, user)
1496 def subscribed_to?(%User{} = user, %{ap_id: ap_id}) do
1497 with %User{} = target <- get_cached_by_ap_id(ap_id) do
1498 subscribed_to?(user, target)
1503 Returns map of outgoing (blocked, muted etc.) relationships' user AP IDs by relation type.
1504 E.g. `outgoing_relationships_ap_ids(user, [:block])` -> `%{block: ["https://some.site/users/userapid"]}`
1506 @spec outgoing_relationships_ap_ids(User.t(), list(atom())) :: %{atom() => list(String.t())}
1507 def outgoing_relationships_ap_ids(_user, []), do: %{}
1509 def outgoing_relationships_ap_ids(nil, _relationship_types), do: %{}
1511 def outgoing_relationships_ap_ids(%User{} = user, relationship_types)
1512 when is_list(relationship_types) do
1515 |> assoc(:outgoing_relationships)
1516 |> join(:inner, [user_rel], u in assoc(user_rel, :target))
1517 |> where([user_rel, u], user_rel.relationship_type in ^relationship_types)
1518 |> select([user_rel, u], [user_rel.relationship_type, fragment("array_agg(?)", u.ap_id)])
1519 |> group_by([user_rel, u], user_rel.relationship_type)
1521 |> Enum.into(%{}, fn [k, v] -> {k, v} end)
1526 fn rel_type -> {rel_type, db_result[rel_type] || []} end
1530 def incoming_relationships_ungrouped_ap_ids(user, relationship_types, ap_ids \\ nil)
1532 def incoming_relationships_ungrouped_ap_ids(_user, [], _ap_ids), do: []
1534 def incoming_relationships_ungrouped_ap_ids(nil, _relationship_types, _ap_ids), do: []
1536 def incoming_relationships_ungrouped_ap_ids(%User{} = user, relationship_types, ap_ids)
1537 when is_list(relationship_types) do
1539 |> assoc(:incoming_relationships)
1540 |> join(:inner, [user_rel], u in assoc(user_rel, :source))
1541 |> where([user_rel, u], user_rel.relationship_type in ^relationship_types)
1542 |> maybe_filter_on_ap_id(ap_ids)
1543 |> select([user_rel, u], u.ap_id)
1548 defp maybe_filter_on_ap_id(query, ap_ids) when is_list(ap_ids) do
1549 where(query, [user_rel, u], u.ap_id in ^ap_ids)
1552 defp maybe_filter_on_ap_id(query, _ap_ids), do: query
1554 def deactivate_async(user, status \\ true) do
1555 BackgroundWorker.enqueue("deactivate_user", %{"user_id" => user.id, "status" => status})
1558 def deactivate(user, status \\ true)
1560 def deactivate(users, status) when is_list(users) do
1561 Repo.transaction(fn ->
1562 for user <- users, do: deactivate(user, status)
1566 def deactivate(%User{} = user, status) do
1567 with {:ok, user} <- set_activation_status(user, status) do
1570 |> Enum.filter(& &1.local)
1571 |> Enum.each(&set_cache(update_following_count(&1)))
1573 # Only update local user counts, remote will be update during the next pull.
1576 |> Enum.filter(& &1.local)
1577 |> Enum.each(&do_unfollow(user, &1))
1583 def approve(users) when is_list(users) do
1584 Repo.transaction(fn ->
1585 Enum.map(users, fn user ->
1586 with {:ok, user} <- approve(user), do: user
1591 def approve(%User{} = user) do
1592 change(user, approval_pending: false)
1593 |> update_and_set_cache()
1596 def update_notification_settings(%User{} = user, settings) do
1598 |> cast(%{notification_settings: settings}, [])
1599 |> cast_embed(:notification_settings)
1600 |> validate_required([:notification_settings])
1601 |> update_and_set_cache()
1604 @spec purge_user_changeset(User.t()) :: Changeset.t()
1605 def purge_user_changeset(user) do
1606 # "Right to be forgotten"
1607 # https://gdpr.eu/right-to-be-forgotten/
1618 last_refreshed_at: nil,
1619 last_digest_emailed_at: nil,
1626 confirmation_pending: false,
1627 password_reset_pending: false,
1628 approval_pending: false,
1629 registration_reason: nil,
1630 confirmation_token: nil,
1634 is_moderator: false,
1636 mastofe_settings: nil,
1639 pleroma_settings_store: %{},
1642 discoverable: false,
1647 def delete(users) when is_list(users) do
1648 for user <- users, do: delete(user)
1651 def delete(%User{} = user) do
1652 BackgroundWorker.enqueue("delete_user", %{"user_id" => user.id})
1655 defp delete_and_invalidate_cache(%User{} = user) do
1656 invalidate_cache(user)
1660 defp delete_or_deactivate(%User{local: false} = user), do: delete_and_invalidate_cache(user)
1662 defp delete_or_deactivate(%User{local: true} = user) do
1663 status = account_status(user)
1666 :confirmation_pending ->
1667 delete_and_invalidate_cache(user)
1669 :approval_pending ->
1670 delete_and_invalidate_cache(user)
1674 |> purge_user_changeset()
1675 |> update_and_set_cache()
1679 def perform(:force_password_reset, user), do: force_password_reset(user)
1681 @spec perform(atom(), User.t()) :: {:ok, User.t()}
1682 def perform(:delete, %User{} = user) do
1683 # Remove all relationships
1686 |> Enum.each(fn follower ->
1687 ActivityPub.unfollow(follower, user)
1688 unfollow(follower, user)
1693 |> Enum.each(fn followed ->
1694 ActivityPub.unfollow(user, followed)
1695 unfollow(user, followed)
1698 delete_user_activities(user)
1699 delete_notifications_from_user_activities(user)
1701 delete_outgoing_pending_follow_requests(user)
1703 delete_or_deactivate(user)
1706 def perform(:deactivate_async, user, status), do: deactivate(user, status)
1708 @spec perform(atom(), User.t(), list()) :: list() | {:error, any()}
1709 def perform(:blocks_import, %User{} = blocker, blocked_identifiers)
1710 when is_list(blocked_identifiers) do
1712 blocked_identifiers,
1713 fn blocked_identifier ->
1714 with {:ok, %User{} = blocked} <- get_or_fetch(blocked_identifier),
1715 {:ok, _block} <- CommonAPI.block(blocker, blocked) do
1719 Logger.debug("blocks_import failed for #{blocked_identifier} with: #{inspect(err)}")
1726 def perform(:follow_import, %User{} = follower, followed_identifiers)
1727 when is_list(followed_identifiers) do
1729 followed_identifiers,
1730 fn followed_identifier ->
1731 with {:ok, %User{} = followed} <- get_or_fetch(followed_identifier),
1732 {:ok, follower} <- maybe_direct_follow(follower, followed),
1733 {:ok, _, _, _} <- CommonAPI.follow(follower, followed) do
1737 Logger.debug("follow_import failed for #{followed_identifier} with: #{inspect(err)}")
1744 @spec external_users_query() :: Ecto.Query.t()
1745 def external_users_query do
1753 @spec external_users(keyword()) :: [User.t()]
1754 def external_users(opts \\ []) do
1756 external_users_query()
1757 |> select([u], struct(u, [:id, :ap_id]))
1761 do: where(query, [u], u.id > ^opts[:max_id]),
1766 do: limit(query, ^opts[:limit]),
1772 def blocks_import(%User{} = blocker, blocked_identifiers) when is_list(blocked_identifiers) do
1773 BackgroundWorker.enqueue("blocks_import", %{
1774 "blocker_id" => blocker.id,
1775 "blocked_identifiers" => blocked_identifiers
1779 def follow_import(%User{} = follower, followed_identifiers)
1780 when is_list(followed_identifiers) do
1781 BackgroundWorker.enqueue("follow_import", %{
1782 "follower_id" => follower.id,
1783 "followed_identifiers" => followed_identifiers
1787 def delete_notifications_from_user_activities(%User{ap_id: ap_id}) do
1789 |> join(:inner, [n], activity in assoc(n, :activity))
1790 |> where([n, a], fragment("? = ?", a.actor, ^ap_id))
1791 |> Repo.delete_all()
1794 def delete_user_activities(%User{ap_id: ap_id} = user) do
1796 |> Activity.Queries.by_actor()
1797 |> Repo.chunk_stream(50, :batches)
1798 |> Stream.each(fn activities ->
1799 Enum.each(activities, fn activity -> delete_activity(activity, user) end)
1804 defp delete_activity(%{data: %{"type" => "Create", "object" => object}} = activity, user) do
1805 with {_, %Object{}} <- {:find_object, Object.get_by_ap_id(object)},
1806 {:ok, delete_data, _} <- Builder.delete(user, object) do
1807 Pipeline.common_pipeline(delete_data, local: user.local)
1809 {:find_object, nil} ->
1810 # We have the create activity, but not the object, it was probably pruned.
1811 # Insert a tombstone and try again
1812 with {:ok, tombstone_data, _} <- Builder.tombstone(user.ap_id, object),
1813 {:ok, _tombstone} <- Object.create(tombstone_data) do
1814 delete_activity(activity, user)
1818 Logger.error("Could not delete #{object} created by #{activity.data["ap_id"]}")
1819 Logger.error("Error: #{inspect(e)}")
1823 defp delete_activity(%{data: %{"type" => type}} = activity, user)
1824 when type in ["Like", "Announce"] do
1825 {:ok, undo, _} = Builder.undo(user, activity)
1826 Pipeline.common_pipeline(undo, local: user.local)
1829 defp delete_activity(_activity, _user), do: "Doing nothing"
1831 defp delete_outgoing_pending_follow_requests(user) do
1833 |> FollowingRelationship.outgoing_pending_follow_requests_query()
1834 |> Repo.delete_all()
1837 def html_filter_policy(%User{no_rich_text: true}) do
1838 Pleroma.HTML.Scrubber.TwitterText
1841 def html_filter_policy(_), do: Config.get([:markup, :scrub_policy])
1843 def fetch_by_ap_id(ap_id, opts \\ []), do: ActivityPub.make_user_from_ap_id(ap_id, opts)
1845 def get_or_fetch_by_ap_id(ap_id, opts \\ []) do
1846 cached_user = get_cached_by_ap_id(ap_id)
1848 maybe_fetched_user = needs_update?(cached_user) && fetch_by_ap_id(ap_id, opts)
1850 case {cached_user, maybe_fetched_user} do
1851 {_, {:ok, %User{} = user}} ->
1854 {%User{} = user, _} ->
1858 {:error, :not_found}
1863 Creates an internal service actor by URI if missing.
1864 Optionally takes nickname for addressing.
1866 @spec get_or_create_service_actor_by_ap_id(String.t(), String.t()) :: User.t() | nil
1867 def get_or_create_service_actor_by_ap_id(uri, nickname) do
1869 case get_cached_by_ap_id(uri) do
1871 with {:error, %{errors: errors}} <- create_service_actor(uri, nickname) do
1872 Logger.error("Cannot create service actor: #{uri}/.\n#{inspect(errors)}")
1876 %User{invisible: false} = user ->
1886 @spec set_invisible(User.t()) :: {:ok, User.t()}
1887 defp set_invisible(user) do
1889 |> change(%{invisible: true})
1890 |> update_and_set_cache()
1893 @spec create_service_actor(String.t(), String.t()) ::
1894 {:ok, User.t()} | {:error, Ecto.Changeset.t()}
1895 defp create_service_actor(uri, nickname) do
1901 follower_address: uri <> "/followers"
1904 |> unique_constraint(:nickname)
1909 def public_key(%{public_key: public_key_pem}) when is_binary(public_key_pem) do
1912 |> :public_key.pem_decode()
1914 |> :public_key.pem_entry_decode()
1919 def public_key(_), do: {:error, "key not found"}
1921 def get_public_key_for_ap_id(ap_id, opts \\ []) do
1922 with {:ok, %User{} = user} <- get_or_fetch_by_ap_id(ap_id, opts),
1923 {:ok, public_key} <- public_key(user) do
1930 def ap_enabled?(%User{local: true}), do: true
1931 def ap_enabled?(%User{ap_enabled: ap_enabled}), do: ap_enabled
1932 def ap_enabled?(_), do: false
1934 @doc "Gets or fetch a user by uri or nickname."
1935 @spec get_or_fetch(String.t()) :: {:ok, User.t()} | {:error, String.t()}
1936 def get_or_fetch("http" <> _host = uri), do: get_or_fetch_by_ap_id(uri)
1937 def get_or_fetch(nickname), do: get_or_fetch_by_nickname(nickname)
1939 # wait a period of time and return newest version of the User structs
1940 # this is because we have synchronous follow APIs and need to simulate them
1941 # with an async handshake
1942 def wait_and_refresh(_, %User{local: true} = a, %User{local: true} = b) do
1943 with %User{} = a <- get_cached_by_id(a.id),
1944 %User{} = b <- get_cached_by_id(b.id) do
1951 def wait_and_refresh(timeout, %User{} = a, %User{} = b) do
1952 with :ok <- :timer.sleep(timeout),
1953 %User{} = a <- get_cached_by_id(a.id),
1954 %User{} = b <- get_cached_by_id(b.id) do
1961 def parse_bio(bio) when is_binary(bio) and bio != "" do
1963 |> CommonUtils.format_input("text/plain", mentions_format: :full)
1967 def parse_bio(_), do: ""
1969 def parse_bio(bio, user) when is_binary(bio) and bio != "" do
1970 # TODO: get profile URLs other than user.ap_id
1971 profile_urls = [user.ap_id]
1974 |> CommonUtils.format_input("text/plain",
1975 mentions_format: :full,
1976 rel: &RelMe.maybe_put_rel_me(&1, profile_urls)
1981 def parse_bio(_, _), do: ""
1983 def tag(user_identifiers, tags) when is_list(user_identifiers) do
1984 Repo.transaction(fn ->
1985 for user_identifier <- user_identifiers, do: tag(user_identifier, tags)
1989 def tag(nickname, tags) when is_binary(nickname),
1990 do: tag(get_by_nickname(nickname), tags)
1992 def tag(%User{} = user, tags),
1993 do: update_tags(user, Enum.uniq((user.tags || []) ++ normalize_tags(tags)))
1995 def untag(user_identifiers, tags) when is_list(user_identifiers) do
1996 Repo.transaction(fn ->
1997 for user_identifier <- user_identifiers, do: untag(user_identifier, tags)
2001 def untag(nickname, tags) when is_binary(nickname),
2002 do: untag(get_by_nickname(nickname), tags)
2004 def untag(%User{} = user, tags),
2005 do: update_tags(user, (user.tags || []) -- normalize_tags(tags))
2007 defp update_tags(%User{} = user, new_tags) do
2008 {:ok, updated_user} =
2010 |> change(%{tags: new_tags})
2011 |> update_and_set_cache()
2016 defp normalize_tags(tags) do
2019 |> Enum.map(&String.downcase/1)
2022 defp local_nickname_regex do
2023 if Config.get([:instance, :extended_nickname_format]) do
2024 @extended_local_nickname_regex
2026 @strict_local_nickname_regex
2030 def local_nickname(nickname_or_mention) do
2033 |> String.split("@")
2037 def full_nickname(nickname_or_mention),
2038 do: String.trim_leading(nickname_or_mention, "@")
2040 def error_user(ap_id) do
2044 nickname: "erroruser@example.com",
2045 inserted_at: NaiveDateTime.utc_now()
2049 @spec all_superusers() :: [User.t()]
2050 def all_superusers do
2051 User.Query.build(%{super_users: true, local: true, deactivated: false})
2055 def muting_reblogs?(%User{} = user, %User{} = target) do
2056 UserRelationship.reblog_mute_exists?(user, target)
2059 def showing_reblogs?(%User{} = user, %User{} = target) do
2060 not muting_reblogs?(user, target)
2064 The function returns a query to get users with no activity for given interval of days.
2065 Inactive users are those who didn't read any notification, or had any activity where
2066 the user is the activity's actor, during `inactivity_threshold` days.
2067 Deactivated users will not appear in this list.
2071 iex> Pleroma.User.list_inactive_users()
2074 @spec list_inactive_users_query(integer()) :: Ecto.Query.t()
2075 def list_inactive_users_query(inactivity_threshold \\ 7) do
2076 negative_inactivity_threshold = -inactivity_threshold
2077 now = NaiveDateTime.truncate(NaiveDateTime.utc_now(), :second)
2078 # Subqueries are not supported in `where` clauses, join gets too complicated.
2079 has_read_notifications =
2080 from(n in Pleroma.Notification,
2081 where: n.seen == true,
2083 having: max(n.updated_at) > datetime_add(^now, ^negative_inactivity_threshold, "day"),
2086 |> Pleroma.Repo.all()
2088 from(u in Pleroma.User,
2089 left_join: a in Pleroma.Activity,
2090 on: u.ap_id == a.actor,
2091 where: not is_nil(u.nickname),
2092 where: u.deactivated != ^true,
2093 where: u.id not in ^has_read_notifications,
2096 max(a.inserted_at) < datetime_add(^now, ^negative_inactivity_threshold, "day") or
2097 is_nil(max(a.inserted_at))
2102 Enable or disable email notifications for user
2106 iex> Pleroma.User.switch_email_notifications(Pleroma.User{email_notifications: %{"digest" => false}}, "digest", true)
2107 Pleroma.User{email_notifications: %{"digest" => true}}
2109 iex> Pleroma.User.switch_email_notifications(Pleroma.User{email_notifications: %{"digest" => true}}, "digest", false)
2110 Pleroma.User{email_notifications: %{"digest" => false}}
2112 @spec switch_email_notifications(t(), String.t(), boolean()) ::
2113 {:ok, t()} | {:error, Ecto.Changeset.t()}
2114 def switch_email_notifications(user, type, status) do
2115 User.update_email_notifications(user, %{type => status})
2119 Set `last_digest_emailed_at` value for the user to current time
2121 @spec touch_last_digest_emailed_at(t()) :: t()
2122 def touch_last_digest_emailed_at(user) do
2123 now = NaiveDateTime.truncate(NaiveDateTime.utc_now(), :second)
2125 {:ok, updated_user} =
2127 |> change(%{last_digest_emailed_at: now})
2128 |> update_and_set_cache()
2133 @spec toggle_confirmation(User.t()) :: {:ok, User.t()} | {:error, Changeset.t()}
2134 def toggle_confirmation(%User{} = user) do
2136 |> confirmation_changeset(need_confirmation: !user.confirmation_pending)
2137 |> update_and_set_cache()
2140 @spec toggle_confirmation([User.t()]) :: [{:ok, User.t()} | {:error, Changeset.t()}]
2141 def toggle_confirmation(users) do
2142 Enum.map(users, &toggle_confirmation/1)
2145 def get_mascot(%{mascot: %{} = mascot}) when not is_nil(mascot) do
2149 def get_mascot(%{mascot: mascot}) when is_nil(mascot) do
2150 # use instance-default
2151 config = Config.get([:assets, :mascots])
2152 default_mascot = Config.get([:assets, :default_mascot])
2153 mascot = Keyword.get(config, default_mascot)
2156 "id" => "default-mascot",
2157 "url" => mascot[:url],
2158 "preview_url" => mascot[:url],
2160 "mime_type" => mascot[:mime_type]
2165 def ensure_keys_present(%{keys: keys} = user) when not is_nil(keys), do: {:ok, user}
2167 def ensure_keys_present(%User{} = user) do
2168 with {:ok, pem} <- Keys.generate_rsa_pem() do
2170 |> cast(%{keys: pem}, [:keys])
2171 |> validate_required([:keys])
2172 |> update_and_set_cache()
2176 def get_ap_ids_by_nicknames(nicknames) do
2178 where: u.nickname in ^nicknames,
2184 defp put_password_hash(
2185 %Ecto.Changeset{valid?: true, changes: %{password: password}} = changeset
2187 change(changeset, password_hash: Pbkdf2.hash_pwd_salt(password))
2190 defp put_password_hash(changeset), do: changeset
2192 def is_internal_user?(%User{nickname: nil}), do: true
2193 def is_internal_user?(%User{local: true, nickname: "internal." <> _}), do: true
2194 def is_internal_user?(_), do: false
2196 # A hack because user delete activities have a fake id for whatever reason
2197 # TODO: Get rid of this
2198 def get_delivered_users_by_object_id("pleroma:fake_object_id"), do: []
2200 def get_delivered_users_by_object_id(object_id) do
2202 inner_join: delivery in assoc(u, :deliveries),
2203 where: delivery.object_id == ^object_id
2208 def change_email(user, email) do
2210 |> cast(%{email: email}, [:email])
2211 |> validate_required([:email])
2212 |> unique_constraint(:email)
2213 |> validate_format(:email, @email_regex)
2214 |> update_and_set_cache()
2217 # Internal function; public one is `deactivate/2`
2218 defp set_activation_status(user, deactivated) do
2220 |> cast(%{deactivated: deactivated}, [:deactivated])
2221 |> update_and_set_cache()
2224 def update_banner(user, banner) do
2226 |> cast(%{banner: banner}, [:banner])
2227 |> update_and_set_cache()
2230 def update_background(user, background) do
2232 |> cast(%{background: background}, [:background])
2233 |> update_and_set_cache()
2236 def roles(%{is_moderator: is_moderator, is_admin: is_admin}) do
2239 moderator: is_moderator
2243 def validate_fields(changeset, remote? \\ false) do
2244 limit_name = if remote?, do: :max_remote_account_fields, else: :max_account_fields
2245 limit = Config.get([:instance, limit_name], 0)
2248 |> validate_length(:fields, max: limit)
2249 |> validate_change(:fields, fn :fields, fields ->
2250 if Enum.all?(fields, &valid_field?/1) do
2258 defp valid_field?(%{"name" => name, "value" => value}) do
2259 name_limit = Config.get([:instance, :account_field_name_length], 255)
2260 value_limit = Config.get([:instance, :account_field_value_length], 255)
2262 is_binary(name) && is_binary(value) && String.length(name) <= name_limit &&
2263 String.length(value) <= value_limit
2266 defp valid_field?(_), do: false
2268 defp truncate_field(%{"name" => name, "value" => value}) do
2270 String.split_at(name, Config.get([:instance, :account_field_name_length], 255))
2273 String.split_at(value, Config.get([:instance, :account_field_value_length], 255))
2275 %{"name" => name, "value" => value}
2278 def admin_api_update(user, params) do
2285 |> update_and_set_cache()
2288 @doc "Signs user out of all applications"
2289 def global_sign_out(user) do
2290 OAuth.Authorization.delete_user_authorizations(user)
2291 OAuth.Token.delete_user_tokens(user)
2294 def mascot_update(user, url) do
2296 |> cast(%{mascot: url}, [:mascot])
2297 |> validate_required([:mascot])
2298 |> update_and_set_cache()
2301 def mastodon_settings_update(user, settings) do
2303 |> cast(%{mastofe_settings: settings}, [:mastofe_settings])
2304 |> validate_required([:mastofe_settings])
2305 |> update_and_set_cache()
2308 @spec confirmation_changeset(User.t(), keyword()) :: Changeset.t()
2309 def confirmation_changeset(user, need_confirmation: need_confirmation?) do
2311 if need_confirmation? do
2313 confirmation_pending: true,
2314 confirmation_token: :crypto.strong_rand_bytes(32) |> Base.url_encode64()
2318 confirmation_pending: false,
2319 confirmation_token: nil
2323 cast(user, params, [:confirmation_pending, :confirmation_token])
2326 @spec approval_changeset(User.t(), keyword()) :: Changeset.t()
2327 def approval_changeset(user, need_approval: need_approval?) do
2328 params = if need_approval?, do: %{approval_pending: true}, else: %{approval_pending: false}
2329 cast(user, params, [:approval_pending])
2332 def add_pinnned_activity(user, %Pleroma.Activity{id: id}) do
2333 if id not in user.pinned_activities do
2334 max_pinned_statuses = Config.get([:instance, :max_pinned_statuses], 0)
2335 params = %{pinned_activities: user.pinned_activities ++ [id]}
2337 # if pinned activity was scheduled for deletion, we remove job
2338 if expiration = Pleroma.Workers.PurgeExpiredActivity.get_expiration(id) do
2339 Oban.cancel_job(expiration.id)
2343 |> cast(params, [:pinned_activities])
2344 |> validate_length(:pinned_activities,
2345 max: max_pinned_statuses,
2346 message: "You have already pinned the maximum number of statuses"
2351 |> update_and_set_cache()
2354 def remove_pinnned_activity(user, %Pleroma.Activity{id: id, data: data}) do
2355 params = %{pinned_activities: List.delete(user.pinned_activities, id)}
2357 # if pinned activity was scheduled for deletion, we reschedule it for deletion
2358 if data["expires_at"] do
2359 {:ok, expires_at, _} = DateTime.from_iso8601(data["expires_at"])
2361 Pleroma.Workers.PurgeExpiredActivity.enqueue(%{
2363 expires_at: expires_at
2368 |> cast(params, [:pinned_activities])
2369 |> update_and_set_cache()
2372 def update_email_notifications(user, settings) do
2373 email_notifications =
2374 user.email_notifications
2375 |> Map.merge(settings)
2376 |> Map.take(["digest"])
2378 params = %{email_notifications: email_notifications}
2379 fields = [:email_notifications]
2382 |> cast(params, fields)
2383 |> validate_required(fields)
2384 |> update_and_set_cache()
2387 defp set_domain_blocks(user, domain_blocks) do
2388 params = %{domain_blocks: domain_blocks}
2391 |> cast(params, [:domain_blocks])
2392 |> validate_required([:domain_blocks])
2393 |> update_and_set_cache()
2396 def block_domain(user, domain_blocked) do
2397 set_domain_blocks(user, Enum.uniq([domain_blocked | user.domain_blocks]))
2400 def unblock_domain(user, domain_blocked) do
2401 set_domain_blocks(user, List.delete(user.domain_blocks, domain_blocked))
2404 @spec add_to_block(User.t(), User.t()) ::
2405 {:ok, UserRelationship.t()} | {:error, Ecto.Changeset.t()}
2406 defp add_to_block(%User{} = user, %User{} = blocked) do
2407 UserRelationship.create_block(user, blocked)
2410 @spec add_to_block(User.t(), User.t()) ::
2411 {:ok, UserRelationship.t()} | {:ok, nil} | {:error, Ecto.Changeset.t()}
2412 defp remove_from_block(%User{} = user, %User{} = blocked) do
2413 UserRelationship.delete_block(user, blocked)
2416 def set_invisible(user, invisible) do
2417 params = %{invisible: invisible}
2420 |> cast(params, [:invisible])
2421 |> validate_required([:invisible])
2422 |> update_and_set_cache()
2425 def sanitize_html(%User{} = user) do
2426 sanitize_html(user, nil)
2429 # User data that mastodon isn't filtering (treated as plaintext):
2432 def sanitize_html(%User{} = user, filter) do
2434 Enum.map(user.fields, fn %{"name" => name, "value" => value} ->
2437 "value" => HTML.filter_tags(value, Pleroma.HTML.Scrubber.LinksOnly)
2442 |> Map.put(:bio, HTML.filter_tags(user.bio, filter))
2443 |> Map.put(:fields, fields)