contentful-multilinks

This is an extension for the Contentful authoring environment.

It adds a new widget for JSON fields (that is, fields of type Object) which contains entries in the form:

  [
     {
        "title": "Homepage",
        "type": "url",
        "url": "https://example.com"
     },
     {
        "title": "Message notes",
        "type": "asset"
        "assetId": "2f1fUdzVXn91F4vQtW9yjy"
     }
  ]

This widget allows adding, editing, reordering, and deleting entries.

It's built with React and makes use of React Sortable.

Installation

The extension.json file in the repository is set up to point to unpkg, which acts as a CDN for the latest version of this extension published to NPM.

This means all you have to do is point Contentful to this file:

1. Space settings
2. "Add extension" button
3. Install from Github
4. https://github.com/ledenis/contentful-multilinks/blob/master/extension.json
5. "Install" button

Development

1. Run npm start to start the dev server over HTTPS

2. Go to the local URL it gives you to accept the self-signed certificate (note that the extension will not work in this context)

3. Install the extension to your Contentful space but point to this local server:

   contentful extension create --space-id $SPACE_ID --src https://localhost:3000
   

   If you've previously installed this way you'll need to use the update command instead:

   contentful extension update --space-id $SPACE_ID --src https://localhost:3000 --force
   

   See the docs for more details.

4. Go look in Contentful at an entry which uses this extension

Publication

1. Make and commit all changes
2. Bump version by running npm version with relevant arguments; this will make another commit and a tag
3. Push the commits and tags
4. Run npm publish to build, package, and publish