Add new attachment

Only authorized users are allowed to upload new attachments.

List of attachments

Kind Attachment Name Size Version Date Modified Author Change note
png
Screen Shot 2018-05-21 at 8.31... 95.8 kB 1 29-Dec-2020 05:25 krivacsz custom_button
png
customButton.png 674.3 kB 1 29-Dec-2020 05:25 krivacsz
png
customButton2.png 276.2 kB 1 29-Dec-2020 05:25 krivacsz
png
customButtonFunction.png 45.0 kB 1 29-Dec-2020 05:25 krivacsz
png
customEvent.png 318.3 kB 1 29-Dec-2020 05:25 krivacsz
png
customEvent2.png 263.2 kB 1 29-Dec-2020 05:25 krivacsz
png
custom_button.png 95.8 kB 1 29-Dec-2020 05:25 krivacsz
png
event_con.png 130.8 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_crushtask2.png 150.2 kB 1 29-Dec-2020 05:25 Ada Csaba
jpg
event_email.jpg 141.8 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_email.png 78.6 kB 2 29-Dec-2020 05:25 Ben Spink
jpg
event_email2.jpg 141.8 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_email2.png 419.4 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_email3.png 214.5 kB 4 29-Dec-2020 05:25 Ada Csaba
png
event_plugin.png 95.6 kB 2 29-Dec-2020 05:25 Ben Spink
png
event_tmng.png 73.1 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_trig.png 223.2 kB 1 29-Dec-2020 05:25 Ada Csaba
png
event_uploadlink.png 106.1 kB 1 29-Dec-2020 05:25 Halmágyi Árpád
jpg
events_action.jpg 141.4 kB 1 12-Aug-2021 16:27 Ada Csaba
jpg
events_generic.jpg 285.9 kB 1 12-Aug-2021 16:27 Ada Csaba
jpg
events_pluginlist.jpg 307.9 kB 2 12-Aug-2021 16:48 Ada Csaba

This page (revision-64) was last changed on 12-Aug-2021 16:49 by Ada Csaba

This page was created on 29-Dec-2020 05:25 by Ben Spink

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 changed one line
Events let you to trigger an event as custom way for example by a custom button placed in the Menu Bar or as Context Manu.
User __Events__ are automation tasks triggered by various user activities, like login, upload or an error condition that may occur. These also allow calling user calling authentication integration or two factor authentication plugins, etc.
\\
[{Image src='events_generic.jpg' width='1440' height='..' align='left' style='..' class='..' }]
\\
!!Action:
Choose the type of action the event should do when triggered.
\\
[{Image src='events_action.jpg' width='1440' height='..' align='left' style='..' class='..' }]
\\
!1. Send Email, simple email notification Events
At line 3 changed one line
1. Create a custom button under UserManager, UserName (default for all users), in the QuickJump select Webinterface, scroll down a little and at the Buttons section click on 'Add':
\\
This type of Event allows sending simple template based email messages, triggered by regular user activity. Various prebuilt templates
available to select from the __Variables/Templates__ dropdown menu.
\\
!2. Run Plugin, to execute various plugins
\\
This type of Event allows running a local , per user or global, server wide configured ''__[CrushTask]__'' plugin based task flow or ''__[Jobs]__'' . It also allows triggering the ''__[HomeDirectory]__'' plugin to automatically create user home folders at login time.
\\
[{Image src='events_pluginlist.jpg' width='1440' height='..' align='left' style='..' class='..' }]
\\
!3. Send reverse notifications
\\
On this we have a separate wiki, see [ReverseEvents]
\\
!!! Trigger hooks
\\
Events can be triggered by activity of a normal user or a share account (temp account) , depending if one (or a combination of) option(s) are set in either the __When this user__ or __When a Share this user creates has this activity__ section. If the former option is
chosen, the Event still needs to be set up on the share creator (master) user account. The hooks themselves can be grouped as:
\\
!! Regular user activity related
\\
This if any of the eponymous __Uploads__, __Creates Folder__, __Deletes__, __Renames__ or __Downloads__ option is set. Can fire an event on user login, if the __Connects__ option is set, or on some user issue, if the __Has an error__ option is used. If an automation task is
to be triggered when a user creates a temp account using our ''__[Sharing]__'' feature, then the __Shares__ option is needed.
\\
\\
At line 5 changed one line
[attachments|customButton2.png]
%%tabbedSection
%%tab-Hooks
[attachments|event_trig.png]
/%
%%tab-Conditions
[attachments|event_con.png]
/%
%%tab-Timing
[attachments|event_tmng.png]
/%
/%
At line 7 changed 4 lines
Add the following javascript function for this button:
[attachments|customButtonFunction.png]\\
\\
\\
!! Special hooks
\\
These allow triggering more advanced Events for specific use cases
\\
\\
!. Pre-Download
\\
This option allows a user to trigger an automation task on server side, before downloading a file, to run a virus scanner or ''__[Zip|Pre-Download]__'' the file, for example.
\\
!. Accepts disclaimer
\\
Users can be configured with ''__[custom web forms|WebInterfacePrefs]__'' that are displayed after login, this hook is called when the user presses the OK button on the form. If the form allows custom user data input, the data entered into the form can be referenced by server variables, in the event task flow. An interesting use case, to allow ''__[Self Registration|Self Registration]__'' for new users.
\\
!. Issues site command
\\
FTP-only, a rarely used feature, to fire an Event when the FTP client issues one of our supported SITE commands.
\\
!. Custom
\\
For some very specific use. The account can be configured with a ''__[Custom|CustomEvent]__'' webinterface button with some special javascript code snippet. When a user presses the button, or issues the __SITE PLUGIN__ FTP command (this is specific to CrushFTP Server only), this
hook is called. Such a use case, WebDAV-style ''__[File Locking|Locked]__'' from the WebInterface.
\\
!. Problem
\\
Another, for specific use. The account can be configured with a __Report a Problem__ webinterface button . When the user presses the button, a small input window is presented where the user can input it's complaints, then this hook is called. If the Event runs access
CrushTask plugin, these additional variables can be used :
\\
At line 12 changed one line
javascript:customEvent({paths:"{files}"});
{path} and {selected_item} to reference the file/folder name in cause
{browser}, {resolution}, {window_size}, {browser_version}, {host}, {local_time}, {local_time_formatted}, {timezone_offset} to reference various client side info
{message} to reference the user form input
{test_results} to reference the state of user action, success or failure
At line 14 changed 9 lines
2. Create the custom event. Under UserManager, UserName (default for all users), in the QuickJump select Webinterface, scroll down a little and at the Buttons section click on 'Add Event'. As User action check the 'custom' and check the 'Do event immediately' flag, set a task/job/plugin. That will be executed when the custom button is hit.
[attachments|customEvent.png]
in an __Email__ task item's email body section, for example.
\\
\\
!!! Trigger conditions
\\
To filter user action committed globally, or just on some subfolder path inside the user working directory itself, __Always do the event__ or __Only if they__ and choose one of the Upload in any directory, Download from any directory, Upload in below directory, etc. option from the dropdown menu. Carefully, for not all combinations of hooks and conditions make sense (like an Event on Upload won't fire if the condition is set to Download from below directory ).
\\
!!! Timing
\\
Events can fire instantaneously, as the user action completes, if the __Do event immediately__ option is chosen, one separate Event instance (thread) for each file/folder the user committed on. For a single Event that would process rather the full list of user altered files/folders, will have to choose one of the options from the __Do event after user__ dropdown list. If the Event sends an email notification by CrushTask's Email task item, a specific variable syntax is required in the email body, to get the full list, like
\\
{{{
{line_start}{name}{r}{n}{line_end}
}}}
for example, to get the full file names list. Otherwise, the task will only process the last item.
\\
!!! Asynchronous events
\\
Events can run in sync with the user upload/download thread, or completely independent, on separate threads, based on the state of the __Run Event Asynchronously__ flag. If is set to __Yes__ , each Event will run independently. On the other hand, __No__ will queue the Events for same user session. If the flag is set __Auto__, the global option from __Preferences->Misc page__ takes effect.
\\
Version Date Modified Size Author Changes ... Change note
64 12-Aug-2021 16:49 6.051 kB Ada Csaba to previous
63 12-Aug-2021 16:48 6.051 kB Ada Csaba to previous | to last
62 12-Aug-2021 16:44 6.051 kB Ada Csaba to previous | to last
61 12-Aug-2021 16:42 5.99 kB Ada Csaba to previous | to last
« This page (revision-64) was last changed on 12-Aug-2021 16:49 by Ada Csaba
G’day (anonymous guest)
CrushFTP10 | What's New
JSPWiki