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:
  • Rename the class to "custom_my-action". (Note that this depends on the folder's name.)
  • Edit the code according to your requirements:

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:

  • View Office files with Microsoft Office Web Viewer (download)
  • View PDFs and annotate with Crocodoc.com (download)
  • View documents online with Vuzit.com (download)

 

Attached Files
There are no attachments for this article.
Comments
There are no comments for this article. Be the first to post a comment.
Name
Email
Security Code Security Code
Related Articles RSS Feed
Forcing certain file types to download
Viewed 2706 times since Thu, Mar 6, 2014
Running custom scripts when users perform various actions
Viewed 3316 times since Thu, Mar 6, 2014
The API
Viewed 4295 times since Wed, Nov 22, 2017
External Login Form
Viewed 3929 times since Wed, Nov 22, 2017
Hiding options from the "Open with..." menu
Viewed 2263 times since Thu, Mar 6, 2014
File reference
Viewed 2449 times since Tue, Jun 10, 2014
Custom CSS
Viewed 1941 times since Wed, Nov 22, 2017
Translating Web File Share
Viewed 20062 times since Wed, Mar 5, 2014
Adding links to the menu
Viewed 2498 times since Thu, Mar 6, 2014
Custom "Open with" actions
Viewed 2129 times since Wed, Nov 22, 2017
MENU