Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update readme #386

Merged
merged 1 commit into from
Dec 3, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 19 additions & 22 deletions readme.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,28 @@
# Fields plugin
# Grails Fields plugin

A spiritual successor to the bean-fields plugin that attempts to provide a configurable way to render forms with appropriate inputs for different properties without having to copy and paste lots of boilerplate code. It should be possible to change the rendering for a field with the minimum of impact on any other code. This plugin attempts to achieve that by using GSP templates looked up by convention. Developers can then create templates for rendering particular properties or types of properties with the former overriding the latter.

## Documentation:
For further information please see the full documentation.

Documentation can be found [here](https://gpc.github.io/fields)
The grails fields plugin simplifies working with forms in Grails by offering convenient and customizable ways to manage
field rendering, validation, and interactions. It provides an easy-to-use API that reduces the boilerplate code for
generating form fields, allowing developers to focus on building their applications rather than managing repetitive UI
logic.

## Documentation
For further information please see the full [Grails fields plugin documentation](https://gpc.github.io/fields).

## Tags and branches:
- `master` latest version for Grails 7.x `implementation "org.grals.plugins:fields:7.0.0"`
- `5.1.0` latest version for Grails 5.x `implementation "org.grals.plugins:fields:5.1.0"` - Also works with Grails 6.x
- `4.0.0` latest version for Grails 4.x `compile "io.github.gpc:fields:4.0.0"`
- `6.0.x` latest version for Grails 7.x `implementation "org.grails.plugins:fields:7.0.0"`
- `5.1.0` latest version for Grails 6.x `implementation "org.grails.plugins:fields:5.1.1"`
- `5.0.3` latest version for Grails 5.x `implementation "org.grails.plugins:fields:5.0.3"`
- `4.0.1` latest version for Grails 4.x `compile "io.github.gpc:fields:4.0.0"` (no support)
- `3.0.0.RC1` last version on coordinates: `org.grails.plugins:fields:3.0.0.RC` - Grails 4.x (no support)
- `2.2.x` and `2.1.x` for Grails 3. (no support)
- `grails2.x` for Grails 2. (no support)


## Important

If you use `org.grails.plugins:scaffolding` version 4.10.0 or less you need to exclude the original `org.grals.plugins:fields:3.3.0.RC1` like this:

```
implementation("org.grails.plugins:scaffolding") {
exclude module: 'fields'
}
implementation 'io.github.gpc:fields:5.0.0'
```

if you are using Grails 4.x, replace `implementation` with `compile` and use `io.github.gpc:fields:4.0.0`.
>[!NOTE]
>If you use `org.grails.plugins:scaffolding` version `4.10.0` or less you need to exclude the original `org.grails.plugins:fields:3.3.0.RC1` like this:
>```
>implementation("org.grails.plugins:scaffolding") {
> exclude module: 'fields'
>}
>implementation 'io.github.gpc:fields:5.0.0'
>```
Loading