Ryzom AMS Plugin Hooks

Owned by Matthew Lagoe
Last updated: May 11, 2014
2 min read

Ryzom AMS Plugin Hooks

Info

documentation notes

All hooks are designed with the following structure

$pluginname_hook_name

The plugin name is defined in the plugin.info

The plugin name matches the folder it installs to

Hooks are documented in the following way

 

First code block is the psudo code defination, this defines the input and output

param_list = Array()

function func_check takes param_list, boolean returns integer(min = 0, max = 5)
    variable_declaration $username
    variable_declaration $permissions
     ...
     statement 
		param_list[time] set to 0
     ...
     statement
        return false if $permissions < 3
     ...
endfunction

following code blocks are assigned a preceding "type"

array's are formatted in the print_r style

global helper variables are preceded with $

variable param_list
Array
(
    [time] => integer(min = 0, max = 100)
    [name] => string(maxchar(32))
    [values] => Array
        (
            [0] => $username
            [1] => $permissions
        )
)
return
Value definitions

1 = true
2 = false
3 = run again
4 = failed
5 = test succeeded

Global Variables

$username = current users username
$permissions = permissions value 
$current_time = current unix timestamp
$pluginname = name of plugin

 

User Hooks

Admin Hooks

Time Hooks

Hook_Cron

 

Hook_Cron definition
type = integer(min = 0, max = 1, default = 0)
last_run = integer 
	pulled from lib_database table cron column lastrun
time_delta = integer 
	pulled from lib_database table plugins column $pluginname_cron_name_delta
cron_function = string 
	function name to run when cron should be activated

function Hook_Cron takes type, time_delta, cron_name returns integer(min = 0, max = 3)
     variable_declaration $current_time 
     ...
     statement 
		if $current_time > last_run + time_delta then return(3)
		else 
		run cron_function
     statement 
		if cron is running then return(2)
     statement 
	    function failed return 0
		function succeeded return 1
     ...
endfunction
variable Type
0 = normal run
1 = force run
return
Value definitions

0 = cron failed
1 = cron succeeded 
2 = cron running
3 = cron doesn't need to run

Display Hooks