|
| 1 | +# free fork of jqGrid |
| 2 | +====== |
| 3 | + |
| 4 | +jqGrid is a popular jQuery Plugin for displaying and editing data in tabular form. It has some other more sophisticated features, like subgrids, TreeGrids, grouping and so on. |
| 5 | + |
| 6 | +jqGrid was developed mostly by [Tony Tomov](https://github.com/tonytomov) in the past and it was available under MIT/GPL-licenses till the version 4.7.0 published Dec 8, 2014 (see [here](https://github.com/tonytomov/jqGrid/tree/v4.7.0)). Short time after that the license agreement was changed (see <a href="https://github.com/tonytomov/jqGrid/commit/1b2cb55c93ee8b279f15a3faf5a2f82a98da3b4c">here</a>) and new 4.7.1 version was <a href="https://github.com/tonytomov/jqGrid/tree/v4.7.1">published</a>. |
| 7 | + |
| 8 | +The code from the GitHib repository is the fork of jqGrid 4.7.0 - the latest version available under MIT/GPL-licenses. It will be provided under MIT/GPL-licenses. |
| 9 | + |
| 10 | +Below you can find short description of new features and bug fixes implemented in free jqGrid 4.12.1 (compared with version 4.12.1). The version is developed by [Oleg Kiriljuk](https://github.com/OlegKi), alias [Oleg](http://stackoverflow.com/users/315935/oleg) on the stackoverflow and [OlegK](http://www.trirand.com/blog/?page_id=393) on trirand forum. |
| 11 | + |
| 12 | +Read [Wiki](https://github.com/free-jqgrid/jqGrid/wiki) for more detailed information about the features of free-jqGrid. The preliminary version of the documentation can be found [here](http://free-jqgrid.github.io/). |
| 13 | + |
| 14 | +Free jqGrid can be used *for free *. We still ask to contribute the development by donating via PayPal, if one have the possibility for it. One can donate by clicking on the following button [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=JGTCBLQM2BYHG "Donate once-off to free jqGrid project using Paypal") or by sending money via Paypal to [email protected] with the comment "free jqGrid". |
| 15 | + |
| 16 | +One can install the package with respect of [bower](http://bower.io/search/?q=free-jqgrid) by using "bower install free-jqgrid", with respect of [npm](https://www.npmjs.com/package/free-jqgrid) by using "npm install free-jqgrid" or from [NuGet](https://www.nuget.org/packages/free-jqGrid) by using "Install-Package free-jqGrid". |
| 17 | + |
| 18 | +Free jqGrid is published on [cdnjs](https://cdnjs.com/libraries/free-jqgrid) and [jsDelivr CDN](http://www.jsdelivr.com/#!free-jqgrid). So one can use it directly from Internet by including for example |
| 19 | +```html |
| 20 | +<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.12.1/css/ui.jqgrid.min.css"> |
| 21 | +<script src="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.12.1/js/i18n/grid.locale-de.min.js"></script> |
| 22 | +<script src="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.12.1/js/jquery.jqgrid.min.js"></script> |
| 23 | +``` |
| 24 | + |
| 25 | +It somebody want to test the *latest* version of free jqGrid, one can load it directly from GitHib using [RawGit](http://rawgit.com/) service: |
| 26 | +```html |
| 27 | +<link rel="stylesheet" href="https://rawgit.com/free-jqgrid/jqGrid/master/css/ui.jqgrid.css"> |
| 28 | +<script src="https://rawgit.com/free-jqgrid/jqGrid/master/js/i18n/grid.locale-de.js"></script> |
| 29 | +<script src="https://rawgit.com/free-jqgrid/jqGrid/master/js/jquery.jqgrid.src.js"></script> |
| 30 | +``` |
| 31 | +All other language files and plugins are avalable from CDN too. See [the wiki article](https://github.com/free-jqgrid/jqGrid/wiki/Access-free-jqGrid-from-different-CDNs) for more details about the usage of free jqGrid from CDNs and RawGit. |
| 32 | + |
| 33 | +The package is published on [WebJars](http://www.webjars.org/) and it's deployed on [Maven Central]((http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22free-jqgrid%22)) too. |
| 34 | + |
| 35 | +Remark: the above URLs will be available **after publishing** the release of the version of 4.12.1 |
| 36 | + |
| 37 | +### Main new features and improvements implemented in the version 4.12.1. |
| 38 | + |
| 39 | +* Add `div.ui-jqgrid-errorbar` and default implementation of `loadError`. Free jqGrid displays now an error message on errors during loading the data from the server. |
| 40 | +* Add `afterResizeDblClick` callback and `jqGridAfterResizeDblClick` event. It allows to make some custom actions after Auto-Resizing of columns for example. |
| 41 | +* Add support of `key`, `jsonmap`, `xmlmap` for `additionalProperties` items specified in object format. |
| 42 | + |
| 43 | +### The below is the full list of changes in the version 4.12.1 compared with 4.12.0 |
| 44 | + |
| 45 | +* Bug fix in displaying of the column name in the validation error message of inline editing. |
| 46 | +* Add missing en-locale information in locale embedded in `grid.base.js`/`jquery.jqgrid.src.js`/`jquery.jqgrid.min.js`. Some texts are missed if one used `jquery.jqgrid.src.js`/`jquery.jqgrid.min.js` *without* including the locale file `grid.locale-en.min.js`. |
| 47 | +* Bug fix of *local* sorting if old style filters (the `postData` with `searchField`, `searchOper`, `searchString`) are used. |
| 48 | +* Improvement of building process, add `watch` to `gruntfile.js`, fix `sourceMappingURL`. |
| 49 | +* Implementing `editrules.custom` as function with more information in parameter as `custom_func`. |
| 50 | +* Add `div.ui-jqgrid-errorbar` and default implementation of `loadError`. Free jqGrid displays now an error message on errors during loading the data from the server. |
| 51 | +* Bug fix of "Next" and "Last" buttons, which should be not enabled on empty local grid. |
| 52 | +* Bug fix of `setRowData` to fill `options.rowData` for custom formatters. |
| 53 | +* Fix the reference to .css from .css.map files. |
| 54 | +* Bug fix in `addChildNode`. |
| 55 | +* Bug fix of internal `readInput` method to correctly support `xmlmap` properties of `colModel` items. |
| 56 | +* Bug fix in saving of postion of editing dialogs. |
| 57 | +* Add `afterResizeDblClick` callback and `jqGridAfterResizeDblClick` event. It allows to make some custom actions after Auto-Resizing of columns for example. |
| 58 | +* Add support of `key`, `jsonmap`, `xmlmap` for `additionalProperties` items specified in object format. |
| 59 | + |
| 60 | +Other readmes contain the list of the features and bug fixed implemented before: |
| 61 | + |
| 62 | +* [README4.12.0.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.12.0.md) contains the readme of free jqGrid 4.12.0. |
| 63 | +* [README4.11.1.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.11.1.md) contains the readme of free jqGrid 4.11.1. |
| 64 | +* [README4.11.0.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.11.0.md) contains the readme of free jqGrid 4.11.0. |
| 65 | +* [README4.10.0.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.10.0.md) contains the readme of free jqGrid 4.10.0. |
| 66 | +* [README492.md](https://github.com/free-jqgrid/jqGrid/blob/master/README492.md) contains the readme of free jqGrid 4.9.2. |
| 67 | +* [README491.md](https://github.com/free-jqgrid/jqGrid/blob/master/README491.md) contains the readme of free jqGrid 4.9.1. |
| 68 | +* [README49.md](https://github.com/free-jqgrid/jqGrid/blob/master/README49.md) contains the readme of free jqGrid 4.9. |
| 69 | +* [README48.md](https://github.com/free-jqgrid/jqGrid/blob/master/README48.md) contains the readme of free jqGrid 4.8. |
| 70 | + |
| 71 | +**Many thanks to all, who sent bug reports and suggestions to improve free jqGrid!** |
0 commit comments