summaryrefslogtreecommitdiff
path: root/README.md
blob: c4d266952798803a17c3a7d82b0b66f6c808e114 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# Strapi Checkbox List Plugin

A custom field plugin for Strapi v5 that extends the Content Type Builder with a flexible checkbox list component. Enable content editors to select multiple values from predefined options with an intuitive interface that seamlessly integrates into the Strapi admin panel.

## Features

- **Multi-select interface**: Intuitive checkbox-based selection for content editors
- **Flexible configuration**: Define custom option lists for each field instance
- **Native integration**: Works seamlessly within Strapi's Content Type Builder
- **Type-safe**: Full TypeScript support for enhanced development experience

## Requirements

- Node.js and npm compatible with Strapi v5
- Strapi `@strapi/strapi` ^5.35.0

## Installation

Install the package in your Strapi project:

```bash
npm install strapi-plugin-checkbox-list
```

Restart your Strapi application, then navigate to the Content Type Builder to add the **Checkbox list** custom field to your content types.

## Usage

After installation, the Checkbox list field type will be available in the Content Type Builder:

1. Open Content Type Builder
2. Select a content type or create a new one
3. Click "Add another field"
4. Choose "Checkbox list" from the custom fields
5. Configure your checkbox options
6. Save and use in your content entries

## Contributing & Support

This project is actively maintained and welcomes contributions. Issues and pull requests can be submitted through either repository:

- **Primary development**: [valentineus/strapi-plugin-checkbox-list](https://code.popov.link/valentineus/strapi-plugin-checkbox-list/issues)
- **GitHub mirror**: [valentineus/strapi-plugin-checkbox-list](https://github.com/valentineus/strapi-plugin-checkbox-list/issues)

Development primarily takes place on the self-hosted Git instance, with GitHub serving as a mirror for broader accessibility.

**Maintainer**: Valentin Popov <valentin@popov.link>

## Development

Build the plugin:

```bash
npm install
npm run build
```

For active development with automatic rebuilds:

```bash
npm run watch
```

To run the test Strapi app from `playground/`:

```bash
cd playground
npm install
npm run develop
```

If you need the plugin linked into the playground app, use the Strapi plugin linker and point it at `playground/`:

```bash
npm run watch:link
```

## License

This project is licensed under the [MIT License](LICENSE.txt).