Custom file actions


You can easily add custom options inside the "Open with.." file contextual menu. Here is a step by step guide:

  1. Make a copy of "/path-to-WebFileShare/customizables/custom_actions/_example" inside the same folder and rename it to "my-action" (you are free to name the folder as you wish). (Writing an underscore in front of the folder's name disables the option.)
  2. Open the file "my-action/app.php" in a PHP editor:

Define the text that will be displayed for the contextual menu option:

$this->JSconfig['title']

Define the URL of the contextual menu option's icon:

$this->JSconfig['icon']

Make the option open a popup window with the specified size.

$this->JSconfig['popup'] = array(

 "width" => 840,

 "height" => 570

);

When using a popup window, the output of the method "custom_my-action::run()" will be displayed inside the popup. The "$this->data" array can be used to find the file's path:

function run() {

 echo $this->data['filePath'];

}

If you wish to execute a JavaScript function (perhaps making an Ajax call) instead of opening a popup, use this instead:

$this->JSconfig['fn'] = "alert('Option clicked!')";

Add the following option to display the contextual option only for certain filetypes:

 $this->JSconfig['extensions'] => array("txt", "pdf", "doc");

Allow only users with download permissions to see and use this plugin:

 $this->JSconfig['requiredUserPerms'] => array("download");


Misc custom actions:

 



Article ID: 581
Created On: Wed, Mar 5, 2014 at 3:30 AM
Last Updated On: Wed, Nov 22, 2017 at 9:19 AM
Authored by: KB Admin01 [[email protected]]

Online URL: https://kb.quikbox.com/article.php?id=581