Skip to content
This repository has been archived by the owner on Jul 7, 2022. It is now read-only.

hennessyevan/netlify-cms-widget-youtube

Repository files navigation

NPM npm bundle size (minified) npm

netlify-cms-widget-youtube

Check out a demo!

Provides a simple text input for youtube videos. Validates strings with a green text color and provides a preview image in the preview pane.

Looking for suggestions for additional functionality. PRs are Welcome!

screenshot of youtube widget

Install

As an npm package:

npm install --save netlify-cms-widget-youtube
import youtube from "netlify-cms-widget-youtube";

CMS.registerWidget("youtube", youtubeControl, youtubePreview);

Via script tag:

<script src="https://unpkg.com/netlify-cms-widget-youtube@^0.3.0"></script>

<script>
  CMS.registerWidget('youtube', youtubeControl, youtubePreview)
</script>

How to use

Add to your Netlify CMS configuration:

    fields:
      - { name: <fieldname>, label: <fieldlabel>, widget: youtube, extraInfo: false, APIkey: "<KEY>" }

Enabling extraInfo will return an object in frontmatter

<fieldname>:
	url: String
	id: String
	mediaType: String
	imageURL: String
	embedURL: String

If you provide an API KEY in the configuration you will get additional information in the Control (as seen in the screenshot above). You can use this API key here to test but it's better you get your own to make sure it always works!

FAQ

Q: My control doesn't show the title or description

You need to add an API Key to the widget settings. Learn about getting an API Key here

Q: How can I get and image url in my output

You need to add extraInfo: true to your Netlify CMS configuration (usually config.yml)

Roadmap

  • Youtube Image in Preview
  • Extended Details in Control from Youtube Data API
  • Optional YAML object output
  • Youtube Search function
  • Couple with a Youtube "Editor Widget"

Support

For help with this widget, open an issue or ask the Netlify CMS community in Gitter.