View Source Plausible.Billing.Quota (Plausible v0.0.1)
This module provides functions to work with plans usage and limits.
Summary
Functions
Returns a list of features the user can use. Trial users have the ability to use all features during their trial.
Returns whether the usage is below the limit or not. Returns false if usage is equal to the limit.
Enterprise plans are always allowed to add more sites (even when
over limit) to avoid service disruption. Their usage is checked
in a background job instead (see check_usage.ex).
Given a user, this function returns the features used across all the sites this user owns + StatsAPI if the user has a configured Stats API key.
Returns the number of sites the given user owns.
Returns the total count of team members associated with the user's sites.
Returns whether the usage is within the limit or not. Returns true if usage is equal to the limit.
Types
@type monthly_pageview_usage() :: %{required(period()) => usage_cycle()}
@type period() :: :last_30_days | :current_cycle | :last_cycle | :penultimate_cycle
@type usage_cycle() :: %{ date_range: Date.Range.t(), pageviews: non_neg_integer(), custom_events: non_neg_integer(), total: non_neg_integer() }
Functions
Returns a list of features the user can use. Trial users have the ability to use all features during their trial.
@spec below_limit?(non_neg_integer(), non_neg_integer() | :unlimited) :: boolean()
Returns whether the usage is below the limit or not. Returns false if usage is equal to the limit.
Enterprise plans are always allowed to add more sites (even when
over limit) to avoid service disruption. Their usage is checked
in a background job instead (see check_usage.ex).
@spec features_usage(Plausible.Auth.User.t() | Plausible.Site.t()) :: [atom()]
Given a user, this function returns the features used across all the sites this user owns + StatsAPI if the user has a configured Stats API key.
Given a site, returns the features used by the site.
@spec monthly_pageview_limit( Plausible.Auth.User.t() | Plausible.Billing.Subscription.t() ) :: non_neg_integer() | :unlimited
@spec monthly_pageview_usage(Plausible.Auth.User.t()) :: monthly_pageview_usage()
@spec site_limit(Plausible.Auth.User.t()) :: non_neg_integer() | :unlimited
@spec site_usage(Plausible.Auth.User.t()) :: non_neg_integer()
Returns the number of sites the given user owns.
@spec team_member_limit(Plausible.Auth.User.t()) :: non_neg_integer()
@spec team_member_usage(Plausible.Auth.User.t()) :: integer()
Returns the total count of team members associated with the user's sites.
The given user (i.e. the owner) is not counted as a team member.
Pending invitations are counted as team members even before accepted.
Users are counted uniquely - i.e. even if an account is associated with many sites owned by the given user, they still count as one team member.
usage_cycle(user, cycle, owned_site_ids \\ nil, today \\ Timex.today())
View Source@spec usage_cycle(Plausible.Auth.User.t(), period(), list() | nil, Date.t()) :: usage_cycle()
@spec within_limit?(non_neg_integer(), non_neg_integer() | :unlimited) :: boolean()
Returns whether the usage is within the limit or not. Returns true if usage is equal to the limit.