https://github.com/statamic/bardify
Convert Replicator fields to Bard fields
https://github.com/statamic/bardify
addon bard medium rich-rext statamic statamic-addon statamic-v2
Last synced: about 2 months ago
JSON representation
Convert Replicator fields to Bard fields
- Host: GitHub
- URL: https://github.com/statamic/bardify
- Owner: statamic
- Created: 2018-01-11T21:14:24.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-06-26T18:04:26.000Z (almost 7 years ago)
- Last Synced: 2025-02-15T20:57:08.324Z (4 months ago)
- Topics: addon, bard, medium, rich-rext, statamic, statamic-addon, statamic-v2
- Language: PHP
- Size: 6.84 KB
- Stars: 3
- Watchers: 6
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Overview
Bard fields are just like Replicator fields, except that the "text" blocks are implied and saved as `text` in your content.
For example you may have a Replicator field in your fieldset where you use your "text" set like this:
``` yaml
fields:
story:
type: replicator
sets:
content: # The "text" set. It's the one with just a single text based field.
fields:
html:
type: redactor
quote:
fields:
quote:
type: text
cite:
type: text
```
and your data would be saved like this:
``` yaml
story:
-
type: text
html: "
This is my story
"
-
type: quote
quote: Oh Hai Mark
cite: Tommy Wiseau
```
To change to Bard, you'd need to replace your `content`/`html` set to `text`/`text`.
``` yaml
story:
-
type: text
text: "
This is my story
"
-
type: quote
quote: Oh Hai Mark
cite: Tommy Wiseau
```
Simple enough, but tedious to do it for all your entries.
**If you happened to already call your text set `text` with a field named `text` - you're in luck and don't need to change anything.**
## Usage
> Note: This modifies your data, so consider making a backup first.
> Another Note: This doesn't support multiple locales yet.
Download this repo and place it in `site/addons/Bardify` and run this command:
```
php please bardify
```
It will automate the following:
- Go through any relevant content files and change the types/fields.
- Remove the "text" set from the Replicator field.
- Change `type: replicator` to `type: bard`. (Wow!)
- If you were using a markdown fieldtype for the text field, it will add `markdown: true` to the Bard field.
## Converting content fields to Bard
You may also convert your `content` field (the text below your YAML front-matter) into a Bard field by running the following command:
```
php please bardify:content
```
It will automate the following:
- Go through any relevant content files and replace the content text with the field name of your choice.
- If you were using a markdown fieldtype, it will add `markdown: true` to the Bard field.