README

ExtendedPasswordField 是一个具有密码显示功能和密码强度进度条的密码输入字段。

ExtendedPasswordField 旨在用于 ATK14 应用程序。

安装

只需使用 Composer

cd path/to/your/atk14/project/
composer require atk14/extended-password-field

ln -s ../../vendor/atk14/extended-password-field/src/app/fields/extended_password_field.php app/fields/
ln -s ../../vendor/atk14/extended-password-field/src/app/widgets/extended_password_widget.php app/widgets/
ln -s ../../../vendor/atk14/extended-password-field/src/public/scripts/utils/extended_password_field.js public/scripts/utils/

ln -s ../../../vendor/atk14/extended-password-field/src/app/controllers/api/password_strength_analyzer_controller.php app/controllers/api/
ln -s ../../../vendor/atk14/extended-password-field/src/app/forms/api/password_strength_analyzer app/forms/api/

链接适当的样式表，可以是 Bootstrap 4 (scss) 或 Bootstrap 3 (less)。

# Bootstrap 4
ln -s ../../../vendor/atk14/extended-password-field/src/public/styles/shared/_extended_password_field.scss public/styles/shared/

# or Bootstrap 3
ln -s ../../../vendor/atk14/extended-password-field/src/public/styles/shared/extended_password_field.less public/styles/shared/

在 gulpfile.js 中将 public/scripts/utils/extended_password_field.js 包含到应用脚本中。

var applicationScripts = [
  // ...
  "public/scripts/utils/extended_password_field.js",
  "public/scripts/application.js"
];

在 public/scripts/application.js 文件中所需位置初始化 ExtendedPasswordField。

// file: public/scripts/application.js

// ...

var
  UTILS = window.UTILS,

  APPLICATION = {
  // ...
  users {
    create_new: function() {
      UTILS.extended_password_field.init();
    }
  },
  // ...  
};

// ...

在 ATK14 应用程序中的使用

在表单中

<?php
// file: app/forms/users/create_new_form.php
class CreateNewForm extends ApplicationForm {

  function set_up(){
    // ...
    $this->add_field("password", new ExtendedPasswordField([
      "minimum_password_strength_required" => 80, // %
      "enable_password_reveal" => true, // default true
      "show_password_strength_progressbar" => true, // default true
    ]));
  }
}

测试

composer update --dev
cd test
../vendor/bin/run_unit_tests

许可证

ExtendedPasswordField 是免费软件，根据 MIT 许可证的条款分发。