class Core

Class Core

Traits

Trait CoreLinkMethods
Trait ObjectManager XELOS Framework

Properties

protected array $object_cache Each object created by a success call of __call or __get will be saved into this property to avoid a multiple creation of same objects and minimize performance loss. If the multiple creation of objects is desirable e.g. in factory classes, the caching can be disabled by setting xf_trait::factory_mode to true. from ObjectManager
protected array[] $registry The instantiation of a requested object can be processed only if the class of the object is registered with the class name as key and its information as array in this property. The element should have at least the class name or the relative path to "class" folder. from ObjectManager
protected string $lib_class_dir This property contains the path to the folder served as root for all requested classes. This folder can contains other folder or classes. All requested and registered classes will be searched in this folder by concating this path with the relative path defined in the registration of the requested class. If the class is not included it will be done on the fly. from ObjectManager
protected string $lib_class_prefix An optional possibility to pretend a prefix for all registered classes. from ObjectManager
protected string $ns_class_prefix An optional possibility to pretend a namespace prefix for classes have no namespace yet. from ObjectManager
protected bool $factory_mode This property effects the object cache. By default it is set to false to enable the object cache for all requested objects. If this property is set true, the object cache will be disabled. from ObjectManager
protected array $injection_objects This is an assoc array and contains objects that will be injected into each requested object. Each containing object will be injected by the name of the key. E.g. ['mod' => $object] this would inject the property named mod with the value of $object. from ObjectManager
protected bool $auto_init This property controls if the init method of requested objects is called by this trait or not. from ObjectManager
bool $full_module_namespace_support
Config $config
bool $instance_copy_id
mixed $template
string $context
Core $parent_context
int $group_context
string $group_name
protected int $security_level
protected string $security_level_mode
$xf_link
array $GPvars
static array|false $hook_cache Used to cache hook table per request
static array|null $hook_policy_cache Used to cache hook policies per request
MagicMethodHelper $action Access to actions defined in the class sub-folder action
MagicMethodHelper $model Access to models defined in the class sub-folder model
MagicMethodHelper $page Access to pages defined in the class sub-folder page
MagicMethodHelper $ui Access to ui components defined in the class sub-folder ui

Methods

string
_(string $token)

Gettext Wrapper using current module context for module specific translations

mixed
__call($class, $args)

Magic method.

__construct(string $instance = null)

No description

mixed
__get($class)

Magic method.

bool
__isset($property)

Magic method.

__set($name, $value)

Magic method.

__toString()

No description

add_actionlog(int $action_id, int|bool $user_id = false, string|bool $what = false, int|bool $target_user_id = false, array|bool $link_params = false, int|bool $post_id = false, int|bool $post_type = 0, int|bool $group_id = false)

No description

add_class_to_registry($registry)

No description

add_config_array(mixed $configArray, mixed $context = false)

No description

bool|string|xelos_global_template
ajax_response(array|bool $json_response = false, bool|int $error_code = false, bool|xelos_global_template $template = false, bool|string $render_mode = false)

Returns the passed JSON and returns the module template directly to the view class for rendering

check_download_file(mixed $path_to_file, mixed $download_params)

No description

clear_template()

No description

dblquery($sql, $mode = 'fetch_assoc', $file = __FILE__, $line = __LINE__, $cache_ttl = false, $cache_group = false, $query_type = false)

Calls dbquery() after given SQL has been converted by $XF->lib->i18n->convert_i18n_sql()

mixed
dbquery(string $sql, string $mode = 'fetch_assoc', string $file = __FILE__, int $line = __LINE__, int|bool $cache_ttl = false, int|bool $cache_group = false, string|bool $query_type = false)

No description

mixed
dbquery_with_params(string $sql, array $params, string $mode = 'fetch_assoc', string $file = __FILE__, int $line = __LINE__, int|bool $cache_ttl = false, int|bool $cache_group = false, string|bool $query_type = false)

No description

bool
delete_file(int $id)

Deletes the file stored in the storage DMS.

xelos_global_template|string
error_response(string $err_msg = 'access_denied', string $err_type = 'denied', string $render_mode = 'full')

No description

get_accessible_page($page_id, $args = array())

No description

array|bool
get_actionlog_entries(int|bool $user_ids = false, array|bool $actionlog_levels = false, int $limit = 10, int|bool $target_user_ids = false, boolean $hide_own = false, int|bool $group_security_id = false, int|bool $post_id = false, string|bool $what = false)

get logged actions. You can restrict the result by the parameters instance and user etc.

array
get_available_languages()

Get the configured languages for this instance

mixed
get_config(string $var, mixed $context = false)

No description

int
get_context_id()

gets the numerical Context-ID (PrimaryKey in Instance_Registry)

array|false
get_current_link(array $params = array())

No description

get_current_url()

No description

string
get_default_i18n()

Get the default language set for this instance

Core|bool
get_dep(string $dep_id, int|bool $group_context = false)

No description

xelos_global_template
get_dep_page(bool|string $default = false, bool|string $cmd = false, bool $preserve_render_mode = false)

No description

array
get_deps($group_context = false)

No description

get_document_index(int $local_document_id, int $document_type = 0)

returns the global document index fron document_index

int|false
get_document_index_id(int $local_document_id, int $document_type = 0)

returns the global document id fron document_index

get_dyn_config($var, $order_set_name = false, $context = false)

No description

mixed
get_file_link(mixed $path_to_file, mixed $params = array())

Get File Link

mixed
get_file_url(string $path_to_file, boolean $inline_disposition = true, string|bool $name = false, boolean $zipOnTheFly = false, int|bool $width = false, int|bool $height = false, string|bool $resize_mode = false, bool $public_file_link = false)

Constructs and returns a download link for file

array
get_file_url_args(string $path_to_file, mixed $inline_disposition = true, mixed $name = false, mixed $zipOnTheFly = false)

No description

int
get_group()

No description

mixed
get_hook(string $original_hook_name, string $provider_instance = 'self', bool $force_new = false, bool $skip_access_check = false)

No description

array
get_hooks(string $local_hook_name, array|bool $limit_to_instances = false, bool $instantiate = true, bool $return_group_siblings = false, bool $hook_class = false)

No description

string
get_lib_class_dir()

Returns the path to class directory.

string
get_lib_class_prefix()

Returns the defined prefix for all classes.

array|bool
get_link()

No description

mixed
get_object(string $class, null|array $args = null, bool $call_init = true)

Call specific object - allows to use constructor-params (overload function) This function is primarily called from the magic __GET and __CALL Methods

array
get_object_cache()

Returns an array containing all objects were requested.

xelos_global_template
get_page(string $page_id, array $args = array())

No description

Core|bool
get_parent_context()

Get Parent Context

mixed
get_plugin(string $name)

No description

array
get_plugins_by_prefix(string $prefix)

No description

get_preview_url($path_to_file, $name = false)

No description

static 
get_resize_hash(int $w, int $h)

Calculate Resize Hash !Is also called static

int
get_security_level()

No description

xm_system_dms
get_system_dms()

Returns the default dms to store application files.

xelos_global_template
get_template(bool $force_new = false)

No description

get_thumb_url($path_to_file, $name = false)

No description

string
get_url()

No description

get_xf_link()

No description

init()

Declare this method in a XELOS module if you require standard code to be executed after __construct with all members and references available

mixed
lpquery(string $query, array $params = array(), string $file = __FILE__, int $line = __LINE__, int $cache_ttl = 0, null $cache_group = null)

No description

notification_info(mixed $user_id, mixed $token)

Get single notification by token to retrieve information before notify

notification_mark_read(mixed $user_id, string $token)

Mark a Notification as Read

notify(mixed $user_id, string $token, string $subject, string $plaintext = null, mixed $html = false, mixed $url = null, string $icon = null, string $type = 'activity')

Notification

notify_vars(mixed $user_id, string $token, VarsTemplate $vars, mixed $url = null, string $icon = null, string $type = 'activity')

Notification with Vars

string|void|xelos_global_template
page__deeplink(array $dependency_id)

DeepLink Page (will be called for unresolvable deeplinks, e.g. from hooks search or others

page__feed(UniversalFeedCreator $feed)

No description

page__file()

No description

mixed
pquery(string $query, array $params = array(), string $file = __FILE__, int $line = __LINE__, int $cache_ttl = 0, null $cache_group = null)

No description

string
prepare_lquery(string $sql)

No description

string
prepare_query(string $sql)

No description

string
print_context_menu($params, $context_links, $current_link = false, $no_js_fallback = true, $onMouseOver = false)

No description

string
print_context_menu_with_submenu(array $entries, array $params = array())

No description

print_current_link()

No description

string
print_file_link(string $path_to_file, array $params = array())

Print File Link (Alias Function)

string
print_link(array $params = array())

Wrapper for XF->lib->link substituting modules with instance names etc.

print_preview_link($path_to_file, $params = array())

No description

string
render()

No description

xelos_global_template
resolve_dep_link(string $dependency, string $page_id, mixed $cmd)

Resolve a Link for a local dependency (a - by returning a valid template or b - by sending a http-redirect)

array
resolve_doc_link(int $post_id, int $post_type = null)

Return the URL info of the page representing your document

false|xm_system_dms_xfs_document
retrieve_document(int $document_index_id, bool $main_document_index_id = false)

Returns the xfs_document in the storage DMS to a ID.

bool
send_file(array $args, bool $binary = false, bool $is_full_path = false)

Get the data.

void
set_config(string $var, string $value, string|bool $context = false, string|bool $subcontext = false)

No description

void
set_config_for_session(string $var, string $value, string $context = false, string $subcontext = false)

No description

set_context_id(int $context_id)

sets the numerical Context-ID (PrimaryKey in Instance_Registry)

set_dep_link_context(xelos_core $parent, string $view, string $page, string $cmd)

Set Dep Link Context - generated URLs will be considered relative to the given parent instance

void
set_group(int $group_id, string|bool $short_name = false)

No description

set_injection_objects(array $objects)

Add given objects to injection object list that will be inject into object by magic call. The array should consists of property name as key and object as value.

set_lib_class_dir($lib_class_dir)

Sets the directory where classes are stored.

set_lib_class_prefix($lib_class_prefix)

Sets the class name prefix.

set_parent_context(Core $obj, mixed $clone_link_helper = true)

No description

void
set_security_level(int $security_level)

No description

void
set_xf_link($xf_link)

No description

setup_check($args = array())

Check/Get Setup Page

xm_system_dms_document|false
store_file(string $path, string $storage_folder, string|bool $file_name = false, DocumentModel|bool $owner = false, DocumentModel|null $owner_document = null)

Stores the file in the system DMS

user_has_access($page = false, $instance_id = false, $group_security_id = false)

No description

array
user_has_access_in_groups(string $page)

Return the group_security ids the user has access to

bool
user_has_policy(string $policy, mixed $policy_value = '*', int|bool $target_user = false, int|bool $group_id = false, string $default_policy = 'deny')

No description

array
user_has_policy_in_groups(string $policy, string $policy_value = false)

Return the group_security ids the user has the policy in

array
user_has_policy_values(string $policy, string $treeTable = null)

User has policy values

xelos_object_manager_init(bool $lib_class_dir, string $lib_class_prefix = '', string $ns_prefix = '')

trait constructor This method have to be called from constructor of each class that uses this trait.

Details

at line 167
string _(string $token)

Gettext Wrapper using current module context for module specific translations

Parameters

string $token

Return Value

string Translated Token

in ObjectManager at line 249
mixed __call($class, $args)

Magic method.

Returns the requested object. If the object is not cached, it will be instantiated with given arguments. This method calls xf_trait::get_object.

Parameters

$class
$args

Return Value

mixed

at line 104
__construct(string $instance = null)

Parameters

string $instance Instance ID

in ObjectManager at line 231
mixed __get($class)

Magic method.

First it checks if the requested property is defined and returns it if null. If not defined of null, it calls xf_trait::get_object and returns its return value.

Parameters

$class

Return Value

mixed

in ObjectManager at line 199
bool __isset($property)

Magic method.

This method checks whether the property is defined or injected by __set. If not injected or defined, it will check the registry for an entry of requested property.

Parameters

$property

Return Value

bool

in ObjectManager at line 219
__set($name, $value)

Magic method.

Sets the given value by $name

Parameters

$name
$value

at line 2290
__toString()

at line 2204
add_actionlog(int $action_id, int|bool $user_id = false, string|bool $what = false, int|bool $target_user_id = false, array|bool $link_params = false, int|bool $post_id = false, int|bool $post_type = 0, int|bool $group_id = false)

Parameters

int $action_id Action ID specifies which kind of action has beed conducted Possible types: ACTIONLOG_ADD, ACTIONLOG_REMOVE, ACTIONLOG_COMMENT,.... (see class for more)
int|bool $user_id User ID mostly $XF->user->get_user_id()
string|bool $what Specifying what has been done (e.g. WHAT has been added) this is default text if displaying user has no access to the linked page
int|bool $target_user_id target User ID (e.g. user has visited profiel from target_user)
array|bool $link_params Link param array for generating a link to the action on the 'what' string
int|bool $post_id Post ID - Normally our primary ID
int|bool $post_type Post Type - If you have different types of Posts
int|bool $group_id Group ID

at line 630
final add_class_to_registry($registry)

Parameters

$registry

at line 822
add_config_array(mixed $configArray, mixed $context = false)

Parameters

mixed $configArray
mixed $context

at line 431
bool|string|xelos_global_template ajax_response(array|bool $json_response = false, bool|int $error_code = false, bool|xelos_global_template $template = false, bool|string $render_mode = false)

Returns the passed JSON and returns the module template directly to the view class for rendering

Parameters

array|bool $json_response JSON Response
bool|int $error_code Error-Code
bool|xelos_global_template $template Template Object (if no template is provided the default template of the current module will be used)
bool|string $render_mode RenderModeAjax (by Default the mode is untouched, if set it will only be applied if the call is an ajax call)

Return Value

bool|string|xelos_global_template

Exceptions

ContentException

at line 1723
check_download_file(mixed $path_to_file, mixed $download_params)

Parameters

mixed $path_to_file
mixed $download_params

at line 1353
clear_template()

at line 685
dblquery($sql, $mode = 'fetch_assoc', $file = __FILE__, $line = __LINE__, $cache_ttl = false, $cache_group = false, $query_type = false)

Calls dbquery() after given SQL has been converted by $XF->lib->i18n->convert_i18n_sql()

Parameters

$sql
$mode
$file
$line
$cache_ttl
$cache_group
$query_type

See also

dbquery()

at line 647
mixed dbquery(string $sql, string $mode = 'fetch_assoc', string $file = __FILE__, int $line = __LINE__, int|bool $cache_ttl = false, int|bool $cache_group = false, string|bool $query_type = false)

Parameters

string $sql SQL Query
string $mode Mode (fetch_assoc, fetch_array)
string $file Filename (for logging and debugging)
int $line Line No
int|bool $cache_ttl Cache TTL in s (Results of this query are case)
int|bool $cache_group Cache Group (can be used to remove all caches from the same group, e.g. template, user_details etc.)
string|bool $query_type reference to string indicates if query was an update/delete or an insert

Return Value

mixed Array with Result OR Insert ID OR Affected Rows OR False for "no rows found"

at line 672
mixed dbquery_with_params(string $sql, array $params, string $mode = 'fetch_assoc', string $file = __FILE__, int $line = __LINE__, int|bool $cache_ttl = false, int|bool $cache_group = false, string|bool $query_type = false)

Parameters

string $sql SQL Query (can contain named markers, e.g. :name)
array $params ['param_name'=>'param_value'] Assoc-Array with SQL Parameters. Will be escaped and inserted into the passed SQL
string $mode Mode (fetch_assoc, fetch_array)
string $file Filename (for logging and debugging)
int $line Line No
int|bool $cache_ttl Cache TTL in s (Results of this query are case)
int|bool $cache_group Cache Group (can be used to remove all caches from the same group, e.g. template, user_details etc.)
string|bool $query_type reference to string indicates if query was an update/delete or an insert

Return Value

mixed Array with Result OR Insert ID OR Affected Rows OR False for "no rows found"

Exceptions

DatabaseException

at line 2508
bool delete_file(int $id)

Deletes the file stored in the storage DMS.

If the file does not exist in the DMS, it checks the mod_storage_path if the file exists there and deletes it there.

Parameters

int $id xfs document ID

Return Value

bool

at line 514
xelos_global_template|string error_response(string $err_msg = 'access_denied', string $err_type = 'denied', string $render_mode = 'full')

Parameters

string $err_msg Error Message
string $err_type Error Type
string $render_mode Render mode

Return Value

xelos_global_template|string (Throws Exception)

Exceptions

ContentException

at line 829
get_accessible_page($page_id, $args = array())

Parameters

$page_id
$args

at line 2249
array|bool get_actionlog_entries(int|bool $user_ids = false, array|bool $actionlog_levels = false, int $limit = 10, int|bool $target_user_ids = false, boolean $hide_own = false, int|bool $group_security_id = false, int|bool $post_id = false, string|bool $what = false)

get logged actions. You can restrict the result by the parameters instance and user etc.

Parameters

int|bool $user_ids or array of int user id(s) of the action should be shown
array|bool $actionlog_levels actionlog_levels array if all levels to be displayed e.g. array(ACTIONLOG_ADD,ACTIONLOG_REMOVE,ACTIONLOG_UPDATE,ACTIONLOG_COMMENT)
int $limit limit
int|bool $target_user_ids or array of int targetuser id(s) of the action should be shown
boolean $hide_own true if own entries are not shown
int|bool $group_security_id group_security
int|bool $post_id to show only entries of a specific post id
string|bool $what show only entries of a specific what

Return Value

array|bool

at line 2324
array get_available_languages()

Get the configured languages for this instance

Return Value

array Empty array if i18n_mode is not available

at line 584
mixed get_config(string $var, mixed $context = false)

Parameters

string $var Parameter (Typical: mod_wwwres_relative, web_path_root, mod_template_path, mod_storage_path)
mixed $context Instance ID

Return Value

mixed Value of Parameter

at line 2299
int get_context_id()

gets the numerical Context-ID (PrimaryKey in Instance_Registry)

Return Value

int $context_id

Parameters

array $params LinkHelper Params in Array Format

Return Value

array|false ['label'=>'', 'target'=>'', 'class'=>'', 'title'=>'', 'href'=>'', 'full'=>''] Link Resource Array

See also

Link::get_current_link()

in CoreLinkMethods at line 181
get_current_url()

at line 2316
string get_default_i18n()

Get the default language set for this instance

Return Value

string Language/Culture (DE_DE)

at line 1247
Core|bool get_dep(string $dep_id, int|bool $group_context = false)

Parameters

string $dep_id internal dependency key
int|bool $group_context Group ID

Return Value

Core|bool

at line 324
xelos_global_template get_dep_page(bool|string $default = false, bool|string $cmd = false, bool $preserve_render_mode = false)

Parameters

bool|string $default Default Page
bool|string $cmd Default CMD
bool $preserve_render_mode

Return Value

xelos_global_template

at line 1281
array get_deps($group_context = false)

Parameters

$group_context

Return Value

array Returns an array with all available dependencies

at line 2355
DocumentIndex get_document_index(int $local_document_id, int $document_type = 0)

returns the global document index fron document_index

requires the model is registered in document_registry for being index by document_index!

Parameters

int $local_document_id
int $document_type

Return Value

DocumentIndex

at line 2337
int|false get_document_index_id(int $local_document_id, int $document_type = 0)

returns the global document id fron document_index

requires the model is registered in document_registry for being index by document_index!

Parameters

int $local_document_id
int $document_type

Return Value

int|false

at line 2274
get_dyn_config($var, $order_set_name = false, $context = false)

Parameters

$var
$order_set_name
$context

Get File Link

Parameters

mixed $path_to_file
mixed $params

Return Value

mixed

at line 1527
mixed get_file_url(string $path_to_file, boolean $inline_disposition = true, string|bool $name = false, boolean $zipOnTheFly = false, int|bool $width = false, int|bool $height = false, string|bool $resize_mode = false, bool $public_file_link = false)

Constructs and returns a download link for file

Parameters

string $path_to_file path to your file within your mod_storage_path
boolean $inline_disposition Show Inline? (Default:True)
string|bool $name Force a specific filename within the headers sent
boolean $zipOnTheFly Want the content zipped? (Default: False)
int|bool $width
int|bool $height
string|bool $resize_mode Resize Mode ['resize', 'crop', false] (Default: False)
bool $public_file_link Generate Public File Link? (not compatible with zipOnTheFly!) This will always resize all images during this call and make them available via public URL /_cache/..

Return Value

mixed

at line 1698
array get_file_url_args(string $path_to_file, mixed $inline_disposition = true, mixed $name = false, mixed $zipOnTheFly = false)

Parameters

string $path_to_file
mixed $inline_disposition
mixed $name
mixed $zipOnTheFly

Return Value

array

at line 390
int get_group()

Return Value

int Group ID

at line 930
mixed get_hook(string $original_hook_name, string $provider_instance = 'self', bool $force_new = false, bool $skip_access_check = false)

Parameters

string $original_hook_name Hook/Callback Key As declared by the provider (e.g. recent_threads)
string $provider_instance Provider Instance Name
bool $force_new Force a new object
bool $skip_access_check

Return Value

mixed Callback Object (Array for Callback or Object for Usage)

Exceptions

Exception

at line 1058
array get_hooks(string $local_hook_name, array|bool $limit_to_instances = false, bool $instantiate = true, bool $return_group_siblings = false, bool $hook_class = false)

Parameters

string $local_hook_name Hook/Callback Key as declared in your Instance Config
array|bool $limit_to_instances Limit to hooks from a certain instance?
bool $instantiate Instantiate Hook Objects?
bool $return_group_siblings Return grouped Siblings?
bool $hook_class

Return Value

array Callback Object (Array for Callback or Object for Usage)

Exceptions

Exception

in ObjectManager at line 167
string get_lib_class_dir()

Returns the path to class directory.

Return Value

string

See also

xf_trait::lib_class_dir
xf_trait::get_lib_class_dir

in ObjectManager at line 177
string get_lib_class_prefix()

Returns the defined prefix for all classes.

Return Value

string

See also

xf_trait::lib_class_prefix

Return Value

array|bool Contains array with url, full etc.

at line 605
final mixed get_object(string $class, null|array $args = null, bool $call_init = true)

Call specific object - allows to use constructor-params (overload function) This function is primarily called from the magic __GET and __CALL Methods

Parameters

string $class
null|array $args
bool $call_init

Return Value

mixed new or existing instance of name

in ObjectManager at line 187
array get_object_cache()

Returns an array containing all objects were requested.

Return Value

array

See also

xf_trait::object_cache

at line 856
xelos_global_template get_page(string $page_id, array $args = array())

Parameters

string $page_id Page ID
array $args Cmd Params

Return Value

xelos_global_template Template Object

at line 1299
Core|bool get_parent_context()

Get Parent Context

Return Value

Core|bool Parent Instance

at line 182
mixed get_plugin(string $name)

Parameters

string $name Plugin Name

Return Value

mixed Plugin

at line 201
array get_plugins_by_prefix(string $prefix)

Parameters

string $prefix Plugin Prefix

Return Value

array with objects ('pluginName'=>Obj)

at line 1596
get_preview_url($path_to_file, $name = false)

Parameters

$path_to_file
$name

at line 1583
static get_resize_hash(int $w, int $h)

Calculate Resize Hash !Is also called static

Parameters

int $w
int $h

at line 415
int get_security_level()

Return Value

int XF_SEC_LEVEL_NONE, XF_SEC_LEVEL_READ, XF_SEC_LEVEL_WRITE, XF_SEC_LEVEL_DELETE or XF_SEC_LEVEL_ADMIN

at line 2445
xm_system_dms get_system_dms()

Returns the default dms to store application files.

It uses the DMS configured in Expert Configuration -> GUI -> Filebrowser DMS: system config key filebrowser_dms

Return Value

xm_system_dms or false

at line 1308
xelos_global_template get_template(bool $force_new = false)

Parameters

bool $force_new Resets all Variables and returns clean/new template

Return Value

xelos_global_template Template Object

at line 1587
get_thumb_url($path_to_file, $name = false)

Parameters

$path_to_file
$name

in CoreLinkMethods at line 108
string get_url()

Return Value

string URL

See also

XF\Lib\Link::get_url()

Return Value

Link

at line 158
init()

Declare this method in a XELOS module if you require standard code to be executed after __construct with all members and references available

at line 762
mixed lpquery(string $query, array $params = array(), string $file = __FILE__, int $line = __LINE__, int $cache_ttl = 0, null $cache_group = null)

Parameters

string $query SQL Query with ? Marker
array $params (1D - array for multiple params)
string $file DEBUG Filename (FILE)
int $line DEBUG Line (LINE)
int $cache_ttl
null $cache_group

Return Value

mixed

Exceptions

Exception

at line 2429
Notification notification_info(mixed $user_id, mixed $token)

Get single notification by token to retrieve information before notify

Parameters

mixed $user_id
mixed $token

Return Value

Notification

at line 2415
notification_mark_read(mixed $user_id, string $token)

Mark a Notification as Read

Parameters

mixed $user_id User-ID or Array of Users
string $token Token

Exceptions

Exception

at line 2397
notify(mixed $user_id, string $token, string $subject, string $plaintext = null, mixed $html = false, mixed $url = null, string $icon = null, string $type = 'activity')

Notification

Parameters

mixed $user_id User-ID or Array of Users
string $token Token for updates for this Notification
string $subject Subject
string $plaintext Plaintext/Shortmessage without HTML
mixed $html HTML-Message
mixed $url Link as URL or as Array (get_current_url)
string $icon FontAwesome-Icon Class
string $type Type of Notification ('activity','todo','message')

at line 2375
notify_vars(mixed $user_id, string $token, VarsTemplate $vars, mixed $url = null, string $icon = null, string $type = 'activity')

Notification with Vars

Parameters

mixed $user_id User-ID or Array of Users
string $token Token for updates for this Notification
VarsTemplate $vars Notification-Vars (subject, plaintext & body)
mixed $url Link as URL or as Array (get_current_url)
string $icon FontAwesome-Icon
string $type Type of notification

DeepLink Page (will be called for unresolvable deeplinks, e.g. from hooks search or others

Parameters

array $dependency_id Arguments

Return Value

string|void|xelos_global_template

at line 1731
page__feed(UniversalFeedCreator $feed)

Parameters

UniversalFeedCreator $feed

at line 1742
page__file()

at line 736
mixed pquery(string $query, array $params = array(), string $file = __FILE__, int $line = __LINE__, int $cache_ttl = 0, null $cache_group = null)

Parameters

string $query SQL Query with ? Marker
array $params (1D - array for multiple params)
string $file DEBUG Filename (FILE)
int $line DEBUG Line (LINE)
int $cache_ttl
null $cache_group

Return Value

mixed

Exceptions

Exception

at line 713
string prepare_lquery(string $sql)

Parameters

string $sql Query

Return Value

string Parsed Query

at line 703
string prepare_query(string $sql)

Parameters

string $sql Query

Return Value

string Parsed Query

at line 1484
string print_context_menu($params, $context_links, $current_link = false, $no_js_fallback = true, $onMouseOver = false)

Parameters

$params
$context_links
$current_link
$no_js_fallback
$onMouseOver

Return Value

string HTML return link resource array

at line 1511
string print_context_menu_with_submenu(array $entries, array $params = array())

Parameters

array $entries of links with Menu labels array(mainmenu_label => array(link1, link2, link3)) for a normal context menu, like print_context_menu array(mainmenu_label => array(link1, link2, submenu_label => array(link3, link4), link5))
array $params of additional params for the first dropdown: class, icon_class

Return Value

string return link resource array

Print File Link (Alias Function)

Parameters

string $path_to_file (Absolute on Disk)
array $params OPTIONAL (defaults: inline_disposition=true, label=basename of file,icon=false,limit_string=false

Return Value

string HTML a tag

Wrapper for XF->lib->link substituting modules with instance names etc.

Example:

$this->mod->print_link(array('label'=>$label, 'page'=>$page, 'ajax_modal'=>array('form' => 'noajax')));
$this->mod->print_link(array('label'=>$label, 'page'=>$page, 'JS-FSLoader'=>array('message' => 'loading..','autohide'=>'5000')));

Parameters

array $params = [ 'label'=>$label, 'page'=>$page, 'cmd'=>$cmd, 'class'=>'btn', 'target'=>'new', 'title'=>$title, 'confirm_text'=>("Are you sure?"), 'JS-FSLoader'=>['message' => 'loading..', 'autohide'=>'5000'], 'ajax_modal'=>['form' => 'noajax', 'width'=> 800 ], 'ajax_update'=>$domId, 'ajax_replace'=>$domId, 'xdi' => DocumentIndex, 'xui_target' => UIAjaxComponent ]

Return Value

string Full HTML A Tag

Parameters

$path_to_file
$params

at line 367
string render()

Return Value

string Output (eg. html)

Resolve a Link for a local dependency (a - by returning a valid template or b - by sending a http-redirect)

Parameters

string $dependency Name (Refers to YOUR entry in the config.yml)
string $page_id PageID
mixed $cmd CMD Params

Return Value

xelos_global_template or string URL

Return the URL info of the page representing your document

Parameters

int $post_id
int $post_type

Return Value

array xf_link LinkHelper

at line 2463
false|xm_system_dms_xfs_document retrieve_document(int $document_index_id, bool $main_document_index_id = false)

Returns the xfs_document in the storage DMS to a ID.

Parameters

int $document_index_id document index ID
bool $main_document_index_id

Return Value

false|xm_system_dms_xfs_document The system_dms_document

at line 1767
bool send_file(array $args, bool $binary = false, bool $is_full_path = false)

Get the data.

.. $args = array('download','myfile.txt')

Redeclare for binary downloads: function send_file($args, $binary = false) { switch($args[1]) { case 'mybinard.txt': parent::send_file($args,'mybinarycontent'); } }

Parameters

array $args Array of arguments passed via CMD parameter
bool $binary True if data as passed as binary stream instead of filename
bool $is_full_path Set to true if args[1] contains a fill hdd path (not within mod_storage of current module). Caution!

Return Value

bool

at line 550
void set_config(string $var, string $value, string|bool $context = false, string|bool $subcontext = false)

Parameters

string $var var
string $value value
string|bool $context context
string|bool $subcontext subcontext

Return Value

void

at line 568
void set_config_for_session(string $var, string $value, string $context = false, string $subcontext = false)

Parameters

string $var var
string $value value
string $context context
string $subcontext subcontext

Return Value

void

at line 2308
set_context_id(int $context_id)

sets the numerical Context-ID (PrimaryKey in Instance_Registry)

Parameters

int $context_id

Set Dep Link Context - generated URLs will be considered relative to the given parent instance

Parameters

xelos_core $parent
string $view
string $page
string $cmd

at line 381
void set_group(int $group_id, string|bool $short_name = false)

Parameters

int $group_id group id
string|bool $short_name short name

Return Value

void

in ObjectManager at line 125
set_injection_objects(array $objects)

Add given objects to injection object list that will be inject into object by magic call. The array should consists of property name as key and object as value.

Parameters

array $objects

in ObjectManager at line 141
set_lib_class_dir($lib_class_dir)

Sets the directory where classes are stored.

This folder can contains other folder or classes. All requested and registered classes will be searched in this folder by concating this path with the relative path defined in the registration of the requested class. If the class is not included it will be done on the fly.

Parameters

$lib_class_dir

in ObjectManager at line 156
set_lib_class_prefix($lib_class_prefix)

Sets the class name prefix.

An optional possibility to pretend a prefix for all registered classes. This prefix is only required in the class name of the requested object. The registered class name should not contains this prefix. E.g. a class called xf_foobar should be registered as foobar.

Parameters

$lib_class_prefix

at line 223
set_parent_context(Core $obj, mixed $clone_link_helper = true)

Parameters

Core $obj Module Instance
mixed $clone_link_helper ???

at line 399
void set_security_level(int $security_level)

Parameters

int $security_level Please use XF_SEC_LEVEL_NONE, XF_SEC_LEVEL_READ, XF_SEC_LEVEL_WRITE, XF_SEC_LEVEL_DELETE or XF_SEC_LEVEL_ADMIN

Return Value

void

Parameters

$xf_link

Return Value

void

at line 903
setup_check($args = array())

Check/Get Setup Page

Parameters

$args

at line 2481
xm_system_dms_document|false store_file(string $path, string $storage_folder, string|bool $file_name = false, DocumentModel|bool $owner = false, DocumentModel|null $owner_document = null)

Stores the file in the system DMS

Parameters

string $path path to the new file
string $storage_folder virtual folder in the System DMS where the document is stored
string|bool $file_name filename in the System DMS
DocumentModel|bool $owner Owning Document Model: Creates an owner reference for the new document
DocumentModel|null $owner_document Document that owns all stored files by reference and subcategory of system dms

Return Value

xm_system_dms_document|false The new xfs_document in the system DMS

at line 1443
user_has_access($page = false, $instance_id = false, $group_security_id = false)

Parameters

$page
$instance_id
$group_security_id

at line 1467
array user_has_access_in_groups(string $page)

Return the group_security ids the user has access to

Parameters

string $page

Return Value

array

at line 1389
bool user_has_policy(string $policy, mixed $policy_value = '*', int|bool $target_user = false, int|bool $group_id = false, string $default_policy = 'deny')

Parameters

string $policy Policy (e.g. read, write, delete)
mixed $policy_value Dynamic Value to check (e.g. category_id, thread_id, item_id) or * for static
int|bool $target_user of targetuser for privacy
int|bool $group_id local group_id if known
string $default_policy policy 'allow' or 'deny'

Return Value

bool success

at line 1408
array user_has_policy_in_groups(string $policy, string $policy_value = false)

Return the group_security ids the user has the policy in

Parameters

string $policy
string $policy_value

Return Value

array

at line 1421
array user_has_policy_values(string $policy, string $treeTable = null)

User has policy values

Parameters

string $policy
string $treeTable Tablename for Tree Policies

Return Value

array

in ObjectManager at line 103
xelos_object_manager_init(bool $lib_class_dir, string $lib_class_prefix = '', string $ns_prefix = '')

trait constructor This method have to be called from constructor of each class that uses this trait.

It sets the defaults and all necessary properties.

Parameters

bool $lib_class_dir
string $lib_class_prefix e.g. 'xf_'
string $ns_prefix e.g. "XELOS\Framework\Lib\"