tinalabs/tinacms-contentful

Edit your Contentful Site with TinaCMS

react-tinacms-contentful

This package provides helpers for setting up TinaCMS to use the Contentful API as well as user authentication with Contentful.

Pre-requisites

To use this plugin, the following is expected:

• You have a working application with TinaCMS already setup
• You have setup OAuth applications with Contentful if you plan to have your users authenticate with Contentful
• You have a space with Content Models and Entries ready to use

Quick Start

To get up and running quickly, follow the instructions for your tech stack:

• tinacms-contentful: plain Javascript APIs for client-side javascript.
• react-tinacms-contentful: React-specific APIs.
• next-tinacms-contentful: Next.js-specific APIs.

Guides

There are three different approaches to using Contentful with TinaCMS, depending on your application's configuration:

1. Client-side with READ-only access tokens, allowing you to fetch entries, assets, and other data from Contentful's API in your client-side JS.
2. Client-side editing with OAuth user authentication, which allows users of your Contentful organization to login to their account to edit the content with Tina that they are allowed to access in Contentful, and allow you to perform CRUD operations on their behalf.
3. Client-side and serverless editing with Oauth user authentication with Next.js Edit Mode, which allows you to maintain server-side sessions for logged in users across multiple tabs in your Next.js application, and manage content in Contentful in API functions, getStaticProps, and getServerSideProps.

There are also the following use-case specific guides:

1. Editing entries with link fields, which allows you to build complex data structures using Contentful Link fields and edit them with a single TinaCMS form.
2. Adding new features to the CMS using Contentful, such as adding toolbar widgets, screen plugins, custom fields, and custom form actions.

Roadmap

The following is a series of things we would like to add or are considering adding to the plugins, if time and resources submits:

• The ability to create, update, and delete content models as the user using the ContentfulClient and in TinaCMS sidebar and toolbar as forms/content creators/screen plugin(s).
• The ability to manage media from multiple spaces at one time