Title: Capsquery Facial Authentication
Author: arijit1992
Published: <strong>2026-يىلى 15-ئىيۇل</strong>
Last modified: 2026-يىلى 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://ug.wordpress.org/plugins/capsquery-facial-authentication/#description)
 * [باھالاشلار](https://ug.wordpress.org/plugins/capsquery-facial-authentication/#reviews)
 *  [ئورنىتىش](https://ug.wordpress.org/plugins/capsquery-facial-authentication/#installation)
 * [ئىجادىيەت](https://ug.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**.

## FAQ

### 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

## Meta

 *  Version **1.1.4**
 *  ئاخىرقى يېڭىلانغان ۋاقىت **3 كۈن بۇرۇن**
 *  ئاكتىپ ئورنىتىش سانى **10 دىن ئاز**
 *  WordPress نەشرى ** 6.0 ياكى يۇقىرى **
 *  **7.0.2** دا سىنالغان
 *  PHP نەشرى ** 7.4 ياكى يۇقىرى **
 *  تىل
 * [English (US)](https://wordpress.org/plugins/capsquery-facial-authentication/)
 * بەلگە
 * [authentication](https://ug.wordpress.org/plugins/tags/authentication/)[biometric](https://ug.wordpress.org/plugins/tags/biometric/)
   [login](https://ug.wordpress.org/plugins/tags/login/)[security](https://ug.wordpress.org/plugins/tags/security/)
 *  [ئالىي كۆرۈنۈش](https://ug.wordpress.org/plugins/capsquery-facial-authentication/advanced/)

## دەرىجە

No reviews have been submitted yet.

[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/)