class Paging extends Container

Constants

SYSTEM_TEMPLATE_UI_FOLDER

CONTAINER_LINK_MODE_REPLACE

Link modes. Should the ajax respone replace the original content, or should it be appended/prepended

CONTAINER_LINK_MODE_APPEND

CONTAINER_LINK_MODE_PREPEND

RENDER_MODE_DEFAULT

RENDER_MODE_NUMBERS

RENDER_MODE_LOAD_MORE

RENDER_MODE_LOAD_PREVIOUS

Properties

$xf_link from  UIComponent
$link_id from  UIComponent
array $GPvars from  UIComponent
Controller $mod from  UIComponent
protected array $local_template_marker from  UIComponent
protected bool $_overwrite_param_array from  UIComponent
protected bool|array|ModelCollection $marker_content from  UIComponent
string $mod_object_manager from  UIComponent
protected bool $_orig_marker_content from  UIComponent
protected array $_allowed_params_filter from  UIComponent
string $unique_dom_id from  UIComponent
protected string $uid from  UIComponent
string read-only $_content

When used in template this property will contain the XML/HTML within the XUI Nodes

from  UIComponent
$link from  UIAjaxComponent
protected string $js_class from  UIAjaxComponent
protected array $js_options from  UIAjaxComponent
protected array $css_classes from  UIAjaxComponent
protected array $xui_payload from  UIAjaxComponent
protected array $xuiLinkedContainers from  UIAjaxComponent
protected bool $deferredLoading from  UIAjaxComponent
protected bool $deferredLoadingMessage from  UIAjaxComponent
protected string|callable $content from  Container
protected string $placeholderContent from  Container
$numbers_before_and_after_dots

Methods

__construct($record_count, $records_on_page, $paging_id = false, $record_start = false)

No description

string
__toString()

No description

void
addLinkedContainer(UIAjaxComponent $linkedContainer, $linkMode = self::CONTAINER_LINK_MODE_REPLACE)

No description

add_css_class($css_class)

Adds a custom css class to the root element of this component.

add_dependency(string $dep_name, UIAjaxComponent $dep_obj, bool $reloadOnUpdate = false)

Add an UIAjaxComponent object and register it under a certain name.

add_url_parameter(mixed $key, mixed $value)

Adds a parameter to url parameter list.

debug()

No description

enable_periodical_update(int $interval)

Enables the periodical update via ajax.

mixed
get($var)

Get Variable / Option

false|mixed
getCurrentAjaxLink(array $params)

No description

int
getCurrentOffset()

Calculates and returns the current offset value usable by $modelCollection->limit()

getLoadPrevious()

No description

string
mixed
get_dependency($dep_name)

Returns a dependent object in order to interact with it

int
get_first_record_of_page()

No description

int
get_last_record_of_page()

No description

int
get_number_of_current_page()

No description

int
get_page_count()

No description

int
get_records_per_page()

No description

string
get_unique_dom_id()

Generates a unique dom id, dependent on the provided UID, as well as the current context.

Template|null
get_view(string|bool $section = false)

Return new template view If using within module xui the tpl file should be named [class_name].tpl e.g. xui_core_table.tpl within the module's template folder

init()

put your comment there.

bool
isInLoadMoreMode()

Returns true, if the pagination is in load more / load previous mode.

is_first_page()

No description

is_last_page()

No description

string
parse_template(string $template_content, array|bool $marker_array = false)

No description

string|null
parse_template_cb_wrapper(mixed $matches)

No description

mixed|string
parse_xtag($xml_source)

No description

mixed
prepare_query(string $query)

No description

false|string
printAjaxLink(array $params)

No description

false|mixed
printCurrentAjaxLink(array $params)

No description

process()

No description

process_xui()

Optional processing method.

render()

Default render method. wraps the content provided by render_xui_content in a unique div and generates a JS object for the GUI

mixed
render_xtag_element()

No description

string|Template
render_xui()

No description

void
reset_marker_content()

restores original content of marker_content

void
set(mixed $var, mixed $value = false) deprecated

Set Variable / Option

setButtonLabelMore(string $buttonLabelMore)

No description

setButtonLabelPrevious(string $buttonLabelPrevious)

No description

void
setDeferredLoading(bool $bool, string $message = '')

Set true to load the content deferred. Displays a placeholder while loading the content. Optional you can pass a message which will replace the default loading message.

setLoadURL(string $url)

No description

setPlaceholderContent(string $placeholderContent)

Setting Placeholder Content will automatically enable deferred loading

void
setRenderModeDefault()

No description

void
setRenderModeLoadMore(bool $mobileOnly = false)

Set the render mode to load more.

void
setRenderModeLoadPrevious(bool $mobileOnly = false)

Set the render mode to load previous.

void
setRenderModeNumbers()

No description

setSmallButtonSize(bool $useSmallButton = true)

No description

void
setTargetContainer(UIAjaxComponent $targetContainer)

UIAjaxComponent where the pagination ajax request will refresh the contents.

void
set_array(mixed $member_array, mixed $vars)

Set Variable / Option for an array

set_content(string|callable $content)

No description

set_default_page($page)

No description

set_link_params($params)

No description

void
set_marker_content(mixed $marker_content = false)

sets marker_content to passed data -> restore original content with reset_marker_content()

set_mod(mixed $mod)

Set link to owning module

set_option(string $key, mixed $val)

Sets options. This options will be used in the JS element of this XUI class.

set_params($record_count, $records_on_page, $paging_id = false, $record_start = false)

No description

set_render_mode($mode)

No description

void
set_render_params(mixed $input_params = array())

Used to inject params. Only allowed params will be used (see $allowed_params_filter)

set_uid($uid)

No description

set_url_parameters(array $parameters)

Sets the url parameter that is used for component loading.

Details

at line 127
__construct($record_count, $records_on_page, $paging_id = false, $record_start = false)

No description

Parameters

$record_count
$records_on_page
$paging_id
$record_start

in UIComponent at line 328
string __toString()

No description

Return Value

string

at line 366
void addLinkedContainer(UIAjaxComponent $linkedContainer, $linkMode = self::CONTAINER_LINK_MODE_REPLACE)

No description

Parameters

UIAjaxComponent $linkedContainer
$linkMode

Return Value

void

in UIAjaxComponent at line 196
add_css_class($css_class)

Adds a custom css class to the root element of this component.

Parameters

$css_class

in UIAjaxComponent at line 134
add_dependency(string $dep_name, UIAjaxComponent $dep_obj, bool $reloadOnUpdate = false)

Add an UIAjaxComponent object and register it under a certain name.

this component will use that name to retrieve the object in order to interact with it.

If reloadOnUpdate is set, the dependent container will be reloaded after the update of the current container. !Beware: The reload url of the dependency container will be the one set in its data attribute and not a possible "new url" used to update the current container. If you want to reload multiple containers at once when the current container is an ajax link target, use $this->addLinkedContainer()

Parameters

string $dep_name
UIAjaxComponent $dep_obj
bool $reloadOnUpdate

Set true to reload dependency if this component is updated.

in UIAjaxComponent at line 94
add_url_parameter(mixed $key, mixed $value)

Adds a parameter to url parameter list.

Parameters

mixed $key
mixed $value

at line 703
debug()

No description

in UIAjaxComponent at line 218
enable_periodical_update(int $interval)

Enables the periodical update via ajax.

The ajax calls will be execute after an interval of seconds passed by parameter one.

Parameters

int $interval

in UIComponent at line 187
mixed get($var)

Get Variable / Option

Parameters

$var

Return Value

mixed

No description

Parameters

array $params

Return Value

false|mixed

at line 380
int getCurrentOffset()

Calculates and returns the current offset value usable by $modelCollection->limit()

Return Value

int

The current offset value

in UIAjaxComponent at line 255
XUILinkHelper getLinkHelper()

No description

Return Value

XUILinkHelper

at line 694
Paging getLoadPrevious()

No description

Return Value

Paging

in Container at line 54
protected string getPlaceholderContent()

Place

Return Value

string

in UIAjaxComponent at line 150
mixed get_dependency($dep_name)

Returns a dependent object in order to interact with it

Parameters

$dep_name

Return Value

mixed

at line 250
int get_first_record_of_page()

No description

Return Value

int

first record displayed

at line 242
int get_last_record_of_page()

No description

Return Value

int

last record displayed

at line 270
int get_number_of_current_page()

No description

Return Value

int

current page

at line 260
int get_page_count()

No description

Return Value

int

total count of pages

at line 234
int get_records_per_page()

No description

Return Value

int

numer of records on a page

in UIComponent at line 204
string get_unique_dom_id()

Generates a unique dom id, dependent on the provided UID, as well as the current context.

Return Value

string

in UIComponent at line 294
Template|null get_view(string|bool $section = false)

Return new template view If using within module xui the tpl file should be named [class_name].tpl e.g. xui_core_table.tpl within the module's template folder

Parameters

string|bool $section Name

Return Value

Template|null

Exceptions

Exception

in UIComponent at line 72
init()

put your comment there.

..

at line 341
bool isInLoadMoreMode()

Returns true, if the pagination is in load more / load previous mode.

Only meaningful after $this->process() call.

Return Value

bool

at line 282
is_first_page()

No description

at line 286
is_last_page()

No description

in UIComponent at line 223
string parse_template(string $template_content, array|bool $marker_array = false)

No description

Parameters

string $template_content

HTML Template

array|bool $marker_array

Markers and Values

Return Value

string

Parsed HTML Content

in UIComponent at line 239
string|null parse_template_cb_wrapper(mixed $matches)

No description

Parameters

mixed $matches

Return Value

string|null

in UIComponent at line 265
mixed|string parse_xtag($xml_source)

No description

Parameters

$xml_source

Return Value

mixed|string

Exceptions

ContentException

at line 462
mixed prepare_query(string $query)

No description

Parameters

string $query

SQL Query to parse, e.g. SELECT * FROM ###tbl|user### ###limit###

Return Value

mixed

No description

Parameters

array $params

Return Value

false|string

No description

Parameters

array $params

Return Value

false|mixed

at line 156
process()

No description

in UIAjaxComponent at line 76
protected process_xui()

Optional processing method.

This method is called when invoke the process method or automatically before the render method is called.

in UIAjaxComponent at line 281
render()

Default render method. wraps the content provided by render_xui_content in a unique div and generates a JS object for the GUI

Exceptions

Exception

in UIComponent at line 273
mixed render_xtag_element()

No description

Return Value

mixed

at line 470
string|Template render_xui()

No description

Return Value

string|Template

in UIComponent at line 175
void reset_marker_content()

restores original content of marker_content

Return Value

void

in UIComponent at line 108
void set(mixed $var, mixed $value = false) deprecated

deprecated - It is preferred to have explicit setters/getters. Please check if you can rewrite usage to use explicit setters with documented options

Set Variable / Option

Parameters

mixed $var

Name of Variable to Set (Alternative: Assoc-Array for multiple variables)

mixed $value

Value of Variable

Return Value

void

at line 88
Paging setButtonLabelMore(string $buttonLabelMore)

No description

Parameters

string $buttonLabelMore

Return Value

Paging

at line 98
Paging setButtonLabelPrevious(string $buttonLabelPrevious)

No description

Parameters

string $buttonLabelPrevious

Return Value

Paging

in UIAjaxComponent at line 115
void setDeferredLoading(bool $bool, string $message = '')

Set true to load the content deferred. Displays a placeholder while loading the content. Optional you can pass a message which will replace the default loading message.

Parameters

bool $bool
string $message

Return Value

void

in UIAjaxComponent at line 102
UIAjaxComponent setLoadURL(string $url)

No description

Parameters

string $url

Return Value

UIAjaxComponent

in Container at line 44
Container setPlaceholderContent(string $placeholderContent)

Setting Placeholder Content will automatically enable deferred loading

Parameters

string $placeholderContent

Return Value

Container

at line 328
void setRenderModeDefault()

No description

Return Value

void

at line 312
void setRenderModeLoadMore(bool $mobileOnly = false)

Set the render mode to load more.

Requires a target XUI component via ->setTargetContainer()

Parameters

bool $mobileOnly

Only use load more in mobile mode?

Return Value

void

at line 323
void setRenderModeLoadPrevious(bool $mobileOnly = false)

Set the render mode to load previous.

Requires a target XUI component via ->setTargetContainer()

Parameters

bool $mobileOnly

Only use load more in mobile mode?

Return Value

void

at line 332
void setRenderModeNumbers()

No description

Return Value

void

at line 108
Paging setSmallButtonSize(bool $useSmallButton = true)

No description

Parameters

bool $useSmallButton

Return Value

Paging

at line 359
void setTargetContainer(UIAjaxComponent $targetContainer)

UIAjaxComponent where the pagination ajax request will refresh the contents.

Parameters

UIAjaxComponent $targetContainer

Return Value

void

in UIComponent at line 124
void set_array(mixed $member_array, mixed $vars)

Set Variable / Option for an array

Parameters

mixed $member_array

Name of Variable to Set (Alternative: Assoc-Array for multiple variables)

mixed $vars

Value of Variable

Return Value

void

in Container at line 23
set_content(string|callable $content)

No description

Parameters

string|callable $content

at line 278
set_default_page($page)

No description

Parameters

$page

No description

Parameters

$params

in UIComponent at line 167
void set_marker_content(mixed $marker_content = false)

sets marker_content to passed data -> restore original content with reset_marker_content()

Parameters

mixed $marker_content

Return Value

void

in UIComponent at line 90
set_mod(mixed $mod)

Set link to owning module

Parameters

mixed $mod

in UIAjaxComponent at line 207
set_option(string $key, mixed $val)

Sets options. This options will be used in the JS element of this XUI class.

Parameters

string $key

update_interval (int) | hide_loading (bool)

mixed $val

at line 140
set_params($record_count, $records_on_page, $paging_id = false, $record_start = false)

No description

Parameters

$record_count
$records_on_page
$paging_id
$record_start

at line 302
set_render_mode($mode)

No description

Parameters

$mode

in UIComponent at line 137
void set_render_params(mixed $input_params = array())

Used to inject params. Only allowed params will be used (see $allowed_params_filter)

Parameters

mixed $input_params

Return Value

void

at line 294
set_uid($uid)

No description

Parameters

$uid

in UIAjaxComponent at line 83
UIAjaxComponent set_url_parameters(array $parameters)

Sets the url parameter that is used for component loading.

Parameters

array $parameters

Return Value

UIAjaxComponent