feat: Add comprehensive documentation suite and reorganize project structure
- Created complete documentation in docs/ directory - Added PROJECT_OVERVIEW.md with feature highlights and getting started guide - Added ARCHITECTURE.md with system design and technical details - Added SECURITY.md with comprehensive security implementation guide - Added DEVELOPMENT.md with development workflows and best practices - Added DEPLOYMENT.md with production deployment instructions - Added API.md with complete REST API documentation - Added CONTRIBUTING.md with contribution guidelines - Added CHANGELOG.md with version history and migration notes - Reorganized all documentation files into docs/ directory for better organization - Updated README.md with proper documentation links and quick navigation - Enhanced project structure with professional documentation standards
This commit is contained in:
SamiAhmed7777
371
f_core/f_classes/class.userinfo.php
Normal file
371
f_core/f_classes/class.userinfo.php
Normal file
@@ -0,0 +1,371 @@
|
||||
<?php
|
||||
/*******************************************************************************************************************
|
||||
| Software Name : EasyStream
|
||||
| Software Description : High End YouTube Clone Script with Videos, Shorts, Streams, Images, Audio, Documents, Blogs
|
||||
| Software Author : (c) Sami Ahmed
|
||||
|*******************************************************************************************************************
|
||||
|
|
||||
|*******************************************************************************************************************
|
||||
| This source file is subject to the EasyStream Proprietary License Agreement.
|
||||
|
|
||||
| By using this software, you acknowledge having read this Agreement and agree to be bound thereby.
|
||||
|*******************************************************************************************************************
|
||||
| Copyright (c) 2025 Sami Ahmed. All rights reserved.
|
||||
|*******************************************************************************************************************/
|
||||
|
||||
defined('_ISVALID') or header('Location: /error');
|
||||
|
||||
class VUserinfo
|
||||
{
|
||||
/* valid username format */
|
||||
public function isValidUsername($username)
|
||||
{
|
||||
global $cfg;
|
||||
|
||||
$min_length = $cfg['signup_min_username'];
|
||||
$max_length = $cfg['signup_max_username'];
|
||||
$char_extra = $cfg['username_format_dott'] == 1 ? '.' : null;
|
||||
$char_extra .= $cfg['username_format_underscore'] == 1 ? '_' : $char_extra;
|
||||
$char_extra .= $cfg['username_format_dash'] == 1 ? '-' : $char_extra;
|
||||
|
||||
switch ($cfg['username_format']) {
|
||||
case 'strict':
|
||||
if (!preg_match("/^[a-z0-9" . $char_extra . "]{" . $min_length . "," . $max_length . "}$/i", trim($username))) {
|
||||
return false;
|
||||
}
|
||||
break;
|
||||
case 'loose':
|
||||
$username = self::clearString($username);
|
||||
if (strlen($username) < $min_length or strlen($username) > $max_length) {return false;}
|
||||
break;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
/* remove chars from string */
|
||||
public function clearString($username)
|
||||
{
|
||||
return preg_replace('/[^a-zA-Z0-9@_.\-]/', '', $username);
|
||||
}
|
||||
/* check for existing username */
|
||||
public function existingUsername($username, $section = 'frontend')
|
||||
{
|
||||
global $db, $class_database;
|
||||
|
||||
$username = self::clearString($username);
|
||||
|
||||
switch ($section) {
|
||||
case "frontend":
|
||||
$db_t = 'db_accountuser';
|
||||
$db_p = 'usr';
|
||||
$db_q = $db->execute(sprintf("SELECT `%s_id` FROM `%s` WHERE `%s_user`='%s' LIMIT 1;", $db_p, $db_t, $db_p, $username));
|
||||
|
||||
if ($db_q->recordcount() > 0) {
|
||||
return true;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
case "backend":
|
||||
$cfg = $class_database->getConfigurations('backend_username');
|
||||
if ($username == $cfg['backend_username']) {
|
||||
return true;
|
||||
break;}
|
||||
break;
|
||||
}
|
||||
}
|
||||
/* check for existing email */
|
||||
public function existingEmail($email, $section = 'frontend')
|
||||
{
|
||||
global $db, $class_filter;
|
||||
|
||||
$email = $class_filter->clr_str($email);
|
||||
$email = preg_replace('/[^a-zA-Z0-9_.\-@]/', '', $email);
|
||||
|
||||
switch ($section) {
|
||||
case 'frontend':
|
||||
$q = $db->execute(sprintf("SELECT `usr_id` FROM `db_accountuser` WHERE `usr_email`='%s' LIMIT 1;", $email));
|
||||
if ($q->recordcount() > 0 and $q->fields['usr_id'] > 0) {
|
||||
return true;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
|
||||
break;
|
||||
case 'backend':
|
||||
$q = $db->execute(sprintf("SELECT `cfg_name` FROM `db_settings` WHERE `cfg_data`='%s' LIMIT 1;", $email));
|
||||
if ($q->recordcount() > 0) {
|
||||
return true;
|
||||
} else {
|
||||
return false;
|
||||
}
|
||||
|
||||
break;
|
||||
}
|
||||
}
|
||||
/* get user id from other fields */
|
||||
public function getUserID($user, $where_field = 'usr_user')
|
||||
{
|
||||
global $db, $class_filter;
|
||||
$user = $where_field == 'usr_user' ? self::clearString($user) : $class_filter->clr_str($user);
|
||||
$q = $db->execute(sprintf("SELECT `usr_id` FROM `db_accountuser` WHERE `" . $where_field . "`='%s' LIMIT 1;", $user));
|
||||
return $q->fields['usr_id'];
|
||||
}
|
||||
/* get user name from other fields */
|
||||
public function getUserName($user, $where_field = 'usr_id')
|
||||
{
|
||||
global $db, $class_filter;
|
||||
$q = $db->execute(sprintf("SELECT `usr_user` FROM `db_accountuser` WHERE `" . $where_field . "`='%s' LIMIT 1;", $class_filter->clr_str($user)));
|
||||
return $q->fields['usr_user'];
|
||||
}
|
||||
/* get email from user id */
|
||||
public function getUserEmail($user = '')
|
||||
{
|
||||
global $db, $smarty;
|
||||
switch ($user) {
|
||||
case '':$user = intval($_SESSION['USER_ID']);
|
||||
break;default:$user = intval($user);}
|
||||
|
||||
$q = $db->execute(sprintf("SELECT `usr_email` FROM `db_accountuser` WHERE `usr_id`='%s' LIMIT 1;", $user));
|
||||
$usr_email = $q->fields['usr_email'];
|
||||
$smarty->assign('usr_email', $usr_email);
|
||||
return $usr_email;
|
||||
}
|
||||
/* get various user details */
|
||||
public function getUserInfo($user_id)
|
||||
{
|
||||
global $db;
|
||||
|
||||
$uid = (int) $user_id;
|
||||
|
||||
$sql = sprintf("SELECT
|
||||
A.`usr_key`, A.`usr_user`, A.`usr_password`, A.`usr_emailextras`, A.`usr_weekupdates`,
|
||||
A.`usr_fname`, A.`usr_lname`, A.`usr_dname`,
|
||||
A.`ch_title`
|
||||
FROM
|
||||
`db_accountuser` A
|
||||
WHERE
|
||||
A.`usr_id`='%s' LIMIT 9;", $uid);
|
||||
|
||||
$u = $db->execute($sql);
|
||||
|
||||
$info['key'] = $u->fields['usr_key'];
|
||||
$info['uname'] = $u->fields['usr_user'];
|
||||
$info['pass'] = $u->fields['usr_password'];
|
||||
$info['fname'] = $u->fields['usr_fname'];
|
||||
$info['lname'] = $u->fields['usr_lname'];
|
||||
$info['dname'] = $u->fields['usr_dname'];
|
||||
$info['ch_title'] = $u->fields['ch_title'];
|
||||
$info['mail_updates'] = $u->fields['usr_emailextras'];
|
||||
$info['week_updates'] = $u->fields['usr_weekupdates'];
|
||||
|
||||
return $info;
|
||||
}
|
||||
/* username validation */
|
||||
public function usernameVerification($username, $section = 'frontend')
|
||||
{
|
||||
global $cfg, $language;
|
||||
|
||||
$file = str_replace("\n", ',', file_get_contents($cfg['list_reserved_users']));
|
||||
$file = (substr($file, -1, 1) == ',') ? substr($file, 0, -1) : $file;
|
||||
$u_array = array_map('trim', explode(',', $file));
|
||||
|
||||
if (self::isValidUsername($username)) {
|
||||
if (in_array($username, $u_array)) {return false;} elseif (!self::existingUsername($username, $section)) {
|
||||
if (!self::existingUsername(str_replace('I', 'l', $username), $section)) {
|
||||
if (!self::existingUsername(str_replace('l', 'I', $username), $section)) {
|
||||
return true;
|
||||
} else {return false;}
|
||||
} else {return false;}
|
||||
} else {return false;}
|
||||
} else {return false;}
|
||||
}
|
||||
/* birthday input validation */
|
||||
public function birthdayVerification($date)
|
||||
{
|
||||
global $cfg;
|
||||
|
||||
$c_age = self::ageFromString($date);
|
||||
if ($c_age < $cfg['signup_min_age'] or $c_age > $cfg['signup_max_age']) {
|
||||
return false;
|
||||
} else {
|
||||
return true;
|
||||
}
|
||||
|
||||
}
|
||||
/* age from date */
|
||||
public function ageFromString($date)
|
||||
{
|
||||
if (!preg_match("/([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})/", $date, $arr)) {
|
||||
return false;
|
||||
}
|
||||
|
||||
$age = date("Y") - $arr[1];
|
||||
if ($arr[2] > date("m")) {$age--;} elseif ($arr[2] == date("m")) {
|
||||
if ($arr[3] > date("d")) {
|
||||
$age--;
|
||||
}
|
||||
|
||||
}
|
||||
return $age;
|
||||
}
|
||||
/* generate random strings */
|
||||
public function generateRandomString($length = 10, $alphanumeric = false)
|
||||
{
|
||||
if (!$alphanumeric) {
|
||||
$str = join('', array_map(function ($value) {return $value == 1 ? mt_rand(1, 3) : mt_rand(0, 9);}, range(1, $length)));
|
||||
} else {
|
||||
$length = 32;
|
||||
$str = '';
|
||||
|
||||
for ($i = 0; $i < $length; $i++) {
|
||||
$str .= chr((mt_rand(1, 36) <= 26) ? (($i % 2) ? mt_rand(65, 90) : mt_rand(97, 122)) : mt_rand(48, 57));
|
||||
}
|
||||
}
|
||||
return $str;
|
||||
}
|
||||
/* check for available username */
|
||||
public function usernameAvailability($username, $section = 'frontend')
|
||||
{
|
||||
global $cfg, $language;
|
||||
|
||||
$file = str_replace("\n", ',', file_get_contents($cfg['list_reserved_users']));
|
||||
$file = (substr($file, -1, 1) == ',') ? substr($file, 0, -1) : $file;
|
||||
$u_array = explode(',', $file);
|
||||
$username = $cfg['username_format'] == 'loose' ? self::clearString(trim($username)) : trim($username);
|
||||
|
||||
if (self::usernameVerification($username)) {
|
||||
if (in_array($username, $u_array)) {
|
||||
echo '<font color="red">' . $language['frontend.signup.ucheck.taken'] . '</font>';die;
|
||||
} elseif (!self::existingUsername($username, $section)) {
|
||||
echo '<font color="green">' . $language['frontend.signup.ucheck.available'] . '</font>';die;
|
||||
} else {
|
||||
echo '<font color="red">' . $language['frontend.signup.ucheck.taken'] . '</font>';die;
|
||||
}
|
||||
} else {
|
||||
echo '<font color="red">' . $language['frontend.signup.ucheck.failed'] . '</font>';die;
|
||||
}
|
||||
}
|
||||
/* truncating strings */
|
||||
public function truncateString($string, $max_length)
|
||||
{
|
||||
return mb_strimwidth($string, 0, $max_length, '...', 'utf-8');
|
||||
|
||||
if (mb_strlen($string, 'UTF-8') > $max_length) {
|
||||
$string = mb_substr($string, 0, $max_length, 'UTF-8');
|
||||
$pos = mb_strrpos($string, ' ', false, 'UTF-8');
|
||||
if ($pos === false) {
|
||||
return mb_substr($string, 0, $max_length, 'UTF-8') . '...';
|
||||
}
|
||||
return mb_substr($string, 0, $pos, 'UTF-8') . '...';
|
||||
} else {
|
||||
return $string;
|
||||
}
|
||||
}
|
||||
/* days from date */
|
||||
public function timeRange($datetime)
|
||||
{
|
||||
global $language;
|
||||
|
||||
$timestamp = self::convert_datetime($datetime);
|
||||
$current_time = time();
|
||||
$time_elapsed = $current_time - $timestamp;
|
||||
$seconds = $time_elapsed;
|
||||
$minutes = round($time_elapsed / 60);
|
||||
$hours = round($time_elapsed / 3600);
|
||||
$days = round($time_elapsed / 86400);
|
||||
$months = round($time_elapsed / 2600640);
|
||||
$years = round($time_elapsed / 31207680);
|
||||
|
||||
if ($seconds <= 60) {
|
||||
return $language['time.ago.now'];
|
||||
} else if ($minutes <= 60) {
|
||||
if ($minutes == 1) {
|
||||
return $language['time.ago.minute'];
|
||||
} else {
|
||||
return str_replace('##', $minutes, $language['time.ago.minutes']);
|
||||
}
|
||||
} else if ($hours <= 24) {
|
||||
if ($hours == 1) {
|
||||
return $language['time.ago.hour'];
|
||||
} else {
|
||||
return str_replace('##', $hours, $language['time.ago.hours']);
|
||||
}
|
||||
} else if ($days <= 30) {
|
||||
if ($days == 1) {
|
||||
return $language['time.ago.day'];
|
||||
} else {
|
||||
return str_replace('##', $days, $language['time.ago.days']);
|
||||
}
|
||||
} else if ($months <= 12) {
|
||||
if ($months == 1) {
|
||||
return $language['time.ago.month'];
|
||||
} else {
|
||||
return str_replace('##', $months, $language['time.ago.months']);
|
||||
}
|
||||
} else {
|
||||
if ($years == 1) {
|
||||
return $language['time.ago.year'];
|
||||
} else {
|
||||
return str_replace('##', $years, $language['time.ago.years']);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/* days from date */
|
||||
public function timeRange_old($datetime)
|
||||
{
|
||||
global $language;
|
||||
|
||||
$time = self::convert_datetime($datetime);
|
||||
$now = time();
|
||||
$interval = $now - $time;
|
||||
|
||||
if ($interval > 0) {
|
||||
$day = $interval / (60 * 60 * 24);
|
||||
if ($day >= 1) {
|
||||
$dd = floor($day);
|
||||
$range = $dd . ' ' . ($dd != 1 ? $language['frontend.global.days'] : $language['frontend.global.day']) . ' ' . $language['frontend.global.ago'];
|
||||
$interval = $interval - (60 * 60 * 24 * $dd);
|
||||
}
|
||||
if ($interval > 0 and $range == '') {
|
||||
$hour = $interval / (60 * 60);
|
||||
if ($hour >= 1) {
|
||||
$hh = floor($hour);
|
||||
$range = $hh . ' ' . ($hh != 1 ? $language['frontend.global.hours'] : $language['frontend.global.hour']) . ' ' . $language['frontend.global.ago'];
|
||||
$interval = $interval - (60 * 60 * $hh);
|
||||
}
|
||||
}
|
||||
if ($interval > 0 and $range == '') {
|
||||
$min = $interval / (60);
|
||||
if ($min >= 1) {
|
||||
$mm = floor($min);
|
||||
$range = $mm . ' ' . ($mm != 1 ? $language['frontend.global.minutes'] : $language['frontend.global.minute']) . ' ' . $language['frontend.global.ago'];
|
||||
$interval = $interval - (60 * $mm);
|
||||
}
|
||||
}
|
||||
if ($interval > 0 and $range == '') {
|
||||
$scn = $interval;
|
||||
$range = $scn >= 1 ? $scn . ' ' . $language['frontend.global.seconds'] . ' ' . $language['frontend.global.ago'] : $language['frontend.global.seconds.ago'];
|
||||
}
|
||||
|
||||
return $range;
|
||||
}
|
||||
}
|
||||
/* unix timestamp */
|
||||
public function convert_datetime($str)
|
||||
{
|
||||
if ($str == '') {
|
||||
return false;
|
||||
}
|
||||
|
||||
list($date, $time) = explode(' ', $str);
|
||||
list($year, $month, $day) = explode('-', $date);
|
||||
list($hour, $minute, $second) = explode(':', $time);
|
||||
|
||||
$timestamp = mktime($hour, $minute, $second, $month, $day, $year);
|
||||
|
||||
return $timestamp;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user