Title: Capsquery Facial Authentication
Author: arijit1992
Published: <strong>2026 年 7 月 15 日</strong>
Last modified: 2026 年 7 月 16 日

---

搜索插件

![](https://ps.w.org/capsquery-facial-authentication/assets/banner-772x250.png?rev
=3609117)

![](https://ps.w.org/capsquery-facial-authentication/assets/icon-256x256.png?rev
=3609117)

# Capsquery Facial Authentication

 作者：[arijit1992](https://profiles.wordpress.org/arijit1992/)

[下载](https://downloads.wordpress.org/plugin/capsquery-facial-authentication.1.1.4.zip)

 * [详情](https://cn.wordpress.org/plugins/capsquery-facial-authentication/#description)
 * [评价](https://cn.wordpress.org/plugins/capsquery-facial-authentication/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/capsquery-facial-authentication/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/capsquery-facial-authentication/#developers)

 [支持](https://wordpress.org/support/plugin/capsquery-facial-authentication/)

## 描述

Capsquery Facial Authentication adds a **Login with Face** button to wp-login.php
and a `[capsquery_facial_authentication]` shortcode for front-end pages.

**How it works**

 1. A user can enrolls their face from **Users  Profile**.
 2. They set a 4–8 digit PIN as a second factor.
 3. At login, the browser captures the face locally using face-api.js.
 4. An encrypted face descriptor is matched on the server.
 5. The user confirms their identity and enters their PIN.

 * Face descriptors encrypted at rest (AES-256-GCM)
 * PIN stored as a secure hash
 * Rate limiting and brute-force protection
 * GDPR export/erase support

**Third-party library**

Face detection and recognition run entirely in the visitor’s browser using [face-api.js](https://github.com/justadudewhohacks/face-api.js)(
MIT license), bundled under `assets/vendor/`. Its pretrained model weights are required
for the plugin to function and are bundled under `assets/models/`. Since the raw
weight files have no meaningful file extension, each one is stored base64-encoded
inside a small `.json` wrapper file and decoded on request by a plugin REST endpoint—
no external network calls or third-party servers are involved.

#### Requirements

 * HTTPS (or localhost for development) — browsers require a secure context for 
   camera access
 * PHP OpenSSL extension
 * A webcam on the client device

### Support

Need help or have questions?

Website: https://capsquery.com/
 Email: arijit.paul@capsquery.com

## 屏幕截图

[⌊Login page with Face Authentication enabled.⌉⌊Login page with Face Authentication
enabled.⌉[

Login page with Face Authentication enabled.

[⌊User Face Enrollment screen.⌉⌊User Face Enrollment screen.⌉[

User Face Enrollment screen.

[⌊PIN verification after successful face recognition.⌉⌊PIN verification after successful
face recognition.⌉[

PIN verification after successful face recognition.

[⌊Plugin Settings page.⌉⌊Plugin Settings page.⌉[

Plugin Settings page.

[⌊Successful facial authentication login.⌉⌊Successful facial authentication login
.⌉[

Successful facial authentication login.

[⌊Unlock with pin page.⌉⌊Unlock with pin page.⌉[

Unlock with pin page.

## 安装

 1. Upload the plugin folder to `/wp-content/plugins/capsquery-facial-authentication/`
    or install via **Plugins  Add New**.
 2. Activate the plugin.
 3. Go to **Settings  Facial Authentication** and confirm Facial Authentication is 
    enabled.
 4. As a user, open **Users  Profile**, enroll your face, and set a PIN.
 5. Visit wp-login.php and click **Login with Face**.

## 常见问题

### Who can use Capsquery Facial Authentication in the free version?

On a single site, this is typically users with the any role.

### Are photos stored on the server?

No. The plugin stores an encrypted mathematical face descriptor (128 numbers), not
an image.

### Is face matching alone enough to log in?

No. A successful face match must be followed by the correct PIN.

### Does it work without HTTPS?

No. Modern browsers block camera access except on HTTPS or localhost.

### How do I add Facial Authentication to a page?

Use the shortcode: `[capsquery_facial_authentication]` or `[capsquery_facial_authentication
redirect="/my-account"]`

### What are the .json files under assets/models?

They are the pretrained face-api.js (MIT-licensed) neural network weights needed
for on-device face detection and recognition. The library’s raw weight files have
no standard file extension, so each one is base64-encoded and wrapped in a `.json`
file; the plugin decodes and streams it back out through its own REST endpoint when
the browser loads the model. They are required — the plugin cannot detect or recognize
faces without them.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Capsquery Facial Authentication」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ arijit1992 ](https://profiles.wordpress.org/arijit1992/)

[帮助将「Capsquery Facial Authentication」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/capsquery-facial-authentication)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/capsquery-facial-authentication/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/capsquery-facial-authentication/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/capsquery-facial-authentication/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/capsquery-facial-authentication/)。

## 更新日志

#### 1.1.0

 * Admin settings page (enable/disable, match sensitivity)
 * Security fixes: removed user_id override, improved REST validation, proper rate-
   limit responses
 * Privacy/GDPR export and erasure support
 * uninstall.php for clean removal
 * Conditional shortcode asset loading

#### 1.1.1

 * Security improvements

#### 1.1.2

 * Fixed issues reported during WordPress.org plugin review.
 * Code cleanup and compliance improvements.

#### 1.1.3

 * Improved facial recognition security by lowering the default matching threshold.
 * Updated available recognition sensitivity presets.
 * Minor security and performance improvements.
 * Improve face detection in low light visibility
 * Minor design improvement

#### 1.1.4

 * Minor change in shortcode condition to fix shortcode js loading issue

## 额外信息

 *  版本 **1.1.4**
 *  最后更新：**2 天前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.0 或更高版本 **
 *  已测试的最高版本为 **7.0.2**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/capsquery-facial-authentication/)
 * 标签
 * [authentication](https://cn.wordpress.org/plugins/tags/authentication/)[biometric](https://cn.wordpress.org/plugins/tags/biometric/)
   [login](https://cn.wordpress.org/plugins/tags/login/)[security](https://cn.wordpress.org/plugins/tags/security/)
 *  [高级视图](https://cn.wordpress.org/plugins/capsquery-facial-authentication/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/)

## 贡献者

 *   [ arijit1992 ](https://profiles.wordpress.org/arijit1992/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/capsquery-facial-authentication/)