Bard
Bard is awesome. But can also be challenging to work with to make it work for every use case.
Including Bard support was a major priority for version 3 to ensure your more advanced content can still work.
Absolute URLs
When Feedamic processes fields - including non-Bard fields - URLs will be converted to Absolute using Statamic's core full_urls modifier.
No Sets
This is easy.
If your Bard field has no sets, Statamic will simply convert it to HTML - easy as that!
Sets
Sets is where it gets more complicated, and first of all, you have two choices.
Exclude
This is easy too. Feedamic can just ignore them.
By default, Feedamic will try to include them - so you need to disable sets.
In one of your site's Service Providers, call the ignoreBardSets method:
1use MityDigital\Feedamic\Models\FeedamicEntry;2 3FeedamicEntry::ignoreBardSets(true);This will ignore Bard Sets when processing your content.
This example only applies to the built-in Feedamic Entry - if you have your own Models, you'll need to call this on those Models too.
You can also pass false to re-enable Set support.
Include
By default, Feedamic will throw a BardContainsSetsException if your field's value contains sets.
To work around this, you will need to create a Modifier that renders your sets - there's an example on how to do this on the Modifiers docs.
Ensure that any links referenced in your Sets are absolute. This is your responsibility: you may want to use Statamic's full_urls modifier.