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://tw.wordpress.org/plugins/capsquery-facial-authentication/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/capsquery-facial-authentication/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/capsquery-facial-authentication/#installation)
 * [開發資訊](https://tw.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 或更新版本 **
 *  已測試相容的 WordPress 版本 **7.0.2**
 *  PHP 版本需求 ** 7.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/capsquery-facial-authentication/)
 * 標籤:
 * [authentication](https://tw.wordpress.org/plugins/tags/authentication/)[biometric](https://tw.wordpress.org/plugins/tags/biometric/)
   [login](https://tw.wordpress.org/plugins/tags/login/)[security](https://tw.wordpress.org/plugins/tags/security/)
 *  [進階檢視](https://tw.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/)