contentchef_dart 1.0.3 contentchef_dart: ^1.0.3 copied to clipboard
The headless CMS designed to accelerate the success of any digital experience. This is the client for any dart/flutter applications.
ContentChef Dart/Flutter SDK #
Welcome to ContentChef API-First CMS's Dart/Flutter SDK.
How to use ContentChef client #
Dart/Flutter
Create your ContentChef instance like this:
import 'package:contentchef_dart/contentchef_dart.dart';
void main() {
var configuration = Configuration(spaceId: SPACE_ID);
var contentChef = (configuration: configuration);
}
SPACE_ID can be retrieved from your ContentChef's dashboard.
You can now use your contentChef
instance to get the channel you want to use to retrieve info: you have two channels, the OnlineChannel
and the PreviewChannel
.
With the OnlineChannel
you can retrieve contents which are in live state and which are actually visible, while with the PreviewChannel
you can retrieve contents which are in in both stage and live states and even contents that are not visible in the current date.
Both the OnlineChannel
and the PreviewChannel
have two methods which are getContent()
and searchContents()
You can use the getContent()
method to collect a specific content by its own publicId
, for example to retrieve a single post from your blog, a single image from a gallery or a set of articles from your featured articles list. Otherwise you can use the searchContents()
method to find contents with multiple matching criteria, like content definition name, publishing dates and more.
Examples #
How to retrieve a content from your OnlineChannel
SPACE_ID can be retrieved from your ContentChef's dashboard.
ONLINE_API_KEY can be retrieved from your ContentChef space homepage.
PUBLISHING_CHANNEL can be retrieved from your ContentChef's dashboard.
/// Retrieve the *content-chef-site* content from the live status:
void main() {
var configuration = Configuration(spaceId: SPACE_ID);
var contentChef = (configuration: configuration);
var getContentFilters = GetContentFilters(publicId: 'content-chef-site');
var onlineChannel = contentChef.getOnlineChannel(apiKey: ONLINE_API_KEY, publishingChannel: PUBLISHING_CHANNEL);
try {
var result = await onlineChannel.getContent(filters: getContentFilters);
print(jsonEncode(result));
} catch(e) {
print(jsonEncode(e));
}
}
How to retrieve a content in the future from your PreviewChannel
SPACE_ID can be retrieved from your ContentChef's dashboard.
PREVIEW_API_KEY can be retrieved from your ContentChef space homepage.
PUBLISHING_CHANNEL can be retrieved from your ContentChef's dashboard.
// Preview the content *content-chef-site* content in a given future date from the live status
// (i.e. if you want to see the content that will be online in 10 days)
// **targetDateResolver** is used only in the PreviewChannel
// targetDateResolver always return a TargetDate as a `TargetDateDef` so that you can change your date dynamically without caring to create a new ContentChef instance
void main() {
var configuration = Configuration(spaceId: SPACE_ID);
var aDate10DaysInFuture = DateTime(DateTime.now().year, DateTime.now().month, DateTime.now().day + 10);
vart targetDateResolver = TargetDateResolver(targetDateSource: aDate10DaysInFuture.toIso8601String());
var contentChef = (configuration: configuration, targetDateResolver: targetDateResolver);
var getContentFilters = GetContentFilters(publicId: 'content-chef-site');
var previewChannel = contentChef.previewChannel(apiKey: PREVIEW_API_KEY, publishingChannel: PUBLISHING_CHANNEL, status: PublishingStatus.live);
try {
var result = await previewChannel.getContent(filters: getContentFilters);
print(jsonEncode(result));
} catch(e) {
print(jsonEncode(e));
}
}
How to Search for all the contents of a specific definition
SPACE_ID can be retrieved from your ContentChef's dashboard.
ONLINE_API_KEY can be retrieved from your ContentChef space homepage.
PUBLISHING_CHANNEL can be retrieved from your ContentChef's dashboard.
// Search for 10 the contents created using the definition *content-chef-site*
void main() {
var configuration = Configuration(spaceId: SPACE_ID);
var searchContentFilters = SearchContentsFilters(skip: 0, take: 10, contentDefinition: ['top-sites']);
var contentChef = (configuration: configuration);
var onlineChannel = contentChef.onlineChannel(apiKey: ONLINE_API_KEY, publishingChannel: PUBLISHING_CHANNEL);
try {
var result = await previewChannel.searchContents(filters: searchContentFilters);
print(jsonEncode(result));
} catch(e) {
print(jsonEncode(e))
}
}
How to use Media helper #
If you request a content that contain a media field, it will return its publicId as value of the field.
In order to retrieve the media public url, you will need to use the Media
helper class.
Examples #
How to retrieve a media without transformations
void main() {
var mediaHelper = Media();
var publicUrl = mediaHelper.getUrl(publicId: 'your-field-media-publicId')
print(publicUrl);
}
How to retrieve a media without transformations
// If you desire to have transformed media you can specify some parameters with the transformation parameter while getting your media publicUrl.
// The possible transformations are: mediaHeight, mediaWidth, autoFormat and mediaFormat, for more information refer to `MediaTransformations` class
void main() {
var mediaHelper = Media();
var transformations = MediaTransformations(mediaWidth: 1000, mediaHeight: 1000);
var publicUrl = mediaHelper.getUrl(publicId: 'your-field-media-publicId', transformations: transformations);
print(publicUrl);
}
Installation #
- Depend on it
Add this to your package's pubspec.yaml file:
dependencies:
contentchef_dart: ^1.0.3
- Install it
You can install packages from the command line:
with pub:
$ pub get
with Flutter:
$ flutter pub get
Alternatively, your editor might support pub get or flutter pub get. Check the docs for your editor to learn more.
- Import it
Now in your Dart code, you can use:
import 'package:contentchef_dart/contentchef_dart.dart';