Frog Live is a Windows application that installs directly onto your PC to allow easy editing of documents and files stored on the Frog Server. FrogLive is designed to work with Frog 3, it will not function with FrogLearn. When you click to edit a file stored in a Web Files folder on the Frog Server, FrogLive automatically downloads the file to your PC, and then opens it using its default application. FrogLive will then continue to monitor the files you've downloaded, and will automatically upload the file to the Frog Server every time you save the file.
Another feature of FrogLive is that it can be used to launch Frog automatically in your default browser and log you in automatically. You only have to enter your username and password once into FrogLive and can then choose to save the credentials. The system can also launch Frog with the user logged in as soon as the user logs into their Windows account.
|IMPORTANT Please note that the latest version of Frog Live will not work on a https connection. Users must connect to the Frog server on port 80 over http. If you are concerned or have any questions about your current set up please contact Frog Technical Support on 01422 395939 or by email at firstname.lastname@example.org.|
Minimum System Requirements
- OS: Windows XP, Windows 7 - Please note this version is currently not supported on Windows 8
- .NET Framework 4
Frog 3 Roles Required:
There are several Frog 3 roles required in order for this new version of Frog Live to work for any Login Profiles you wish to use Frog Live:
- Use The Webfiles.file.getinfo Method
- Use The Webfiles.folder.getcontents Method
- Use The Webfiles.folder.getinfo Method
- Use The Webfiles.file.download Method
- Use The Webfiles.file.update Method
If these roles are not enabled, Frog Live should prompt you that they need to be enabled after you login however it's always worth checking prior to installing for the first time.
As this version of Frog Live v3 is in beta testing, please be aware there are some issues that we are aware of and will be investigated prior to full rollout.
1). Frog Live v3 does not support connections over https
2). Windows 8 is currently not supported
3). When a server name is specified, this cannot be overwritten if incorrect and requires re-installation of the software.
4). There is currently no way (such as an MSI answer or tranform file) to specify the server name. Software packing such as PRISM or Winstall LE will hold the address, should it be specified when installed as part of the packaging process.
5). There is an issue with picking up the 'Logged in Users' permission. If this is set to 'Deny' on a folder, contents will not be able to be accessed via Frog Live, regardless of any other permissions stating that they can. For example: If a folder has the following: Everyone (Deny), Logged in Users (Deny), Staff (Read Only) then Frog Live cannot access the content. In this situation, it is necessary as a workaround to set Logged in Users to (Read Only) and explicitly state the other login profiles as Deny. For example: Everyone (Deny), Logged in Users (Read Only), Staff (Read Only), Students (Deny), Parents (Deny) would allow access to the content via FrogLive for staff.
Installing Frog Live
- To install, double click the installer package to be presented with the installation window.
- Click next to continue this process. You can then specify (if desired) the location of where you wish to install this program. If you wish to do this, click “Browse” and select the desired path.
- Click “Next” when you are happy with the installation directory.
- You will then be informed this program is ready to install, click the “Install” button to begin this process.
- You will then be able to view the progress bar and status of the installation.
- Depending on your machine and the settings you have applied, User Account Control within Windows (if enabled) will prompt you, asking if you wish to make changes to this computer. Click “Yes” to continue the installation.
- You will be returned to the installation window where the progress bar will start to fill. During the installation as the progress bar fills, you will be prompted with the following Frog Live popup.
- You will need to enter your servers URL into this box including http:// If you enter an address into this box and miss the above prefix, you will receive the following message and will need to re-enter the address correctly.
- Next you will be informed that the installation has been completed. Click Finish to close this window.
How to login using Frog Live
- To open Frog Live, navigate to the .exe shortcut to launch the program. Typically (depending on your operating system) this can be found when you click on Start --> All Programs --> Frog --> Frog Live then double click the Frog Live icon.
- You will be presented with the following Frog Live window.
- Next, click on “User” then “Login from the dropdown.
- A new window will open in your internet browser, asking you to authorise access to your Frog server. Enter your username and password to your Frog server then click connect.
- Providing you have entered correct login details, the authentication window will close and the Frog Live window will begin loading the files in your personal files area. This can take some time depending on how many files you have in their e-portfolio area. You can also see in the top bar of this window that it states your username.
Frog Live Settings
If you click “App” in the top toolbar of this window you are presented with the following options.
- Launch Frog
When this is clicked, a new window will open in your default browser that will take you to your Frog server. The page shown will be that which is set under “Page shown after login” in the Login Profile settings (unless specified otherwise for a specific user).
When this is clicked you will receive a small popup window with the title “Settings”. The settings available reflect some of the settings that have been chosen in the toolkit for your Login Profile. This information is covered in more detail further on in this guide.
Start when windows starts – If enabled, Frog Live will start when your Windows machine is started. Open Frog at startup -- If enabled, Frog Live will launch Frog in your default browser when started. Allow Close – If enabled, it will allow users to close Frog Live completely. Start Minimised – If enabled, when Frog Live is started, it will start minimised but will be present in your taskbar icons. Show information notifications – If enabled, additional notifications are displayed when actioning files, in the bottom right area of your taskbar. Allow Logout -- If enabled, it will allow users to be able to use the logout feature within Frog Live. Auto Login -- If enabled, users will be automatically logged in upon launching Frog Live. This user will need to have logged in previously for this to occur.
When this options is clicked, Frog Live will minimise itself to the taskbar but will continue running. To show the program again you will need to double left click the small taskbar icon to reveal the FrogLive window.
When this option is clicked, the Frog Live program will completely close.
Under the user tab there are three options to choose from, these are:
When this is clicked you will receive a small popup window with the title “User Details”. These are simply the details for the user you are logged in as.
When this is clicked you will receive a small popup window with the title “Connection Details”. These are simply the details for the Frog server you are logged in to.
When this option is clicked you will be prompted with the following.
Clicking no will return you to Frog Live but clicking yes will log you out of Frog Live but the program will remain open.
Upon clicking “Help” from the Frog Live window you are then able to click “About” to open up a popup window containing information regarding Frog Live.
The information displayed includes the version of Frog Live that you currently have installed on your machine along with a list of some of the changes made from previous versions of this program.
How to edit files using Frog Live
Once you are successfully logged into Frog Live you will see two fairly central tabs labelled:
- Recent Files
Recent Files displays a list of the recent files you have opened through Frog Live.
You can double click one of these files to open it through Frog Live. When doing so, you will be prompted with the following popup, asking if you want to allow this website to open a program on your computer. If you do not wish to be prompted for every file you try to open through Frog, deselect the checkbox “Always ask before opening this type of address” then click Allow.
If you click Allow, this document will be opened through Frog Live and will open in your default program set on your machine for this file type.
You will then be able to make changes to this file and click save. This file will then be uploaded through Frog Live and back into Frog. Providing you have the setting “Show Information Notifications” enabled then you will see the following similar notification appear in your taskbar.
You could also decide to open and edit this file through Frog 3. To do this, simply navigate to the desired location in your e-portfolio area and double click the file to open it. It is possible to download files from other locations other than your e-portfolio. This is done by simply navigating to the desired location through a web files component and opening the file.
Please note: The download button in Frog will still function but not open the document through Frog Live. When using a web files component you will need to use the "Open" function to open your documents through Frog Live.
The file will then open in your default program for this file type. You can then make any desired changes and click “save” to upload this back to Frog. This file will then be displayed in the “recent files” tab of Frog Live.
When the desired file has been downloaded to your local machine it will be stored in a similar path to below: C:\Users\edward.clementson\AppData\Local\Temp\Frog\152501.docx It is stored here so it can be uploaded easily back into Frog 3 via your browser. The file name is the ID of the file that is present on Frog. When you hit save, the file name will not change within Frog to this file ID.
On this tab, you are able to browse through your files in your personal e-portfolio area. It is not possible to navigate away from your personal files area but you are able to search through all folders in this location.
You are able to double click a file and your computer will attempt to open this in your default editing program for this file type. When you open a file using this method, Frog Live will swap you to the “Recent Files” tab and you will see the newly opened file in this location.
Additional Toolkit Settings
There are additional setting located in your Frog 3 toolkit that allow administrators to select which options can be applied within Frog Live for certain users. Firstly, login to your toolkit and navigate to Admin --> Login Profiles.
Double left click a login profile from the list of existing profiles on your platform. This will open up a settings popup window. From here, click the “Frog Live” tab to view these settings.
In here are a variety of settings relating to different features and interactions between Frog 3 and Frog Live. The above screenshot displays some of the options but the full list can be viewed below. The Frog Live settings that have “(deprecated)” beside them will not work with this new version of Frog Live.
- Allow User Control: Automatic Log In – If enabled it allows a user to be able to choose whether Frog Live automatically tries to log them in.
- Allow User Control: Close – If enabled it allows users to be able to close Frog Live.
- Allow User Control: Launch Frog On Log In – If enabled it allows a user to be able to choose whether Frog is launched automatically when the users logs into Frog Live.
- Allow User Control: Logout – If enabled it allows users to be able to close Frog Live.
- Allow User Control: Remember Me (Deprecated) – This setting relates to the old version of Frog Live only. This is currently under review for the new version of Frog Live but we hope for this to be available in a future update.
- Allow User Control: Remember Password (Deprecated) – This setting relates to the old version of Frog Live only. This is currently under review for the new version of Frog Live but we hope for this to be available in a future update.
- Allow User Control: Secure Connection – At the time of writing this, there is no option for this within Frog Live.
- Allow User Control: Start Minimized -- If enabled it allows a user to be able to choose whether Frog Live starts minimised to your taskbar.
- Default Setting: Automatic Log In – This setting, when enabled, automatically logs in users where possible into Frog Live.
- Default Setting: Launch Frog on Log In -- This setting, when enabled, automatically launches Frog when users login to Frog Live.
- Default Setting: Remember (Deprecated) -- This setting relates to the old version of Frog Live only. This is currently under review for the new version of Frog Live but we hope for this to be available in a future update.
- Default Setting: Remember Password (Deprecated) – This setting relates to the old version of Frog Live only. This is currently under review for the new version of Frog Live but we hope for this to be available in a future update.
- Default Setting: Secure Connection (if available) -- At the time of writing this, there is no option for this within Frog Live.
- Default Setting: Start Minimized – This setting, when enabled, automatically starts Frog Live minimised to your taskbar.