README

== About ==

Page Forms is an extension to MediaWiki that allows for the
creation of forms that can be used to create and edit pages. It can
work by itself, or in conjuction with two other extensions that
both handle the storage of data: Cargo and Semantic MediaWiki.

For much more information on Page Forms, see the extension
homepage at https://www.mediawiki.org/wiki/Extension:Page_Forms

Notes on installing Page Forms can be found in the file INSTALL.

== Credits ==

Page Forms was created, and mostly written by, Yaron Koren.

Significant parts of the code were contributed by Stephan Gambke.

Much of the jQuery and related JavaScript functionality was initially
created by Sanyam Goyal as part of the 2010 Google Summer of Code
program.

Integration with the Page Schemas extension was initially created by
Ankit Garg as part of the 2011 Google Summer of Code.

Support for section handling, and PHPUnit tests, were added by Himeshi
De Silva as part of the 2013 Google Summer of Code.

The "tokens" and updated "combobox" input types were created by
Jatin Mehta as part of the 2014 Google Summer of Code.

Support for hierarchies in the Cargo extension was added by Feroz
Ahmed as part of the 2017 Google Summer of Code.

The page Special:MultiPageEdit was added by Yashdeep Thorat as part
of the 2018 Google Summer of Code.

Handling of "display=calendar" was added by Priyanshu Varshney as
part of the 2019 Google Summer of Code.

Use of the jExcel and jsTree libraries, and greater use of the
OOUI library, were added by Amr El-Absy as part of the 2020 Google
Summer of Code.

Autocompletion within the spreadsheet interface was added by Yash
Varshney as part of the 2021 Google Summer of Code.

Important code contributions were also made by Addshore, Anjali
Kumari, Christoph Burgmer, Cindy Cicalese, Clément Flipo, Daniel
Friesen, Daniel Hansch, Eugene Mednikov, Harold Solbrig, Ilmārs
Poikāns, Jayson Harshbarger, Jeffrey Stuckman, Jeroen De Dauw,
Joel Natividad, Louis Gerbarg, LY Meng, Mark Hershberger, Mathias
Lidal, Matt Williamson, MWJames, Niklas Laxstrom, Nils Opperman,
Paladox, Pastakhov, Patrick Nagel, Peter Grassberger, Pierre Boutet,
Reedy, Remco de Boer, Sahaj Khandelwal, Sam Wilson, Sanjay
Thiyagarajan, Sebastian Richter, Sergey Chernyshev, Siebrand
Mazeland, Simon Heimler, Solitarius, Tombolano, Tom Fellows,
Vedmaka, wheresmytab and others.

Language translations were provided by many people; see the files in
the /i18n and /languages directories for the full listings.

== Contact ==

Comments, questions and suggestions should be sent to the MediaWiki
or mailing list:

 https://lists.wikimedia.org/mailman/listinfo/mediawiki-l

If possible, please add "[Page Forms]" at the beginning of the subject
line, to clarify the subject matter.

Bug reports should be submitted at the Wikimedia Phabricator site:

 https://phabricator.wikimedia.org/maniphest/task/create/

== Credits to other projects ==

Page Forms includes the following JavaScript libraries:

* FullCalendar (https://fullcalendar.io/), distributed under the MIT
license.

* Jspreadsheet (https://bossanova.uk/jspreadsheet/), distributed
under the MIT license.

* jsTree (https://www.jstree.com/) by Ivan Bozhanov, distributed under
the MIT license.

* RateYo! (https://rateyo.fundoocode.ninja/) by Prashanth Pamidi,
distributed under the MIT license.

* Select2 (https://select2.org/) by Igor Vaynberg, Kevin Brown and
others, distributed under the MIT license.

* SortableJS (https://sortablejs.github.io/Sortable/) by RubaXa and
owenm, distributed under the MIT license.

Page Forms also makes extensive use of the jQuery and OOUI
JavaScript libraries, both of which are included within MediaWiki.