| Zeile 11 | Zeile 11 |
|---|
/**
* Checks if a user with uid $uid exists in the database.
*
|
/**
* Checks if a user with uid $uid exists in the database.
*
|
* @param int The uid to check for.
| * @param int $uid The uid to check for.
|
* @return boolean True when exists, false when not.
*/
function user_exists($uid)
| * @return boolean True when exists, false when not.
*/
function user_exists($uid)
|
| Zeile 32 | Zeile 32 |
|---|
/**
* Checks if $username already exists in the database.
*
|
/**
* Checks if $username already exists in the database.
*
|
* @param string The username for check for.
| * @param string $username The username for check for.
|
* @return boolean True when exists, false when not.
*/
function username_exists($username)
{
|
* @return boolean True when exists, false when not.
*/
function username_exists($username)
{
|
global $db;
| |
$options = array(
'username_method' => 2
);
return (bool)get_user_by_username($username, $options);
|
$options = array(
'username_method' => 2
);
return (bool)get_user_by_username($username, $options);
|
}
| }
|
/**
* Checks a password with a supplied username.
*
|
/**
* Checks a password with a supplied username.
*
|
* @param string The username of the user.
* @param string The plain-text password.
| * @param string $username The username of the user.
* @param string $password The plain-text password.
|
* @return boolean|array False when no match, array with user info when match.
|
* @return boolean|array False when no match, array with user info when match.
|
*/
| */
|
function validate_password_from_username($username, $password)
{
|
function validate_password_from_username($username, $password)
{
|
global $db, $mybb;
| global $mybb;
|
$options = array(
|
$options = array(
|
'fields' => array('username', 'password', 'salt', 'loginkey', 'coppauser', 'usergroup'),
| 'fields' => '*',
|
'username_method' => $mybb->settings['username_method'],
);
| 'username_method' => $mybb->settings['username_method'],
);
|
| Zeile 75 | Zeile 73 |
|---|
/**
* Checks a password with a supplied uid.
*
|
/**
* Checks a password with a supplied uid.
*
|
* @param int The user id.
* @param string The plain-text password.
* @param string An optional user data array.
| * @param int $uid The user id.
* @param string $password The plain-text password.
* @param array $user An optional user data array.
|
* @return boolean|array False when not valid, user data array when valid.
*/
function validate_password_from_uid($uid, $password, $user = array())
| * @return boolean|array False when not valid, user data array when valid.
*/
function validate_password_from_uid($uid, $password, $user = array())
|
| Zeile 89 | Zeile 87 |
|---|
}
if(!$user['password'])
{
|
}
if(!$user['password'])
{
|
$query = $db->simple_select("users", "uid,username,password,salt,loginkey,usergroup", "uid='".(int)$uid."'");
$user = $db->fetch_array($query);
| $user = get_user($uid);
|
}
if(!$user['salt'])
{
// Generate a salt for this user and assume the password stored in db is a plain md5 password
|
}
if(!$user['salt'])
{
// Generate a salt for this user and assume the password stored in db is a plain md5 password
|
$user['salt'] = generate_salt();
$user['password'] = salt_password($user['password'], $user['salt']);
$sql_array = array(
"salt" => $user['salt'],
"password" => $user['password']
);
$db->update_query("users", $sql_array, "uid='".$user['uid']."'");
| $password_fields = create_password($user['password'], false, $user);
$db->update_query("users", $password_fields, "uid='".$user['uid']."'");
|
}
if(!$user['loginkey'])
| }
if(!$user['loginkey'])
|
| Zeile 112 | Zeile 104 |
|---|
);
$db->update_query("users", $sql_array, "uid = ".$user['uid']);
}
|
);
$db->update_query("users", $sql_array, "uid = ".$user['uid']);
}
|
if(salt_password(md5($password), $user['salt']) == $user['password'])
| if(verify_user_password($user, $password))
|
{
return $user;
}
| {
return $user;
}
|
| Zeile 125 | Zeile 117 |
|---|
/**
* Updates a user's password.
*
|
/**
* Updates a user's password.
*
|
* @param int The user's id.
* @param string The md5()'ed password.
* @param string (Optional) The salt of the user.
| * @param int $uid The user's id.
* @param string $password The md5()'ed password.
* @param string $salt (Optional) The salt of the user.
|
* @return array The new password.
|
* @return array The new password.
|
| | * @deprecated deprecated since version 1.8.6 Please use other alternatives.
|
*/
function update_password($uid, $password, $salt="")
{
| */
function update_password($uid, $password, $salt="")
{
|
| Zeile 171 | Zeile 164 |
|---|
/**
* Salts a password based on a supplied salt.
*
|
/**
* Salts a password based on a supplied salt.
*
|
* @param string The md5()'ed password.
* @param string The salt.
| * @param string $password The md5()'ed password.
* @param string $salt The salt.
|
* @return string The password hash.
|
* @return string The password hash.
|
| | * @deprecated deprecated since version 1.8.9 Please use other alternatives.
|
*/
function salt_password($password, $salt)
{
return md5(md5($salt).$password);
|
*/
function salt_password($password, $salt)
{
return md5(md5($salt).$password);
|
| | }
/**
* Salts a password based on a supplied salt.
*
* @param string $password The input password.
* @param string $salt (Optional) The salt used by the MyBB algorithm.
* @param string $user (Optional) An array containing password-related data.
* @return array Password-related fields.
*/
function create_password($password, $salt = false, $user = false)
{
global $plugins;
$fields = null;
$parameters = compact('password', 'salt', 'user', 'fields');
if(!defined('IN_INSTALL') && !defined('IN_UPGRADE'))
{
$plugins->run_hooks('create_password', $parameters);
}
if(!is_null($parameters['fields']))
{
$fields = $parameters['fields'];
}
else
{
if(!$salt)
{
$salt = generate_salt();
}
$hash = md5(md5($salt).md5($password));
$fields = array(
'salt' => $salt,
'password' => $hash,
);
}
return $fields;
}
/**
* Compares user's password data against provided input.
*
* @param array $user An array containing password-related data.
* @param string $password The plain-text input password.
* @return bool Result of the comparison.
*/
function verify_user_password($user, $password)
{
global $plugins;
$result = null;
$parameters = compact('user', 'password', 'result');
if(!defined('IN_INSTALL') && !defined('IN_UPGRADE'))
{
$plugins->run_hooks('verify_user_password', $parameters);
}
if(!is_null($parameters['result']))
{
return $parameters['result'];
}
else
{
$password_fields = create_password($password, $user['salt'], $user);
return my_hash_equals($user['password'], $password_fields['password']);
}
|
}
/**
| }
/**
|
| Zeile 203 | Zeile 272 |
|---|
/**
* Updates a user's salt in the database (does not update a password).
*
|
/**
* Updates a user's salt in the database (does not update a password).
*
|
* @param int The uid of the user to update.
| * @param int $uid The uid of the user to update.
|
* @return string The new salt.
*/
function update_salt($uid)
| * @return string The new salt.
*/
function update_salt($uid)
|
| Zeile 222 | Zeile 291 |
|---|
/**
* Generates a new login key for a user.
*
|
/**
* Generates a new login key for a user.
*
|
* @param int The uid of the user to update.
| * @param int $uid The uid of the user to update.
|
* @return string The new login key.
*/
function update_loginkey($uid)
| * @return string The new login key.
*/
function update_loginkey($uid)
|
| Zeile 243 | Zeile 312 |
|---|
* Adds a thread to a user's thread subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
* Adds a thread to a user's thread subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
* @param int The tid of the thread to add to the list.
* @param int (Optional) The type of notification to receive for replies (0=none, 1=email, 2=pm)
* @param int (Optional) The uid of the user who's list to update.
| * @param int $tid The tid of the thread to add to the list.
* @param int $notification (Optional) The type of notification to receive for replies (0=none, 1=email, 2=pm)
* @param int $uid (Optional) The uid of the user who's list to update.
|
* @return boolean True when success, false when otherwise.
*/
|
* @return boolean True when success, false when otherwise.
*/
|
function add_subscribed_thread($tid, $notification=1, $uid="")
| function add_subscribed_thread($tid, $notification=1, $uid=0)
|
{
global $mybb, $db;
| {
global $mybb, $db;
|
| Zeile 259 | Zeile 328 |
|---|
if(!$uid)
{
|
if(!$uid)
{
|
return;
}
| return false;
}
|
$query = $db->simple_select("threadsubscriptions", "*", "tid='".(int)$tid."' AND uid='".(int)$uid."'");
$subscription = $db->fetch_array($query);
|
$query = $db->simple_select("threadsubscriptions", "*", "tid='".(int)$tid."' AND uid='".(int)$uid."'");
$subscription = $db->fetch_array($query);
|
if(!$subscription['tid'])
| if(empty($subscription) || !$subscription['tid'])
|
{
$insert_array = array(
'uid' => (int)$uid,
'tid' => (int)$tid,
'notification' => (int)$notification,
|
{
$insert_array = array(
'uid' => (int)$uid,
'tid' => (int)$tid,
'notification' => (int)$notification,
|
'dateline' => TIME_NOW,
'subscriptionkey' => md5(TIME_NOW.$uid.$tid)
| 'dateline' => TIME_NOW
|
);
$db->insert_query("threadsubscriptions", $insert_array);
|
);
$db->insert_query("threadsubscriptions", $insert_array);
|
}
| }
|
else
{
// Subscription exists - simply update notification
| else
{
// Subscription exists - simply update notification
|
| Zeile 283 | Zeile 350 |
|---|
"notification" => (int)$notification
);
$db->update_query("threadsubscriptions", $update_array, "uid='{$uid}' AND tid='{$tid}'");
|
"notification" => (int)$notification
);
$db->update_query("threadsubscriptions", $update_array, "uid='{$uid}' AND tid='{$tid}'");
|
}
return true;
}
| }
return true;
}
|
/**
* Remove a thread from a user's thread subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
/**
* Remove a thread from a user's thread subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
* @param int The tid of the thread to remove from the list.
* @param int (Optional) The uid of the user who's list to update.
| * @param int $tid The tid of the thread to remove from the list.
* @param int $uid (Optional) The uid of the user who's list to update.
* @return boolean True when success, false when otherwise.
*/
function remove_subscribed_thread($tid, $uid=0)
{
global $mybb, $db;
if(!$uid)
{
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return false;
}
$db->delete_query("threadsubscriptions", "tid='".$tid."' AND uid='{$uid}'");
return true;
}
/**
* Adds a forum to a user's forum subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
* @param int $fid The fid of the forum to add to the list.
* @param int $uid (Optional) The uid of the user who's list to update.
|
* @return boolean True when success, false when otherwise.
*/
|
* @return boolean True when success, false when otherwise.
*/
|
function remove_subscribed_thread($tid, $uid="")
| function add_subscribed_forum($fid, $uid=0)
|
{
global $mybb, $db;
|
{
global $mybb, $db;
|
if(!$uid)
{
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return;
}
$db->delete_query("threadsubscriptions", "tid='".$tid."' AND uid='{$uid}'");
return true;
}
/**
* Adds a forum to a user's forum subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
* @param int The fid of the forum to add to the list.
* @param int (Optional) The uid of the user who's list to update.
* @return boolean True when success, false when otherwise.
*/
function add_subscribed_forum($fid, $uid="")
{
global $mybb, $db;
if(!$uid)
{
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return;
}
| if(!$uid)
{
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return false;
}
|
$fid = (int)$fid;
$uid = (int)$uid;
$query = $db->simple_select("forumsubscriptions", "*", "fid='".$fid."' AND uid='{$uid}'", array('limit' => 1));
$fsubscription = $db->fetch_array($query);
|
$fid = (int)$fid;
$uid = (int)$uid;
$query = $db->simple_select("forumsubscriptions", "*", "fid='".$fid."' AND uid='{$uid}'", array('limit' => 1));
$fsubscription = $db->fetch_array($query);
|
if(!$fsubscription['fid'])
| if(empty($fsubscription) || !$fsubscription['fid'])
|
{
$insert_array = array(
'fid' => $fid,
| {
$insert_array = array(
'fid' => $fid,
|
| Zeile 356 | Zeile 423 |
|---|
* Removes a forum from a user's forum subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
* Removes a forum from a user's forum subscription list.
* If no uid is supplied, the currently logged in user's id will be used.
*
|
* @param int The fid of the forum to remove from the list.
* @param int (Optional) The uid of the user who's list to update.
| * @param int $fid The fid of the forum to remove from the list.
* @param int $uid (Optional) The uid of the user who's list to update.
|
* @return boolean True when success, false when otherwise.
*/
|
* @return boolean True when success, false when otherwise.
*/
|
function remove_subscribed_forum($fid, $uid="")
| function remove_subscribed_forum($fid, $uid=0)
|
{
global $mybb, $db;
if(!$uid)
|
{
global $mybb, $db;
if(!$uid)
|
{
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return;
| {
$uid = $mybb->user['uid'];
}
if(!$uid)
{
return false;
|
}
$db->delete_query("forumsubscriptions", "fid='".$fid."' AND uid='{$uid}'");
|
}
$db->delete_query("forumsubscriptions", "fid='".$fid."' AND uid='{$uid}'");
|
|
|
return true;
}
/**
* Constructs the usercp navigation menu.
|
return true;
}
/**
* Constructs the usercp navigation menu.
|
*
*/
| *
*/
|
function usercp_menu()
{
global $mybb, $templates, $theme, $plugins, $lang, $usercpnav, $usercpmenu;
| function usercp_menu()
{
global $mybb, $templates, $theme, $plugins, $lang, $usercpnav, $usercpmenu;
|
| Zeile 389 | Zeile 456 |
|---|
$lang->load("usercpnav");
// Add the default items as plugins with separated priorities of 10
|
$lang->load("usercpnav");
// Add the default items as plugins with separated priorities of 10
|
if($mybb->settings['enablepms'] != 0)
| if($mybb->settings['enablepms'] != 0 && $mybb->usergroup['canusepms'] == 1)
|
{
$plugins->add_hook("usercp_menu", "usercp_menu_messenger", 10);
}
|
{
$plugins->add_hook("usercp_menu", "usercp_menu_messenger", 10);
}
|
$plugins->add_hook("usercp_menu", "usercp_menu_profile", 20);
$plugins->add_hook("usercp_menu", "usercp_menu_misc", 30);
| if($mybb->usergroup['canusercp'] == 1)
{
$plugins->add_hook("usercp_menu", "usercp_menu_profile", 20);
$plugins->add_hook("usercp_menu", "usercp_menu_misc", 30);
}
|
// Run the plugin hooks
$plugins->run_hooks("usercp_menu");
global $usercpmenu;
|
// Run the plugin hooks
$plugins->run_hooks("usercp_menu");
global $usercpmenu;
|
| |
if($mybb->usergroup['canusercp'] == 1)
{
eval("\$ucp_nav_home = \"".$templates->get("usercp_nav_home")."\";");
}
|
eval("\$usercpnav = \"".$templates->get("usercp_nav")."\";");
|
eval("\$usercpnav = \"".$templates->get("usercp_nav")."\";");
|
|
|
$plugins->run_hooks("usercp_menu_built");
}
| $plugins->run_hooks("usercp_menu_built");
}
|
| Zeile 412 | Zeile 487 |
|---|
*/
function usercp_menu_messenger()
{
|
*/
function usercp_menu_messenger()
{
|
global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapsed, $collapsedimg;
| global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapse, $collapsed, $collapsedimg;
|
|
|
| | $expaltext = (in_array("usercppms", $collapse)) ? $lang->expcol_expand : $lang->expcol_collapse;
|
$usercp_nav_messenger = $templates->get("usercp_nav_messenger");
// Hide tracking link if no permission
$tracking = '';
| $usercp_nav_messenger = $templates->get("usercp_nav_messenger");
// Hide tracking link if no permission
$tracking = '';
|
| Zeile 439 | Zeile 515 |
|---|
if($folderinfo[0] == 4)
{
$class = "usercp_nav_trash_pmfolder";
|
if($folderinfo[0] == 4)
{
$class = "usercp_nav_trash_pmfolder";
|
}
| }
|
else if($folderlinks)
|
else if($folderlinks)
|
{
| {
|
$class = "usercp_nav_sub_pmfolder";
|
$class = "usercp_nav_sub_pmfolder";
|
}
| }
|
else
{
$class = "usercp_nav_pmfolder";
|
else
{
$class = "usercp_nav_pmfolder";
|
}
| }
|
$folder_id = $folderinfo[0];
$folder_name = $folderinfo[1];
|
$folder_id = $folderinfo[0];
$folder_name = $folderinfo[1];
|
|
|
eval("\$folderlinks .= \"".$templates->get("usercp_nav_messenger_folder")."\";");
}
if(!isset($collapsedimg['usercppms']))
{
$collapsedimg['usercppms'] = '';
|
eval("\$folderlinks .= \"".$templates->get("usercp_nav_messenger_folder")."\";");
}
if(!isset($collapsedimg['usercppms']))
{
$collapsedimg['usercppms'] = '';
|
}
| }
|
if(!isset($collapsed['usercppms_e']))
{
$collapsed['usercppms_e'] = '';
}
|
if(!isset($collapsed['usercppms_e']))
{
$collapsed['usercppms_e'] = '';
}
|
|
|
eval("\$usercpmenu .= \"".$usercp_nav_messenger."\";");
|
eval("\$usercpmenu .= \"".$usercp_nav_messenger."\";");
|
}
| }
|
/**
* Constructs the usercp profile menu.
*
*/
function usercp_menu_profile()
{
|
/**
* Constructs the usercp profile menu.
*
*/
function usercp_menu_profile()
{
|
global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapsed, $collapsedimg;
| global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapse, $collapsed, $collapsedimg;
|
$changenameop = '';
if($mybb->usergroup['canchangename'] != 0)
|
$changenameop = '';
if($mybb->usergroup['canchangename'] != 0)
|
| Zeile 501 | Zeile 577 |
|---|
$collapsed['usercpprofile_e'] = '';
}
|
$collapsed['usercpprofile_e'] = '';
}
|
| | $expaltext = (in_array("usercpprofile", $collapse)) ? $lang->expcol_expand : $lang->expcol_collapse;
|
eval("\$usercpmenu .= \"".$templates->get("usercp_nav_profile")."\";");
}
| eval("\$usercpmenu .= \"".$templates->get("usercp_nav_profile")."\";");
}
|
| Zeile 510 | Zeile 587 |
|---|
*/
function usercp_menu_misc()
{
|
*/
function usercp_menu_misc()
{
|
global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapsed, $collapsedimg;
| global $db, $mybb, $templates, $theme, $usercpmenu, $lang, $collapse, $collapsed, $collapsedimg;
|
$draftstart = $draftend = '';
$draftcount = $lang->ucp_nav_drafts;
|
$draftstart = $draftend = '';
$draftcount = $lang->ucp_nav_drafts;
|
| Zeile 524 | Zeile 601 |
|---|
}
if($mybb->settings['enableattachments'] != 0)
|
}
if($mybb->settings['enableattachments'] != 0)
|
{
| {
|
eval("\$attachmentop = \"".$templates->get("usercp_nav_attachments")."\";");
}
| eval("\$attachmentop = \"".$templates->get("usercp_nav_attachments")."\";");
}
|
| Zeile 539 | Zeile 616 |
|---|
}
$profile_link = get_profile_link($mybb->user['uid']);
|
}
$profile_link = get_profile_link($mybb->user['uid']);
|
| | $expaltext = (in_array("usercpmisc", $collapse)) ? $lang->expcol_expand : $lang->expcol_collapse;
|
eval("\$usercpmenu .= \"".$templates->get("usercp_nav_misc")."\";");
}
/**
* Gets the usertitle for a specific uid.
*
|
eval("\$usercpmenu .= \"".$templates->get("usercp_nav_misc")."\";");
}
/**
* Gets the usertitle for a specific uid.
*
|
* @param int The uid of the user to get the usertitle of.
| * @param int $uid The uid of the user to get the usertitle of.
|
* @return string The usertitle of the user.
*/
|
* @return string The usertitle of the user.
*/
|
function get_usertitle($uid="")
| function get_usertitle($uid=0)
|
{
global $db, $mybb;
| {
global $db, $mybb;
|
| Zeile 574 | Zeile 652 |
|---|
if($title['posts'] <= $user['postnum'])
{
$usertitle = $title;
|
if($title['posts'] <= $user['postnum'])
{
$usertitle = $title;
|
| | break;
|
}
}
| }
}
|
| Zeile 584 | Zeile 663 |
|---|
/**
* Updates a users private message count in the users table with the number of pms they have.
*
|
/**
* Updates a users private message count in the users table with the number of pms they have.
*
|
* @param int The user id to update the count for. If none, assumes currently logged in user.
* @param int Bitwise value for what to update. 1 = total, 2 = new, 4 = unread. Combinations accepted.
* @param int The unix timestamp the user with uid last visited. If not specified, will be queried.
| * @param int $uid The user id to update the count for. If none, assumes currently logged in user.
* @param int $count_to_update Bitwise value for what to update. 1 = total, 2 = new, 4 = unread. Combinations accepted.
* @return array The updated counters
|
*/
function update_pm_count($uid=0, $count_to_update=7)
{
| */
function update_pm_count($uid=0, $count_to_update=7)
{
|
| Zeile 631 | Zeile 710 |
|---|
/**
* Return the language specific name for a PM folder.
*
|
/**
* Return the language specific name for a PM folder.
*
|
* @param int The ID of the folder.
* @param string The folder name - can be blank, will use language default.
| * @param int $fid The ID of the folder.
* @param string $name The folder name - can be blank, will use language default.
|
* @return string The name of the folder.
*/
function get_pm_folder_name($fid, $name="")
| * @return string The name of the folder.
*/
function get_pm_folder_name($fid, $name="")
|
| Zeile 646 | Zeile 725 |
|---|
switch($fid)
{
|
switch($fid)
{
|
case 1:
| case 0:
|
return $lang->folder_inbox;
|
return $lang->folder_inbox;
|
| | break;
case 1:
return $lang->folder_unread;
|
break;
case 2:
return $lang->folder_sent_items;
| break;
case 2:
return $lang->folder_sent_items;
|
| Zeile 666 | Zeile 748 |
|---|
/**
* Generates a security question for registration.
*
|
/**
* Generates a security question for registration.
*
|
| | * @param int $old_qid Optional ID of the old question.
|
* @return string The question session id.
*/
|
* @return string The question session id.
*/
|
function generate_question()
| function generate_question($old_qid=0)
|
{
global $db;
| {
global $db;
|
| Zeile 681 | Zeile 764 |
|---|
$order_by = 'RAND()';
}
|
$order_by = 'RAND()';
}
|
$query = $db->simple_select('questions', 'qid, shown', 'active=1', array('limit' => 1, 'order_by' => $order_by));
| $excl_old = '';
if($old_qid)
{
$excl_old = ' AND qid != '.(int)$old_qid;
}
$query = $db->simple_select('questions', 'qid, shown', "active=1{$excl_old}", array('limit' => 1, 'order_by' => $order_by));
|
$question = $db->fetch_array($query);
if(!$db->num_rows($query))
| $question = $db->fetch_array($query);
if(!$db->num_rows($query))
|
| Zeile 712 | Zeile 801 |
|---|
/**
* Check whether we can show the Purge Spammer Feature
*
|
/**
* Check whether we can show the Purge Spammer Feature
*
|
* @param int The users post count
* @param int The usergroup of our user
* @param int The uid of our user
| * @param int $post_count The users post count
* @param int $usergroup The usergroup of our user
* @param int $uid The uid of our user
|
* @return boolean Whether or not to show the feature
*/
function purgespammer_show($post_count, $usergroup, $uid)
| * @return boolean Whether or not to show the feature
*/
function purgespammer_show($post_count, $usergroup, $uid)
|