Howto16r1:Create Apps for websites to open in a new window

From innovaphone wiki
Jump to navigation Jump to search

Applies to

  • firmware version V16 and higher
  • it might work also with older Verions but it is not tested!

More Information

Create apps for (external) websites to be opened in a new browser tab (Browser version of myApps) or to be opened in a new docked out myApps window (Native myApps Client). To make this possible you are going to host a html file in a shared folder from the Files App. This html file will be accessed and will open the required Website URL that has been passed with this URL in a new window.

Configuration

html file to download

[redirect_kpe.zip]

Create a Shared Folder in Files App

In case you need a detailed example howto create a shared folder, check this wiki: Files_App_example

  1. Open the Files App, click on the add folder symbol on the upper right and create a new folder with the name html
  2. Click on the Mark button on the upper right and make sure only the new html folder is ticked
  3. Click on the right arrow button on the right and share this folder with the fileskey access,
  4. Select share as link with filekey and leave all other fileds empty. Then click on Share
  5. Open the new folder by clicking on the folder name html-folder
  6. Copy and paste the downloaded html file redirect_kpe.html to the html-folder using drag-and-drop from the Windows-Explorer to the Files App
  7. Copy and paste your optional icon files to the html-folder using drag-and-drop from the Windows-Explorer to the Files App
  8. Finally click on the little i symbol on the upper right. Take note of the link shown and copy it to a text file for later use.
  9. Change the URL in the textfile for your purpose according to this example. The URL contains the destination to the redirect html file, added with the destination URL for the website to be opened and attached the fileskey to allow the acces to this html-folder. Example: "https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html?url=https://yourdestination.com&fileskey=Y0UrS3cr3tK3Y1234 "

Create the App Object

  1. Navigate in PBX-AdvancedUI to PBX/Objects
  2. Choose object type App from left sided drop down and confirm with New
  3. Define app-object-name and app-object-longname and confirm with Apply
  4. switch to tab App
  5. Insert the used URL based on the example above - see also some examples below
  6. Insert optional the icon URL - see how to create an icon in the section below
  7. tick plain website
  8. confirm with OK

Create an App Icon (Optional)

  • Search and download respective logo or create it with a screenshot tool. Observe any copyrights and rights of use.
  • Max. size of 100x100 px is sufficent. If not available in that size, shrink down by use of any common image editor
  • Choose any appropriate Base 64 image encoder, upload the adapted logo and copy the resulting hex dump
  • paste the hex dump content including leading data:image/png;base64,into field Icon (URL)
  • pay attention to the max supported size of 3072 characters. Shrink down your source image if necessary.
  • exampl of the icon URL: https://yourAP-DNSname.com/yoursystemname.com/files/UI/html/youriconfilename.png&fileskey=Y0UrS3cr3tK3Y1234

Grant access to users

Tick respective App-Object-Name in Apps-tab at user object or distributing configuration template object

URL examples

App html URL: https://your.AppDNSname.com/yoursystemname.com/files/UI/html/redirect_kpe.html? (followed by in theory any website URL that you want to use as the destination URL) Some example listed:

  • Here: https://wego.here.com/p/here:cm:namedplace:20171588?map=48.71042,9.00612,13.24
  • Nextcloud: https://nextcloud.com/
  • Karls: https://www.karls.nl

Followed by your Fileskey &fileskey=Y0UrS3cr3tK3Y1234

Web App example on the Community

If you want to see an example of this redirect Web App, go to the Community PBX and go to the All Apps icon in the bottom right corner and add the URL Redirect App to your homescreen.

By opening this App it will open the redirect html file and after a timeout of 3 seconds it will open the innovaphone website about security in a new browser tab.

Known issues

  • No known issues yet,
  • Feel free to add if you find some

Related articles

Retrieved from "https://wiki.innovaphone.com/index.php?title=Howto16r1:Create_Apps_for_websites_to_open_in_a_new_window&oldid=79825"