Developer Area/Plugins/Third party: Difference between revisions

Latest revision as of 16:18, 4 Ocak 2024

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
Update type = what upgrades are available for this plugin, i.e. major, minor, patch, or security?
Support = Is there a community supporting this library? When was the last release year if not in active support
- 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.
License = software license for the library
Notes = extra information, e.g. resources, notes, and new
Composer = check if the library is managed by Composer
NPM = check if the library is managed by NPM

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	Update type	Support	License	URL/Notes	Composer
ADODB	5.22.6	Up to date	Active	BSD 3-Clause LGPL	Official site \| GitHub \| Twitter Wish-list: extract $SESSION	✅
CSS Tidy	2.1.0	Up to date	Active	LGPL	GitHub	✅
Elasticsearch PHP	7.17.2	Major, 8.10.0	Active	Apache v2.0 LGPL v2.1	GitHub \| Changelog Move to OpenSearch	✅
HTML Purifier	4.16.0	Up to date	2022	LGPL v2.1+	HTML Purifier \| GitHub	✅
PHPMailer	6.8.1	Up to date	Active	LGPL	GitHub	✅
ReCaptcha	1.2.4	Minor, 1.3.0	Active	BSD-3	GitHub	✅
simplesamlphp	2.0.4	Minor, 2.0.6	Active	GPL 2.1	GitHub Optional library - called in Makefile	❌

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

NPM-managed JS libraries

Name	Mahara version	Update type	Support	License	Notes
yargs	5.0.2	Minor, 5.3.2	Active	MIT
Chart.js	3.9.1	Major, 4.4.0	Active	MIT	Migration to v4
Clipboard js	2.0.11	Up to date	Active	MIT	version # is tagged
Dragon-drop	3.6.1	Up to date	2020	MIT
Dropzone	5.9.3	Patch, 5.9.3	2021	MIT
jQuery	3.7.1	Up to date	Active	MIT	Forum
jQuery UI	1.13.2	Up to date	Active	MIT
JS Color	2.5.1	Up to date	Inactive,2022	GPL 3
Marked	4.3.0	Minor, 4.3.0 Major 9.1.0	Active	MIT
Moment.js	2.29.4	Up to date	Active	MIT	Moment JS 🆕 Luxon GitHub
Popper	2.11.8	Up to date	Active	MIT	GitHub issue \| tooltips Floating UI
Fontawesome	6.4.2	Up to date	Active	SIL OFL 1.1	Upgrade steps \| Changelog
TinyMCE	5.10.7	Major, 6.7.0	Active	LGPL 2.1	Downloads \| Changelog 📲 Test mobile
Video.js	7.21.5	Major, 8.5.2	Active	Apache License 2.0	Video JS

Manually managed JS libraries

Name	Mahara version	Update type	Support	Location `(./htdocs/...)`	License	Notes	NPM
Date time picker	4.17.47	Major 6.17.16	Active - v6	.../js/bootstrap-datetimepicker/	MIT	Changelog Latest release: rewrite (beta)	❌
Datatables	1.11.4	Minor	Active	.../js/DataTables/	MIT	Download Release notes CDN	❌ Need to use web builder
Gridstack	4.4.1	Major	Active	.../js/gridstack/	MIT	[Demos](https://gridstackjs.com/demo/) https://github.com/gridstack/gridstack.js/tree/master/doc	🚧
Json editor	2.6.1	Minor	Active	.../js/jsoneditor/	MIT	Changelog	🚧
PDFjs	3.10.111	Minor 🚧	Active	.../artefact/file/blocktype/pdf/js/pdfjs/	Apache License 2	Getting started The Firefox dist version different to NPM package	❌

Forked/stale/deprecated libraries

Name	Mahara version	Latest version	Support	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.

@@ Line 27: / Line 27: @@
 *'''Mahara version''' = the <code>README.Mahara</code> file for the library | [https://nodejs.dev/learn/semantic-versioning-using-npm 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?
+*'''Update type''' = what upgrades are available for this plugin, i.e. major, minor, patch, or security?
-*'''Upgrades/updates''' = what upgrades are available for this plugin?
+*'''Support''' = Is there a community supporting this library? When was the last release year if not in active support
-*'''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
+*'''Notes''' = extra information, e.g. resources, notes, and new
-*🚧 Work in progress – data needs to be updated
+*'''Composer''' = check if the library is managed by Composer
+*'''NPM''' = check if the library is managed by NPM
 '''PHP versions in support''' https://www.php.net/supported-versions.php<nowiki/>⁣ – 14 LTS - Ends security support in 30 Apr 2023, go to 16 LTS soon
@@ Line 57: / Line 55: @@
 !'''Name'''
 !'''Mahara <br />version'''
-!'''Available<br />update (Major, Minor, Security, Patch)'''
+!'''Update type'''
-!'''Last release'''
+!'''Support'''
 !'''License'''
 !'''URL/Notes'''
@@ Line 120: / Line 118: @@
 |[https://github.com/simplesamlphp/simplesamlphp GitHub]
 Optional library - called in Makefile
-<small>htdocs/auth/saml/extlib/modules</small>
 |❌
 |}
@@ Line 137: / Line 133: @@
 !'''Name'''
 !'''Mahara <br />version'''
-!'''Update available (Major, Minor, Security, Patch)'''
+!'''Update type'''
-!'''Last release'''
+!'''Support'''
-!'''Location<br />'''<code><small>(./htdocs/...)</small></code>
 !'''License'''
-!'''Notes - For URL see component page on local'''
+!'''Notes'''
 |-
 | style="font-weight:bold;" |'''yargs'''
@@ Line 147: / Line 142: @@
 |Minor, 5.3.2
 |Active
-|<small>.../lib/bootstrap/assets/javascripts/<br /></small>
 |MIT
 |
@@ Line 155: / Line 149: @@
 |Major, 4.4.0
 |Active
-|<small>.../js/chartjs/</small>
 |MIT
 |[https://www.chartjs.org/docs/latest/migration/v4-migration.html Migration to v4]
@@ Line 163: / Line 156: @@
 |Up to date
 |Active
-|<small>.../js/clipboard/</small>
 |MIT
 |version # is tagged
@@ Line 171: / Line 163: @@
 |Up to date
 |2020
-|<small>..../js/dragondrop/</small>
 |MIT
 |
@@ Line 179: / Line 170: @@
 |Patch, 5.9.3
 |2021
-|<small>.../js/dropzone/</small>
 |MIT
 |
@@ Line 187: / Line 177: @@
 |Up to date
 |Active
-|<small>.../js/jquery/</small>
 |MIT
 |[https://forum.jquery.com/ Forum]
@@ Line 195: / Line 184: @@
 |Up to date
 |Active
-|<small>.../js/jquery/jquery-ui/</small>
 |MIT
 |
@@ Line 203: / Line 191: @@
 |Up to date
 |Inactive,2022
-|<small>.../js/jscolor/</small>
 |GPL 3
 |
@@ Line 212: / Line 199: @@
 Major 9.1.0
 |Active
-|<small>.../js/marked/</small>
 |MIT
 |
@@ Line 220: / Line 206: @@
 |Up to date
 |Active
-|<small>.../js/momentjs/</small>
 |MIT
 |[http://momentjs.com/ Moment JS] 🆕 [https://moment.github.io/luxon/#/ Luxon GitHub]
@@ Line 228: / Line 213: @@
 |Up to date
 |Active
-|<small>.../js/popper/</small>
 |MIT
 |[https://github.com/twbs/bootstrap/issues/31451 GitHub issue]<nowiki> | </nowiki>[https://dev.to/fezvrasta/smarter-tooltips-and&#x20;-popovers-with-popper-2-44bh tooltips]
@@ Line 237: / Line 221: @@
 |Up to date
 |Active
-|<small>.../theme/raw/sass/lib/font-awesome/</small>
 |SIL OFL 1.1
 |[https://fontawesome.com/docs/web/setup/upgrade/ Upgrade steps]<nowiki> | </nowiki>[https://fontawesome.com/docs/changelog/ Changelog]
@@ Line 245: / Line 228: @@
 |Major, 6.7.0
 |Active
-|<small>.../js/tinymce/</small>
 |LGPL 2.1
-|[https://www.tiny.cloud/ Tiny Cloud]<nowiki> | </nowiki>[https://www.tiny.cloud/get-tiny/self-hosted Downloads]<nowiki> | </nowiki>[https://www.tiny.cloud/docs/changelog/ Changelog]<nowiki> |</nowiki>[https://www.tiny.cloud/blog/category/news-and-updates/ News]
+|[https://www.tiny.cloud/get-tiny/self-hosted Downloads]<nowiki> | </nowiki>[https://www.tiny.cloud/docs/changelog/ Changelog]
-📲 Test on mobile
+📲 Test mobile
 |-
 | style="font-weight:bold;" |'''Video.js'''
@@ Line 254: / Line 236: @@
 |Major, 8.5.2
 |Active
-|<small>.../artefact/file/blocktype/<br />internalmedia/videojs/</small>
 |Apache License 2.0
 |[http://videojs.com/ Video JS]
@@ Line 264: / Line 245: @@
 !'''Name'''
 !'''Mahara <br />version'''
-!'''Update available (Major, Minor, Security, Patch)'''
+!'''Update type'''
-!'''Last release'''
+!'''Support'''
 !'''Location<br />'''<code><small>(./htdocs/...)</small></code>
 !'''License'''
-!'''Notes - For URL see component page on local'''
+!'''Notes'''
 !'''NPM'''
 |-
@@ Line 274: / Line 255: @@
 '''picker'''
 |4.17.47
-|Major 6.17.16 🚧
+|Major 6.17.16
 |Active - v6
 |<small>.../js/bootstrap-datetimepicker/</small>
@@ Line 299: / Line 280: @@
 |<small>.../js/gridstack/</small>
 |MIT
-|
+|[Demos](<nowiki>https://gridstackjs.com/demo/</nowiki>)
-|❌
+https://github.com/gridstack/gridstack.js/tree/master/doc
+|🚧
 |-
 | style="font-weight:bold;" |'''Json editor'''
@@ Line 318: / Line 302: @@
 |Apache License 2
 |[http://mozilla.github.io/pdf.js/getting_started/#download Getting started]
-The Firefox dist version seems to be the only working one
+The Firefox dist version different to NPM package
 |❌
 |}
@@ Line 328: / Line 312: @@
 !'''Mahara <br />version'''
 !'''Latest<br />version'''
-!'''Status'''
+!'''Support'''
 !'''Location<br />'''<code><small>(./htdocs/...)</small></code>
 !'''License'''

Developer Area/Plugins/Third party: Difference between revisions

From Mahara Wiki

< Developer Area‎ | Plugins

Latest revision as of 16:18, 4 Ocak 2024

Contents

Composer commands

Checking the `.Mahara` files

Syncing the list in 'Country' dropdowns

Third-party libraries (PHP and JS)

Legend

PHP libraries (excluding external)

JavaScript and jQuery libraries

NPM-managed JS libraries

Manually managed JS libraries

Forked/stale/deprecated libraries

Fonts

Composer.json dependencies

Developer Area/Plugins/Third party: Difference between revisions

From Mahara Wiki

< Developer Area‎ | Plugins

Latest revision as of 16:18, 4 Ocak 2024

Composer commands

Checking the .Mahara files

Syncing the list in 'Country' dropdowns

Third-party libraries (PHP and JS)

Legend

PHP libraries (excluding external)

JavaScript and jQuery libraries

NPM-managed JS libraries

Manually managed JS libraries

Forked/stale/deprecated libraries

Fonts

Composer.json dependencies

Checking the `.Mahara` files