Files
wordpress-theme-aksrt/inc/helpers/jio-phone.php
T
kate522andClaude Opus 5 35bb96e82f refactor: rename the theme brand and every identifier from AKSRT to Jio
Full-project rename. `git grep -i aksrt` is now empty apart from the
DBMigrator 3.3.0 changelog note that documents the rename itself.

Code identifiers
- PHP namespace AKSRT\ -> Jio\ (composer PSR-4 + 378 declarations)
- global constants AKSRT_* -> JIO_* (VERSION/DIR/URI, PAY_TYPE_*, CAPTCHA_*)
- procedural functions, hooks, options, meta keys, table names,
  cookies, query vars, ajax actions and nonces: aksrt_ -> jio_
- text domain aksrt -> jio; Theme Name -> Jio
- JS globals: aksrtData/aksrtAdminData/... -> jioData/jioAdminData/...,
  window.AKSRTCaptcha & friends -> window.JioCaptcha, Aksrt* -> Jio*
- Vue components Aks*.vue -> Jio*.vue (15 files renamed + imports)
- CSS classes/data-attrs/custom properties: aksrt- -> jio-
- REST namespace aksrt/v1 -> jio/v1 (incl. payment gateway callbacks)

Storage layer
- DB tables {prefix}aksrt_* -> {prefix}jio_*; SCHEMA_VERSION 3.2.0 -> 3.3.0
  so dbDelta creates the new names on install
- widget id_base aksrt_widget_* -> jio_widget_*
- uninstall.php drop list rebuilt from the actual migrator tables
  (dropped 3 stale entries, added the 17 missing ones)

Removed
- hardcoded https://api.aksrt.com/version.json default update endpoint;
  get_endpoint() now reads the 「更新端点」 setting and do_check() no-ops
  when it is empty

Files renamed: inc/helpers/aksrt-*.php -> jio-*.php (54),
assets/admin/src/components/form/Aks*.vue -> Jio*.vue (15).
Build artifacts regenerated: assets/css/build, assets/js/runtime,
assets/admin/build.

Verified: audit-psr4-paths errors=0, audit-admin-contracts errors=0
(warnings=56, unchanged baseline), 813/813 widget-system tests,
44/44 phpunit, php -l clean across all PHP.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-11-01 20:05:04 +08:00

69 lines
1.9 KiB
PHP

<?php
/**
* Phone number masking helpers shared by the account UI and the
* phone-match verification endpoint.
*
* The hidden middle segment adapts to the number: domestic 11-digit
* numbers hide 4 digits (138****1234), longer international numbers
* hide length-7 digits (min 4), so the digit-entry UI renders one box
* per hidden digit.
*
* @package Jio
*/
if (!defined('ABSPATH')) {
exit;
}
/**
* Split a bound phone number into visible prefix / hidden middle / visible suffix.
*
* Works on the digit core of the number (a leading "+" is ignored for the split
* but reported back). Returns null when the number holds fewer than 8 digits —
* such numbers cannot be verified by middle-digit entry.
*
* @return array{prefix:string,hidden:string,suffix:string,hidden_length:int,leading_plus:bool}|null
*/
function jio_phone_mask_parts(string $phone): ?array {
$phone = trim($phone);
if ($phone === '') {
return null;
}
$leading_plus = $phone[0] === '+';
$core = preg_replace('/\D+/', '', $phone);
$length = strlen($core);
if ($length < 8) {
return null;
}
$hidden_length = min(11, max(4, $length - 7));
$suffix_length = $length - 3 - $hidden_length;
if ($suffix_length < 1) {
return null;
}
return [
'prefix' => substr($core, 0, 3),
'hidden' => substr($core, 3, $hidden_length),
'suffix' => substr($core, $length - $suffix_length),
'hidden_length' => $hidden_length,
'leading_plus' => $leading_plus,
];
}
/**
* Masked display form of a phone number, e.g. 138****1234 or +861******1234.
* Falls back to the raw number when it cannot be masked.
*/
function jio_phone_mask_display(string $phone): string {
$parts = jio_phone_mask_parts($phone);
if ($parts === null) {
return $phone;
}
$mask = str_repeat('*', (int) $parts['hidden_length']);
$display = $parts['prefix'] . $mask . $parts['suffix'];
return $parts['leading_plus'] ? '+' . $display : $display;
}