ImageEdit
class ImageEdit extends UIAjaxComponent
Class ImageEdit
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 |
|
Properties
| Link | $xf_link | from UIComponent | |
| string | $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 |
| XUILinkHelper | $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 |
Methods
UIComponent constructor.
Link a container that will also be reloaded, if an ajax link has the current container as target.
Adds a custom css class to the root element of this component.
Add an UIAjaxComponent object and register it under a certain name.
Adds a parameter to url parameter list.
Enables the periodical update via ajax.
Returns a placeholder which is used to display while this component is loading the content.
Returns a dependent object in order to interact with it
Generates a unique dom id, dependent on the provided UID, as well as the current context.
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
No description
No description
Process XUI
Default render method. wraps the content provided by render_xui_content in a unique div and generates a JS object for the GUI
Actual rendering method - must be implemented by children.
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.
Set Variable / Option for an array
Set the aspect ratio of the crop box.
Enable to crop the image automatically when initialize.
Define the automatic cropping area size (percentage).
Show the grid background of the container.
Enable to move the crop box by dragging.
Enable to resize the crop box by dragging.
Show the center indicator above the crop box.
Check if the current image is a cross-origin image.
Check the current image's Exif Orientation information.
Define the dragging mode of the cropper.
Show the dashed lines above the crop box.
Show the white modal above the crop box (highlight the crop box).
The minimum width and height of the crop box.
The minimum width and height of the canvas (image wrapper).
The minimum width and height of the container.
Show the black modal above the image and under the crop box.
Enable to move the image.
Sets the option values for the cropper JS class.
Re-render the cropper when resize the window.
Restore the cropped area after resize the window.
Enable to rotate the image.
Enable to scale the image.
Enable to toggle drag mode between "crop" and "move" when click twice on the cropper.
Define the view mode of the cropper.
Define zoom ratio when zoom the image by wheeling mouse.
Enable to zoom the image by dragging touch.
Enable to zoom the image by wheeling mouse.
Enable to zoom the image.
Sets the document index of a system dms image file.
Sets the source image file. The target file can be set optionally.
sets marker_content to passed data -> restore original content with reset_marker_content()
Sets options. This options will be used in the JS element of this XUI class.
Used to inject params. Only allowed params will be used (see $allowed_params_filter)
Sets settings for this image edit component.
Sets the url parameter that is used for component loading.
Details
at line 37
__construct(string $link_id = null)
UIComponent constructor.
in
UIComponent at line 328
string
__toString()
No description
in
UIAjaxComponent at line 158
void
addLinkedContainer(UIAjaxComponent $linkedContainer, $linkMode = self::CONTAINER_LINK_MODE_REPLACE)
Link a container that will also be reloaded, if an ajax link has the current container as target.
in
UIAjaxComponent at line 196
add_css_class($css_class)
Adds a custom css class to the root element of this component.
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()
in
UIAjaxComponent at line 94
add_url_parameter(mixed $key, mixed $value)
Adds a parameter to url parameter list.
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.
in
UIComponent at line 187
mixed
get($var)
Get Variable / Option
in
UIAjaxComponent at line 456
false|mixed
getCurrentAjaxLink(array $params)
No description
in
UIAjaxComponent at line 255
XUILinkHelper
getLinkHelper()
No description
in
UIAjaxComponent at line 267
protected string
getPlaceholderContent()
Returns a placeholder which is used to display while this component is loading the content.
in
UIAjaxComponent at line 150
mixed
get_dependency($dep_name)
Returns a dependent object in order to interact with it
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.
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
at line 229
handle_document_creation(string $source_image_path, DocumentIndex $xfs_document_index)
No description
in
UIComponent at line 72
init()
put your comment there.
..
in
UIComponent at line 223
string
parse_template(string $template_content, array|bool $marker_array = false)
No description
in
UIComponent at line 239
string|null
parse_template_cb_wrapper(mixed $matches)
No description
in
UIComponent at line 265
mixed|string
parse_xtag($xml_source)
No description
in
UIAjaxComponent at line 430
false|string
printAjaxLink(array $params)
No description
in
UIAjaxComponent at line 443
false|mixed
printCurrentAjaxLink(array $params)
No description
in
UIAjaxComponent at line 225
process()
dummy process method - may be overwritten
at line 161
process_xui()
Process XUI
Crops the file by crop data and return the result. If the source is a document index then, first a new version will be created before cropping the image.
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
in
UIComponent at line 273
mixed
render_xtag_element()
No description
at line 281
protected string|Template
render_xui()
Actual rendering method - must be implemented by children.
Returns a template or a string containing the HTML of the element's content.
in
UIComponent at line 175
void
reset_marker_content()
restores original content of marker_content
in
UIComponent at line 108
void
set(mixed $var, mixed $value = false)
deprecated
deprecated
Set Variable / Option
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.
in
UIAjaxComponent at line 102
UIAjaxComponent
setLoadURL(string $url)
No description
in
UIComponent at line 124
void
set_array(mixed $member_array, mixed $vars)
Set Variable / Option for an array
at line 408
set_crop_aspect_ratio(float $float)
Set the aspect ratio of the crop box.
By default, the crop box is free ratio.
at line 509
set_crop_auto_crop(bool $bool = true)
Enable to crop the image automatically when initialize.
at line 518
set_crop_auto_crop_area(float $float = 0.8)
Define the automatic cropping area size (percentage).
at line 500
set_crop_background(bool $bool = true)
Show the grid background of the container.
at line 590
set_crop_box_movable(bool $bool = true)
Enable to move the crop box by dragging.
at line 599
set_crop_box_resizable(bool $bool = true)
Enable to resize the crop box by dragging.
at line 482
set_crop_center(bool $bool = true)
Show the center indicator above the crop box.
at line 441
set_crop_check_cross_origin(bool $bool = true)
Check if the current image is a cross-origin image.
If it is, when clone the image, a crossOrigin attribute will be added to the cloned image element and a timestamp will be added to the src attribute to reload the source image to avoid browser cache error. By adding crossOrigin attribute to image will stop adding timestamp to image url, and stop reload of image. If the value of the image's crossOrigin attribute is "use-credentials", then the withCredentials attribute will set to true when read the image data by XMLHttpRequest.
at line 455
set_crop_check_orientation(bool $bool = true)
Check the current image's Exif Orientation information.
More exactly, read the Orientation value for rotating or flipping the image, and then override the Orientation value with 1 (the default value) to avoid some issues (1, 2) on iOS devices. Requires to set both the rotatable and scalable options to true at the same time. Note: Don't trust this all the time as some JPG images have incorrect (not standard) Orientation values. Requires Typed Arrays support (IE 10+).
at line 398
set_crop_drag_mode($mode = 'crop')
Define the dragging mode of the cropper.
at line 473
set_crop_guides(bool $bool = true)
Show the dashed lines above the crop box.
at line 491
set_crop_highlight(bool $bool = true)
Show the white modal above the crop box (highlight the crop box).
at line 641
set_crop_min_box_size(int $width, int $height)
The minimum width and height of the crop box.
Note: This size is relative to the page, not the image.
at line 629
set_crop_min_canvas_size(int $width, int $height)
The minimum width and height of the canvas (image wrapper).
at line 618
set_crop_min_container_size(int $width, int $height)
The minimum width and height of the container.
at line 464
set_crop_modal(bool $bool = true)
Show the black modal above the image and under the crop box.
at line 527
set_crop_moveable(bool $bool = true)
Enable to move the image.
at line 146
set_crop_options(array $options)
Sets the option values for the cropper JS class.
This class uses Cropper.js to provide cropping functionality, so use options of the cropper.js defined of the website.
at line 417
set_crop_responsive(bool $bool = true)
Re-render the cropper when resize the window.
at line 426
set_crop_restore(bool $bool = true)
Restore the cropped area after resize the window.
at line 536
set_crop_rotateable(bool $bool = true)
Enable to rotate the image.
at line 545
set_crop_scalable(bool $bool = true)
Enable to scale the image.
at line 608
set_crop_toggle_drag_mode_on_dblclick(bool $bool = true)
Enable to toggle drag mode between "crop" and "move" when click twice on the cropper.
at line 386
set_crop_view_mode($number = 0)
Define the view mode of the cropper.
at line 581
set_crop_wheel_zoom_ratio(float $float = 0.1)
Define zoom ratio when zoom the image by wheeling mouse.
at line 563
set_crop_zoom_on_touch(bool $bool = true)
Enable to zoom the image by dragging touch.
at line 572
set_crop_zoom_on_wheel(bool $bool = true)
Enable to zoom the image by wheeling mouse.
at line 554
set_crop_zoomable(bool $bool = true)
Enable to zoom the image.
at line 67
set_document_index(int|DocumentIndex $document_index_or_id)
Sets the document index of a system dms image file.
If the param is an id, the document will be resolved by the given id.
at line 51
set_image_paths(string $source_image_path, string|null $target_image_path = null)
Sets the source image file. The target file can be set optionally.
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()
in
UIComponent at line 90
set_mod(mixed $mod)
Set link to owning module
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.
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)
at line 106
set_settings(array $settings)
Sets settings for this image edit component.
Cropper: This class uses Cropper.js to provide cropping functionality, so use options of the cropper.js defined of the website.
in
UIAjaxComponent at line 177
set_uid($uid)
No description
in
UIAjaxComponent at line 83
UIAjaxComponent
set_url_parameters(array $parameters)
Sets the url parameter that is used for component loading.