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.
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.
1). Windows 8 has been tested and has reported no known errors so far
2). 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.
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.
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.
- 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 “Settings” in the top toolbar of this window you are presented with the following options.
- Launch Frog
- Log out
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).
These can be changed in the same screenshot shown above. 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.
Launch Frog on Start -- If enabled, Frog Live will launch Frog in your default browser when started.
Start Minimised – If enabled, when Frog Live is started, it will start minimised but will be present in your taskbar icons.
Automatically Login to Frog Live -- 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 option is clicked, the Frog Live program will completely close and Log out
How to edit files using Frog Live
Once you are successfully logged into Frog Live you will see two tabs, one for Recent files and the other for settings
- 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.
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.
This tab will show the same settings as described earlier.
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.