Actions

Developer Area/Plugins/Third party: Difference between revisions

From Mahara Wiki

< Developer Area‎ | Plugins
No edit summary
Line 57: Line 57:
!'''Name'''
!'''Name'''
!'''Mahara <br />version'''
!'''Mahara <br />version'''
!'''Available<br />versions 🚧'''
!'''Available<br />updates'''
!'''Security'''
!'''Security'''
!'''Update type'''
!'''Last release'''
!'''Support'''
!'''License'''
!'''License'''
!'''URL/Notes'''
!'''URL/Notes'''
Line 69: Line 68:
|Up to date
|Up to date
|N/A
|N/A
| style="color:#333;" |None
|Active
|Active
|BSD 3-Clause<br />LGPL
|BSD 3-Clause<br />LGPL
Line 76: Line 74:
|-
|-
| style="font-weight:bold;" |CSS Tidy
| style="font-weight:bold;" |CSS Tidy
|2.0.3
|2.1.0
|Up to date
|Up to date
|N/A
|N/A
|None
|Active
|Active
|LGPL
|LGPL
Line 85: Line 82:
|✅
|✅
|-
|-
| style="font-weight:bold;" |Elasticsearch
| style="font-weight:bold;" |Elasticsearch PHP
| style="color:#333;" |7.17.2
| style="color:#333;" |7.17.2
|8.9.0
|Major, 8.10.0
|N/A
|N/A
|Major
|Active
|Active
|Apache v2.0  LGPL v2.1
|Apache v2.0  LGPL v2.1
|[https://github.com/elastic/elasticsearch-php GitHub]<nowiki> | </nowiki>[https://github.com/elastic/elasticsearch-php/blob/master/CHANGELOG.md Changelog]
|[https://github.com/elastic/elasticsearch-php GitHub]<nowiki> | </nowiki>[https://github.com/elastic/elasticsearch-php/blob/master/CHANGELOG.md Changelog]
[https://github.com/elastic/elasticsearch-php/milestone/6 PHP 8 milestone] 83%
Move to OpenSearch


Check that docker is also pulling in the same version!
|✅
 
|*
|-
|-
| style="font-weight:bold;" |HTML Purifier
| style="font-weight:bold;" |HTML Purifier
|4.14.0
|4.16.0
|Up to date
|Up to date
|N/A
|N/A
|None
|2022
|Inactive, 2022
|LGPL v2.1+
|LGPL v2.1+
|[http://www.htmlpurifier.org/ HTML Purifier]<nowiki> | </nowiki>[https://github.com/ezyang/htmlpurifier/ GitHub]
|[http://www.htmlpurifier.org/ HTML Purifier]<nowiki> | </nowiki>[https://github.com/ezyang/htmlpurifier/ GitHub]
Line 113: Line 106:
|Up to date
|Up to date
|N/A
|N/A
|None
|Active
|Active
|LGPL
|LGPL
Line 121: Line 113:
| style="font-weight:bold;" |ReCaptcha
| style="font-weight:bold;" |ReCaptcha
|1.2.4
|1.2.4
|1.30
|Minor, 1.3.0
|TBC
|TBC
|'''PHP 8 support'''
|Active
|Active
|BSD-3
|BSD-3
Line 131: Line 122:
| style="font-weight:bold;" |simplesamlphp
| style="font-weight:bold;" |simplesamlphp
|2.0.4
|2.0.4
|2.0.6
|Minor, 2.0.6
|N/A
|N/A
|Minor
|Active
|Active
|GPL 2.1
|GPL 2.1
Line 141: Line 131:
<small>htdocs/auth/saml/extlib/modules</small>
<small>htdocs/auth/saml/extlib/modules</small>
|❌
|❌
|-
|behat
|3.13.0
|Up to date
|N/A
|
|
|
|✅
|-
|behat/gherkin
|4.9.0
|Up to date
|N/A
|
|
|
|✅
|-
|behat/mink
|1.7.1
|Up to date
|N/A
|
|
|
|✅
|-
|behat/mink-browserkit-driver
|1.3.3
|Up to date
|N/A
|
|
|
|✅
|-
|behat/mink-extension
|2.3.1
|Up to date
|N/A
|
|
|
|✅
|-
|behat/mink-goutte-driver
|1.3.0
|Up to date
|N/A
|
|
|
|✅
|-
|behat/mink-selenium2-driver
|1.3.1
|Up to date
|N/A
|
|
|
|✅
|-
|behat/transliterator
|1.5.0
|Up to date
|N/A
|
|
|
|✅
|}
|}


Line 153: Line 215:
!'''Name'''
!'''Name'''
!'''Mahara <br />version'''
!'''Mahara <br />version'''
!'''Available<br />versions'''
!'''Update available'''
!'''Security'''
!'''Security'''
!'''Update type'''
!'''Last release'''
!'''Support'''
!'''Location<br />'''<code><small>(./htdocs/...)</small></code>
!'''Location<br />'''<code><small>(./htdocs/...)</small></code>
!'''License'''
!'''License'''
Line 164: Line 225:
| style="font-weight:bold;" |Bootstrap
| style="font-weight:bold;" |Bootstrap
|5.0.2
|5.0.2
|5.1
|Minor, 5.3.2
5.2
|?
 
5.3
|No
|'''Minor'''
|Active
|Active
|<small>.../lib/bootstrap/assets/javascripts/<br /></small>
|<small>.../lib/bootstrap/assets/javascripts/<br /></small>
Line 180: Line 237:
picker  
picker  
|4.17.47
|4.17.47
|'''6.2.10'''
|'''Major'''
|No
|No
|'''Major'''
|Active - v6
|Active - v6
|<small>.../js/bootstrap-datetimepicker/</small>
|<small>.../js/bootstrap-datetimepicker/</small>
Line 192: Line 248:
|-
|-
| style="font-weight:bold;" |Chart.js
| style="font-weight:bold;" |Chart.js
|3.7.1
|3.9.1
|'''4.4.0'''
|Major, 4.4.0
|No
|No
|'''Major'''
|Active
|Active
|<small>.../js/chartjs/</small>
|<small>.../js/chartjs/</small>
Line 204: Line 259:
|-
|-
| style="font-weight:bold;" |Clipboard js
| style="font-weight:bold;" |Clipboard js
|2.0.10
|2.0.11
|'''2.0.11'''
|Up to date
|No
|No
|'''Patch'''
|Active
|Active
|<small>.../js/clipboard/</small>
|<small>.../js/clipboard/</small>
Line 215: Line 269:
|-
|-
| style="font-weight:bold;" |Dragon-drop
| style="font-weight:bold;" |Dragon-drop
|3.2.1
|3.6.1
|[https://github.com/schne324/dragon-drop/releases/tag/v3.6.1 '''3.6.1''']
|'''Minor'''
|No
|No
|'''Minor'''
|2020
|Inactive
 
2018
|<small>..../js/dragondrop/</small>
|<small>..../js/dragondrop/</small>
|MIT
|MIT
Line 229: Line 280:
| style="font-weight:bold;" |Datatables
| style="font-weight:bold;" |Datatables
|1.11.4
|1.11.4
|'''1.13.6'''
|'''Minor'''
|No
|No
|'''Minor'''
|Active
|Active
|<small>.../js/DataTables/</small>
|<small>.../js/DataTables/</small>
Line 237: Line 287:
|[https://datatables.net/ Data Tables]<nowiki> |</nowiki>[https://datatables.net/download/index Download]
|[https://datatables.net/ Data Tables]<nowiki> |</nowiki>[https://datatables.net/download/index Download]
[https://cdn.datatables.net/ Release notes CDN]
[https://cdn.datatables.net/ Release notes CDN]
|*Web builder
|❌ Need to use web builder
|-
|-
| style="font-weight:bold;" |Dropzone
| style="font-weight:bold;" |Dropzone
|5.7.6
|5.9.3
|'''5.9.3'''
|Patch, 5.9.3
|No
|No
|'''Minor'''
|2021
|Inactive, 2021
|<small>.../js/dropzone/</small>
|<small>.../js/dropzone/</small>
|MIT
|MIT
|[https://github.com/dropzone/dropzone/releases GitHub releases] 6.0.0 in beta
|[https://www.npmjs.com/package/dropzone NPM dropzone]
|✅
|✅
|-
|-
| style="font-weight:bold;" |Gridstack
| style="font-weight:bold;" |Gridstack
|4.4.1
|4.4.1
|'''v9.0'''
|'''Major'''
'''v7.2.3,'''
'''v6.0.3,  v5.1.1'''
 
'''v4.4.1'''
|No
|No
|'''Major'''
|Active
|Active
|<small>.../js/gridstack/</small>
|<small>.../js/gridstack/</small>
Line 266: Line 310:
|-
|-
| style="font-weight:bold;" |jQuery
| style="font-weight:bold;" |jQuery
|3.6.3
|3.7.1
|'''3.7.1'''
|Up to date
|No
|No
|'''Minor'''
|Active
|Active
|<small>.../js/jquery/</small>
|<small>.../js/jquery/</small>
|MIT
|MIT
|[http://jquery.com/ Website]<nowiki> | </nowiki>[https://github.com/jquery/jquery GitHub]<nowiki> | </nowiki>[https://blog.jquery.com/2021/03/02/ Blog post]<br />[https://forum.jquery.com/ Forum]<nowiki> | </nowiki>[https://twitter.com/jquery Twitter]
|[http://jquery.com/ Website] [https://forum.jquery.com/ Forum]
|✅
|✅
|-
|-
| style="font-weight:bold;" |jQuery UI
| style="font-weight:bold;" |jQuery UI
|1.13.1
|1.13.2
|'''1.13.2'''
|Up to date
|No
|No
|'''Patch'''
|Active
|Active
|<small>.../js/jquery/jquery-ui/</small>
|<small>.../js/jquery/jquery-ui/</small>
|MIT
|MIT
|[http://jqueryui.com/ jQuery UI] Security and compatibility fixes
|[http://jqueryui.com/ jQuery UI]
|✅
|✅
|-
|-
| style="font-weight:bold;" |JS Color
| style="font-weight:bold;" |JS Color
|2.4.7
|2.5.1
|'''2.5.1'''
|Up to date
|No
|N/A
|'''Minor'''
|Inactive,2022
|Inactive
|<small>.../js/jscolor/</small>
|<small>.../js/jscolor/</small>
|GPL 3
|GPL 3
|http://jscolor.com/ - click download for #
|http://jscolor.com/
|✅
|✅
|-
|-
| style="font-weight:bold;" |Json editor
| style="font-weight:bold;" |Json editor
|2.6.1
|2.6.1
|'''2.10.1'''
|'''Minor'''
|No
|No
|'''Minor'''
|Active
|Active
|<small>.../js/jsoneditor/</small>
|<small>.../js/jsoneditor/</small>
Line 310: Line 350:
|-
|-
| style="font-weight:bold;" |Marked
| style="font-weight:bold;" |Marked
|4.0.12
|4.3.0
|'''9'''
|Minor, 4.3.0
Major 9.1.0
|No
|No
|'''Major'''
|Active
|Active
|<small>.../js/marked/</small>
|<small>.../js/marked/</small>
Line 321: Line 361:
|-
|-
| style="font-weight:bold;" |Moment.js
| style="font-weight:bold;" |Moment.js
|2.29.1
|2.29.4
|'''2.5.2'''
|Up to date
'''3.4.3'''
|No
|No
|'''<nowiki>Minor|Major</nowiki>'''
|Active
|Active
|<small>.../js/momentjs/</small>
|<small>.../js/momentjs/</small>
|MIT
|MIT
|[http://momentjs.com/ Moment JS] 🆕 [https://moment.github.io/luxon/#/ Luxon GitHub]
|[http://momentjs.com/ Moment JS] 🆕 [https://moment.github.io/luxon/#/ Luxon GitHub]
Connected to jquery date-picker
|✅
|✅
|-
|-
| style="font-weight:bold;" |PDFjs
| style="font-weight:bold;" |PDFjs
|3.10.111
|3.10.111
|'''3.10.111'''
|'''Minor'''
|No
|No
|'''Minor'''
|Active
|Active
|<small>.../artefact/file/blocktype/pdf/js/pdfjs/</small>
|<small>.../artefact/file/blocktype/pdf/js/pdfjs/</small>
Line 348: Line 383:
|-
|-
| style="font-weight:bold;" |Floating UI (Popper)
| style="font-weight:bold;" |Floating UI (Popper)
|2.10.2
|2.11.8
|'''Yes'''
|Up to date
|No
|N/A
|'''Minor'''
|Active
|Active
|<small>.../js/popper/</small>
|<small>.../js/popper/</small>
Line 361: Line 395:
|6.4.2
|6.4.2
|Up to date
|Up to date
|No
|N/A
|Up to date
|Active
|Active
|<small>.../theme/raw/sass/lib/font-awesome/</small>
|<small>.../theme/raw/sass/lib/font-awesome/</small>
Line 371: Line 404:
| style="font-weight:bold;" |TinyMCE
| style="font-weight:bold;" |TinyMCE
|5.10.7
|5.10.7
|Up to date
|Major, 6.7.0
|No
|No
|Up to date
|Active
|Active
|<small>.../js/tinymce/</small>
|<small>.../js/tinymce/</small>
Line 383: Line 415:
| style="font-weight:bold;" |Video.js
| style="font-weight:bold;" |Video.js
|7.21.5
|7.21.5
|'''8.5.2'''
|Major, 8.5.2
|No
|No
|'''<nowiki>Minor|Major</nowiki>'''
|Active
|Active
|<small>.../artefact/file/blocktype/<br />internalmedia/videojs/</small>
|<small>.../artefact/file/blocktype/<br />internalmedia/videojs/</small>

Revision as of 13:31, 9 October 2023

A list of the third-party plugins within Mahara.

Composer commands

For available versions, e.g. composer show phpro/grumphp-shim 1.14.* --all

For our composer dependencies: composer show --tree

For checking the dependencies of a library version, e.g. composer show elasticsearch/elasticsearch 7.17.* --tree

Check if there are any outdated libraries (according to the version syntax in composer.json) composer outdated

Checking the .Mahara files

To check the versions in the .Mahara files, a helpful way to update this list is to go: 

 find ./htdocs -type f -iname "README.Mahara" -exec grep 'Version' -B1 {} \; -print

... on the current codebase.

Syncing the list in 'Country' dropdowns

To keep in sync is the country names we use for 'Country' dropdowns. To check what the current state of play is 

perl -MLocale::Country -le 'print join("\n", sort map { country2code($_) . " => " . country2code($_, LOCALE_CODE_ALPHA_3) . ", // " . $_ } all_country_names())'

and check the results against htdocs/lib/country.php and htdocs/lang/en.utf8/mahara.php files

For any confusion you can also check against https://www.iso.org

Third-party libraries (PHP and JS)

Legend

  • Mahara version = the README.Mahara file for the library | SemVer Info - explaining the symbols in the Mahara version column
  • Latest version = the most recent available version
  • Security = is there a new security patch available?
  • Upgrades/updates = what upgrades are available for this plugin?
  • Support = Is there a community supporting this library?
    • Active: There is ongoing work being put into the library
    • Inactive: Maintained but not actively making releases
    • Archived: Not being maintained
    • Deprecated (officially): All maintainers have left, and site may not exist in extreme cases.
  • PHP8 = is the latest version of this plugin compatible with PHP8?
  • README location = where it can be found in Mahara
  • License = software license for the library
  • URL/Notes = extra information, e.g. resources, notes, and news
  • 🚧 Work in progress - data needs to be updated

PHP versions in support https://www.php.net/supported-versions.php - 14 LTS - Ends security support in 30 Apr 2023, go to 16 LTS soon

💡 A new idea is being proposed to better handle customisations on updating third party libraries lives here → https://reviews.mahara.org/c/mahara/+/13780

PHP libraries (excluding external)

https://eusonlito.github.io/php-changes-cheatsheet/deprecated.html

Libraries are managed by Composer. See composer.json

Run composer show to get a quick summary of library versions managed by Composer.

Run composer outdated to get a list of outdated libraries.

🟡 Libraries yet to be moved to Composer: SimpleSAMLPHP - currently lives in htdocs/auth/saml/extlib and the version is managed in Makefile by curl.

Name Mahara
version 		Available
updates 		Security Last release License URL/Notes Composer
ADODB 5.22.6 Up to date N/A Active BSD 3-Clause
LGPL 		Official site | GitHub | Twitter
Wish-list: extract $SESSION 		✅
CSS Tidy 2.1.0 Up to date N/A Active LGPL GitHub ✅
Elasticsearch PHP 7.17.2 Major, 8.10.0 N/A Active Apache v2.0 LGPL v2.1 GitHub | Changelog

Move to OpenSearch

✅
HTML Purifier 4.16.0 Up to date N/A 2022 LGPL v2.1+ HTML Purifier | GitHub ✅
PHPMailer 6.8.1 Up to date N/A Active LGPL GitHub ✅
ReCaptcha 1.2.4 Minor, 1.3.0 TBC Active BSD-3 GitHub ✅
simplesamlphp 2.0.4 Minor, 2.0.6 N/A Active GPL 2.1 GitHub

Optional library - called in Makefile

htdocs/auth/saml/extlib/modules

❌
behat 3.13.0 Up to date N/A ✅
behat/gherkin 4.9.0 Up to date N/A ✅
behat/mink 1.7.1 Up to date N/A ✅
behat/mink-browserkit-driver 1.3.3 Up to date N/A ✅
behat/mink-extension 2.3.1 Up to date N/A ✅
behat/mink-goutte-driver 1.3.0 Up to date N/A ✅
behat/mink-selenium2-driver 1.3.1 Up to date N/A ✅
behat/transliterator 1.5.0 Up to date N/A ✅

JavaScript and jQuery libraries

🟡 Check that our Node version is still in support https://endoflife.date/nodejs node| https://nodejs.org/en/download/releases/ ➡ Update the .nvmrc file with the supported version.

Run npm list to get a quick list of the versions and libraries managed by NPM

Goal: to move libraries to be managed by NPM

Name Mahara
version 		Update available Security Last release Location
(./htdocs/...) 		License URL/Notes NPM
Bootstrap 5.0.2 Minor, 5.3.2 ? Active .../lib/bootstrap/assets/javascripts/
 		MIT Releases | GitHub

bootstrap versions

✅
Date time

picker

4.17.47 Major No Active - v6 .../js/bootstrap-datetimepicker/ MIT GitHub | Get Date Picker

Latest release: rewrite (beta)

❌
Chart.js 3.9.1 Major, 4.4.0 No Active .../js/chartjs/ MIT Chart JS | GitHub

Migration to v4

✅
Clipboard js 2.0.11 Up to date No Active .../js/clipboard/ MIT Clipboard JS | GitHub
version # is tagged 		✅
Dragon-drop 3.6.1 Minor No 2020 ..../js/dragondrop/ MIT GitHub ✅
Datatables 1.11.4 Minor No Active .../js/DataTables/ MIT Data Tables |Download

Release notes CDN

❌ Need to use web builder
Dropzone 5.9.3 Patch, 5.9.3 No 2021 .../js/dropzone/ MIT NPM dropzone ✅
Gridstack 4.4.1 Major No Active .../js/gridstack/ MIT GitHub | Website ❌
jQuery 3.7.1 Up to date No Active .../js/jquery/ MIT Website Forum ✅
jQuery UI 1.13.2 Up to date No Active .../js/jquery/jquery-ui/ MIT jQuery UI ✅
JS Color 2.5.1 Up to date N/A Inactive,2022 .../js/jscolor/ GPL 3 http://jscolor.com/ ✅
Json editor 2.6.1 Minor No Active .../js/jsoneditor/ MIT GitHub |Changelog 🚧
Marked 4.3.0 Minor, 4.3.0

Major 9.1.0

No Active .../js/marked/ MIT GitHub ✅
Moment.js 2.29.4 Up to date No Active .../js/momentjs/ MIT Moment JS 🆕 Luxon GitHub ✅
PDFjs 3.10.111 Minor No Active .../artefact/file/blocktype/pdf/js/pdfjs/ Apache License 2 Getting started | GitHub

The Firefox dist version seems to be the only working one

*
Floating UI (Popper) 2.11.8 Up to date N/A Active .../js/popper/ MIT https://popper.js.org/
GitHub issue | tooltips 		✅
Fontawesome 6.4.2 Up to date N/A Active .../theme/raw/sass/lib/font-awesome/ SIL OFL 1.1 Font Awesome | GitHub | Upgrade steps | Changelog ✅
TinyMCE 5.10.7 Major, 6.7.0 No Active .../js/tinymce/ LGPL 2.1 Tiny Cloud | Downloads | Changelog |News

📲 Test on mobile

✅
Video.js 7.21.5 Major, 8.5.2 No Active .../artefact/file/blocktype/
internalmedia/videojs/ 		Apache License 2.0 Video JS | GitHub ✅

Forked/stale/deprecated libraries

Name Mahara
version 		Latest
version 		Status Location
(./htdocs/...) 		License URL Next action
Dwoo🟡 1.3.7 1.3.7 Archived, 2020 .../lib/dwoo/ LGPL Dead site?

GitHub

Javascript
templates 		3.20.0 3.20.0 Archived, 2021 .../js/javascript-templates/ MIT GitHub
jQuery mobile 1.5.0-alpha.1 1.5.0-rc1 Deprecated .../js/jquery/jquery-mobile/ MIT Website
🚨 "transition(ed) ... under the jQuery project umbrella, jQuery UI" 		Remove and test
jQuery UI plugin
touch-punch 		0.2.3 0.2.3 Deprecated .../js/jquery/jquery-ui/
jquery-ui-touch-punch.min.js 		MIT or GPL
Version 2 		GitHub

🚨 external to JQuery UI

Use a fork?
jTLine 1.0 1.0 Inactive, 2018 .../js/jTLine/ MIT GitHub

Twitter

Ref

Masonry 4.2.2 4.2.2 Inactive, 2018 .../js/masonry/ MIT Masonry

GitHub

TinyMCE
Mathslate 		1.1 1.1 Forked, 2015 .../js/tinymce/plugins/mathslate/ GPL 3 Our version is forked.
to work with Tinymce 5
Oauth PHP 175 175 Archived, 2010 .../webservice/libs/oauth-php/ MIT Code Replace with an oauth2 php library see what Moodle does (old comment)
zxcvbn 4.4.2 4.4.2 Inactive, 2017 .../js/zxcvbn/ MIT GitHub
Cookie consent 3.1.1 4.0 No open source updates .../js/cookieconsent/ MIT Download GitHub

Open source version is not updated. 🚨

Select2 4.0.13 4.0.13 Inactive, 2020 .../js/select2/ MIT Select2 | Releases

RC 4.1

Fonts

Name Mahara
version 		Latest
version 		Status README location
(./htdocs/...) 		License URL/Notes
Aurulent Sans
(font) 		2007.05.04 2007.05.04 n/a .../lib/fonts/ SIL OFL v1.10 Font Squirrel Aurulent Sans
Deja Vu Sans
(font) 		2.37 2.37 n/a .../lib/fonts/ DejaVu Fonts Font Squirrel Deja Vu Sans
Open Sans
(font) 		1.10 1.10 Unknown .../theme/raw/fonts/ Apache License Google Fonts Open Sans
Roboto Slab
(font) 		1.100263 1.100263 Unknown .../theme/raw/fonts/ MIT Google Fonts Roboto
Charis SIL
(fonts) 		6.001 6.001 Active .././lib/fonts/ SIL OFL About font | Download

Composer.json dependencies

Resources: https://git.mahara.org | /mahara/mahara/-/blob/ | mahara/external/composer.json

Run composer outdated to check for updates.

Retrieved from ‘https://wiki.mahara.org/index.php?title=Developer_Area/Plugins/Third_party&oldid=13855’