Title: Capsquery Facial Authentication
Author: arijit1992
Published: <strong>تەممووز 15, 2026</strong>
Last modified: تەممووز 16, 2026

---

گەڕان لە پێوەکراوەکان

![](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://ku.wordpress.org/plugins/capsquery-facial-authentication/#description)
 * [پێداچوونەوەکان](https://ku.wordpress.org/plugins/capsquery-facial-authentication/#reviews)
 *  [دامەزراندن](https://ku.wordpress.org/plugins/capsquery-facial-authentication/#installation)
 * [گەشەپێدان](https://ku.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.

## پێداچوونەوەکان

![](https://secure.gravatar.com/avatar/851e4a58a0b3a595c5da6f9fe1134337a101e228eab8592b7c334b5933e8aa0a?
s=60&d=retro&r=g)

### 󠀁[Excellent Plugin](https://wordpress.org/support/topic/excellent-plugin-9938/)󠁿

 [fronttechnologies](https://profiles.wordpress.org/fronttechnologies/) ئاب 8, 2026

I have used this plugin for my website, and it is really working so nice and very
easy to use

![](https://secure.gravatar.com/avatar/0f20922ed83e5bd0ac79a2667a325b599f711a4faa069405ba1158016bed220d?
s=60&d=retro&r=g)

### 󠀁[Excellent plugin, working great.](https://wordpress.org/support/topic/very-helpful-1604/)󠁿

 [debjit94](https://profiles.wordpress.org/debjit94/) تەممووز 31, 2026

I am using this plugin for a team of 25 people and it is working great. I have tried
many but this one is a complete solution.

![](https://secure.gravatar.com/avatar/1440dea4fd09d8b0cf80460a7ef1eaebbba8d8a6819fdf44e62a24b91e803821?
s=60&d=retro&r=g)

### 󠀁[Excellent Facial Authentication Plugin](https://wordpress.org/support/topic/excellent-facial-authentication-plugin/)󠁿

 [Sudip Debnath](https://profiles.wordpress.org/developersd/) تەممووز 27, 2026

Easy to set up, works smoothly, and delivers reliable facial authentication. A well-
built plugin with a simple and user-friendly experience. Highly recommended.

 [ خوێندنەوەی 3 پێداچوونەوە ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/)

## بەشداربووان و گەشەپێدەران

“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/)
بکە، یان بەشداربە لە [ڕووداوتۆماری گەشەپێدان](https://plugins.trac.wordpress.org/log/capsquery-facial-authentication/)
لە ڕێگەی [(RSS)](https://plugins.trac.wordpress.org/log/capsquery-facial-authentication/?limit=100&mode=stop_on_copy&format=rss).

## ڕووداوتۆمارگەریی گۆڕین

#### 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**
 *  دوایین بەڕۆژکردنەوە **4 حەفتە لەمەوبەر**
 *  دامەزراندنی چالاک **کەمتر لە 10**
 *  وەشانی وۆردپرێس ** 6.0 یان بەرزتر **
 *  تاقیکراوەتەوە تا **7.0.3**
 *  وەشانی PHP ** 7.4 یان بەرزتر **
 *  زمان
 * [English (US)](https://wordpress.org/plugins/capsquery-facial-authentication/)
 * تاگەکان
 * [authentication](https://ku.wordpress.org/plugins/tags/authentication/)[biometric](https://ku.wordpress.org/plugins/tags/biometric/)
   [login](https://ku.wordpress.org/plugins/tags/login/)[security](https://ku.wordpress.org/plugins/tags/security/)
 *  [بینینی پێشکەوتوو](https://ku.wordpress.org/plugins/capsquery-facial-authentication/advanced/)

## هەڵسەنگاندنەکان

 5 out of 5 stars.

 *  [  3 5-star reviews     ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/?filter=1)

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

[See all reviews](https://wordpress.org/support/plugin/capsquery-facial-authentication/reviews/)

## بەشداربووان

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

## پشتیوانی

هیچت هەیە بۆ وتن؟ پێویستت بە یارمەتییە؟

 [بینینی مەکۆی پاڵپشتی](https://wordpress.org/support/plugin/capsquery-facial-authentication/)