README

用户配置文件管理

安装

在 composer.json 中添加 admin 依赖

"open20/amos-admin": "dev-master",

在 modules-amos.php 中启用 Admin 模块，添加

 'admin' => [
	'class' => 'open20\amos\admin\AmosAdmin',
 ],

将 admin 迁移添加到控制台模块（console/config/migrations-amos.php）

'@vendor/open20/amos-admin/src/migrations'

如果需要标签，请启用标签插件中的用户标签根。为此

• 激活标签插件（确保它在模块配置列表中）
• 打开标签管理器（需要管理员权限）url: /tag/manager
• 点击标签树根以启用
• 在页面最后的选项（用户兴趣）中，为需要的用户角色启用。

可配置字段

以下是可配置字段列表，AmosAdmin 模块的属性。如果某些属性的默认值不适合您的项目，您可以在模块中配置它，例如

 'admin' => [
	'class' => 'open20\amos\admin\AmosAdmin',
	'enableRegister' => true, //changed property (default was false)
 ],
 

配置示例

$modules['admin'] =  [
    'class' => 'open20\amos\admin\AmosAdmin',
	'enableRegister' => true,
	'organizationModuleName' => 'organizations',
	'modelMap' => [
		'User' => [
			'class' => 'open20\amos\porting\console\models\PortingUser',
		]
	],
     'fieldsConfigurations' => [
            'boxes' => [
                'box_account_data' => ['form' => true, 'view' => true],
                'box_dati_accesso' => ['form' => true, 'view' => true],
                'box_dati_contatto' => ['form' => true, 'view' => true],
                'box_dati_fiscali_amministrativi' => ['form' => false, 'view' => false],
                'box_dati_nascita' => ['form' => false, 'view' => false],
                'box_email_frequency' => ['form' => true, 'view' => true],
                'box_facilitatori' => ['form' => true, 'view' => true],
                'box_foto' => ['form' => true, 'view' => true],
                'box_informazioni_base' => ['form' => true, 'view' => true],
                'box_presentazione_personale' => ['form' => true, 'view' => true],
                'box_prevalent_partnership' => ['form' => true, 'view' => true],
                'box_privacy' => ['form' => true, 'view' => true],
                'box_questio' => ['form' => false, 'view' => false],
                'box_role_and_area' => ['form' => true, 'view' => true],
                'box_social_account' => ['form' => true, 'view' => true],
            ],
            'fields' => [
                'attivo' => ['form' => true, 'view' => true, 'referToBox' => 'box_account_data'],
                'codice_fiscale' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_fiscali_amministrativi'],
                'cognome' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
                'default_facilitatore' => ['form' => true, 'view' => true],
                'email' => ['form' => true, 'view' => false, 'referToBox' => 'box_dati_contatto'],
                'email_pec' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_contatto'],
                'facebook' => ['form' => true, 'view' => true, 'referToBox' => 'box_social_account'],
                'facilitatore_id' => ['form' => true, 'view' => true, 'referToBox' => 'box_facilitatori'],
                'googleplus' => ['form' => true, 'view' => true, 'referToBox' => 'box_social_account'],
                'linkedin' => ['form' => true, 'view' => true, 'referToBox' => 'box_social_account'],
                'nascita_comuni_id' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_nascita'],
                'nascita_data' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_nascita'],
                'nascita_nazioni_id' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_nascita'],
                'nascita_province_id' => ['form' => false, 'view' => false, 'referToBox' => 'box_dati_nascita'],
                'nome' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
                'note' => ['form' => true, 'view' => false, 'referToBox' => 'box_informazioni_base'],
                'presentazione_breve' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
                'presentazione_personale' => ['form' => true, 'view' => true, 'referToBox' => 'box_presentazione_personale'],
                'prevalent_partnership_id' => ['form' => true, 'view' => true, 'referToBox' => 'box_prevalent_partnership'],
                'privacy' => ['form' => true, 'view' => true, 'referToBox' => 'box_privacy'],
                'sesso' => ['form' => true, 'view' => false, 'referToBox' => 'box_informazioni_base'],
                'telefono' => ['form' => true, 'view' => false, 'referToBox' => 'box_dati_contatto'],
                'twitter' => ['form' => true, 'view' => true, 'referToBox' => 'box_social_account'],
                'ultimo_accesso' => ['form' => true, 'view' => true, 'referToBox' => 'box_account_data'],
                'ultimo_logout' => ['form' => true, 'view' => true, 'referToBox' => 'box_account_data'],
                'username' => ['form' => true, 'view' => false, 'referToBox' => 'box_dati_accesso'],
                'user_profile_age_group_id' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
                'user_profile_area_id' => ['form' => true, 'view' => false, 'referToBox' => 'box_role_and_area'],
                'userProfileImage' => ['form' => true, 'view' => true, 'referToBox' => 'box_foto'],
                'user_profile_role_id' => ['form' => true, 'view' => false, 'referToBox' => 'box_role_and_area'],
            ]
        ]
    ];
    .
    .
    . 
    return $modules;

模块配置参数

• enableRegister - 布尔型，默认 = false
  设置为 true 以启用用户注册到应用程序并创建自己的用户配置文件

• showLogInRegisterButton - 布尔型，默认 = true
  设置为 true 以在登录表单上启用用户注册按钮

• hideStandardLoginPageSection - 布尔型，默认 = false
  如果为 true，则隐藏用户可以输入用户名和密码的登录页面部分。

• textWarningForRegisterDisabled - 字符串，设置显示在注册禁用时的文本

• enableUserContacts - 布尔型，默认 = true
  启用连接到用户、发送私信并在用户配置文件“网络”部分中查看“联系人”

• cached - 布尔型，默认 = false
  启用或禁用管理员查询缓存

• cacheDuration - 整型，默认 = 84600（24小时）
  如果 $cache = true，则查询缓存持续时间（秒）- 默认为 1 天

• bypassWorkflow - 布尔型，默认 = false
  如果为 true，则插件绕过用户配置文件工作流程并显示无关内容

• htmlMailContent - 字符串，默认 = '@vendor/open20/amos-admin/src/mail/user/credenziali-html'
  这是用于渲染电子邮件消息的 html。在视图中，有变量 $profile，它是 'open20\amos\admin\models\UserProfile' 的实例。

• textMailContent - 字符串，默认 = '@vendor/open20/amos-admin/src/mail/user/credenziali-text'
  这是用于渲染电子邮件消息的文本。在视图中，有变量 $profile，它是 'open20\amos\admin\models\UserProfile' 的实例

• fieldsConfigurations - 数组，默认

public $fieldsConfigurations = [
        'boxes' => [
            'box_informazioni_base' => ['form' => true, 'view' => true]
        ],
        'fields' => [
            'nome' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
            'cognome' => ['form' => true, 'view' => true, 'referToBox' => 'box_informazioni_base'],
            'userProfileImage' => ['form' => true, 'view' => true, 'referToBox' => 'box_foto']
        ]
    ];

此数组包含所有配置，用于启用/禁用表单/向导和视图中的框和字段，用于 UserProfile 模型。在 /src/views/user-profile/boxes 中找到所有可能的子视图以启用/禁用用户配置文件。

• profileRequiredFields - 数组，默认 = ['nome', 'cognome', 'status', 'presentazione_breve']
  用户配置文件表单中的必填字段：默认情况下，名称、姓氏、配置文件状态和简短介绍（我用 140 个字符介绍自己）是必填的。
  如果您的平台，例如，您不希望简短介绍成为必填字段，则按如下方式覆盖 profileRequiredFields 属性

'admin' => [
    'class' => 'open20\amos\admin\AmosAdmin',
    'profileRequiredFields' => ['nome', 'cognome', 'status'] 
],

• confManager - ConfigurationManager，默认 = null
  //TODO 解释

• defaultUserRole - 字符串，默认 = 'BASIC_USER'
  在用户创建时，可以自定义分配给新用户的 Rbac 角色，默认为 BASIC_USER 角色。

• organizationModuleName - 字符串，默认 = 'organizzazioni'
  这是模块名称（你在平台模块配置中用作数组键）指代扩展自 open20\amos\core\interfaces\OrganizationsModuleInterface 的模块。它用于提供自定义用于设置用户档案主要合作伙伴的实体类型的可能性，例如。//TODO 更好地解释

• allowLoginWithEmailOrUsername - 布尔值，默认 = true
  此功能允许用户使用用户名或电子邮件登录。默认启用。

• userCanSelectUsername - 布尔值，默认 = false
  如果设置为 false，当创建新用户时，平台自动使用电子邮件中 '@' 前的部分设置用户名。如果用户名不可用，系统生成一个唯一的用户名。默认情况下，用户无法选择用户名。

• disableUpdateChangeStatus - 布尔值，默认 = false
  如果设置为 false，则禁用个人资料修改的弹出窗口。

• enableWorkflowChangeStatusMails - 布尔值，默认 = true
  如果设置为 false，则禁用更改个人资料工作流状态的邮件。

• whiteListProfileImageExts - 字符串，默认 = jpeg, jpg, png, gif
  用于设置个人资料的允许扩展名。

• associateTutor - 整数，默认 = null 在创建用户时，将用户（导师）设置为创建用户的联系人。

• defaultPrivateMessage - 布尔值，默认 = null 在创建用户时，从导师发送一条私人消息

• roleAndAreaOnOrganizations - 布尔值，默认 = false
  如果为 true，则隐藏标准角色和区域，并在单个网络组织行中启用它。

• roleAndAreaFromOrganizationsWithTypeCat - 布尔值，默认 = false
  如果为 true，则在角色和区域查询中使用 "type_cat" 字段。

• sendUserAssignmentsReportOnDelete - 布尔值，默认 = false 当用户删除自己或被其他用户删除时，启用通过电子邮件向所有管理员用户发送报告。邮件包含有关删除用户在应用程序内所有分配的总结。

• enableSendMessage - 布尔值，默认 = false
  如果为 true 且 $enableUserContacts 为 false，则所有用户在查看图标上看到“发送消息”按钮。

• helpLinkAction - 字符串，默认 = null
  从后端运行的操作，通过电子邮件和发送的私人消息进入技术区域部分，启用上述参数。

• showFacilitatorForModuleSelect - 布尔值，默认 = false
  启用修改协调员

• dontCheckOneTagPresent - 布尔值，默认 = false
  如果为 true，则模型验证不检查是否有至少一个标签对非管理员用户存在。

• enableMultiUsersSameCF - 布尔值，默认 = false
  如果为 true，则模型验证不检查税务代码的唯一性。

• enableInviteUserToEvent - 布尔值，默认 = false
  如果为 true，则启用单个用户上的链接，用于通过事件社区邀请用户参加已发布的活动。

• createContentInMyOwnCommunityOnly - 布尔值，默认 = false 如果为 true，则基本验证用户只能在本人社区中创建内容

• actionBlacklistManageInvite - 数组，默认 = [] 用于检查操作控制器可以使用邀请按钮。

如何使用令牌组

首先创建令牌组，然后你可以使用以下函数。

• 您可以使用令牌登录，使用链接 /admin/security/login?token=[令牌]
• 登录后，您将被重定向到 TokenGroup 上设置的 URL

获取创建的令牌组（对于模型，或 model/model_id）

TokenGroup::getTokenGroup($classname, $id = null)

使用 user_id（数组）为组生成用户令牌

$tokenGroup->generateTokenUsersByIds($ids)

使用 user_id 生成单个令牌，@return TokenUsers

$tokenUser = $tokenGroup->generateSingleTokenUser($id)