Knowledgebase : 1) FrogLearn > Widgets
   

Action Button Widget:

This is mainly used as a button that can be clicked (Only users with “Contribute’ or “Edit and Manage” rights will be able to see and click the button)

Link actions are available to set the button to duplicate a page, copy page content and  site access

Duplicate a page: It takes a copy of the selected page and adds it to the end of the current site menu 

Copy page content: It takes a copy of the contents from the selected page and adds it to the current page 

Site access: will grant the logged in user access to the selected site 

Each link action has its own advanced setting options 

Assignment Calendar:

The Assignment Calendar widget shows homework but in a traditional calendar view.

It is designed it based on schools requests to help students understand when their homework was due. 

Here you can view calendar using a personalised view which can be changed by going into edit mode. Using this view you can double click on the assignment to view the assignment.

When you click on the assignment it will you to the assignment itself it acts as a shortcut rather than launching the application separately 

Public view which shows all assignments set to classes, though not individuals. This can be used for both on public websites and for overall views. This view is limited as it will only display the name of the teacher and homework title, but not allow you to view the assignment directly.

Calendar Widget:

The Calendar widget allows you to either embed a Frog calendar or display an Agenda view listing all the events for a calendar.

The first thing you will need to do is choose what type of calendar to display – either the ‘Calendar’ or ‘Booking Calendar’.

By default, this slider will be on ‘Personal’ which means it is pointing to the ‘Calendar’ application. If you click ‘Booking’ that will of course change the widget to look at the ‘Booking Calendar’.

Once you have selected the calendar type you wish to display, you need to select the specific calendar item you want to display by choosing it from the drop down menu.

Now you can choose the agenda view, which displays the next 5, 10 or 15 events or the calendar view.

You have the option to adjust the height of the widget. This widget also works with the Create Event widget which provide access to create event directly into calendar or booking calendar.

Please note that you cannot set the calendar widget to display the logged -in user's calendar, only your own, If you wish to add the user's calendar to a page in Frog, this is possible and there is a tutorial on the community site

 

Basic Code Activity Widget:

The Code Activity widget is one of the widgets you can use to collect work in from your students. It allows your students to submit computer code as:

HTML 

Javascript 

PHP

or Python

This can be selected when you click the Edit Code button in the editing panel and select the drop down options.

The code entered will colour code automatically and lint. That is to say it will highlight any errors such as unclosed tags. It will auto-complete mots tags and quotes for you, mirroring the functionality in most code editors. Linting and auto-complete do not run for students when they are interacting with the widget.

As a teacher, you can add starting code to the widget and set a task for your students to amend it, or leave it blank.

Success Criteria can be added as well, allowing you to give more detail around what you expect the students to be able to do.

This widget is the same as the activity in the New Assignment wizard. By making it available in the widget tray, this means you can construct a complete independent learning homework around the activity and then either assign the site or page.

It is worth noting that this widget will not run or process any code displayed. We built this widget following conversations with schools where they reported firewalls and antivirus systems preventing electronic collection of code from students.

The final element of the Basic Code Activity that’s worth highlighting is that the widget can be marked using Feedback, Frog’s comment-based marking system. 

Code Viewer:


The Code Viewer allows you to display:
• HTML
• Javascript
• PHP
• Or Python


The code displayed will automatically colour based on the language selected and
provides linting assistance to automatically add closing tags, quotations and highlight
errors.


To input some code, click the Edit Code button in the Edit Panel


The widget only displays code, it does not run the code. If you wish to demonstrate
your programming, then the HTML widget can run HTML, CSS and Javascript.


The widget can have a title set in the Edit Panel, which can be useful for highlighting
steps or different elements

Create Event Widget:

There are two ways to add an event or booking onto the Calendar or Booking calendars.


You can either open the calendar or booking calendar applications via the search bar or FrogDrive, and then manage them in there, or alternatively you can do this via the ‘Create Event’ Widget in a site.

To use the ‘Create Event Widget’ just drag the widget onto a page, and then click it to open the widget settings in the edit panel:


You will then be able to choose which calendar you want this widget to create events for, in the same way you would for the calendar widget:


• you have two choices – either ‘Personal’ which points to the ‘Calendar’
application, or ‘Booking’ which points to the ‘Booking Calendar’ application.


• Once you’ve chosen which calendar type you want to use, you then need to
select from the drop-down list, which calendar item you wish the ‘Create Event’ widget
to point to.

• You also have the ability to allow recurring events or not when using this widget.

Everyone will be able to see the Create Event widget, unless you use Rules to hide it. Permission to add events is handled by the calendars themselves. You will have to set up these permissions in the applications, otherwise users will receive an error message.

The advantage of using the Create Event Widget, is that it saves the number of clicks needed to get to the calendar and add events or bookings to it (especially if you use it on a dashboard).

Once you have finished setting the Create Event widget’s settings, it’s worth adding a calendar widget below the ‘create event widget’ and set it to point to the same calendar. Combining these two widgets like this is a great way to use them, as it means the user adding the event or booking can see it added to the calendar straight away.

ePortfolio List Widget:

You can use this widget to display ePortfolio as a list

Frog drive view 

Tiles view 

File Drop Widget:

The File Drop was originally designed to allow students to hand-in documents via the Assignments system. This widget offers the same functionality as the File Drop Activity in the Assignments wizard but on a site.

Although it is mainly found in assignments, it has many ways it can be used as It provides you with an interactive area, where users can upload files. Please note that in order to interact with the FileDrop widget, users will need at least contribute rights to the site

The File Drop has two views.

Individual means that only people with Edit and Manage rights and the individual who uploaded a file can see the file. This is a useful tool when working with students, as it allows them all to pass work to you but prevents them from seeing anyone else’s.

Group view displays all files to everyone.


You can allow or prevent users from deleting their own files. Again, this is really useful for the classroom. And anyone with Edit and Manage rights to the site can delete files from the File Drop too

Like the other activity widgets, there is also the option to name the File Drop and add success criteria. If you are using the File Drop as part of an assignment, students will be able to upload directly to this area. If they have an iOS device such as an iPhone or iPad, then the free app FrogSnap will allow them to hand in images, audio files and video directly to the File Drop in an assignment.

Form Widget: 

Forms are a great simple way of collecting information from your staff, students and parent directly into Frog. And because in most cases they are already logged in you don't have to worry about collecting their details which makes a Frog form a quick task

Currently, to create a form you only intend to use once, drag the form widget onto the. If you plan to use your form on more than one site, you should create the form in the Forms section of FrogDrive. When you add a form to a site, it actually creates a copy of the Form. This is useful if you want to reuse the same layout but change some of the details.

In the Editing panel, click the New Form button.

A new pop up appears. Here you can add and remove elements to make your form.

As with everything in Frog, it’s all drag and drops, and we’ve listened to what you’ve asked for. You can recreate the look of your paper forms by being able to set layouts for each row.

When you click option Import form it will take you to a new window which will have two options 

1. Import forms

2. New Form

With my forms here you will view forms that you have created 

With new form option, you can view all the forms created within Frog which can be assigned or use in a new site 

Here I have a single row and I’m going to drag in a Text element. This is actually a RichText box, allowing me to add links, images and make the text bold. I can use this to make a heading in my row top

Now I can keep adding elements in this row, just like a Layout box when page editing, but I could choose to add another row underneath and have additional columns.

• We’ve already mentioned Text
• Single Line – allows me to add a single line for text entry.
• The paragraph gives the Form filler-in a larger space.
• Checkboxes let you set a number of options, which allow for more than one
selection, while
• Radio buttons limit the user to one of the options.
• The dropdown is also like this
• Date Picker lets you select a date
• And File Upload allows your users to upload files to the form. This can be handy for school trips, Reprographics

Each element has options available, just like when you’re editing a page. Most are fairly obvious, so I’m just going to highlight two here:

If you check the Required Field, your users cannot submit the form without filling this bit in

I can send my form to an email address or multiple email addresses, using a comma to separate them and I can set the form to only allow one entry per person using the Single Submission Form check box.

To view the results of my form you will have two options. First, you can add a Data Viewer widget to a page or you can navigate to site menu which is located at the left top corner of the site 

In the form results, I can see all the information, but if I click on the Action Cog, I can export all the data as a CSV spreadsheet or I can clear all the results.

Forum Widget:

The Forum widget is a great tool to communicate with your students, staff, and parents as it can be used for work, student voice or parent groups. This can be a very useful tool.

Like any forum on the internet, it allows users to create topics for discussion, that can then be replied to by other users within the school. However, the forum widget does not require users to sign in or adding users as to when you are already logged in when you sign into Frog for the first time.

Now with permission, you will need at least contribution rights to be able to use this widget.

In the edit panel, you can view a few settings that can be altered 

 

This is set to ( Never ) by default. If you click Temporarily, it will give you 3 options, which is generally telling you the amount of time that users have after posting the content. before they can edit or delete their post whenever they want. This is a popular option because it allows users to correct any mistakes at the point of posting but doesn’t allow them to go in and make changes after the time limit. 

Frog Apps widget:

The Frog Apps widget allows you to link to a Frog Application, rather than having to go the applications section of FrogDrive. Remember these are the internal applications of FrogLearn, not any mobile apps.

In the widget settings panel, you can see all the Frog applications you have access to. All the apps are displayed here, but you also have to ability to search if necessary

You can also choose to bypass the link and embed the application directly in the page and set the height for how much of the page the app takes up. Most apps work best without sharing width. If you embed the app in a small layout space, you might find it hard to use

If an app is not available to be used by a profile, for instance, if you add the Assignment
Manager app to a student or parent portal, the widget will display a message explaining
that the user does not have access. Frog admins can alter access to most apps in
Groups and Policies.

Once the app is added you can now use the app as a widget which can display relevant features 

 

 

The Frog page widget allows users to embed content from one page in a site, within another page on a site. This can help save time constructing sites and help to distribute control over specific elements within a site.

A good example of this is having one site containing a number of notice boards then nesting certain noticeboards into different dashboard sites. This way you can provide key staff members access to add notices to noticeboards without granting them overall access to changing all of the dashboard pages. The Frog page widget also is useful for having to update certain information in a number of places if it all leads back to the one source.

When editing a site, click on the "widgets" tab in the left hand content tray. From here drag the Frog page widget onto an editable area on the page.

In order to select a page to embed within this widget click the page icon to the right of the "select a page" area. This will expand a pane, displaying the sites area within FrogDrive.

Navigate to the site in question by accessing the different site areas on the left hand menu. When you've found the site you wish to access to find a page to embed, single left click the site and you will be shown a basic preview of this site. Here you can navigate through the pages to find the page to embed in your site.

Once you've found the page click on the green "Use" button at the top right of the site picker pane. Clicking the "back to site picker" text at the top left of the preview pane returns you to the site selection area. Once you've clicked "Use" the preview pane will close and the name of the site and page selected will be present in the widget "page" settings area and the page selected will be viewable within edit mode in the Frog page widget.


Once the widget is on the page, single left click the widget to be shown the settings for this widget on the left hand side. The 2 settings available are  the ability to select a page and the ability to define a height of this widget. By default the height of the widget is set to "auto" meaning that the Frog page will not have a scroll frame and simply display all of the content on this page. By clicking the height slider the icon will turn red to "Manual" where you are able to change the height of the widget on this page in pixels. 

If the content on the Frog page is greater than the height specified then there will be a scroll bar present when out of edit mode so users can view all of the content.


When exiting edit mode, after clicking the blue "Save Changes" button on the left hand edit tray the selected page along with the chosen height settings will then be shown within this sites page. It is important to remember that when nesting a page from one site into another site that users need access to view both sites (minimum "can view" permissions) or the content will not be displayed.

Frog Site List Widget:

This can be used to create a menu of site links, such as for a department menu, then you should consider using Site List Widget 

If sites are tagged or inserted with the correct keywords. This widget only displays sites which the user has access to 

To use properly, you will have had to tag your sites while sharing. I’ll just jump to a mathematics site that I’ve created, and I’ll show you where to add these tags. One option is to add the tags in from the edit panel when in the site settings area, so I’ll add these in here now. Alternatively, you can add the tags when sharing a site. Now that’s done, I’ll head back over to where I want to add my site link widget.

You can then add these tags or keywords to the Site List widget’s settings and it will list the matching sites. In this way, you can create dynamic, personalized menus

As you can see here, I have added the tags Curricular and Mathematics so this widget will display the mathematics site and any other sites with those tags.

The widget has three views or display types

With advanced settings, you can change the way its aligned, set it at a fixed dates 

The sites will always display in alpha-numeric order of their titles

Frog Site Widget:

This widget is used to embed an entire site into another one

All you need to do to use this widget is drag it on to a page, click on it to reveal the widget settings in the edit panel, and then click on the select site button to start searching for a site.

This site has 5 pages within it which can all be shown via this one widget. This is particularly useful when using the noticeboard widget as you can have notices for the whole school, ks3, ks4 etc all embedded onto a page, without having to have 5 separate notice boards on your site. It’s worth mentioning that the theme I have used for the notices site has been stripped back to just show the tabs at the top and nothing else. This theme has been added as it allows you to keep the look and feel of the new site without any conflicting themes or backgrounds from the existing Notices site. If I quickly show you the staff dashboard, you can see how this has been used to display lots of notices to all staff without having lots of different widgets on a site. The information is easy to find and allows you to keep the page organised and easy to navigate.

The Frog Site widget retains the permission granted by its original site. This is especially useful when using noticeboards like in this example. Noticeboards require Edit and Manage rights to be able to post, but it is not always desirable for all staff to be able to edit the main staff dashboard. By creating a separate notices site, staff can be given editing rights to that site, and when nested on their dashboard, they can still post notices, but cannot edit anything else

Within FrogLearn you are able to control what content user groups see within sites or dashboards. This is done by using rules that can be applied to both pages within a site and specific widgets on a page.

Setting Rules on Pages or Widgets

In order to create a rule and apply it to a site page or widget, first access that site and click the black “edit” button at the top left to open up the site in edit mode. Single left click the page in the site that you wish to add/change a rule on or single left click the widget that has been dragged onto your site.

For rules on Pages: Next, click on the “page” tab in the left hand side edit tray then just below, click on where it says “rules”. Each of the pages should be hidden by default as indicated by the slider in this section.

For rules on widgets: Single left click this widget to select it which should bring you to the settings tab for the widget then click on where it says "rules". 

The first option you will see is a slider indicating whether the page or widget is to be shown or hidden by default. Clicking this slider will change the option from "show" (default value) to "hide".

  • HIDE – Remain hidden until conditions of the rules are met.

  • SHOW – Remain visible until conditions of the rules are met.

On the rules tab you will be able to see any existing rules that have been listed, below. To add a new rule click the “Add Rule” button to open up the rule editing window.

This is where you define the condition for the rule. Set the slider to set the first part of the condition.

This toggles between:

  • WHEN – Met only when the next part of condition is true.

  • UNLESS – The condition is met unless the next part of the rule is true.

From the Add a Rule drop down menu, you can select to add a rule specifying either:.

  • The user is in a group or profile - You are able to type in the name of a group or profile into a text box and select multiple groups from the dropdown list.

  • The date is... - You are able to select a specific date or range of dates.

  • The user is logged in - No additional options required after selecting this option.

The settings available depend on which of the options you select (see above). Once you have chosen the desired parameters click the blue “Add” button to confirm your rule selection.

It is worth noting that you can add multiple rules to a page or widget in one go.

‘AND’ Rules

Adding another Rule in "Site Rules" will mean that the first rule AND the second rule has to be true before the condition is met. Multiple rules can be added here, each being linked with the AND rule.

If you ever need to modify a rule you can click the pencil icon to the right of the rule. Clicking the cross will delete this rule.

Please be aware however that there is a “Use Last Rule” button you can click when viewing the rules window to automatically add the previously used rule. Once clicked the rule will appear and you can click the blue “Apply” button  when happy with your changes to be taken back to the site.

This will return you to the site looking at the page tab in the left edit panel. A blue and white cog  icon is displayed beside any page (or widget) when a custom rule is applied.

 

You can make changes to existing rules by clicking the penicl icon in the left hand edit panel and delete any rules here by clicking the X icon.

Clicking on “Save Changes” in the left hand edit panel will save your changes. In this example, users who login who are a member of the student profile will now be restricted from viewing this widget.

‘OR’ Rules

Each time a new Rule is created, it is added to the Rules Settings panel (the most recent displayed to the top) and is joined to the previously added rule with an ‘OR’.


In this example the page will be visible to ‘students’ who are in ‘group1’ after 01/04/2015 but then it will be visible to all users after 01/05/2015.

Within a site it is possible for you to use a Site Timeline widget to share photos, videos, audio files and documents with students, staff and parents. The widget allows users to see a series of events (photos, videos, audio files, documents) in chronological order and comment on or like them. This new feature could be used for school trips, local sports day events, class exercises or even as a blog.

You can easily upload photos, video or audio files of work directly to a Site Timeline using the FrogSnap app.

When viewing a site in edit mode, drag on the Site Timeline widget into an active area on the page.

In order to display the settings for this widget, single left click the widget on the page when in edit mode.