Files
wordpress-theme-aksrt/inc/helpers/aksrt-ip-geo.php
T

313 lines
9.6 KiB
PHP

<?php
/**
* IP 归属地 — shared storage, format, and display helpers.
*
* Display positions (ip_geo_display): comment | user_home | user_center | post
* Meta:
* comment → aksrt_comment_addr (array)
* user → aksrt_user_addr (array), aksrt_register_ip (string)
*
* @package AKSRT
*/
defined('ABSPATH') || exit;
if (!function_exists('aksrt_get_ip_geo_config')) :
/**
* @return array<string,mixed>
*/
function aksrt_get_ip_geo_config(): array {
if (class_exists('\AKSRT\Settings\Settings') && method_exists('\AKSRT\Settings\Settings', 'get_ip_geo_settings')) {
return \AKSRT\Settings\Settings::get_ip_geo_settings();
}
return [
'ip_geo_enabled' => false,
'ip_geo_display' => ['comment'],
'ip_geo_format' => 'province_city',
'ip_geo_fallback_text' => '',
];
}
endif;
if (!function_exists('aksrt_ip_geo_master_enabled')) :
function aksrt_ip_geo_master_enabled(): bool {
$c = aksrt_get_ip_geo_config();
return !empty($c['ip_geo_enabled']);
}
endif;
if (!function_exists('aksrt_ip_geo_display_enabled')) :
/**
* Whether a surface may show IP 归属地 badges.
*
* @param string $location comment|user_home|user_center|post
*/
function aksrt_ip_geo_display_enabled(string $location): bool {
if (!aksrt_ip_geo_master_enabled()) {
return false;
}
$c = aksrt_get_ip_geo_config();
$display = $c['ip_geo_display'] ?? [];
if (!is_array($display)) {
$display = [$display];
}
$display = array_map('sanitize_key', $display);
return in_array(sanitize_key($location), $display, true);
}
endif;
if (!function_exists('aksrt_ip_geo_format_key')) :
function aksrt_ip_geo_format_key(): string {
$c = aksrt_get_ip_geo_config();
$format = sanitize_key((string) ($c['ip_geo_format'] ?? 'province_city'));
return in_array($format, ['province_city', 'province', 'country_province'], true)
? $format
: 'province_city';
}
endif;
if (!function_exists('aksrt_user_city_enabled')) :
/**
* Users feature switch (user home / user center), independent of comment city_s.
*/
function aksrt_user_city_enabled(): bool {
if (!class_exists('\AKSRT\Settings\Settings')) {
return false;
}
$all = \AKSRT\Settings\Settings::get_all();
return !empty($all['user_city_s']);
}
endif;
if (!function_exists('aksrt_user_city_type')) :
/**
* User-facing precision (maps to shared format keys).
*/
function aksrt_user_city_type(): string {
if (!class_exists('\AKSRT\Settings\Settings')) {
return aksrt_ip_geo_format_key();
}
$all = \AKSRT\Settings\Settings::get_all();
$type = sanitize_key((string) ($all['user_city_type'] ?? ''));
// zibll: pro / city
if ($type === 'pro' || $type === 'province') {
return 'province';
}
if ($type === 'city' || $type === 'province_city') {
return 'province_city';
}
if ($type === 'country_province') {
return 'country_province';
}
return aksrt_ip_geo_format_key();
}
endif;
if (!function_exists('aksrt_normalize_geo_addr')) :
/**
* @param mixed $raw Meta value.
* @return array{country:string,province:string,city:string}
*/
function aksrt_normalize_geo_addr($raw): array {
if (!is_array($raw)) {
return ['country' => '', 'province' => '', 'city' => ''];
}
// Accept zibll-shaped nation → country.
$country = trim((string) ($raw['country'] ?? $raw['nation'] ?? ''));
return [
'country' => $country,
'province' => trim((string) ($raw['province'] ?? '')),
'city' => trim((string) ($raw['city'] ?? '')),
];
}
endif;
if (!function_exists('aksrt_format_geo_label')) :
/**
* @param array<string,string> $addr Addr.
* @param string $type Format key.
*/
function aksrt_format_geo_label(array $addr, string $type = 'province_city'): string {
$addr = aksrt_normalize_geo_addr($addr);
if (class_exists('\AKSRT\Extensions\IPGeo')) {
$label = \AKSRT\Extensions\IPGeo::get_instance()->format($addr, $type);
if (is_string($label) && $label !== '') {
return $label;
}
}
// Local fallback (mirrors IPGeo::format).
switch ($type) {
case 'province':
return $addr['province'] !== '' ? $addr['province'] : $addr['city'];
case 'country_province':
return trim($addr['country'] . ' ' . $addr['province']);
case 'province_city':
default:
$parts = array_filter([$addr['province'], $addr['city']]);
if (empty($parts) && $addr['country'] !== '') {
return $addr['country'];
}
return implode(' ', $parts);
}
}
endif;
if (!function_exists('aksrt_get_geo_badge_html')) :
/**
* @param array<string,string>|mixed $addr Addr meta.
* @param string $type Format.
* @param string $class CSS classes.
* @param string $title Title attr.
*/
function aksrt_get_geo_badge_html($addr, string $type = 'province_city', string $class = 'badg badg-sm', string $title = ''): string {
$label = aksrt_format_geo_label(is_array($addr) ? $addr : [], $type);
if ($label === '') {
$fallback = (string) (aksrt_get_ip_geo_config()['ip_geo_fallback_text'] ?? '');
if ($fallback === '') {
return '';
}
$label = $fallback;
}
if ($title === '') {
$title = __('IP 属地', 'aksrt');
}
$class = trim($class . ' aksrt-ip-geo-badge');
return '<span class="' . esc_attr($class) . '" title="' . esc_attr($title) . '">' . esc_html($label) . '</span>';
}
endif;
if (!function_exists('aksrt_lookup_geo_for_ip')) :
/**
* @return array{country:string,province:string,city:string}
*/
function aksrt_lookup_geo_for_ip(string $ip): array {
$ip = trim($ip);
if ($ip === '' || !class_exists('\AKSRT\Extensions\IPGeo')) {
return ['country' => '', 'province' => '', 'city' => ''];
}
$geo = \AKSRT\Extensions\IPGeo::get_instance()->lookup($ip);
return aksrt_normalize_geo_addr(is_array($geo) ? $geo : []);
}
endif;
if (!function_exists('aksrt_store_user_addr')) :
/**
* Resolve current client IP and persist user meta.
* Zibll: refresh on every login when user_city_s is on.
* Also refresh when article (post) display needs author addr.
*/
function aksrt_store_user_addr(int $user_id, ?string $ip = null): void {
if ($user_id <= 0 || !aksrt_ip_geo_master_enabled()) {
return;
}
$need = aksrt_user_city_enabled()
|| aksrt_ip_geo_display_enabled('post')
|| aksrt_ip_geo_display_enabled('user_home')
|| aksrt_ip_geo_display_enabled('user_center');
if (!$need) {
return;
}
if ($ip === null || $ip === '') {
$ip = function_exists('aksrt_get_client_ip') ? (string) aksrt_get_client_ip() : (string) ($_SERVER['REMOTE_ADDR'] ?? '');
}
$ip = trim($ip);
if ($ip === '') {
return;
}
$addr = aksrt_lookup_geo_for_ip($ip);
if ($addr['country'] === '' && $addr['province'] === '' && $addr['city'] === '') {
return;
}
update_user_meta($user_id, 'aksrt_user_addr', $addr);
}
endif;
if (!function_exists('aksrt_get_user_addr')) :
/**
* @param int $user_id User ID.
* @return array{country:string,province:string,city:string}
*/
function aksrt_get_user_addr(int $user_id): array {
if ($user_id <= 0) {
return ['country' => '', 'province' => '', 'city' => ''];
}
$raw = get_user_meta($user_id, 'aksrt_user_addr', true);
// Legacy / accidental zibll key.
if ((!is_array($raw) || empty($raw)) && metadata_exists('user', $user_id, 'user_addr')) {
$raw = get_user_meta($user_id, 'user_addr', true);
}
return aksrt_normalize_geo_addr($raw);
}
endif;
if (!function_exists('aksrt_get_user_city_badge_html')) :
/**
* Badge for user home / user center (requires user_city_s + display location).
*
* @param int $user_id User.
* @param string $location user_home|user_center
* @param string $class CSS.
*/
function aksrt_get_user_city_badge_html(int $user_id, string $location = 'user_home', string $class = 'badg'): string {
if ($user_id <= 0 || !aksrt_user_city_enabled()) {
return '';
}
if (!aksrt_ip_geo_display_enabled($location)) {
return '';
}
return aksrt_get_geo_badge_html(aksrt_get_user_addr($user_id), aksrt_user_city_type(), $class);
}
endif;
if (!function_exists('aksrt_get_post_author_city_badge_html')) :
/**
* Article detail author IP 属地 (uses author last-login addr).
*/
function aksrt_get_post_author_city_badge_html(int $author_id = 0, string $class = 'badg badg-sm'): string {
if (!aksrt_ip_geo_display_enabled('post')) {
return '';
}
if ($author_id <= 0) {
$author_id = (int) get_the_author_meta('ID');
}
if ($author_id <= 0) {
return '';
}
// Prefer user_city type when feature on; else global format.
$type = aksrt_user_city_enabled() ? aksrt_user_city_type() : aksrt_ip_geo_format_key();
return aksrt_get_geo_badge_html(aksrt_get_user_addr($author_id), $type, $class);
}
endif;
// ── Hooks: persist on login / register ──────────────────────────────────────
add_action('wp_login', static function ($user_login, $user = null): void {
$user_id = 0;
if ($user instanceof WP_User) {
$user_id = (int) $user->ID;
} elseif (is_string($user_login) && $user_login !== '') {
$u = get_user_by('login', $user_login);
$user_id = $u instanceof WP_User ? (int) $u->ID : 0;
}
if ($user_id > 0 && function_exists('aksrt_store_user_addr')) {
aksrt_store_user_addr($user_id);
}
}, 20, 2);
add_action('user_register', static function ($user_id): void {
$user_id = (int) $user_id;
if ($user_id <= 0) {
return;
}
$ip = function_exists('aksrt_get_client_ip') ? (string) aksrt_get_client_ip() : (string) ($_SERVER['REMOTE_ADDR'] ?? '');
$ip = trim($ip);
if ($ip !== '') {
update_user_meta($user_id, 'aksrt_register_ip', $ip);
}
if (function_exists('aksrt_store_user_addr')) {
aksrt_store_user_addr($user_id, $ip !== '' ? $ip : null);
}
}, 20, 1);