GeoGebrEmbed

This plugin allows for quick, easy and HTML5 compatible embedding of GeoGebra applets in DokuWiki pages.

In its most basic form, you can just include some activity from GeoGebra.org (formerly known as GeoGebraTube):

<ggb>17499</ggb>

The plugin will use the pre-configured default values (see below).

In reality, you will most certainly want to set at least a few options. Or you might prefer to directly use an existing GGB file rather than upload it to GeoGebra.org:

<ggb 450x300>17499</ggb>
<ggb>{{:path:to:your:file.ggb}}</ggb>
<ggb appName="geometry" pb></ggb>

All parameters are optional. If you make use of the size parameter, it MUST come first. Other than that, parameters can appear in any order.

<ggb size htmlparams ggbparams>source</ggb>
< ggb size htmlparams ggbparams>source</ggb>

• using < ggb> instead of <ggb> will center the applet on the page
• size can be one of these:
  • width
  • widthxheight, e.g. 800×600
• htmlparams can currently be class=“…”. The classes will be added to the div as is.
• ggbparams will be forwarded to the GeoGebra applet; please note:
  • if the parameter is a numeric value, no quotes are needed, e.g. scale=2
  • if the parameter is a boolean value, no quotes are needed, e.g. showMenuBar=true
  • if the parameter is a string, you MUST use quotes, e.g. appName=“graphing”
• source can be one of these:
  • GeoGebra.org material ID (formely known as GeoGebraTube ID)
  • a (previously uploaded) file, as inserted by DokuWiki's Media Manager
  • a base64 encoded string containing the necessary data

• If you want to upload and insert a GeoGebra file using the Media Manager, you will have to add the following to <wikiroot>/conf/mime.local.conf:
  

  ggb	application-x/geogebra-file

  If that file does not exist, you will have to create it. Without this setting, Media Manager will prevent you from uploading *.ggb files.

• If the source is an alphanumeric string not longer than 12 chars (default), it will automatically interpret it as a material ID. Longer strings will be considered as base 64. The threshold can be configured.
• Regardless of the auto-detection mentioned above, you can always provide an ID explicitly by writing id:XXXXXX. There is currently no need for that, but one never knows, i.e. GeoGebra.org could decide to change the format of its material IDs. This would give you a workaround while waiting for an update to the plugin.
• When embedding a GeoGebra applet using its material ID, this ID can be found in the page's source code. If you do not want the ID to become public, you cannot use this variant. Embedding is no protection, it is just a convenience.
• When inserting a GGB file via the Media Manager, you will have trailing chars, i. e. file.ggb. This is normally used to provide an alternative text for images.. The GeoGebrEmbed plugin does not make use of this feature. However, you do not have to remove the |}} part. This means, you can just select a GGB file from the Media Manager and it will work.
• Floating text around a GeoGebra applet (like you might do with an image) will not work, because applets are embedded in multiple <div>s and we do not have full control over the styling.

Some common parameters can be set using short forms:

• In order to set a red border using the short form, you could write bc=“#FF0000” or border=“#FF0000”.
• In order to activate the reset icon, you write ri. Alternatively, if you have the reset icon globally enabled (see configuration options), you can write nori in order to disable it for the given applet.

If you feel a parameter would deserve a short form, please open an issue on the bug tracker.

Please see the GeoGebra reference page for a complete list of parameters.

The plugin will forward any parameter to GeoGebra without further treatment, except for

• short forms, which will be converted to the corresponding official parameter and then passed on to GeoGebra
• the class parameter, which is passed to the <div> that will contain the applet

You can specify a set of default options that will be used for applets where you did not locally set the corresponding parameters. Also, the first two parameters allow you to change default settings of the plugin.

• If you encounter a bug, please open an issue.
• If you have a suggestion, please make a pull request. If you do not know what that means, just open an issue and describe your suggestion.

• Correct styling (2021-10-20 16:47)
• Add possibility to center applet (2021-10-19 11:23)
• Add compatibility with imagereference plugin (2021-10-18 17:29)
• Skip default width/height if scaleContainerClass is set (2021-10-17 11:58)
• Fix handling of default values (2021-10-16 10:25)
• Fix caching issues (2021-10-16 09:43)
• initial commit (2021-10-10 10:35)

The plugin embeds GeoGebra apps using JavaScript and HTML5 as suggested by the relevant GeoGebra support page.