SrGeogebra is an ILIAS Plugin used to display GeoGebra (.ggb) files inside the ILIAS page editor. The ILIAS page editor is the editor used in Wikis, ILIAS learning modules or if you "Customize Pages" of courses or groups.
This documentation will teach you how to use the SrGeoGebra plugin within ILIAS learning modules.
- Create SrGeoGebra objects
- Upload .ggb files
- Display .ggb files
- Edit SrGeoGebra objects
- Delete SrGeoGebra objects
- Set default values of new SrGeoGebra objects
To use this plugin it is required to add the file extension "ggb" into the ILIAS file upload whitelist.
ILIAS 5.4: Select the "Administration" tab and choose the entry "Files".
ILIAS 6: Select the "Administration" tab, expand "Repository and Objects" by clicking on it and choose the entry "Files".
- Switch to the tab "Upload Settings".
- Enter the value "ggb" inside the "Custom Suffix Whitelist" text area.
- Click "Save".
Some values may already be inside the "Custom Suffix Whitelist" text area. In that case, separate each value with a comma. (E.g. "xyz, ggb")
A user is able to create a new SrGeoGebra object by clicking the button "Click here to add content" and selecting the menu entry "Insert GeoGebra Object".
The user must now fill out all the form inputs correctly to successfully create a new SrGeoGebra object. The following inputs are presented to the user:
- Title: The title this object should have. (Not displayed anywhere)
- Upload: The .ggb file this object should display.
- Width: The width this object should have. (In Pixels, e.g. 800)
- Height: The height this object should have. (In Pixels, e.g. 600)
- Enable Dragging And Zooming: States whether the Graphics View(s) should be moveable using Shift + mouse drag (or. Ctrl + mouse drag) or zoomable using Shift + mouse wheel (or Ctrl + mouse wheel). Setting this parameter to "false" disables moving and zooming of the drawing pad.
- Enable Reset Icon: States whether a small icon (GeoGebra ellipse) should be shown in the upper right corner of the applet. Clicking on this icon resets the applet (i.e. it reloads the file given in the filename parameter).
- Alignment: The side this object should be aligned to.
Hint: The settings above are all considered "generic" settings. To keep creation simple, all "advanced" options are automatically taken from the plugin configuration.
Finally, the user must click the button "Create" to save all inputs. The object has now been created.
A user is able to edit the generic settings of a SrGeoGebra object by clicking onto an existing SrGeoGebra object and selecting the menu entry "Edit".
The user is now able to edit the generic settings by changing the values of the inputs as desired and clicking the button "Save". The object has now been edited.
A user is able to edit the advanced settings of a SrGeoGebra object by clicking onto an existing SrGeoGebra object and selecting the menu entry "Edit".
The user must now select "Advanced Settings" at the top.
The user is now able to edit the advanced settings by changing the values of the inputs as desired and clicking the button "Save". The object has now been edited. The user may now use the "< Page" button to return back to the edit page.
A user is able to delete a SrGeoGebra object by clicking onto an existing SrGeoGebra object and selecting the menu entry "Delete".
The user must accept the prompt by selecting "OK". The object has now been deleted.
Default settings are values that are automatically used in place of undefined values. The 5 top inputs starting with "Default" within the configuration are generic settings while all the other inputs are advanced settings. When creating a new SrGeoGebra object, the top 5 inputs are merely used as a template for new objects and can be edited. As all the other inputs are advanced settings that can't be defined when creating a new SrGeoGebra object, the values defined in here will automatically transfer onto newly created objects.
All advanced settings used in this plugin are listed here: https://wiki.geogebra.org/en/Reference:GeoGebra_App_Parameters
An administrator is able to edit the default settings by accessing the plugin configuration under Administration -> Plugins -> Actions/Configure.
The administrator is now able to edit the default settings by changing the values of the inputs as desired and clicking the button "Save". The default settings have now been set.
This feature requires at least version 0.5.1 of the SrGeoGebra plugin
Immutable fields are fields that cannot be changed within SrGeoGebra objects and always use the value from the plugin configuration instead.
An administrator is able to manage immutable fields by accessing the plugin configuration under Administration -> Plugins -> Actions/Configure.
The administrator is now able to manage immutable fields by clicking into the "Immutable Fields" field. A context menu with all possible configuration settings will pop up. Select the fields that you wish to make unchangeable.
Entires may be removed by selecting the "x" next to each name.
Click the button "Save" if you are finished. The immutable fields have now been set.
Every existing GeoGebra object will be forced to use the unchangeable values within the configuration. Maintainers of SrGeoGebra objects are not able to change these values by editing their SrGeoGebra objects. However, they are able to detect unchangeable values as they remain greyed out.
Please note that the values of exisiting objects are not replaced upon changing a field to immutable. However, these objects prioritize the value from the configuration. (E.g. a SrGeoGebra object has a width of 400. The width then gets changed to an immutable field with the value 1000. The user then reverts the width back to a changeable field, keeping the value 400 from earlier.)
- Scaled objects are always forced to be aligned to the left
- Only downscaling is currently supported