zotonic_mod_admin_identity

%% @author Marc Worrell <marc@worrell.nl>
%% @copyright 2017-2026 Marc Worrell
%% @doc Model for mod_admin_identity
%% @end

%% Copyright 2017-2026 Marc Worrell
%%
%% Licensed under the Apache License, Version 2.0 (the "License");
%% you may not use this file except in compliance with the License.
%% You may obtain a copy of the License at
%%
%%     http://www.apache.org/licenses/LICENSE-2.0
%%
%% Unless required by applicable law or agreed to in writing, software
%% distributed under the License is distributed on an "AS IS" BASIS,
%% WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
%% See the License for the specific language governing permissions and
%% limitations under the License.

-module(m_admin_identity).
-moduledoc("
Model for admin identity configuration values, including password policy regex and default category/content-group for new users.

Available Model API Paths
-------------------------

| Method | Path pattern | Description |
| --- | --- | --- |
| `get` | `/password_regex/...` | Return `mod_admin_identity.password_regex` used to validate admin-set passwords. |
| `get` | `/new_user_category/...` | Return default category for newly created users from `mod_admin_identity.new_user_category` (fallback: `person`). |
| `get` | `/new_user_contentgroup/...` | Return default content group for newly created users from `mod_admin_identity.new_user_contentgroup` (fallback: `default_content_group`). |

`/+name` marks a variable path segment. A trailing `/...` means extra path segments are accepted for further lookups.
").

-behaviour (zotonic_model).

-export([
    m_get/3
]).

-include_lib("kernel/include/logger.hrl").

-spec m_get( list(), zotonic_model:opt_msg(), z:context() ) -> zotonic_model:return().
m_get([ <<"password_regex">> | Rest ], _Msg, Context) ->
    {ok, {m_config:get_value(mod_admin_identity, password_regex, Context), Rest}};
m_get([ <<"new_user_category">> | Rest ], _Msg, Context) ->
    Cat = case m_config:get_value(mod_admin_identity, new_user_category, Context) of
        undefined -> person;
        <<>> -> person;
        C -> C
    end,
    {ok, {Cat, Rest}};
m_get([ <<"new_user_contentgroup">> | Rest ], _Msg, Context) ->
    CG = case m_config:get_value(mod_admin_identity, new_user_contentgroup, Context) of
        undefined -> default_content_group;
        <<>> -> default_content_group;
        C -> C
    end,
    {ok, {CG, Rest}};
m_get(_Vs, _Msg, _Context) ->
    {error, unknown_path}.