Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kitconcept/volto-separator-block
https://github.com/kitconcept/volto-separator-block
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kitconcept/volto-separator-block
- Owner: kitconcept
- Created: 2022-03-28T08:37:32.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-25T09:37:12.000Z (3 months ago)
- Last Synced: 2024-11-13T06:33:39.991Z (2 months ago)
- Language: JavaScript
- Size: 8.76 MB
- Stars: 1
- Watchers: 4
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-volto - volto-separator-block - A divider visual indicator type of block (Addons)
README
# volto-separator-block (@kitconcept/volto-separator-block)
A new add-on for Volto
[](https://www.npmjs.com/package/@kitconcept/volto-separator-block)
[](https://kitconcept.github.io/volto-separator-block/)
[](https://github.com/kitconcept/volto-separator-block/actions/workflows/code.yml)
[](https://github.com/kitconcept/volto-separator-block/actions/workflows/unit.yml)
The Volto Separator Block allows editors to add a visual separator between blocks to a Volto page.
## Screenshot
## Screencast
## Block Alignment Enhancer
This block features by default a block `schemaEnhancer` that provides an alignment option for the separator. This can be disabled by overwriting with your own `schemaEnhancer`
```js
config.blocks.blocksConfig.separator = {
...config.blocks.blocksConfig.separator,
schemaEnhancer: mySeparatorSchemaEnhancer,
}
```
or setting it to `null` or `undefined`:
```js
config.blocks.blocksConfig.separator = {
...config.blocks.blocksConfig.separator,
schemaEnhancer: null,
}
```
Also, if you want to keep the default alignment but still add your own `schemaEnhancer` you can compose it along with your own:
```js
import { composeSchema } from '@plone/volto/helpers';
import { SeparatorStyleEnhancer } from '@kitconcept/volto-separator-block';
config.blocks.blocksConfig.separator = {
...config.blocks.blocksConfig.separator,
schemaEnhancer: composeSchema(mySeparatorSchemaEnhancer, defaultSeparatorEnhancer),
}
```
## Installation
To install your project, you must choose the method appropriate to your version of Volto.
### Volto 17 and earlier
Create a new Volto project (you can skip this step if you already have one):
```
npm install -g yo @plone/generator-volto
yo @plone/volto my-volto-project --addon @kitconcept/volto-separator-block
cd my-volto-project
```
Add `@kitconcept/volto-separator-block` to your package.json:
```JSON
"addons": [
"@kitconcept/volto-separator-block"
],
"dependencies": {
"@kitconcept/volto-separator-block": "*"
}
```
Download and install the new add-on by running:
```
yarn install
```
Start volto with:
```
yarn start
```
### Volto 18 and later
Add `@kitconcept/volto-separator-block` to your `package.json`:
```json
"dependencies": {
"@kitconcept/volto-separator-block": "*"
}
```
Add `@kitconcept/volto-separator-block` to your `volto.config.js`:
```javascript
const addons = ['@kitconcept/volto-separator-block'];
```
If this package provides a Volto theme, and you want to activate it, then add the following to your `volto.config.js`:
```javascript
const theme = '@kitconcept/volto-separator-block';
```
## Test installation
Visit http://localhost:3000/ in a browser, login, and check the awesome new features.
## Development
The development of this add-on is done in isolation using a new approach using pnpm workspaces and latest `mrs-developer` and other Volto core improvements.
For this reason, it only works with pnpm and Volto 18 (currently in alpha).
### Pre-requisites
- [Node.js](https://6.docs.plone.org/install/create-project.html#node-js)
- [Make](https://6.docs.plone.org/install/create-project.html#make)
- [Docker](https://6.docs.plone.org/install/create-project.html#docker)
### Make convenience commands
Run `make help` to list the available commands.
```text
help Show this help
install Installs the add-on in a development environment
start Starts Volto, allowing reloading of the add-on during development
build Build a production bundle for distribution of the project with the add-on
i18n Sync i18n
ci-i18n Check if i18n is not synced
format Format codebase
lint Lint, or catch and remove problems, in code base
release Release the add-on on npmjs.org
release-dry-run Dry-run the release of the add-on on npmjs.org
test Run unit tests
ci-test Run unit tests in CI
backend-docker-start Starts a Docker-based backend for development
storybook-start Start Storybook server on port 6006
storybook-build Build Storybook
acceptance-frontend-dev-start Start acceptance frontend in development mode
acceptance-frontend-prod-start Start acceptance frontend in production mode
acceptance-backend-start Start backend acceptance server
ci-acceptance-backend-start Start backend acceptance server in headless mode for CI
acceptance-test Start Cypress in interactive mode
ci-acceptance-test Run cypress tests in headless mode for CI
```
### Development environment set up
Install package requirements.
```shell
make install
```
### Start developing
Start the backend.
```shell
make backend-docker-start
```
In a separate terminal session, start the frontend.
```shell
make start
```
### Lint code
Run ESlint, Prettier, and Stylelint in analyze mode.
```shell
make lint
```
### Format code
Run ESlint, Prettier, and Stylelint in fix mode.
```shell
make format
```
### i18n
Extract the i18n messages to locales.
```shell
make i18n
```
### Unit tests
Run unit tests.
```shell
make test
```
### Run Cypress tests
Run each of these steps in separate terminal sessions.
In the first session, start the frontend in development mode.
```shell
make acceptance-frontend-dev-start
```
In the second session, start the backend acceptance server.
```shell
make acceptance-backend-start
```
In the third session, start the Cypress interactive test runner.
```shell
make acceptance-test
```
## License
The project is licensed under the MIT license.
# Credits
The development of this plugin has been kindly sponsored by [Forschungszentrum Jülich](https://fz-juelich.de).
# License
The project is licensed under the MIT license.