Documentation by Black Sheep Research

User Tools

Site Tools

Trace:
userpoints:developer

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
userpoints:developer [2024/02/07 17:04] – adminuserpoints:developer [2025/03/07 14:28] (current) – admin
Line 28: Line 28:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    UserPoints::newpoints('rule_name');+    if (class_exists(UserPoints::class) { 
 +        UserPoints::newpoints('rule_name'); 
 +    }
 </code> </code>
  
Line 46: Line 48:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    $upid = UserPoints::getAnyUserReferreID( $userID ); +    if (class_exists(UserPoints::class) { 
-    if ( $bupid ) UserPoints::newpoints( 'rule_name', $upid ); +        $upid = UserPoints::getAnyUserReferreID( $userID ); 
 +        if ( $bupid ) UserPoints::newpoints( 'rule_name', $upid ); 
 +    }
 </code> </code>
  
Line 56: Line 60:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   +    if (class_exists(UserPoints::class) { 
-    UserPoints::newpoints( 'rule_name', '', $keyreference);  +        $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   
 +        UserPoints::newpoints( 'rule_name', '', $keyreference); 
 +    }
 </code> </code>
  
Line 66: Line 72:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   +    if (class_exists(UserPoints::class) { 
-    UserPoints::newpoints( rule_name','', $keyreference,'information_data');  +        $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   
 +        UserPoints::newpoints( rule_name','', $keyreference,'information_data'); 
 +    }
 </code> </code>
  
Line 76: Line 84:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   +    if (class_exists(UserPoints::class) { 
-    UserPoints::newpoints( 'rule_name','', $keyreference,'',-1450);  +        $keyreference = UserPoints::buildKeyreference('rule_name', 'item id' );   
 +        UserPoints::newpoints( 'rule_name','', $keyreference,'',-1450); 
 +    }
 </code> </code>
  
Line 86: Line 96:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    $keyreference=UserPoints::buildKeyreference('up_purchasewithvirtuemart', $transactionID ); +    if (class_exists(UserPoints::class) { 
-    if (UserPoints::newpoints( 'up_purchasewithvirtuemart', '', $keyreference, 'Product reference: AM-5245', -1290, true)) +        $keyreference=UserPoints::buildKeyreference('up_purchasewithvirtuemart', $transactionID ); 
-    { +        if (UserPoints::newpoints( 'up_purchasewithvirtuemart', '', $keyreference, 'Product reference: AM-5245', -1290, true)) 
-         [... code for successful operation ...]+        { 
 +            [... code for successful operation ...] 
 +        }
     }     }
 </code> </code>
Line 103: Line 115:
 <code php> <code php>
     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;     use BlackSheepResearch\Component\UserPoints\Site\UserPoints;
-    UserPoints::newpoints(+    if (class_exists(UserPoints::class) { 
 +      UserPoints::newpoints(
         string $pluginfunction,         string $pluginfunction,
         [string $BUPIDotheruser = ''],         [string $BUPIDotheruser = ''],
Line 112: Line 125:
         [integer $force=0],         [integer $force=0],
         [string $frontmessage='']         [string $frontmessage='']
-    );+      ); 
 +    }
 </code> </code>
  
Line 119: Line 133:
 ==== Step 2 - XML file creation ==== ==== Step 2 - XML file creation ====
  
-Then developers have to create an xml file to make easier the installation process in the UserPoints 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”. +To complete the integration of an application with UserPoints, create an XML file to specify rule(s). The XML file should be added at the top level of the extension that is being integrated with UserPoints. In the case of a component, it should be on the user side. The XML file must be called userpoints_rule.xml. If the extension being integrated with UserPoints has been installed including a valid userpoints_rule.xml file, then the site administrator can invoke "Auto-detect new rules" from the UserPoints control panel. UserPoints will then look for any XML rule files and incorporate them into the database of rules. 
-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 UserPoints. + 
-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+An example of userpoints_rule.xml is the file for Remository which reads: 
 + 
 +<code> 
 +<?xml version="1.0" encoding="UTF-8"?> 
 +<userpoints> 
 +    <component>com_remository</component> 
 +    <rules> 
 +        <rule> 
 +            <name>Upload</name> 
 +            <description>Give points when a new file is uploaded</description> 
 +            <plugin_function>up_remository_up</plugin_function> 
 +            <fixed_points>true</fixed_points> 
 +            <category>ot</category> 
 +            <display_message>1</display_message> 
 +            <email_notification>1</email_notification> 
 +        </rule> 
 +        <rule> 
 +            <name>Download</name> 
 +            <description>Take points when a file is downloaded</description> 
 +            <plugin_function>up_remository_down</plugin_function> 
 +            <fixed_points>false</fixed_points> 
 +            <category>ot</category> 
 +            <display_message>1</display_message> 
 +            <email_notification>1</email_notification> 
 +        </rule> 
 +    </rules> 
 +</userpoints> 
 +</code> 
  
 === Code list for categories : === === Code list for categories : ===
Line 144: Line 186:
 </code> </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).+=== Code list for methods: === 
 + 
 +You can add a <method> tag into the XML for a rule, with the following options: 
 + 
 +<code> 
 +1 -> Only once 
 +2 -> Once a day per user 
 +3 -> Once a day for a single user on all users 
 +4 -> Whenever 
 +5 -> Once per week 
 +6 -> Once per month 
 +7 -> Once per year 
 +</code> 
  
-==== Plugin/Rule installation ====+NOTE : It is possible to create new rules manually by filling all the fields in the creation of a new rule directly in the rule manager (button 'New' in toolbar). But for the integration of other extensions with UserPoints the use of a userpoints_rule.xml file is much better.
  
-- auto-detect xml file at the root of frontend component: 
-Click on the button “Auto-detect plugins” in the control panel of UserPoints after installation of third component, plugin or module. Check regularly or periodically by clicking on this button. 
  
-==== Using UserPoints information in a third party component ====+===== Using UserPoints information in a third party component =====
  
 You can use easily the profil informations of a user directly in a third component. You can use easily the profil informations of a user directly in a third component.
Line 414: Line 467:
 * Created on 15 January 2016. * Created on 15 January 2016.
  
-* Last updated on 7 February 2024.+* Last updated on 25 November 2024.
  
  
  
  
userpoints/developer.1707325480.txt.gz · Last modified: 2024/02/07 17:04 by admin