Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
OlegKi committed Dec 24, 2016
1 parent c69a476 commit 2dbad52
Show file tree
Hide file tree
Showing 2 changed files with 116 additions and 28 deletions.
56 changes: 28 additions & 28 deletions README.md
Expand Up @@ -38,34 +38,34 @@ All other language files and plugins are available from CDN too. See [the wiki a

Remark: the above URLs will be available **after publishing** the release of the version of 4.13.6.

### Below one can see the full list of changes in the version 4.13.5 compared with 4.13.4:

* Fix sorting of `sorttype:"int"` for the value 0
* Bug fix in `columnChooser` in case of the usage grouped headers (see https://github.com/free-jqgrid/jqGrid/commit/eb2b98e26a799c2134d413a8a4c8b13dc9083d02)
* Small code reorganization of `reorderSelectedColumns` used in `columnChooser`
* Bug fix in `reorderSelectedColumns` used in `columnChooser`
* Small fix of the position of Font Awesome sorting icons in `ui.jqgrid.css`
* Fix the usage of `columnChooser` on grids which has no column grouping
* Small improvement of performance of `columnChooser`
* Move calling of `bindEv` (`dataInit` and `dataEvents`) after the elements are placed on the DOM. It reduces the requirement of placing the main code of `dataInit` inside of `setTimeout`.
* Some improvements of the code of `filterToolbar`
* Small bug fix in `createEl` to prevent creating unneeded attribute `column` in searching dialog
* Add support of `stype:"checkbox"` - the 3-state checkbox. One can use `stype: "checkbox", searchoptions: { sopt: ["eq"], value: "true:false" }`
* Change the code of `template:"booleanCheckbox"` to use `stype:"checkbox"`
* Bug fix of min height of the btable to 1px to hold horizontal scrolling position during filtering to no rows
* Bug fix padding-top and padding-bottom to 0 inside of text input in searching toolbar in Bootstrap
* Small fixes of the code based on reports of ReSharper
* Bug fix in showHideCol/showCol/hideCol in Microsoft Edge
* Make the code of `getAccessor` more safe
* Add new helper method `$.jgrid.getRelativeRect`. See https://github.com/free-jqgrid/jqGrid/commit/8150d860a75176bb589ec2fdab89a65ce074ee90 for an example of the usage of `$.jgrid.getRelativeRect` to specify `top` option of `editGridRow` inside of `ondblClickRow` callback
* Add the usage of new helper method `$.jgrid.getRelativeRect` in `formatter:"actions"`
* Bug fix of position of Bootstrap modal in case of `dir="rtl"` on body
* Improving the position of the dialog with validation error in cell editing using `$.jgrid.getRelativeRect` method
* Improving the look of View form and make the look closer in Bootstrap and jQuery UI
* Improve processing of select with `multiple` attribute in the filter toolbar in case of loading the data via Ajax
* Update AMD dependencies of JS files included in plugins folder to be used correctly in RequireJs. [The demo](http://www.ok-soft-gmbh.com/jqGrid/OK/requireJsInline3_.htm) provides an example of loading plugins via RequireJs.

The main changes can be seen on [the demo](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-jqueryui-fa-stype-checkbox.htm), which uses jQuery UI, and [the another one](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-bootstrap-fa-stype-checkbox.htm), which uses Bootstrap.
### Below one can see the full list of changes in the version 4.13.6 compared with 4.13.5:

* Bug fix sorting of `sorttype:"int"` for the value 0.
* Bug fix in `columnChooser` in case of usage grouped headers (see [the commit](https://github.com/free-jqgrid/jqGrid/commit/eb2b98e26a799c2134d413a8a4c8b13dc9083d02)).
* Small code reorganization of `reorderSelectedColumns`, used by `columnChooser`.
* Bug fix in `reorderSelectedColumns`, used by `columnChooser`.
* Small fix of the position of Font Awesome sorting icons in `ui.jqgrid.css`.
* Bug fix in `columnChooser` on grids, which has no column grouping.
* Small improvement of performance of `columnChooser`.
* Move calling of `bindEv` (`dataInit` and `dataEvents`) *after* the elements are placed on the HTML document. It reduces the requirement of placing the main code of `dataInit` inside of `setTimeout`.
* Some improvements of the code of `filterToolbar`.
* Small bug fix in `createEl` to prevent creating unneeded attribute `column` in data fields of the searching dialog.
* Add support of `stype:"checkbox"` - the 3-state checkbox with an additional *intermediate* state. One can use it in the form `stype: "checkbox", searchoptions: { sopt: ["eq"], value: "true:false" }`.
* Change the code of `template:"booleanCheckbox"` to use `stype:"checkbox"`.
* Bug fix of min height of the `btable` (the main table with the data) to 1px to hold horizontal scrolling position during filtering to no rows.
* Bug fix of `padding-top` and `padding-bottom` to 0 inside of the text input in the searching toolbar in case of usage of Bootstrap GUI style.
* Small fixes of the code based on reports of ReSharper.
* Bug fix in `showHideCol`/`showCol`/`hideCol`. The problem were exist only in Microsoft Edge.
* Make the code of `getAccessor` more safe.
* Add new helper method `$.jgrid.getRelativeRect`. See [the commit](https://github.com/free-jqgrid/jqGrid/commit/8150d860a75176bb589ec2fdab89a65ce074ee90) for an example of the usage of `$.jgrid.getRelativeRect` to specify `top` option of `editGridRow` inside of `ondblClickRow` callback.
* Add the usage of new helper method `$.jgrid.getRelativeRect` in `formatter:"actions"`.
* Bug fix of the position of Bootstrap modal in case of usage `direction: "rtl"` in combination with the attribute `dir="rtl"` on the HTML body.
* Improving the position of the dialog with validation error in cell editing using `$.jgrid.getRelativeRect` method.
* Improving the look of View form and make it looks closer in both built-in GUI styles: Bootstrap and jQuery UI.
* Improve processing of select with `multiple` attribute in the filter toolbar in case of loading the data via Ajax.
* Update AMD dependencies of JavaScript files included in plugins folder to be used correctly in RequireJs. [The demo](http://www.ok-soft-gmbh.com/jqGrid/OK/requireJsInline3_.htm) provides an example of loading jqGrid modules and some jqGrid plugins via RequireJs.

The new features introduced in the version 4.13.6 can be seen on [the demo](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-jqueryui-fa-stype-checkbox.htm), which uses jQuery UI, and [the another one](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-bootstrap-fa-stype-checkbox.htm), which uses Bootstrap.

Other old readmes contain the list of the features and bug fixed implemented before:

Expand Down
88 changes: 88 additions & 0 deletions README4.13.6.md
@@ -0,0 +1,88 @@
# free fork of jqGrid
[![npm version](https://img.shields.io/npm/v/free-jqgrid.svg?style=flat)](https://www.npmjs.com/package/free-jqgrid)![downloadstotal](https://img.shields.io/npm/dt/free-jqgrid.svg?style=flat-square)&nbsp;[![Bower](https://img.shields.io/bower/v/free-jqgrid.svg?style=flat-square)](http://bower.io/search/?q=free-jqgrid)&nbsp;[![NuGet](https://img.shields.io/nuget/v/free-jqgrid.svg?style=flat-square)](https://www.nuget.org/packages/free-jqGrid/)&nbsp;[![Maven Central](https://img.shields.io/maven-central/v/org.webjars.npm/free-jqgrid.svg?style=flat-square)](http://search.maven.org/#search%7Cga%7C1%7Cfree-jqgrid)<br>[![GitHub commits](https://img.shields.io/github/commits-since/free-jqgrid/jqgrid/v4.7.0.svg)](https://github.com/free-jqgrid/jqGrid/compare/v4.7.0...master)&nbsp;![time to close pull requests](https://img.shields.io/badge/pull%20requests%20closed%20in-about%203%20hours-brightgreen.svg?style=flat-square)![time to close issues](https://img.shields.io/badge/issues%20closed%20in-1%20day-yellowgreen.svg?style=flat-square)&nbsp;[![GitHub watchers](https://img.shields.io/github/watchers/free-jqgrid/jqGrid.svg)](https://github.com/free-jqgrid/jqGrid/watchers)[![GitHub forks](https://img.shields.io/github/forks/free-jqgrid/jqGrid.svg)](https://github.com/free-jqgrid/jqGrid/network)[![GitHub stars](https://img.shields.io/github/stars/free-jqgrid/jqGrid.svg)](https://github.com/free-jqgrid/jqGrid/stargazers)&nbsp;![devDependency status](https://david-dm.org/free-jqgrid/jqgrid/dev-status.svg)&nbsp;[![GitHub license](https://img.shields.io/badge/license-MIT%20or%20GNU%20GPLv2-blue.svg)](https://github.com/free-jqgrid/jqGrid/blob/master/LICENSE.md)
---
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.

jqGrid was developed originally by [Tony Tomov](https://github.com/tonytomov) 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>.

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.

Below you can find short description of minor new features and the bug fixes implemented in free jqGrid 4.13.6 (compared with version 4.13.5). The version is developed by [Oleg Kiriljuk](https://github.com/OlegKi), alias [Oleg](https://stackoverflow.com/users/315935/oleg) on the stackoverflow and [OlegK](http://www.trirand.com/blog/?page_id=393) on trirand forum.

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](https://free-jqgrid.github.io/).

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 [![PayPayl donate button](https://www.paypalobjects.com/webstatic/en_US/btn/btn_donate_pp_142x27.png)](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 oleg.kiriljuk@ok-soft-gmbh.com with the comment "free jqGrid". Bank transfer based on the invoice from OK soft GmbH is another option of donating. Just send the email with the information about the amount of donation and you will get the corresponding invoice with the full information about our bank account and our VAT number.

One can install the package with respect of [npm](https://www.npmjs.com/package/free-jqgrid) by using "npm install free-jqgrid", with respect of [bower](https://bower.io/search/?q=free-jqgrid) by using "bower install free-jqgrid" or from [NuGet](https://www.nuget.org/packages/free-jqGrid) by using "Install-Package free-jqGrid".

The package is published on [WebJars](http://www.webjars.org/) too and it's deployed to [Maven Central](https://search.maven.org/#search%7Cga%7C1%7Cfree-jqgrid).

Free jqGrid is is available from [jsDelivr CDN](https://www.jsdelivr.com/projects/free-jqgrid) and [cdnjs](https://cdnjs.com/libraries/free-jqgrid). Thus one can use it directly from Internet by including for example the URLs like
```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/free-jqgrid/4.13.6/css/ui.jqgrid.min.css">
<script src="https://cdn.jsdelivr.net/free-jqgrid/4.13.6/js/jquery.jqgrid.min.js"></script>
```
or
```html
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.13.6/css/ui.jqgrid.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/free-jqgrid/4.13.6/js/jquery.jqgrid.min.js"></script>
```
**The locale file is optional**. One can, but one don't need to include `grid.locale-en.min.js`, because the same information is already included in the `jquery.jqgrid.min.js` (or `jquery.jqgrid.src.js`).

If somebody want to test the *latest* version of free jqGrid, one can load it directly from GitHib using [RawGit](https://rawgit.com/) service:
```html
<link rel="stylesheet" href="https://rawgit.com/free-jqgrid/jqGrid/master/css/ui.jqgrid.css">
<script src="https://rawgit.com/free-jqgrid/jqGrid/master/js/jquery.jqgrid.src.js"></script>
```
All other language files and plugins are available 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.

Remark: the above URLs will be available **after publishing** the release of the version of 4.13.6.

### Below one can see the full list of changes in the version 4.13.6 compared with 4.13.5:

* Bug fix sorting of `sorttype:"int"` for the value 0.
* Bug fix in `columnChooser` in case of usage grouped headers (see [the commit](https://github.com/free-jqgrid/jqGrid/commit/eb2b98e26a799c2134d413a8a4c8b13dc9083d02)).
* Small code reorganization of `reorderSelectedColumns`, used by `columnChooser`.
* Bug fix in `reorderSelectedColumns`, used by `columnChooser`.
* Small fix of the position of Font Awesome sorting icons in `ui.jqgrid.css`.
* Bug fix in `columnChooser` on grids, which has no column grouping.
* Small improvement of performance of `columnChooser`.
* Move calling of `bindEv` (`dataInit` and `dataEvents`) *after* the elements are placed on the HTML document. It reduces the requirement of placing the main code of `dataInit` inside of `setTimeout`.
* Some improvements of the code of `filterToolbar`.
* Small bug fix in `createEl` to prevent creating unneeded attribute `column` in data fields of the searching dialog.
* Add support of `stype:"checkbox"` - the 3-state checkbox with an additional *intermediate* state. One can use it in the form `stype: "checkbox", searchoptions: { sopt: ["eq"], value: "true:false" }`.
* Change the code of `template:"booleanCheckbox"` to use `stype:"checkbox"`.
* Bug fix of min height of the `btable` (the main table with the data) to 1px to hold horizontal scrolling position during filtering to no rows.
* Bug fix of `padding-top` and `padding-bottom` to 0 inside of the text input in the searching toolbar in case of usage of Bootstrap GUI style.
* Small fixes of the code based on reports of ReSharper.
* Bug fix in `showHideCol`/`showCol`/`hideCol`. The problem were exist only in Microsoft Edge.
* Make the code of `getAccessor` more safe.
* Add new helper method `$.jgrid.getRelativeRect`. See [the commit](https://github.com/free-jqgrid/jqGrid/commit/8150d860a75176bb589ec2fdab89a65ce074ee90) for an example of the usage of `$.jgrid.getRelativeRect` to specify `top` option of `editGridRow` inside of `ondblClickRow` callback.
* Add the usage of new helper method `$.jgrid.getRelativeRect` in `formatter:"actions"`.
* Bug fix of the position of Bootstrap modal in case of usage `direction: "rtl"` in combination with the attribute `dir="rtl"` on the HTML body.
* Improving the position of the dialog with validation error in cell editing using `$.jgrid.getRelativeRect` method.
* Improving the look of View form and make it looks closer in both built-in GUI styles: Bootstrap and jQuery UI.
* Improve processing of select with `multiple` attribute in the filter toolbar in case of loading the data via Ajax.
* Update AMD dependencies of JavaScript files included in plugins folder to be used correctly in RequireJs. [The demo](http://www.ok-soft-gmbh.com/jqGrid/OK/requireJsInline3_.htm) provides an example of loading jqGrid modules and some jqGrid plugins via RequireJs.

The new features introduced in the version 4.13.6 can be seen on [the demo](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-jqueryui-fa-stype-checkbox.htm), which uses jQuery UI, and [the another one](http://www.ok-soft-gmbh.com/jqGrid/OK/formEditOnDoubleClick-bootstrap-fa-stype-checkbox.htm), which uses Bootstrap.

Other old readmes contain the list of the features and bug fixed implemented before:

* [README4.13.5.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.5.md) contains the readme of free jqGrid 4.13.5.
* [README4.13.4.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.4.md) contains the readme of free jqGrid 4.13.4.
* [README4.13.3.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.3.md) contains the readme of free jqGrid 4.13.3.
* [README4.13.2.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.2.md) contains the readme of free jqGrid 4.13.2.
* [README4.13.1.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.1.md) contains the readme of free jqGrid 4.13.1.
* [README4.13.0.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.13.0.md) contains the readme of free jqGrid 4.13.0.
* [README4.12.1.md](https://github.com/free-jqgrid/jqGrid/blob/master/README4.12.1.md) contains the readme of free jqGrid 4.12.1.
* [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.
* [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.
* [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.
* [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.
* [README492.md](https://github.com/free-jqgrid/jqGrid/blob/master/README492.md) contains the readme of free jqGrid 4.9.2.
* [README491.md](https://github.com/free-jqgrid/jqGrid/blob/master/README491.md) contains the readme of free jqGrid 4.9.1.
* [README49.md](https://github.com/free-jqgrid/jqGrid/blob/master/README49.md) contains the readme of free jqGrid 4.9.0.
* [README48.md](https://github.com/free-jqgrid/jqGrid/blob/master/README48.md) contains the readme of free jqGrid 4.8.0.

**Many thanks to all, who sent bug reports and suggestions to improve free jqGrid!**

0 comments on commit 2dbad52

Please sign in to comment.