Differences

This shows you the differences between two versions of the page.

--- betauserpoints:developer [2023/04/07 07:04] – admin
+++ betauserpoints:developer [2023/04/07 09:32] (current) – admin
@@ Line 1: / Line 1: @@
- --- //[[martin@black-sheep-research.com|Martin Brampton]] 2023/04/07 07:59//====== BetaUserPoints Developers API documentation ======
+====== BetaUserPoints API documentation ======
-Introduction BetaUserPoints - API integration in a Third party component (advanced)
+Introduction BetaUserPoints - API integration in a Third party component (advanced)
-This documentation is priorly dedicated to developers and anyone with sufficient knowledge of PHP language and Joomla 4 component development.
+This documentation is dedicated to developers and anyone with a sufficient knowledge of the PHP language and Joomla 4 component development.
 Licence: BetaUserPoints is released under license GNU/GPL License. Author: Bernard Gilly – Adrien Roussel - Martin Brampton. This project started as AlphaUserPoints back in 2008.
 ===== Plugin/Rule creation =====
-Plugin creation (new rule creation for a 3rd party component) is done in 2 steps
+A plugin creation (new rule creation for a 3rd party component) is done in 2 steps
 === Step1 - API insertion in a component ===
-Just insert the following API in the component code where needed. The best is to make it follow a user action that could give the users some points or take some. For example : in a comment system component or in a forum, just add the API after the comment or topic INSERT query in the database.
+Just insert the following API in the component code where needed. The best way is to make it follow a user action that could give the users some points or take some. For example : in a comment system component or in a forum, just add the API after the comment or topic INSERT query in the database.
 === Basic API ===
 <code php>
-$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
-if ( file_exists($api_AUP))
+    if ( file_exists($api_BUP))
-{
+    {
-    require_once $api_AUP;   BetaUserPointsHelper::newpoints( 'function_name' );
+        require_once $api_BUP; BetaUserPointsHelper::newpoints( 'function_name' );
-}
+    }
 </code>
-function\_name is the name of the rule that will be used to attribute points to the current user (if logged in). For each BetaUserPoints integrated rule (system rules), names syntax is as follows:
+function_name is the name of the rule that will be used to attribute points to the current user (if logged in). For each BetaUserPoints integrated rule (system rules), names syntax is as follows:
-example: sysplgaup\_newregistered for new users points attribution
+example: sysplgbup_newregistered for new users points attribution
 It is convenient to keep the same name syntax for third party components plugin as follows:
-plgaup\_functionname
+plgbup_functionname
-Example: plgaup\_newcomment or plgaup\_newtopic for a comment system or forum API integration. To name a rule that would give points when adding a new topic in Kunena: plgaup\_kunena\_topic\_create.
+Example: plgbup_newcomment or plgbup_newtopic for a comment system or forum API integration. To name a rule that would give points when adding a new topic in Kunena: plgbup_kunena_topic_create.
 Keep in mind that this method only gives points to the current user logged in. This is the Basic API.
 === Attribute points to another user than the current user ===
-To give points to anothe user than the one connected, only the user id is required. To get his BetaUserPoints (AUPID) Identity, we just need to use the getAnyUserReferreID(). This method is the one used to give points to an article author when the article is being read by someone on the site.
+To give points to anothe user than the one connected, only the user id is required. To get his BetaUserPoints (BUPID) Identity, we just need to use the getAnyUserReferreID(). This method is the one used to give points to an article author when the article is being read by someone on the site.
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   ``if ( file_exists($api_AUP))   ``{   require_once $api_AUP;   $aupid = BetaUserPointsHelper::getAnyUserReferreID( $userID );   if ( $aupid )   BetaUserPointsHelper::newpoints( 'function_name', $aupid );   }`
-=== Prevent from attributing points more than once for the same action ===
+<code php>
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    if ( file_exists($api_BUP))
+    {
+        require_once $api_BUP;
+        $bupid = BetaUserPointsHelper::getAnyUserReferreID( $userID );
+        if ( $bupid ) BetaUserPointsHelper::newpoints( 'function_name', $bupid );
+    }
+</code>
+=== Avoid attributing points more than once for the same action ===
+To avoid a user getting points many times for something already done, we can add a reference key. When calling the BetaUserPointsHelper::newpoints function, a precheck is done on this reference key. This method is used in the rule where a user reading an article would give points to the author.
+<code php>
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    if ( file_exists($api_BUP))
+    {
+        require_once $api_BUP;
+        $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', 'item id' );
+        BetaUserPointsHelper::newpoints( 'function_name', '', $keyreference);
+    }
+</code>
-To avoid that a user would get points many times for something allready done, we can add a reference key. When calling the BetaUserPointsHelper::newpoints function, a pre check is done on this reference key. This method is used in the rule where a user reading an article would give points to the author.
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   if ( file_exists($api_AUP))   {   require_once $api_AUP;   $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', ‘item id’ );   BetaUserPointsHelper::newpoints( 'function_name', '', $keyreference);   }`
 === Adding information datas ===
 To add information datas to be displayed in the action details, just add a new parameter as follows:
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   ``if ( file_exists($api_AUP))   {   require_once $api_AUP;   $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', ‘item id’ );   BetaUserPointsHelper::newpoints( function_name','', $keyreference,'information_datas');   }`
+<code php>
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    if ( file_exists($api_BUP))
+    {
+        require_once $api_BUP;
+        $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', 'item id' );
+        BetaUserPointsHelper::newpoints( function_name','', $keyreference,'information_datas');
+    }
+</code>
 === Using different amounts of points on the same rule ===
 A component might also need to add or to take points for different amounts. For example, when buying goods with points. Products have different prices, a fixed amount in the rule would'nt make it. The API $randompoints parameter comes instead of the amount of points set in the rule. It can be negative in case of purchases or penalities.
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   ``if ( file_exists($api_AUP))   {   require_once $api_AUP;   $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', ‘item id’ );   BetaUserPointsHelper::newpoints( function_name','', $keyreference,'',-1450);   }`
-=== Get the result from a successfull operation ===
+<code php>
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    if ( file_exists($api_BUP))
+    {
+        require_once $api_BUP;
+        $keyreference = BetaUserPointsHelper::buildKeyreference('function_name', 'item id' );
+        BetaUserPointsHelper::newpoints( function_name','', $keyreference,'',-1450);
+    }
+</code>
-In a more advanced code, if the component routine needs to know if the operation has been successfull or not, (enough amount of points for a purchase in a user account), we can add a 'feedback' parameter. It has a Boolean type value. Code example:
+=== Get the result from a successful operation ===
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   ``if ( file_exists($api_AUP))   {   require_once $api_AUP;   $keyreference=BetaUserPointsHelper::buildKeyreference('plgaup_purchasewithvirtuemart', $transactionID );   if (BetaUserPointsHelper::newpoints( 'plgaup_purchasewithvirtuemart', '', $keyreference, 'Product reference: AM-5245', -1290, true))   {   [... code continued ...]   }   }`
+In a more advanced code, if the component routine needs to know if the operation has been successful or not, (enough amount of points for a purchase in a user account), we can add a 'feedback' parameter. It has a Boolean type value. Code example:
+<code php>
+    $api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';
+    if ( file_exists($api_BUP))
+    {
+        require_once $api_BUP;
+        $keyreference=BetaUserPointsHelper::buildKeyreference('plgbup_purchasewithvirtuemart', $transactionID );
+        if (BetaUserPointsHelper::newpoints( 'plgbup_purchasewithvirtuemart', '', $keyreference, 'Product reference: AM-5245', -1290, true))
+        {
+            [... code continued ...]
+        }
+    }
+</code>
 === Remove the constraint on the type of user ===
-In a customized code component, you can force and remove the constraint on a rule to the user level by adding the parameter _force = 1_. The existing rule will be available now for _guest, registered and special_.
+In a customized code component, you can force and remove the constraint on a rule to the user level by adding the parameter _force = 1_. The existing rule will be available now for _guest, registered_ and _special_.
 === Display an additional system message on frontend ===
-You can display a specific message on frontend by adding the parameter frontmessage=”You custom message”. API full implementation
+you can display a specific message on frontend by adding the parameter frontmessage=”You custom message”. API full implementation
-`BetaUserPointsHelper::newpoints(   string$pluginfunction,   [string$AUPIDotheruser = ''],   [string$keyreference = ''],   [string$data = ''],   [integer$randompoints = 0],   ``[boolean$feedback = false],   [integer$force=0],   [string$frontmessage='']   );`
+<code php>
+    BetaUserPointsHelper::newpoints(
-Note: If the operation is a points substraction, the account has to have at least the same amount of points. If not, a notice warns the user that he doe'snt have enough points to complete the action (by default). You can set up general parameter in the configuration of BetaUserPoints, in backend administrator to allows your users to have a negative account.
+        string$pluginfunction,
+        [string$BUPIDotheruser = ''],
+        [string$keyreference = ''],
+        [string$data = ''],
+        [integer$randompoints = 0],
+        [boolean$feedback = false],
+        [integer$force=0],
+        [string$frontmessage='']
+    );
+</code>
+Note: If the operation is a points substraction, the account has to have at least the same amount of points. If not, a notice warns the user that he doe'snt have enough points to complete the action (by default). You can set up general parameter in the configuration of BetaUserPoints, in backend administrator to allows your users to have a negative account.
 ==== Step 2 - XML file creation ====
-Then developers have to create an xml file to make easier the installation process in the BetaUserPoints component. This xml file has to be utf-8 encoded (required). All developers of third party extensions for Joomla! can add directly at the root of their frontend component a unique xml file containing all the rules for a single component. Deveoper has to respect the ordering and tags: structure example: [betauserpoints\_rule.xml](images/stories/documentation/betauserpoints/betauserpoints_rule.xml) Tag “component” is the name of the third component like “com\_kunena” or other. As it is the same component, it is worth repeating for each rule in the tag “rule”.
+Then developers have to create an xml file to make easier the installation process in the BetaUserPoints component. This xml file has to be utf-8 encoded (required). All developers of third party extensions for Joomla! can add directly at the root of their frontend component a unique xml file containing all the rules for a single component. Deveoper has to respect the ordering and tags: structure example: [betauserpoints_rule.xml](images/stories/documentation/betauserpoints/betauserpoints_rule.xml) Tag “component” is the name of the third component like “com_kunena” or other. As it is the same component, it is worth repeating for each rule in the tag “rule”.
 Administrator of the website which install a third component with this xml file can autodetect directly from the button “auto-detect plugins” in control panel of BetaUserPoints.
-This xml file has to be utf-8 encoded (required) but not be zipped! Just put this file at the root of frontend component folder or plugin or module and include this file in your installer extension. This file must be named exactly as follows: betauserpoints\_rule.xml
+This xml file has to be utf-8 encoded (required) but not be zipped! Just put this file at the root of frontend component folder or plugin or module and include this file in your installer extension. This file must be named exactly as follows: betauserpoints_rule.xml
 === Code list for categories : ===
-ar -> articles
+<code>
-cd -> coupons
+ar -> articles
-co -> community
+cd -> coupons
-fo -> forums/comments
+co -> community
-li -> links
+fo -> forums/comments
-mu -> music
+li -> links
-ot -> other
+mu -> music
-ph -> photo
+ot -> other
-po -> polls
+ph -> photo
-pu -> purchase
+po -> polls
-re -> recommend/send to a friend
+pu -> purchase
-sh -> shopping
+re -> recommend/send to a friend
-su -> private
+sh -> shopping
-sy -> system rules
+su -> private
-us -> users
+sy -> system rules
-vi -> video
+us -> users
+vi -> video
+</code>
 NOTE : Optionally, you can avoid this step manually by filling all the fields in the creation of a new rule directly in the rule manager (button 'New' in toolbar).
-===== Plugin/Rule installation =====
+==== Plugin/Rule installation ====
-\- auto-detect xml file at the root of frontend component:
+- auto-detect xml file at the root of frontend component:
 Click on the button “Auto-detect plugins” in the control panel of BetaUserPoints after installation of third component, plugin or module. Check regularly or periodically by clicking on this button.
+==== Using BetaUserPoints information in a third party component ====
-===== Using BetaUserPoints informations in a third party component =====
+You can use easily the profil informations of a user directly in a third component.
+=> Before using a function, you must include the API at least once in your page like this:
-You can easily use the profile information of a user directly in a third component.
+<code php>
-\=> Before using a function, you must include the API at least once in your page like this:
+$api_BUP = JPATH_SITE.'/components/com_betauserpoints/helper.php'; if ( file_exists($api_BUP)) { require_once $api_BUP; }
+</code>
-`$api_AUP = JPATH_SITE.'/components/com_betauserpoints/helper.php';   if ( file_exists($api_AUP)) { require_once $api_AUP; }`
 === Profile information ===
-To get the entire profile information, just use the function getUserInfo();
+To get the entire profil information, just use the function getUserInfo();
-Just use the referreid of BetaUserPoints user or the Joomla ID of the user (id of Joomla users table).
+Just use the referreid of BetaUserPoints user or the joomla ID of the user (Id of Joomla users table).
 Use the first method with the referreid to get user Information profile like this :
-`BetaUserPointsHelper::getUserInfo($referrerid );`
+<code php>
+BetaUserPointsHelper::getUserInfo($referrerid );
+</code>
-If you do not have the referreid, you can use the ID of user in the second parameter like this :
+If you do not have the referreid, you can use the ID of user in second parameter like this :
-`$user = JFactory::getUser();   $userid = $user->id ;   $profil = BetaUserPointsHelper::getUserInfo ( '', $user->id );`
+<code php>
-Then you can get the following user informations:
+$user = JFactory::getUser(); $userid = $user->id ; $profil = BetaUserPointsHelper::getUserInfo ( '', $user->id );
-$profil->name
+</code>
-$profil->username
-$profil->registerDate
+Then you can get the following user informations:
-$profil->lastvisitDate
-$profil->email
+<code>
-$profil->referreid
+$profil->name
-$profil->points
+$profil->username
-$profil->max\_points
+$profil->registerDate
-$profil->last\_update
+$profil->lastvisitDate
-$profil->referraluser
+$profil->email
-$profil->referrees
+$profil->referreid
-$profil->blocked
+$profil->points
-$profil->birthdate
+$profil->max_points
-$profil->avatar
+$profil->last_update
-$profil->levelrank
+$profil->referraluser
-$profil->leveldate
+$profil->referrees
-$profil->gender
+$profil->blocked
-$profil->aboutme
+$profil->birthdate
-$profil->website
+$profil->avatar
-$profil->phonehome
+$profil->levelrank
-$profil->phonemobile
+$profil->leveldate
-$profil->address
+$profil->gender
-$profil->zipcode
+$profil->aboutme
-$profil->city
+$profil->website
-$profil->country
+$profil->phonehome
-$profil->education
+$profil->phonemobile
-$profil->graduationyear
+$profil->address
-$profil->job
+$profil->zipcode
-$profil->facebook
+$profil->city
-$profil->twitter
+$profil->country
-$profil->icq
+$profil->education
-$profil->aim
+$profil->graduationyear
-$profil->yim
+$profil->job
-$profil->msn
+$profil->facebook
-$profil->skype
+$profil->twitter
-$profil->gtalk
+$profil->icq
-$profil->xfire
+$profil->aim
+$profil->yim
+$profil->msn
+$profil->skype
+$profil->gtalk
+$profil->xfire
 $profil->profileviews
+</code>
-=== Get AUP avatar of user ===
+=== Get BUP avatar of user ===
 Display the image of avatar from BetaUserPoints.
-`$avatar = BetaUserPointsHelper:: getAupAvatar(   $userid,   [$linktoprofil=0],   [ $width=48],   [$height=48],   [$class=''],   [$otherprofileurl='']   )   echo $avatar ;`
-if $linktoprofil set to 1, display avatar with the link to the AUP profil of this user.
-=== Get link to AUP user profile ===
+<code php>
+$avatar = BetaUserPointsHelper:: getAupAvatar( $userid, [$linktoprofil=0], [ $width=48], [$height=48], [$class=''], [$otherprofileurl=''] ) echo $avatar ;
+</code>
-Get the url to show the profile of a user.
+if $linktoprofil set to 1, display avatar with the link to the BUP profil of this user.
-`$linktoAUPprofil = BetaUserPointsHelper::getAupLinkToProfil($userid);`
-=== Get link to AUP users list ===
-Get the url to show the list of users with points etc…
+=== Get link to BUP user profile ===
-`$linktoAUPusersList = BetaUserPointsHelper:: getAupUsersURL();`
+Get the url to show the profil of user.
+<code php>
+$linktoBUPprofil = BetaUserPointsHelper::getAupLinkToProfil($userid);
+</code>
+=== Get link to BUP users list ===
+Get the url to show the list of users with points etc…
+<code php>
+$linktoBUPusersList = BetaUserPointsHelper:: getAupUsersURL();
+</code>
 === Get avatar Path of a user ===
-Get the avatar path of a specific user
+Get the path avatar path of a specific user
-`$avatarPath = BetaUserPointsHelper:: getAvatarPath( $userid );`
+<code php>
+$avatarPath = BetaUserPointsHelper:: getAvatarPath( $userid );
+</code>
 === Get avatar Live Path of a user ===
 Get the live url avatar path of a specific user
-`$avatarLivePath = BetaUserPointsHelper:: getAvatarLivePath( $userid );      `
+<code php>
+$avatarLivePath = BetaUserPointsHelper:: getAvatarLivePath( $userid );
+</code>
 === Get the medals list of a user ===
-`$medalslistuser = getUserMedals($referrerid);`
+<code php>
-or
+$medalslistuser = getUserMedals($referrerid);
-`$medalslistuser = getUserMedals('', $userid);`
+</code>
+or
-return $medallistuser->id
+<code php>
-return $medallistuser->rank (name of medal)
+$medalslistuser = getUserMedals('', $userid);
-return $medallistuser->description (reason for awarded)
+</code>
-return $medallistuser->icon (name file icon)
-return $medallistuser->image (name file image) Complete example to display large image of medals:
+<code>
+return $medallistuser->id
-`$user = JFactory::getUser();   ``$userid = $user->id ;   if(!defined("_AUP_MEDALS_PATH"))   {   define('_AUP_MEDALS_PATH', JURI::root() . 'components/com_betauserpoints/assets/images/awards/large/’);   }   if(!defined("_AUP_MEDALS_LIVE_PATH"))   {   define('_AUP_ MEDALS _LIVE_PATH', JURI::base(true) . '/components/com_betauserpoints/assets/images/awards /large/');   }   $medalslistuser = BetaUserPointsHelper::getUserMedals( '', $userid );   for each ( $medalslistuser as $medallistuser )   {   echo '<img src="'. _AUP_MEDALS_LIVE_PATH'.$medallistuser->image . '" alt="" />';   }`
+return $medallistuser->rank (name of medal)
+return $medallistuser->description (reason for awarded)
+return $medallistuser->icon (name file icon)
+return $medallistuser->image (name file image) Complete example to display large image of medals:
+</code>
+<code php>
+    $user = JFactory::getUser();
+    $userid = $user->id;
+    if(!defined("_BUP_MEDALS_PATH"))
+    {
+        define('_BUP_MEDALS_PATH', JURI::root() . 'components/com_betauserpoints/assets/images/awards/large/');
+    }
+    if(!defined("_BUP_MEDALS_LIVE_PATH"))
+    {
+        define('_BUP_ MEDALS _LIVE_PATH', JURI::base(true) . '/components/com_betauserpoints/assets/images/awards /large/');
+    }
+    $medalslistuser = BetaUserPointsHelper::getUserMedals( '', $userid );
+    for each ( $medalslistuser as $medallistuser )
+    {
+        echo '<img src="'. _BUP_MEDALS_LIVE_PATH'.$medallistuser->image . '" alt="" />';
+    }
+</code>
 === Get the ReferreID of any user ===
-`$referreid = BetaUserPointsHelper::getAnyUserReferreID( $userID );`
+<code php>
+$referreid = BetaUserPointsHelper::getAnyUserReferreID( $userID );
+</code>
 === Get the current total points of any user ===
-Use the first method with the referreid to get the total points
+Use the first method with the referreid to get the total of points
-`$totalPoints = BetaUserPointsHelper::getCurrentTotalPoints( $referrerid );      `If you do not have the referreid, you can use the ID of user (joomla) in the second parameter like this :
+<code php>
+$totalPoints = BetaUserPointsHelper::getCurrentTotalPoints( $referrerid );
-`$user = JFactory::getUser();   $userid = $user->id ;   $totalPoints = BetaUserPointsHelper::getCurrentTotalPoints( '', $userid );`
+</code>
+If you have not the referreid, you can use the ID of user (joomla) in second parameter like this :
+<code php>
+$user = JFactory::getUser(); $userid = $user->id ; $totalPoints = BetaUserPointsHelper::getCurrentTotalPoints( '', $userid );
+</code>
 === Get the list of activities ===
-`$listActivities = BetaUserPointsHelper::getListActivity($type='all', $userid='all', $numrows=0);   `
+<code php>
-$params $type = all | positive | negative
+$listActivities = BetaUserPointsHelper::getListActivity($type='all', $userid='all', $numrows=0);
-$params $userid = all or unique userID
+</code>
-$params $limit = int (0 by default)
-example-1 -> -------------------------------------------------------------------------
+<code>
-example-1 -> $listActivities = BetaUserPointsHelper::getListActivity('all', 'all');
+$params $type = all | positive | negative
-example-1 SAME AS -> $listActivities = BetaUserPointsHelper::getListActivity();
+$params $userid = all or unique userID
-example-1 -> show all activities with pagination, positive and negative points of activity for all users
+$params $limit = int (0 by default)
-\-----------------------------------------------------------------------------------
+example-1 -> -------------------------------------------------------------------------
-example-2 -> -------------------------------------------------------------------------
+example-1 -> $listActivities = BetaUserPointsHelper::getListActivity('all', 'all');
-example-2 -> $user = JFactory::getUser();
+example-1 SAME AS -> $listActivities = BetaUserPointsHelper::getListActivity();
-example-2 -> $userID = $user->id;
+example-1 -> show all activities with pagination, positive and negative points of activity for all users
-example-2 -> $listActivities = BetaUserPointsHelper::getListActivity('positive',$userID,20);
+-----------------------------------------------------------------------------------
-example-2 -> show only positive points of activity for the current user logged in and show only 20 rows of recent activities
+example-2 -> -------------------------------------------------------------------------
+example-2 -> $user = JFactory::getUser();
-Returns an array or $rows
+example-2 -> $userID = $user->id;
-List of available fields :
+example-2 -> $listActivities = BetaUserPointsHelper::getListActivity('positive',$userID,20);
-insert\_date
+example-2 -> show only positive points of activity for the current user logged in and show only 20 rows of recent activities
-referreid
+</code>
-points (of this activity)
-datareference
+Returns an array or $rows
-rule\_name
-plugin\_function
+List of available fields :
-category
+<code>
+insert_date
+referreid
+points (of this activity)
+datareference
+rule_name
+plugin_function
+category
+</code>
 === Get the next user rank ===
-`$nextrankinfo = BetaUserPointsHelper::getNextUserRank($referrerid='’, $userid='0', currentrank);`
+<code php>
+$nextrankinfo = BetaUserPointsHelper::getNextUserRank($referrerid='', $userid='0', currentrank);
-return $nextrankinfo->id
+</code>
-return $nextrankinfo->rank (name of rank)
-return $nextrankinfo->description (description of rank)
+<code>
-return $nextrankinfo->levelpoints (level points to reach this rank)
+return $nextrankinfo->id
-return $nextrankinfo->typerank (return 0)
+return $nextrankinfo->rank (name of rank)
-return $nextrankinfo->icon (name file icon)
+return $nextrankinfo->description (description of rank)
-return $nextrankinfo->image (name file image)
+return $nextrankinfo->levelpoints (level points to reach this rank)
-=== Get version of AUP ===
+return $nextrankinfo->typerank (return 0)
+return $nextrankinfo->icon (name file icon)
+return $nextrankinfo->image (name file image)
+</code>
+=== Get version of BUP ===
+<code php>
+$num_bup_version = BetaUserPointsHelper::getBupVersion();
+</code>
+Returns the current version of BetaUserPoints like -> 4.0.0
+==== BetaUserPoints is open for third component ====
+Create your own plugin for BetaUserPoints !
+Plugins provide functions which are associated with trigger events.
+Available events in BetaUserPoints:
+<code>
+- onBeforeInsertUserActivityBetaUserPoints - onUpdateBetaUserPoints
+- onAfterUpdateBetaUserPoints
+- onChangeLevelBetaUserPoints
+- onUnlockMedalBetaUserPoints
+- onGetNewRankBetaUserPoints
+- onResetGeneralPointsBetaUserPoints
+- onBeforeDeleteUserActivityBetaUserPoints
+- onAfterDeleteUserActivityBetaUserPoints
+- onBeforeDeleteAllUserActivitiesBetaUserPoints
+- onAfterDeleteAllUserActivitiesBetaUserPoints
+- onBeforeMakeRaffleBetaUserPoints
+- onAfterMakeRaffleBetaUserPoints
+</code>
+You can see the example file /plugins/betauserpoints/example_plugin_bup.php in your Joomla directory with parameters for each functions.
+[betauserpoints](/extensions/index.php?option=com_tags&view=tag&id=4-betauserpoints)
+* Created on 15 January 2016.
+* Last updated on 05 April 2023.
-`$num_aup_version = BetaUserPointsHelper::getAupVersion();`
-Returns the current version of BetaUserPoints like -> 1.0.0
-===== BetaUserPoints is open to third party component =====
-Create your own plugin for BetaUserPoints !
-Plugins provide functions which are associated with trigger events.
-Available events in BetaUserPoints:
-\- onBeforeInsertUserActivityBetaUserPoints - onUpdateBetaUserPoints
-\- onAfterUpdateBetaUserPoints
-\- onChangeLevelBetaUserPoints
-\- onUnlockMedalBetaUserPoints
-\- onGetNewRankBetaUserPoints
-\- onResetGeneralPointsBetaUserPoints
-\- onBeforeDeleteUserActivityBetaUserPoints
-\- onAfterDeleteUserActivityBetaUserPoints
-\- onBeforeDeleteAllUserActivitiesBetaUserPoints
-\- onAfterDeleteAllUserActivitiesBetaUserPoints
-\- onBeforeMakeRaffleBetaUserPoints
-\- onAfterMakeRaffleBetaUserPoints
-You can see the example file /plugins/betauserpoints/example\_plugin\_aup.php in your Joomla directory with parameters for each functions.
-[betauserpoints](/extensions/index.php?option=com_tags&view=tag&id=4-betauserpoints), [alphauserpoints](/extensions/index.php?option=com_tags&view=tag&id=5-alphauserpoints)
-*   Created on 15 January 2016.
-*   Last updated on 5 April 2023.